User guide

Developers guidelines | AT commands
60 June 2010
Ensemble C27: Accessory UI
Commands
AT*SEAM Add menu item
Description: Adds the persistent menu item to the phone menu structure and assigns a
category to this menu item. The menu is placed in one of the categories
specified by <category>. It is possible for an accessory to add a persistent
menu item to more than one category. This command should then be
called once for every new menu item. When the phone receives this AT
command, it must:
• Create the additional menu if it is not already present.
• Add an item with the text specified in <persistent menu item text>.
• Upon successful request, the phone answers with a <menu_ID>. This
ID is being used when sending unsolicited *SEAAI to the accessory.
• When the user selects the menu an unsolicited result code *SEAAI sent.
• If the phone receives a new persistent menu item when there already
exist a persistent menu the old menu item is deleted and a new
created.
• If the accessory is disconnected, the corresponding accessory menu
item is deleted. If there are no items in the additional menu the
additional menu is deleted.
Execution
command: AT*SEAM=<persistent menu item text>[,<category>]
Execution command
response: *SEAM:<menu_id>
Test command: AT*SEAM=? Shows if the command is supported.
Parameters:
<persistent_menu_ite
m_text>:
<persistent_menu_it
em_text>
Description
String type The menu item text in the additional menu
<category>:
<category> Description
Integer type
0 Connectivity (placed directly under Connectivity)
1 Bluetooth
2 Entertainment
3 Messaging
4 Organiser
5 Settings – General