View source for FreeRunner/Buttons and LEDs

From Openmoko

Jump to: navigation, search

You do not have permission to edit this page, for the following reasons:

  • The action you have requested is limited to users in the group: Administrators.
  • You must confirm your email address before editing pages. Please set and validate your email address through your user preferences.

You can view and copy the source of this page:

Template used on this page:

Return to FreeRunner/Buttons and LEDs.

Personal tools

This is the Software specification for the Openmoko Neo FreeRunner Button and LEDs. Note that this is a future specification which is not yet implemented in the software


What's currently implemented


Those are all userspace directories for controlling the LEDs. echo 0 > brightness will turn the LED off. echo 1 > brightness will turn it on. trigger currently does nothing.


  • AUX = Button on the left side of the device, upper area
  • POWER = Button on the right side of the device, center area (right below the USB socket)


EVENT red behind AUX button
HEARTBEAT orange behind POWER button
WIRELESS blue behind POWER button


  • OFF = Device has no power or has been shutdown
  • ON = Device is fully powered
  • ON+CHARGING = Device is fully powered and has been connected to a USB host or Openmoko charger.
  • LOCK = Device is fully powered, but has screen lock displayed
  • SUSPEND = Device has been suspended to low-power mode

Basic Button Usage

This is grouped by mode:

Mode: OFF

  • To switch the device on: Press and hold POWER until the boot logo appears.
  • To enter the "normal" (NAND) boot menu: Press and hold POWER, one second later press and hold AUX.
  • To enter the "rescue" (NOR) boot menu: Press and hold AUX, then press and hold POWER.

Mode: ON

  • To suspend the device: Press POWER.
  • To shut down the device: Press and hold POWER for 4 seconds. If the device hangs, press and hold POWER for 8 seconds. If it still hangs, remove the battery and disconnect from USB.
  • To go to the home screen: Press AUX.
  • To display the profile screen: Press and hold AUX until it appears.


  • To wakeup the device: Press POWER.

Basic LED Usage

LEDs are very useful in broadcasting valuable basic status information to the user in a way that the user does not have to unlock the device, enable the screen or turning the screen saver off and subsequently search the screen for basic status information.

This is grouped by mode:

Mode: OFF

  • All LEDs will be turned off.

Mode: ON

  • HEARTBEAT will emit a short blink every 4 seconds.
  • If Bluetooth is powered on, WIRELESS will emit a short blink every 2 seconds.
  • If Wifi is powered on, WIRELESS will emit a long blink every 2 seconds.
  • If Bluetooth and Wifi are powered on, WIRELESS will be lit continuosly.


Same as ON, with the exception of

  • HEARTBEAT will increase blinking as the charge level of the battery increases.
  • HEARTBEAT will be continuosly lit, if the battery has been fully charged.


  • All LEDs will be turned off.

Advanced Button/LED Usage

  • In ON-Mode, EVENT will blink every 2 seconds if there's an event that needs your attention.
  • The more events, the faster EVENT will blink.
  • Pressing AUX will acknowledge the event with the topmost priority and display it to you.
  • EVENT will stop to blink once all events have been acknowledged.