Gecko OS Variables

• Shortcuts
• Documentation Format
• List of Variables
• Variable Properties

This page provides a list of Gecko OS 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.

Variable settings can be loaded using the load command.

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

Shortcuts

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.

Documentation Format

Many Gecko OS 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.

variable

Abbreviation

var

Access

get/set

Description

A description of the function of the variable.

Arguments

A full list of mandatory and optional arguments.

Default

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

• All Variables
  • all
• Broadcast
  • broadcast.data
  • broadcast.http.host
  • broadcast.interface
  • broadcast.interval
  • broadcast.udp.ip
  • broadcast.udp.remote_port
• Bus
  • bus.mode
  • bus.stream.cmd_gpio
  • bus.stream.cmd_seq
  • bus.stream.flush_count
  • bus.stream.flush_time
  • bus.stream.flush_time_reset
• DMS
  • dms.bundle_id
• GPIO
  • gpio.init
  • gpio.usage
• Host Boot
  • hboot.filename
  • hboot.gpio
• HTTP Server
  • http.server.api_enabled
  • http.server.cors_origin
  • http.server.enabled
  • http.server.interface
  • http.server.max_clients
  • http.server.notfound_filename
  • http.server.port
  • http.server.root_filename
• IO Connection
  • ioconn.control_gpio
  • ioconn.enabled
  • ioconn.local_port
  • ioconn.protocol
  • ioconn.remote_host
  • ioconn.remote_port
  • ioconn.status_gpio
• Network
  • network.default_interface
  • network.tls.ca_cert
  • network.tls.client_cert
  • network.tls.client_key
  • network.tls.handshake_timeout
  • network.tls.version
• NTP
  • ntp.enabled
  • ntp.interface
  • ntp.interval
  • ntp.server
• Remote Terminal
  • remote_terminal.enabled
  • remote_terminal.interface
  • remote_terminal.password
  • remote_terminal.port
  • remote_terminal.timeout
• Setup
  • setup.gpio.control_gpio
  • setup.web.idle_timeout
  • setup.web.passkey
  • setup.web.root_filename
  • setup.web.ssid
  • setup.web.url
• SoftAP Interface
  • softap.auto_start
  • softap.captive_portal_enabled
  • softap.channel
  • softap.client_list
  • softap.dhcp_server.enabled
  • softap.dns_server.enabled
  • softap.dns_server.url
  • softap.hide_ssid
  • softap.idle_timeout
  • softap.info
  • softap.max_clients
  • softap.passkey
  • softap.ssid
  • softap.static.gateway
  • softap.static.ip
  • softap.static.netmask
• Stream
  • stream.auto_close
• System
  • system.build_number
  • system.cmd.buffered
  • system.cmd.echo
  • system.cmd.format
  • system.cmd.header_enabled
  • system.cmd.prompt_enabled
  • system.gotosleep.timeout
  • system.indicator.gpio
  • system.indicator.state
  • system.memory.usage
  • system.oob.event_mask
  • system.oob.gpio
  • system.oob.gpio_level
  • system.oob.rising_edge_mask
  • system.oob.status
  • system.print_level
  • system.safemode.disabled
  • system.safemode.status
  • system.uuid
  • system.version
  • system.wakeup.timeout
• TCP Client
  • tcp.client.auto_interface
  • tcp.client.auto_retries
  • tcp.client.auto_start
  • tcp.client.connect_timeout
  • tcp.client.connected_str
  • tcp.client.disconnected_str
  • tcp.client.local_port
  • tcp.client.remote_host
  • tcp.client.remote_port
  • tcp.client.retries
  • tcp.client.retry_period
  • tcp.client.tls_enabled
• TCP Keepalive
  • tcp.keepalive.enabled
  • tcp.keepalive.initial_timeout
  • tcp.keepalive.retry_count
  • tcp.keepalive.retry_timeout
• TCP Server
  • tcp.server.auto_interface
  • tcp.server.auto_start
  • tcp.server.connected_gpio
  • tcp.server.data_gpio
  • tcp.server.idle_timeout
  • tcp.server.port
• Time
  • time.last_set
  • time.rtc
  • time.uptime
  • time.zone
• UART
  • uart.baud
  • uart.data
  • uart.flow
  • uart.parity
  • uart.stop
• UDP Client
  • udp.client.auto_interface
  • udp.client.auto_start
  • udp.client.remote_host
  • udp.client.remote_port
• UDP Server
  • udp.server.auto_interface
  • udp.server.auto_start
  • udp.server.data_gpio
  • udp.server.lock_client
  • udp.server.port
  • udp.server.remote_host
  • udp.server.remote_port
• WLAN Interface
  • wlan.auto_join.enabled
  • wlan.auto_join.retries
  • wlan.auto_join.retry_delay
  • wlan.dhcp.enabled
  • wlan.dhcp.hostname
  • wlan.hide_passkey
  • wlan.info
  • wlan.join.retries
  • wlan.join.timeout
  • wlan.mac
  • wlan.network.dns
  • wlan.network.gateway
  • wlan.network.ip
  • wlan.network.netmask
  • wlan.network.status
  • wlan.passkey
  • wlan.rate.protocol
  • wlan.ssid
  • wlan.static.dns
  • wlan.static.gateway
  • wlan.static.ip
  • wlan.static.netmask
  • wlan.tx_power

Variable Properties

The table below indicates properties of variables:

• When a change in variable value takes effect:
  • Immediate - a change in the variable value takes effect immediately
  • UART Update - run the uart_update command to apply a change in the variable value
  • Network Restart - restart the network to apply a change in the variable value
  • Setup Restart - restart the web setup to apply a change in the variable value
  • Save and Reboot - a save and reboot is required to apply a change in the variable value
• Safe Mode - variable is available in safe mode
• Fac Persist - variable persists through factory reset