ZentriOS Variables

This page provides a list of ZentriOS variables with a full description of the function of each variable together with example usage.

Variables are cached in volatile RAM and must be saved to non-volatile flash memory to persist between reboots. To save variables to flash, use the save command. Some variables impact the operation of the entire system, wake and sleep timers for example. A save and reboot is required before new settings for these types of variables take effect.

The get and set Command API functions are used to read and write ZentriOS variables respectively.


A shortcut is assigned to each variable. The format for shortcuts is shown in the following table. The shortcut is a hybrid of the first two characters of the first word of the variable name, plus (typically) the first character of the second word (if a second word exists), plus (typically) the first character of the third word of the variable name (if a third word exists). Each of these characters is separated by a space character. In some instances, it was not possible to use the first letter of the second or third word in the variable name, in these cases another letter has been somewhat arbitrarily chosen.

Variable NameShortcut
Templatefirst_word.second_word.third_wordfi s t
Example 1time.uptimeti u
Example 2wlan.scan.retrieswl s r

Documentation Format

Many ZentriOS responses shown in the examples on this page were captured with system.print_level = 0, and system.cmd.header_enabled = 1. These machine friendly settings make it easy for a host MCU to parse responses by examining response headers. Documentation for each variable is provided in the format shown below.




A description of the function of the variable.


A full list of mandatory and optional arguments.


The factory reset default value.

Get example

An example of how to read the variable, including response codes.

Set example

An example of how to write the variable, including response codes (for writeable variables).

NOTE! Don't forget to check out command navigation tips to make it easier to find and type specific variable names.

List of Variables

Variable Properties

The table below indicates properties of variables:

VariableSave and Rebootuart_updateNetwork RestartSetup RestartSafe ModeNVM BackupLockable
broadcast.interfaceSave and Reboot
broadcast.intervalSave and Reboot
bus.command.rx_bufsizeSave and Reboot
bus.modeSave and RebootSafe ModeNVM BackupLockable
bus.stream.cmd_gpioSave and Reboot
bus.stream.cmd_seqSave and Reboot
bus.stream.flush_countSave and Reboot
bus.stream.flush_timeSave and Reboot
bus.stream.flush_time_resetSave and Reboot
gpio.initSave and Reboot
http.server.api_enabledNetwork Restart
http.server.cors_originNetwork Restart
http.server.enabledNetwork Restart
http.server.interfaceNetwork Restart
http.server.max_clientsNetwork Restart
http.server.portNetwork Restart
http.server.root_filenameNetwork Restart
ioconn.control_gpioSave and Reboot
ioconn.enabledSave and Reboot
ioconn.status_gpioSave and Reboot
ntp.enabledSave and Reboot
ntp.interfaceSave and Reboot
ntp.intervalSave and Reboot
ntp.serverSave and Reboot
remote_terminal.enabledNetwork Restart
remote_terminal.portNetwork Restart
setup.gpio.control_gpioSave and Reboot
setup.web.idle_timeoutSetup Restart
setup.web.passkeySetup Restart
setup.web.root_filenameSetup Restart
setup.web.ssidSetup Restart
setup.web.urlSetup Restart
softap.auto_startNetwork Restart
softap.channelNetwork Restart
softap.dhcp_server.enabledNetwork Restart
softap.hide_ssidNetwork Restart
softap.idle_timeoutNetwork Restart
softap.passkeyNetwork Restart
softap.ssidNetwork Restart
softap.static.gatewayNetwork Restart
softap.static.ipNetwork Restart
softap.static.netmaskNetwork Restart
system.cmd.echoSafe ModeNVM Backup
system.cmd.header_enabledSafe ModeNVM Backup
system.cmd.modeSafe Mode
system.cmd.prompt_enabledSafe ModeNVM Backup
system.gotosleep.timeoutSave and Reboot
system.indicator.gpioSave and Reboot
system.indicator.stateSave and Reboot
system.print_levelSafe ModeNVM Backup
system.safemode.disabledSave and RebootSafe Mode
system.safemode.statusSafe Mode
system.uuidSafe Mode
system.versionSafe Mode
tcp.client.auto_retriesSave and Reboot
tcp.client.connect_timeoutSafe ModeNVM Backup
tcp.client.local_portSafe ModeNVM Backup
tcp.client.retriesSafe ModeNVM Backup
tcp.client.retry_periodSafe ModeNVM Backup
tcp.keepalive.enabledNVM Backup
tcp.keepalive.initial_timeoutNVM Backup
tcp.keepalive.retry_countNVM Backup
tcp.keepalive.retry_timeoutNVM Backup
tcp.server.auto_startNetwork Restart
tcp.server.portNetwork Restart
uart.baudSave and Rebootuart_updateSafe ModeNVM BackupLockable
uart.dataSave and Rebootuart_updateSafe ModeNVM BackupLockable
uart.flowSave and Rebootuart_updateSafe ModeNVM BackupLockable
uart.paritySave and Rebootuart_updateSafe ModeNVM BackupLockable
uart.stopSave and Rebootuart_updateSafe ModeNVM BackupLockable
udp.client.auto_interfaceNetwork Restart
udp.client.auto_startNetwork Restart
wlan.auto_join.enabledNetwork Restart
wlan.auto_join.retriesSave and Reboot
wlan.auto_join.retry_delaySave and Reboot
wlan.dhcp.enabledNetwork RestartSafe ModeNVM Backup
wlan.dhcp.hostnameNetwork Restart
wlan.hide_passkeySafe ModeNVM Backup
wlan.join.retriesNetwork RestartSafe ModeNVM Backup
wlan.join.timeoutSave and RebootSafe ModeNVM Backup
wlan.macSafe Mode
wlan.network.dnsSafe Mode
wlan.network.gatewaySafe Mode
wlan.network.ipSafe Mode
wlan.network.netmaskSafe Mode
wlan.network.statusSafe Mode
wlan.passkeyNetwork RestartSafe ModeNVM Backup
wlan.rate.protocolNetwork RestartSafe ModeNVM Backup
wlan.ssidNetwork RestartSafe ModeNVM Backup
wlan.static.dnsNetwork RestartSafe ModeNVM Backup
wlan.static.gatewayNetwork RestartSafe ModeNVM Backup
wlan.static.ipNetwork RestartSafe ModeNVM Backup
wlan.static.netmaskNetwork RestartSafe ModeNVM Backup
wlan.tx_powerSafe ModeNVM Backup