DSM-G600, DNS-3xx and NSA-220 Hack Forum

This package provides three programs for use on the
DSM-G600.  They are:

dsmg600-button:
  a utility (and daemon) to monitor the front panel
  button and execute a specified command when the 
  button is pressed for 7-12 seconds.  Ideally:
     /sbin/shutdown -h now
  This will cleanly shutdown all services, unmount
  disks, and call the kernel's poweroff function.
  However, at present the kernel doesn't know how
  to actually cut power, so it enters an infloop
  waiting for somebody to unplug it.
  
dsmg600-leds:
  a utility to control the front panel leds
  
dsmg600-poweroff:
  immediately cuts power. This is unsafe to use
  when you have mounted disks and processes 
  running...


All three utilities support '-h' for help.
Install the utilities manually into your path
(the gentoo hdboot integration -- see below --
expects that they are installed into /usr/bin)



References:
  http://forum.source.pri.ee/t164-chkbutton-buttons-leds.html
  http://dns323.kood.org/forum/p3117-20070521-174259.html
  http://www.beattie-home.net/beattie/DSM-G600/
  http://wiki.rot13.org/rot13/index.cgi?dsm_g600



Gentoo hdboot integration:
=============================================================

Add the following to /etc/conf.d/local.start
to make the power led steady green once the
boot sequence is complete:
 
  (/usr/bin/dsmg600-leds -m led_power -s 1 -c g) >/dev/null 2>&1

Add the following to /etc/conf.d/local.stop
to make the power led start flashing when the
machine enters its shutdown/reboot cycle:

  (/usr/bin/dsmg600-leds -m led_power -s f -c g) >/dev/null 2>&1

To enable the dsmg600-button daemon to be invoked
during normal hdboot:

  cp gentoo-initscript   /etc/init.d/chkbutton
  cp gentoo-config-file  /etc/conf.d/chkbutton
  rc-update add chkbutton boot


To build:
=======================================================
edit the Makefile to set CC, LD, CFLAGS, and LDFLAGS
as appropriate for your build environment.  Then 'make'

Note that gentoo-embedded uses a different version of
uClibc (0.9.28) than does the DSM G600 firmware and 
Linksys-supplied cross toolchain (0.9.26).


Help output:
=============================================================

#############################################################
dsmg600-leds version 0.2.0
Utility program to control the LEDs on the DSM-G600

dsmg600-leds [options]
  -m MODE    which led to modify (power, hdd, wlan, etc)
  -s STATE   state to set the led (on, off, flash)
  -c COLOR   which color to set the led
  -g CODE    send specific three-letter code
  -n         dry-run (do not send commands)
  -d         display debug messages
  -h         display this message
  -v         display version information
  -l         display license information

Valid Modes: led_power  led_hdd   led_hddfull
             led_usb    led_wlan  poweroff

Valid States: on    (or 1)
              off   (or 0)
              flash (or f)

Valid Colors: green  (or g)
              yellow (or y)

Restrictions:
   -g cannot be combined with -m|-s|-c
   usually, all three -m|-s|-c must be specified together
     except: '-m poweroff' needs no -s or -c -- it immediately cuts power
             '-s off' needs no -c
   not all modes accept all states or colors:
     led_power:   green only, can't turn off
     led_hdd:     yellow only, no flashing
     led_hddfull: yellow only
     led_usb:     no restrictions
     led_wlan:    green only
                  flash mode blinks fast a few times, before
                  returning to previous state (on or off)

Valid Codes for -g
   SYN  --  Power led flash, HDD, HDD-Full, USB, WLAN leds off
   TSO  --  Power, HDD, USB, WLAN leds green, HDD-Full yellow
   TSR  --  Power, HDD-Full, WLAN leds off, HDD, USB leds yellow
   TSC  --  Power, HDD, HDD-Full, USB, WLAN leds off
   ZWC  --  Turn Power off
   ZWO  --  Power led solid
   ZBO  --  Power led flash
   WLO  --  WLAN led green
   WLC  --  WLAN led off
   WBO  --  WLAN flash green then off
   HDC  --  HDD-Full led off
   HBO  --  HDD-Full led flash yellow
   HDO  --  HDD-Full led yellow
   HDE  --  HDD led yellow
   HDN  --  HDD led off
   MMK  --  USB led green
   MMF  --  USB led yellow
   MMC  --  USB led off
   MMI  --  USB led blink green
   MUI  --  USB led blink yellow
   MMN  --  USB led off
   AKO  --  unknown

EXAMPLE: dsmg600-leds -m led_wlan -s on -c greeen
         dsmg600-leds -g MMC
#############################################################






#############################################################
dsmg600-button version 0.2.0
Utility program to monitor the power button on the DSM-G600

dsmg600-button [options]
  -a CMD     run specified CMD when button pressed <send msg to log>
  -n         dry-run (do not launch child action)
  -d         display or log debug messages
  -e         exit after first detected button press (no loop)
  -f         before executing CMD, flash leds
  -r         resident daemon mode (uses syslog)
  -u USER    [daemon only] run as specified user
  -p PIDFILE [daemon only] create pid file with specified path
  -h         display this message
  -v         display version information
  -l         display license information

EXAMPLE: dsmg600-button -a '/sbin/shutdown -h now' -f -r -p /var/run/my.pid

NOTE: the -f option is present becuase, in the example above, it might
      be an additional 20 or 30 seconds before init gets around to
      running /etc/conf.d/local.stop, which is the logical place to
      start blinking the power led to indicate 'shutdown in progress'.
      But that's a LONG time to hold the button down...
#############################################################





#############################################################
dsmg600-poweroff version 0.2.0
Utility program to immediately kill power on the DSM-G600

dsmg600-poweroff [options]
  -n         dry-run (do not actually poweroff)
  -d         display debug messages
  -h         display this message
  -v         display version information
  -l         display license information
#############################################################