User guide

Developers guidelines | AT commands
166 June 2010
AT*EKEY Keypad/joystick control (ver. 2)
Description: Emulates ME keypad by giving each keystroke as a character <key>. If
emulation fails in an ME, an error, +CME ERROR: <err> is returned. This
command should be accepted (OK returned) before actually starting to
press the keys. Thus unsolicited result codes of key pressings and display
events can be returned (see AT+CMER). It will also be possible to receive
unsolicited event for CKEV when an EKEY is sent to the ME. For example,
this makes it possible for a connected Bluetooth device to be controlled by
the EKEY command.
The physical keypad always has higher priority than emulation of key-
strokes via AT*EKEY. That is, if the physical keypad is operated during
execution of a series of keystrokes generated by AT*EKEY the emulated
keypad operation is terminated immediately.
Note: To use some of the keys, a specific character set has to be set via
command AT+CSCS=<chset>. For example, the characters “[“ and “]”
used to emulate the left and right selection keys on the phone are not
included in the default GSM character table. To handle this issue, the
8859-1 character table can be set by first sending AT+CSCS=”8859-1” to
the phone.
Note: This command is an upgrade of AT+CKPD ver. 3 supporting the
same keys. The parameters <time> and <pause> have been removed and
two new parameters have been added. The <keyfunc> parameter indicat-
ing whether the key was pressed or released and the <nr_of_keys> param-
eter telling how many keys that will be sent in the command. Also the
returned result for EKEY=? is changed.
Execution
command:
AT*EKEY=<nr_of_keys>,<key>,<keyfunc>[,<key>,<keyfunc>]…
Test command: AT*EKEY=?
Test command
response EKEY: supported <nr_of_keys>, (list of supported <key>), (list of
supported <keyfunc>)
Parameter:
<nr_of_keys>: Integer type. The number of <key> characters and corresponding
<keyfunc> parameters that will be sent. Maximum value=20.
<key> Character representing keys as listed in the following table. Colon
character (IRA 58) followed by one character can be used to indicate a
manufacturer specific key.
Char IRA (dec) Comment plus some known key
symbols
# 35 Hash (number sign)
* 42 Star (*)
0–9 48–57 Number keys
: 58 Escape character for manufacturer
specific keys
< 60 Left joystick direction
> 62 Right joystick direction
C/c 67/99 Clear display (C/CLR)
D/d 68/100 Volume down