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.

When developing apps using the ZentriOS SDK, variables are referred to as settings and the settings Native API is used to read and write variables.


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.data_busSave and RebootSafe ModeNVM BackupLockable
bus.log_busSave and RebootSafe ModeNVM BackupLockable
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.config_fileSave and Reboot
gpio.initSave and Reboot
gpio.sleepSave and Reboot
http.server.api_enabledNetwork Restart
http.server.cors_originNetwork Restart
http.server.denied_filenameNetwork Restart
http.server.enabledNetwork Restart
http.server.interfaceNetwork Restart
http.server.max_clientsNetwork Restart
http.server.notfound_filenameNetwork Restart
http.server.passwordNetwork Restart
http.server.portNetwork Restart
http.server.root_filenameNetwork Restart
http.server.tls_certNetwork Restart
http.server.tls_enabledNetwork Restart
http.server.tls_keyNetwork Restart
http.server.tls_log_clientsNetwork Restart
http.server.tls_verify_peerNetwork Restart
http.server.usernameNetwork Restart
http.server.ws_connected_gpioNetwork Restart
http.server.ws_data_gpioNetwork Restart
ioconn.control_gpioSave and Reboot
ioconn.enabledSave and Reboot
ioconn.status_gpioSave and Reboot
mdns.enabledNetwork Restart
mdns.interfaceNetwork Restart
mdns.nameNetwork Restart
mdns.serviceNetwork Restart
mdns.ttlNetwork Restart
network.buffer.rxtx_ratioSave and Reboot
network.buffer.sizeSave and Reboot
network.tls.ca_certSafe Mode
ntp.enabledSave and Reboot
ntp.interfaceSave and Reboot
ntp.intervalSave and Reboot
ntp.serverSave and Reboot
remote_terminal.enabledNetwork Restart
remote_terminal.interfaceNetwork Restart
remote_terminal.portNetwork Restart
setup.auto.cmdSave and Reboot
setup.gpio.control_gpioSave and Reboot
setup.gpio.levelSave and Reboot
setup.gpio.modeSave 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.dns_server.enabledNetwork Restart
softap.dns_server.urlNetwork Restart
softap.hide_ssidNetwork Restart
softap.idle_timeoutNetwork Restart
softap.passkeyNetwork Restart
softap.rate.protocolNetwork Restart
softap.rate.transmitNetwork Restart
softap.rssi_averageSave and Reboot
softap.ssidNetwork Restart
softap.static.gatewayNetwork Restart
softap.static.ipNetwork Restart
softap.static.netmaskNetwork Restart
spi.master.active_gpioSave and RebootSafe Mode
spi.master.active_levelSave and RebootSafe Mode
system.activity.gpioSave and Reboot
system.activity.gpio_levelSave and Reboot
system.bflash.cs_gpioSave and Reboot
system.boot.imageSave and RebootSafe Mode
system.cmd.bufferedSafe ModeNVM Backup
system.cmd.echoSafe ModeNVM Backup
system.cmd.header_enabledSafe ModeNVM Backup
system.cmd.modeSafe Mode
system.cmd.prompt_enabledSafe ModeNVM Backup
system.cmd.timestampSafe ModeNVM Backup
system.factory_reset.aux_gpioSave and Reboot
system.factory_reset.aux_levelSave and Reboot
system.gotosleep.timeoutSave and Reboot
system.indicator.gpioSave and Reboot
system.indicator.stateSave and Reboot
system.oob.gpioSave and Reboot
system.powersave.modeSave 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_interfaceSave and Reboot
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_interfaceNetwork Restart
tcp.server.auto_startNetwork Restart
tcp.server.connected_gpioNetwork Restart
tcp.server.data_gpioNetwork Restart
tcp.server.idle_timeoutNetwork Restart
tcp.server.max_clientsNetwork Restart
tcp.server.portNetwork Restart
tcp.server.tls_certNetwork Restart
tcp.server.tls_enabledNetwork Restart
tcp.server.tls_keyNetwork Restart
tcp.server.tls_verify_peerNetwork 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
udp.server.auto_interfaceNetwork Restart
udp.server.auto_startNetwork Restart
udp.server.data_gpioNetwork Restart
udp.server.lock_clientNetwork Restart
udp.server.portNetwork Restart
udp.server.remote_hostNetwork Restart
udp.server.remote_portNetwork Restart
wlan.antenna.selectSafe ModeNVM Backup
wlan.auto_join.enabledNetwork Restart
wlan.auto_join.retriesSave and Reboot
wlan.auto_join.retry_delaySave and Reboot
wlan.bssidNetwork Restart
wlan.dhcp.enabledNetwork RestartSafe ModeNVM Backup
wlan.dhcp.hostnameNetwork Restart
wlan.dhcp.timeoutNetwork RestartSafe ModeNVM Backup
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.network.status_gpioSave and Reboot
wlan.passkeyNetwork RestartSafe ModeNVM Backup
wlan.powersave.listen_intervalSave and Reboot
wlan.powersave.modeSave and Reboot
wlan.powersave.sleep_delaySave and Reboot
wlan.rate.protocolNetwork RestartSafe ModeNVM Backup
wlan.rate.transmitNetwork RestartSafe ModeNVM Backup
wlan.regionNetwork Restart
wlan.roam.thresholdNetwork RestartSafe ModeNVM Backup
wlan.rssi_averageSave and Reboot
wlan.scan.active_dwellNetwork RestartSafe ModeNVM Backup
wlan.scan.channel_maskNetwork RestartSafe ModeNVM Backup
wlan.scan.home_dwellNetwork RestartSafe ModeNVM Backup
wlan.scan.num_probesNetwork RestartSafe ModeNVM Backup
wlan.scan.passive_dwellNetwork RestartSafe ModeNVM Backup
wlan.scan.retriesNetwork RestartSafe ModeNVM Backup
wlan.scan.typeNetwork RestartSafe ModeNVM Backup
wlan.securityNetwork 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
zap.auto_runSave and RebootLockable