Key mapping is the process of linking a key on your hardware (bluetooth) keyboard to a key present on the terminal keyboard that TTerm for iPad 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 for iPad maps this key to a key or key combination that does exist, for example a combination of Command + Enter.

TTerm for iPad's 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 for iPad 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 for iPad 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 for iPad 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 knowledgebase articles.

Related Articles: