Skip to content

UCI options

OpenWrt keeps its configuration in UCI files under /etc/config/, one file per package, and LuCI writes the same files the shell does. This is the index of the options this image cares about.

Read a value with uci show <package>; change one with uci set, then uci commit <package>.

Committing by hand does not restart anything

uci commit writes the file. It does not reload the service, and it does not tell LuCI's page — which reloads only when you press its save button. After a hand edit, either restart the service named in the row below, or use the page.

awvoice — the phone line

The full reference, including the options the page hides and the quiet-hours and contact sections, is on the phone port's own page: settings reference. The short form:

option shipped what it decides
main.enabled 1 the whole line. Off means the chip is in reset and the phone is silent
main.channel 1 which of the chip's two channels is this line
main.board /etc/awvoice/board.bin the board file: the chip's operating values
main.at_interface 2 the modem USB interface holding the voice AT port
main.cid / main.cid_when dtmf / ring1 caller-id signalling, and where it sits relative to the first ring
main.hd 0 HD voice wanted. The modem's own answer decides what is used
main.region auto the numbering plan that decides display form
main.ringback auto local progress tone, or the network's audio
main.call_waiting 1 the second call, and with it the three-way join
main.flash_min_ms / main.flash_max_ms 80 / 300 the hook-flash window
main.dial_pause_s 6 how long a pause between digits ends the number
main.led green:phone the indicator lamp, or '' to leave it alone
main.ring_rate_ms / main.offhook_rate_ms 300 / 1000 the LED's blink rates
main.hotline_delay_s 10 the window before a hotline number goes out
main.record_enabled / record_path / record_max_mb 0 / /etc/awvoice/recordings / 50 call recordings
main.machine_enabled / machine_delay / machine_max_s / machine_max_mb / machine_path 0 / 10 / 120 / 50 / /etc/awvoice/messages the answering machine
main.web_port / web_iface / web_cert / web_key 7443 / lan / /etc/uhttpd.crt / /etc/uhttpd.key the browser phone's encrypted audio stream
main.my_number unset display only; nothing is dialled from it
main.earpiece_volume / main.modem_rx_gain unset written to the modem only when set
sip.mode web whether a phone on your own network may join the line, and it starts or stops that service when saved
dnd.<name> none shipped one section per quiet-hours window
contact.<name> none shipped phone-book entries, with ring_through

cw-led — the front panel

Every option, its range and whether the page shows it, is in the LED settings table. The ones that surprise people:

option shipped note
global.enabled 1 the daemon runs from the first boot
global.tick 5 not on the page. Every interval below is counted in ticks
modem.port /dev/ttyUSB2 the port freed for the LED daemon by 47-cw-awvoice-at-port
night.exempt all five lamps nothing is switched off at night until you remove one
internet.mode http204 the active probe; interface and ping are the alternatives
internet.probe_down_fail 2 two failed probes are needed to extinguish the lamp

qmodem_sip — the service a network phone uses

This file belongs to the SIP service in the QModem feed, and the AWvoice page treats it as another program's settings — it reads them back and never stores a secret. The values this image ships, after its patch:

option shipped what it means here
sipd.main.media_socket_path /var/run/awvoice-phoned/media.sock where the service hands audio. This is the setting that makes a soft phone audible on a fresh router
sipd.main.rtp_start / rtp_end 40000 / 40031 the media port range
direction.inbound.enabled 1 a phone on your LAN may call in
direction.inbound.interface / listen_port / transport lan / 5060 / udp_tcp where it listens
direction.inbound.username awvoice the account name a soft phone signs in with
direction.inbound.password CleanWRT#40 the same secret as the default Wi-Fi key, so a router has one pair to remember. Change it on the AWvoice page
direction.inbound.voip_enabled 0 the vendor VoIP engine is not used; the phone daemon carries the front end
direction.inbound.sms_enabled 0 SMS stays with QModem
direction.outbound.realm / password unset the outbound direction, which reaches a server outside the house, ships no secret
direction.outbound.register_interval 300 seconds between registration attempts
direction.outbound.voip_enabled 0 as above

Nothing in this file is started by the image. The service runs when the AWvoice page's switch starts it, and no SIP port is open until then.

footstrap — the look

The image writes 27 options on first boot, listed option by option in first-boot defaults and explained in the theme. The two that behave differently from the rest:

option what it holds
settings.login_bg the checksum of the photo file, not a path. It is how the first-boot script recognises its own default
settings.cw_look the name of the look the image applied. A router that already carries it is left alone

uhttpd — the web server

option shipped why
main.redirect_https 1 plain HTTP becomes HTTPS. See security
awvoice_provision.listen_http 0.0.0.0:8080 the plain listener that serves a scanned provisioning file, with directory listings off and the private-network filter on
awvoice_provision.home /www/awvoice-provision a directory that holds nothing else

wireless, system, network, dropbear

option shipped note
wireless.<radio>.ssid CleanWRT-2.4G, CleanWRT-5G, CleanWRT-6G by band
wireless.<iface>.encryption / key psk2 / CleanWRT#40 the key is written only when none is set
system.@system[0].hostname CleanWRT
system.@system[0].timezone UTC set yours; alarm calls and quiet hours trust the clock
system.@system[0].log_size 64 the log buffer in KiB
network.globals.packet_steering 1 receive work spread over the four cores
dropbear.@dropbear[0].PasswordAuth / RootPasswordAuth on / on with no root password set, so the first login is over Ethernet

The rest of the shipped files

adblock, fstab, irqbalance, minidlna, p910nd, qmodem_ttl, samba4, syncthing and watchcat — every value and what it means in behaviour, in first-boot defaults.

Where to go next

What each file and port is files and ports
What the phone daemon answers over ubus the API and who may call it
What the image writes at first boot first-boot defaults