How to configure / customize remote controller

All Carpe Iter handlebar remotes can be fully configured and customized via the on-screen interface in NGH. The emphasis here is on can be. Every Carpe Iter Bluetooth remote comes pre-loaded with a default function map, meaning customization is a feature you can use, but it is completely optional.

You can apply your custom configuration globally to all apps, or configure the controller separately for each supported GPS app. 

Note: Global settings apply across the board to standard GPS navigation apps, but they do not affect specialized applications like TerraPirata or Rally Navigator, as those apps employ specific commands not found in standard navigation.

Why Customize?

Depending on your active app, you may want your controller to behave differently. For example, when running Google Maps, you might not need the map panning feature. Instead, you can remap those specific buttons to control your action camera or music.

You can also adapt the controller to fit your logic (e.g., swapping Zoom In and Zoom Out) or exploit advanced app features. Apps like Locus Map and MyRoute-app offer extensive features beyond our default profile, which you can easily assign to any available input 

element.

In the graphics below we are showing configuration options for the Global settings, but the same scope of options is available for each individual app configuration.

1. Function Configuration

Beyond predefined general and app-specific commands (Zooming, Map Panning, Map re-centering, track recording on/off, Map style, Map overlays, and more), Carpe Iter controllers can be programmed using any keycode from a standard 102-key hardware keyboard, including modifiers (Shift, Ctrl, Alt) and Num Pad symbols.

Additionally, you have access to dedicated controls for:

• Media: Play, Pause, Next, Previous, Mute, Volume +/-

• Action Cameras: Start/Stop Recording, Take Photo, Show Live Preview (Insta360 cameras are currently supported; DJI support is coming soon).

[Graphics showing configuration interface example for the Terrain Command III with Toggle Switches]

Since the addtional keycode options are not needed by everyone, they are hidden in default setting and can be activated by enabling the "Advanced settings" in the Controller configuration interface.

[Graphics showing the Advanced settings]

These expanded keycodes allow you to program the Carpe Iter controller for third-party apps that accept standard keyboard inputs. This effectively lets you build custom support for applications that Carpe Iter does not natively integrate with yet.

2. Hardware Button Behavior Configuration

Beyond assigning functions, you can also configure exactly how each physical button behaves when pressed, greatly expanding your control options. The hardware behavior settings are:

• Default: Behaves like a standard keyboard stroke. The assigned function executes continuously for exactly as long as you keep the button pressed.

• Long-Press Single Action: Allows you to map two entirely different functions to the same button (one for a short press, one for a long press).

  • Example: Short press = "Pan map up". Long press = "Play music".

  • The Logic: The long-press command executes exactly once, regardless of how long you hold the button down. This is critical for toggle functions (like Play/Pause) so the music doesn't rapidly turn on and off if you hold the button too long.

• Long-Press Continuous: Allows you to map two different functions to the same button, but treats the long press as an "auto-fire" action.

  • The Logic: Unlike the single action, the long-press command executes repeatedly for the entire duration the button is held down. It effectively simulates the Default behavior, but on a long press. This is highly useful for functions that require / support continuous execution, such as map panning, volume change, etc.

On each long-press type you can also configure the delay for detecting the long press (for how long the button needs to be pressed to qualify as a long-press). Default setting is 300ms (roughly 1/3 of a second). 

[Graphics showing hardware button press configuration options example for the Terrain Command III with Toggle Switches]

Some Carpe Iter controller types (especially the Terrain Command III) offer additional settings relating to specific hardware configurations. These are covered in the Support Portal sections dealing with the specific controller types.