Skip to main content

Virtual RC joypad

The virtual RC joypad is a test tool available only in Harlock Desktop when the debug UI is enabled. It is not available on Android. It sends RC_CHANNELS_OVERRIDE commands to the active vehicle: test it in SITL first and always verify the vehicle configuration before enabling it on real hardware.

Open and move the window​

Open the Harlock menu and select Dev → Virtual RC. The opaque joypad opens immediately in a detached window. Drag the top bar to move it. It behaves like a normal desktop window and can move behind Harlock or other applications. Selecting the menu item again focuses the existing window. Closing the main Harlock window also closes the joypad, so it cannot remain open as an orphaned window.

UNI RC 7 Pro layout​

The layout mirrors the main controls of the SIYI UNI RC 7 Pro:

ControlChannelJoypad function
Left stick horizontalRC4Yaw
Left stick verticalRC3Throttle/collective
Right stick horizontalRC1Roll
Right stick verticalRC2Pitch
M1–M6RC5Six-position flight-mode selector
SA / SBRC6 / RC7Three-position Low, Mid, and High selectors
Motor InterlockRC8Dedicated Heli Off/On switch
S1–S4RC9–RC12Auxiliary controls
L1/L2 and R1/R2RC13–RC16Auxiliary controls

M1–M6 are radio positions, not mode names. The resulting flight mode is defined by the vehicle's FLTMODE1–FLTMODE6 parameters.

Enable output​

Output starts disabled. Select Enable output only after connecting the vehicle and checking the values. Arm/Disarm is available only while output is active.

Enabling output does not send RC5, RC6, RC7, or RC9–RC16 until you select a position, so it does not automatically change flight mode. RC8 is the exception: it starts at Motor Interlock Off (1000 µs) and is sent immediately as the safe Heli state.

While the vehicle is armed, Hold in Loiter (or Escape) requests Loiter first, returns RC3 throttle/collective to its configured neutral, releases yaw, roll, pitch, and RC5, and retains selected RC6–RC16 commands, including Motor Interlock. Neutral RC3 asks Loiter for zero vertical speed instead of allowing the vehicle to descend. The sticks are disabled in this state, but auxiliary controls and Disarm remain available; Resume pilot input restores them.

Closing the joypad while armed performs the same Loiter handover and hides the window without interrupting the RC hold. Select Virtual RC Joypad from the Harlock menu to show it again. Settings can also be opened while armed: Harlock first performs the same safe Loiter handover, keeps neutral RC3 and selected auxiliary commands active, and applies saved changes without interrupting the hold. Cancel leaves the saved configuration and active hold unchanged. The retained overrides are released on disarm. Switching to another Harlock window does not stop output.

Keyboard controls​

The default shortcuts are W/S for pitch, A/D for yaw, left/right arrows for roll, and up/down arrows for throttle. 5 cycles M1–M6; 6 and 7 cycle SA/SB; 8 toggles Motor Interlock; and 9, Q, E, R, T, Y, U, and I toggle S1–S4, L1/L2, and R1/R2. Escape stops output.

Number-row and numeric-keypad digits are equivalent. To change a binding, open settings, find Keyboard shortcuts, select a field, and press the replacement key. Duplicate bindings are rejected and Escape remains reserved.

Return to neutral also applies to keyboard input. When enabled, releasing either key returns that axis, including throttle, to its configured neutral value.

Heli arming sequence​

First verify the Motor Interlock channel on the vehicle; RC8_OPTION=32 is a common configuration.

  1. Verify RC8 Motor Interlock is Off and put RC3/collective in the safe arming position.
  2. Select a mode that permits arming, or leave RC5 unselected to retain the current vehicle mode.
  3. Wait for all pre-arm checks, then select Enable output.
  4. Select Arm and complete the slide confirmation. Output remains active because arming was requested by the joypad.
  5. Only when the area is safe, set Motor Interlock to On and wait for rotor run-up.

To disarm, return collective to its safe position, set Motor Interlock to Off, wait for rotor run-down, and complete the Disarm command while output remains active.

danger

Default values and channels do not replace checking the vehicle's FLTMODE_CH, FLTMODEx, and RCx_OPTION parameters. An RC override can move a real vehicle.

Configuration​

The gear button opens settings. When disarmed, it stops active output; when armed, Harlock first enters the safe Loiter hold and continues sending neutral RC3 and selected auxiliary commands while you edit. You can configure axis channels, every operator-facing control name, every command position's PWM value, all keyboard shortcuts, and whether output may remain active while the vehicle is armed. Channel numbers remain visible in settings but are not shown in the operating joypad.

When Use RC calibration from vehicle parameters is enabled, values come from the RCx_MIN, RCx_TRIM, and RCx_MAX parameters already loaded by Harlock. Disable it to enter custom PWM values. Output stops before applying a live calibration change.

Done saves and updates the armed hold, Cancel discards the draft without changing the active stream, and Reset restores defaults in the draft.