C Language Development Kit/Application development/Using the system menu

From OptiWiki

The operating system of the handheld terminals (except the units without display) contains a system menu that you can use to start system testing, to control application loading and to perform some other actions.

The following aspects of the system menu of a terminal will be described below:

1. Entering the system menu
2. Contents of the system menu
3. Descriptions of the items of the system menu

Entering the system menu

On the PHL, H13 and OPH100x you can enter the system menu by performing the following actions:

1. Make sure the handheld terminal is switched off.
2. Press and hold the "." (H13, OPH100x and PHL1300) or "0" (other terminals) key.
3. Press and hold the "1" (H13, OPH100x and PHL1300) or "7" (other terminals) key.
4. Press the power key.

On the DWT7133, OPL97xx and the DCL153x you can enter the system menu by simultaneously pressing all three keys (Use the Scroll-up, trigger and Scroll-down key respectively on the OPL9728, OPL9712).

Contents of the system menu

System menu OPL97xx/DCL153x	System menu OPL9724/OPL9712	System menu OPH1003	System menu OPH1004 and H13	System menu of the other terminals
Cancel	Cancel	Cancel	Cancel	Cancel
Restart	Restart	Restart	Restart	Restart
Download appl	Download appl	Download appl	Download software	Restart
Set contrast	Set contrast	Settings	Settings	Set contrast
Show version	Show version	Diagnostics	Show version	Show version
List files	List files	List files	List files	List files
Terminal id	Terminal id	Show version	Diagnostics
Diagnostics	Diagnostics
	Input address
	Input PINcode
	BLT Local name

You can navigate the system menu by:

• Pressing the up-key (or "F7"; on most terminals) for going up, and pressing the down-key (or "F8" on most terminals) for going down, pressing "ENT" key to confirm a choice. When your terminal does not have function keys nor up/down keys, use the Q1/Q2 keys instead.
• Typing the number of the option that you want, for example, pressing the '4' key gets you into the diagnostics. This option is not available on the OPH100x, and neither of course on devices that do not have a keyboard with numbers.

Descriptions of the items of the system menu

Descriptions of the various items of the system menu are described in the table below.

	Description
Cancel	Exits the system menu and the handheld terminal continues the application that was running exactly where it left off. For example, while running an application in the handheld terminal, you want to know which operating system is inside the scanner. You can enter the system menu, choose Show version, return to the system menu, and then go on with the application by choosing Cancel.
Restart	Restarts the application that is currently loaded in the handheld terminal. The handheld terminal will again execute the startup code of the application and then continue with the main() function.
Download appl	Enables you to load a target file (an application) into the handheld terminal using Appload. See Loading software on the terminals for more details on this subject. Some terminals (DWT, OPL97xx and DCL153x) normally don't need this option, since they are automatically able to receive an application when placed into the cradle or connected by USB direct cable. This option is nevertheless supported.
Settings	Enables you to change all kinds of configuration settings: Contrast, Date & time, Key-click, Terminal id, Auto power down time and Backlight. Changes done here, are permanent (they are stored in non-volatile memory) so they keep active even after a restart, until changed again.
Set contrast	Allows you to set the contrast of the display. The contrast level here is stored in the Flash-ROM, so that, even if the batteries are empty, this value is always maintained.
Show version	Shows the version of the ROM and the version of the operating system. When you press a key, the checksums are calculated. Pressing a key again takes you back to the system menu. This information is useful to identify the hardware version and the operating system for technical support purposes.
List files	Lists the files that are currently in the file system of the handheld terminal.
Terminal id	Allows you to set the ID of the terminal. This can be used to uniquely define a terminal. Use the function getterminalid() to use this id in your application.
Diagnostics	Displays a series of tests for the LCD display, the RAM memory, the real-time clock (RTC), the keyboard and the scanning performance. Further instruction will be shown on the LCD screen off your terminal.
Input address	Allows you to set the Bluetooth address of the device that will be used to communicate with. Please refer to the OPL9724 manual for more details on this subject.
Input PINcode	Allows you to set the PIN code that will used when a Bluetooth connection is established. An empty PIN code means that the OPL9724 will not send the PIN code when it tries to connect. Please refer to the OPL9724 manual for more details on this subject.
BLT Local name	Allows you to set the local name of the bluetooth module of the OPL9724. This is the name that will be displayed on the remote device when a Bluetooth connection is established with the OPL9724 or when the OPL9724 is discovered. Please refer to the OPL9724 manual for more details on this subject.