System Functions

System functions cover the configuration, status and control of a number of miscellaneous and loosely coupled features. These are managed by the system variables and other commands and variables, as follows:

Configuring ZentriOS Command Mode and Response

ZentriOS commands can be entered manually via a ZentriOS terminal or by a host MCU system.

There are optimizations for human and machine control.

Variables:

• system.cmd.buffered
• system.cmd.echo
• system.cmd.header_enabled
• system.cmd.mode
• system.cmd.prompt_enabled
• system.cmd.timestamp
• system.print_level
• system.msg

Power management

Power consumption can be minimized, and battery life extended, by a number of strategies.

Commands and variables:

• sleep- system.wakeup.events
• system.wakeup.timeout
• system.gotosleep.timeout

See also Wi-Fi power management variables:

• wlan.powersave.listen_interval
• wlan.powersave.mode
• wlan.powersave.sleep_delay

Sleeping and Waking

When the module is not required to be active, you can put it into a low-power sleep mode with the sleep command, but don't forget to configure a wake mechanism before putting the module in a sleep state. This wake can be either a timeout (system.wakeup.timeout) or a GPIO level change event (system.wakeup.events). .

The module may also be awoken from sleep with a power cycle.

It is also possible to set the module to go to sleep after a specified time by setting system.gotosleep.timeout.

Powersave Mode

System powersave mode allows the module to power down when idle, with a rapid power up in response to activity. See system.powersave.mode. Powersave mode is on by default.

Monitoring System State

System state can be monitored via visual indication by LED, system messages and GPIO level indication.

State monitoring variables:

• system.indicator.gpio
• system.indicator.state
• system.msg
• system.activity.gpio
• system.activity.gpio_level

Sub-system states can also be associated with GPIOs. See Peripherals.

For a detailed snapshot of system state get the values of all the ZentriOS variables:

get all

Controlling the Boot Image

Boot image commands and variables:

• reboot
• factory_reset- system.boot.image
• system.safemode.status

See also:

• Update and Recovery, Factory Reset
• Update and Recovery, Safe Mode

The boot image is by default services.bin, but may be changed for various reasons.

If exceptions occur due to misconfiguration, the module may switch to safe mode, changing the boot image to kernel.bin.

System Identification and Version

Commands and variables:

• version command - this gives the same result as get system.version
• system.uuid
• system.version