Programming the SIB™
SiB™ vs SID mode
Programs in SiB™ mode
Programs in SID mode
A - Z
This command allows you to configure and manage multiple Access Points.
AP Usage: AP function [parameters...] This command allows you to configure and manage multiple Access Points. It exposes the following functions: AP LIST AP SCAN AP STATUS AP ADD AP USE AP PRIO AP DEL AP SETIP To learn more, type HELP AP function See also: TXPW, PREW, PRE, POST
This function sets a static IP address on a specific AP.
AP SETIP Usage: AP SETIP ssid ip netmask gateway dnsip This function sets a static IP address on a specific AP. At this time, if you configure a static IP on a single AP and have multiple APs listed, you must enter a static IP for all other APs, as the SiB™ cannot switch to a static IP and then back to DHCP at present. Example: AP SETIP myHomeRouter 192.168.0.22 255.255.255.0 192.168.0.1 188.8.131.52
This function shows the status of the connected AP.
AP STATUS Usage: AP STATUS This function shows the status of the connected AP. The function shows the connection status, including SSID, IP address, mask, gateway and DNS IP address used. Example: AP STATUS
This functions lists all of the Access Points configured on your SiB™.
AP LIST Usage: AP LIST This functions lists all of the Access Points configured on your SiB™. They are listed in order of connection attempt. The APs are numbered, and the priority value is also listed. The numbers assigned to each AP can be used in other functions, like AP DEL
This function performs a scan of available Access Points and outputs the result.
AP SCAN Usage: AP SCAN This function performs a scan of available Access Points and outputs the result. The output includes only the Access Point SSID and signal strength.
This function adds an Access Point configuration to the SiB™.
AP ADD Usage: AP ADD ssid password [priority] This function adds an Access Point configuration to the SiB™. This function only adds and saves a configuration, it does not test nor connect to the newly connected Access Point. The [priority] value can be any number from 0 to 127; 0 being most important and 127 being least important. If [priority] is omitted, the AP will automatically receive a priority of 0 and will become the first AP on the list. If a priority is given and an AP already exists with that priority, the new AP will take priority but will not overwrite the previous AP.
This function deletes an Access Point from the list of configured APs.
AP DEL Usage: AP DEL number|ssid This function deletes an Access Point from the list of configured APs. You cannot delete the currently used Access Point. You can provide either a number or an SSID for deletion. The number provided is the index number given on the AP LIST command output. For example, the first AP on a list will have an index of 1. If you enter an SSID instead, all configured Access Points matching the given SSID will be deleted.
This function disconnects from the current Access Point and connects to the specified AP. You can either enter an SSID or an index number here.
AP USE Usage: AP USE number|SSID This function disconnects from the current Access Point and connects to the specified AP. You can either enter an SSID or an index number here. The index numbers are provided by the command AP LIST. If an SSID is specified and multiple AP's exist with the same SSID, each will be tried in order from most important to least important priority. If this function fails, it will attempt to reconnect to any AP by going through the list in order of priority.
This function changes the priority of an Access Point.
AP PRIO Usage: AP PRIO number|ssid|auto|manual prio This function changes the priority of an Access Point. The SiB™ can automatically connect to the best access point in signal strength; this is called 'automatic' mode. This mode (TODO in future) will be on by default. To enable this mode manually, enter AP PRIO AUTO. To switch back to manual mode, enter AP PRIO MANUAL. To specify a manual order: You can specify either an index number or an SSID. The index numbers are provided by the function AP LIST. If you enter an SSID and more than one Access Points are configured with the same SSID, the command will return an error. If a priority is set that matches another AP, the specified AP will take priority over the existing AP, but will not overwrite the existing AP. This function allows you to re-order the configured Access Points.
This function allows you to managed authorized users for your SiB™.
AUTH Usage: AUTH function [parameters] This function allows you to managed authorized users for your SiB™. The authorized users will be able to issue commands to your SiB™ directly via IM. The following functions are available: AUTH ADD AUTH DEL AUTH LIST To learn more, type HELP AUTH function
This function adds an authorized user to your SiB™.
AUTH ADD Usage: AUTH ADD number This function adds an authorized user to your SiB™. The number entered must be the mobile number of the SIMP™ user you wish to authorize, in international format, without any formatting symbols such as +, -, ( and ).
This function deletes an authorized user from accessing your SiB™.
AUTH DEL Usage: AUTH DEL number This function deletes an authorized user from accessing your SiB™. The number entered must be the mobile number of a SIMP™ user.
This function lists the authorized users to your SiB™.
AUTH LIST Usage: AUTH LIST This function lists the authorized users to your SiB™.
The CALIB function provides calibration for time and temperature for your SiB™.
CALIB Usage: CALIB function The CALIB function provides calibration for time and temperature for your SiB™. Calibration can be done on three functions: time, temperature, and voltage. To calibrate the clock, issue CALIB TIME. This command will put your SiB™ to sleep for 10 minutes and measure the offset or delay of the clock. Some commands can be enhanced by adding a + symbol, as described in HELP. These commands will use the CALIB result in their calculations of time. To calibrate the temperature, issue CALB TEMP temperature - where 'temperature' is the current temperature in Celcius, without decimal values. For example. CALIB TEMP 26 will calibrate the temperature sensor to 26 degrees. Like CALIB TIME, this will put your SiB™ to sleep for some time as the calibration needs to measure the temperature after a cold-boot. To calibrate the voltage read-out for the command RV, issue CALIB POWER gpio# referenceVoltageMV. For example, CALIB POWER 36 3000 will read the voltage on pin 36 and calibrate the SiB™ to read 3000mV (3V) To view current calibration values, enter CALIB STATUS See also: TEMP, RV
CONF is the primary function to apply configuration changes to the SiB™.
CONF Usage: CONF setting value CONF is the primary function to apply configuration changes to the SiB™. Issue CONF LIST to view all available settings and their current value. Settings: cpu.speed: Can be set to 40 or 240 (in MHZ) safeties: Can be set to on or off. Set to OFF to disable safeties that prevent accidental battery drainage.
This command enables Exclusive mode.
EX Usage: EX This command enables Exclusive mode. This command can only be used inside of a PROGRAM block. It wwill have no effect otherwise. Exclusive mode instructs the SiB™ to queue any notifications received, other than STOP, while a program is running. When not in exclusive mode, the SiB™ will execute instructions received via IM while a program is running. You can stop a running exclusive program by issuing the STOP command.
This command foramts your SiB™. It effectively performs a factory reset.
FORMAT Usage: FORMAT PLEASE This command foramts your SiB™. It effectively performs a factory reset. There is no confirmation prompt when this command is issued. This command executes immediately and all content on your SiB™ is lost. Your SiB™ will enter provision mode on the next power-on or reset. See also: RENEW
This function allows you to toggle the SiB™'s default LED use on or off.
IO Usage: IO LED ON|OFF This function allows you to toggle the SiB™'s default LED use on or off. This function must be followed by a reset in SID mode. When the LED is ON, the SiB™ will animate the LED to provide feedback. When the LED is OFF, the SiB™ will not make use of it. However, you may still access it via WA.
Changes the SiB™ operation mode.
MODE Usage: MODE SiB™|SID Changes the SiB™ operation mode. The SiB™ supports two operation modes: SiB™ and SID. IN SiB™ mode, at startup, a button click sequence is detected and the appropriate program is selected and executed. If no program exists, the SiB™ goes back to sleep. If a program executes and the execution completes, the SiB™ goes back to sleep. In SID mode, at startup, the button click sequence detection is skipped and the last running program resumes. When a running program ends, the SID stays on and waits for it's next command.
Allows you to tweak power consumption of specific devices.
POWER Usage: POWER device on|off|level Allows you to tweak power consumption of specific devices. This function can toggle the power for a few devices: BT: Turns the BlueTooth radio on or off. WIFI: Turns the WiFi radio on or off, or sets the power output level of the Wifi to the given value, where level is a number between 0 and 100 See also: TXPW
This function allows you to reset the SiB™s name and / or conversation without reprovisionning it.
RENEW Usage: RENEW all|convo new_name This function allows you to reset the SiB™s name and / or conversation without reprovisionning it. If ALL is specified, the SiB™ will reset and acquire a new name and control conversation, using the given name. If CONVO is specified, the SiB™ will reset and create a new control conversation, using the given name.
Creates a SiB™ range extender.
SiB™EXT Usage: SiB™EXT on ssid pw | off Creates a SiB™ range extender. Using this command turns your SiB™ into a range extender. This command does not persist after resets. If you wish to have this state persist on reset, enter this command into a PROGRAM with a LOOP in SID mode. To enable the extension, enter SiB™EXT ON ssid pw Where SSID is an SSID you wish to assign to the SiB™ and the password is the password that other SiB™s will use to authenticate to your extension. The SSID entered MUST begin with 'sibext'; this allows connecting SiB™ devices to identify and properly route requests. To turn off the range extender, enter SiB™EXT OFF
Enables or disables broadcast station mode.
STATION Usage: STATION on|off Enables or disables broadcast station mode. This command can only be used in mode SID and the device only broadcasts the station mode while the device is running (i.e., not sleeping). This command is required in order to use TRIGGER functions, functions that trigger based on the proximity of a SIMP™ user.
Sets the maximum power used in WiFi transmissions.
TXPW Usage: TXPW value_in_percentage Sets the maximum power used in WiFi transmissions. Example: TXPW 100
Sets the timezone offset for AT commands.
TZO Usage: TZO offset Sets the timezone offset for AT commands. The offset value can be any number of hours only. At this time, the firmware does not support fractional time zones.
Updates the SiB™ to the specified firmware version. If no version is specified, updates to the latest firmware.
UPDATE Usage: UPDATE [version] Updates the SiB™ to the specified firmware version. If no version is specified, updates to the latest firmware.