This feature is only available in TTerm 1.1.0 and above on devices with iOS7 or above.

Key mapping is the process of linking a key on your hardware (bluetooth) keyboard to a key present on the terminal keyboard that TTerm is emulating.

An example of a key that several terminal keyboards posses is the Line Feed key (often in addition to an enter or return key). As there is no direct Line Feed equivalent on any modern Apple keyboard by default TTerm maps this key to a key or key combination that does exist, for example a combination of Command + Enter.

TTerms key mapping configuration allows you to view and edit this setting. To create or change an existing key mapping follow these steps.

  1. Ensure a physical keyboard is connected to your device, usually this is via bluetooth.
  2. Edit or create a new connection, ensuring that you have already selected the emulation you require to connect to your host system. If you are unsure which emulation is required, please check with your system administrator.
  3. Select the Keyboard item under Advanced Configuration, then select Bluetooth Keyboard.
  4. Under the keyboard mapping heading you will see a graphical display of the emulation keyboard. Just like the keyboard that displays when connected to a host. You can toggle or swipe this keyboard to show function keys, number pads and so on, you can also tap Shift/Alt/Ctrl combinations. Tap the emulation key you wish to map. Note that keys that can be mapped are colored green. TTerm will display a pop up listing the emulation key and its mapped equivalent on the physical keyboard.
  5. To change this mapping tap the Change Key Mapping button. On pressing the Change Key Mapping button TTerm will await input from the physical keyboard.
  6. Press the key or combination of keys on the physical keyboard that you wish to map the emulation key to. TTerm will update the key mapping.

Repeat steps 4-6 for as many keys as are required.

Listings of default key mappings for each terminal are available as separate, individual FAQ articles.