Prev: The Supervisor Dialog

SMS Control

The supervisor allows to control the m application can be controlled via SMS commands. SMS control must be enabled, and commands must be prefixed by the smskey configured in the supervisor properties.

The available SMS commands are:

• smskey reboot: immediately reboot the device. This can be used to reset the device if it stops working properly. Note that the compatibility restrictions mentioned in * (Library) apply.
• smskey run script args: starts the m application if it is not already running, then starts the script script with the arguments args. Use function proc.args to get the arguments from within the script. If the script is already running, this command is ignored.
• smskey shutdown: stops all scripts and exits the m application. If m is not running, this command is ignored.
• smskey start: starts the m application. If m is already running, this command is ignored.
• smskey status: m status inquiry, replies with an SMS describing the status of the m application and some GSM information. If m is running, the reply will look like:

  m status: running, mem=mem,   net=mcc,mnc, loc=lac,cid, sig=signal

  If m is not running, the reply will look like:

  m status: NOT running (category reason),   net=mcc,mnc, loc=lac,cid, sig=signal

  The meaning of the fields is the following:
  

  mem	bytes of memory used by m (only on Symbian 2nd Edition)
  category	m exit category (if panicked)
  reason	m exit reason (if panicked)
  mcc	GSM mobile country code
  mnc	GSM mobile network code
  lac	GSM location area code
  cid	GSM cell id
  signal	GSM signal strength

• smskey status phone: like status above, but the response is sent to phone number phone. phone must not contain white space.
• smskey stop script: stops execution of script script. If script is not running, this command is ignored.

The following examples require the smsctrl property to be enabled, and smskey to be set to mshell:

1. SMS to start the m application:

   mshell start

2. SMS to start the MySupervisor script, passing it 0769988776 as an argument:

   mshell run MySupervisor 0769988776

3. SMS to check the status of the m application:

   mshell status → m status: NOT running (E32USER-CBase 71), net=228,115, loc=1616,17689, sig=3

   m is not running because it crashed with a E32USER-CBase 71 panic. The phone is somewhere near cell 17689 in area 1616 of the Swisscom GSM network.

---

Next: Supervisor Properties File

Navigation