11. Buttons for CCpilot V510/V710 and Yukon development board

Depending on your device there are 8 (V510) or 10 (V710) configurable buttons. For Yukon development board 16 buttons are available. The configuration of each button can be done using CCAux API or CCSettingsConsole. All button functions are controlled using the button module in CCAux API or the –button category in CCSettingsConsole.

The following functions are available:

Function

Description

Comment

CCAux API function

Standard keyboard input

Button events can be read from the device node /dev/input/event2. Buttons will generate events corresponding to F1-F16 keys.

Raw data from the buttons can also be read using CCAux API or CCSettingsConsole

This functionality is always available.

Button_getButtonDownStatus()

Start up

Button press will start the unit from off state.

Only short press can be used.

Button_setStartupButtons()

Shut down

Button press will shut down the unit.

Short press or long press can be used.

Button_setShutdownButtons()

Suspend

Button press will make unit go to suspend.

Short press or long press can be used.

Button_setSuspendButtons()

Wake up

Button press will wake up the unit from suspend.

Only short press can be used.

Button_setWakeupButtons()

Note that one button can have several functions at the same time. For instance, both start up and shut down. Also note there must always be at least one way to boot a unit. If start up using ignition and pre-ignition (where applicable) is disabled, start up from at least one button must be enabled. For shut down and suspend it is possible to demand a long button press to trigger the function. The time required for a long-press is adjustable using the CCAux API or CCSettingsConsole.

Each button has a backlight LED. The backlight LEDs are programmable using CCAux API or CCSettingsConsole. It is also possible to configure an LED pattern that is automatically activated during the boot sequence. If such a pattern is activated, it is up to the user to set the LED status to desired values after boot is finished using a start script or user application.