Settings reference
Everything is in one file, /etc/config/awvoice. The page writes the same file, so uci and LuCI
never disagree. An option with an invalid value is reported in the log and its default is used
instead:
logread -e awvoice | tail -20
The shipped file carries only four settings — flash_min_ms 80, flash_max_ms 300,
led green:phone and sip.mode web. Every other value below is a compiled default , which is
why an option that is absent from your file is not a bug.
The line — awvoice.main
The service
option
values
default
what it does
enabled
0|1
1
the whole phone line. The init script refuses to start the daemon when it is 0, and the kernel puts the chip in reset
channel
0|1
1
which of the line chip's two channels is this jack
board
a path
/etc/awvoice/board.bin
the board file: this board's chip operating values
at_interface
0–9
2
the modem's USB interface number holding the voice AT port. The tty is found through sysfs, not by a fixed name
my_number
digits
unset
shown on the page so you know which number this line is. Nothing is ever dialled from it
Dialling and the hook
option
values
default
what it does
dial_pause_s
3–15
6
how long a pause after the last digit ends the number
flash_min_ms
20–500
80
a shorter break is bounce and is ignored
flash_max_ms
300–3000
300
a break at or above this is on hook. Between the two is a flash
hotline_number
up to 20 digits
unset
dialled when a lifted handset dials nothing
hotline_delay
3–99 s
10
how long that wait is
Caller id and restriction
option
values
default
what it does
cid
dtmf|bellcore|etsi|off
dtmf
how the number reaches the handset's display
cid_when
ring1|prering
ring1
FSK placement, after or before the first ring. Ignored by the DTMF variant , and the page shows the control disabled for it
region
auto or a region name
auto
the numbering plan that turns national digits into international form, for display and for matching. 43 regions
clir
network|hide|show
network
per-subscription calling-line restriction, sent as AT+CLIR=0|1|2. No control on the page ; saving the page leaves the stored value as it was
Tones and audio
option
values
default
what it does
ringback
auto|on|off
auto
local progress tone until the network's own audio is heard, always local, or never
hd
0|1
0
HD voice wanted. The modem is asked which rate it actually puts on the bus, and the line comes up at that rate only if it answers so
earpiece_volume
0–255, or unset
unset
written to the modem as AT+CLVL at every modem setup, when set
modem_rx_gain
0–65535, or unset
unset
written as AT+QRXGAIN when set. 8192 is unity
level_trace
0|1
0
logging only: the modem's audio level every 100 ms
Features
option
values
default
what it does
call_waiting
0|1
1
announce a second call, and with it hold, swap and refuse. Off, the second call is refused on arrival
conference
0|1
0
the three-way join after a flash and 3. Off as installed
led
an LED name or ''
green:phone in the shipped file, empty as a compiled default
the indicator lamp. '' leaves the lamp alone
ring_rate_ms
100–3000
300
the blink rate while a call rings
offhook_rate_ms
200–10000
1000
the blink rate while the handset is off hook
Recordings
option
values
default
what it does
record_enabled
0|1
0
record the calls this line answers
record_path
an absolute path
/etc/awvoice/recordings
where they go
record_max_mb
1–4095
50
the folder's budget; past it the oldest files are removed
The answering machine
option
values
default
what it does
machine_enabled
0|1
0
answer for you
machine_delay
0–60 s
10
seconds of ringing first. 0 answers at once
machine_max_s
10–600 s
120
the longest single message; the call ends at it
machine_max_mb
1–4095
50
the messages folder's budget
machine_path
an absolute path
/etc/awvoice/messages
where messages go
machine_greeting
—
—
retired. Any stored value is ignored and said so in the log. The greeting is one fixed file, /etc/awvoice/greeting.wav, managed from its own card
The browser phone
option
values
default
what it does
web_port
1024–65535
7443
the port the audio WebSocket listens on
web_iface
a logical interface name
lan
whose IPv4 address the listener binds. It never binds a WAN interface
web_cert
a path
/etc/uhttpd.crt
the certificate the stream uses
web_key
a path
/etc/uhttpd.key
its key
Page-only settings
option
values
default
note
page_refresh_s
1|2|3|5|10|15|30
1
the page's own poll interval. The daemon does not read it
mic_gain_db, earpiece_gain_db
-99–99
unset
shown disabled with Not available yet , and never written by the page
The network side — awvoice.sip
option
values
default
what it does
mode
web, interop, baresip
web
whether a phone on your own network may join the line. Saving also starts or stops that service. An unknown word is refused and the previous value stays
The service's own settings — account, port, direction, provider — are in a different package,
/etc/config/qmodem_sip, listed in UCI options .
Lists and records
section type
what it holds
limits
contact
name, a number list as digits or digits:mobile|home|work, quick, ring_through
100 contacts, 3 numbers each, name ≤ 32, quick exactly 2 digits and unique
blocking (the first of this type)
anonymous, and the lists incoming, incoming_prefix, outgoing, outgoing_prefix
50 entries per list
alarm
label, time as HH:MM, a day list (1 = Monday … 7), enabled
20 alarms, label ≤ 32
forwarding (the first of this type)
enabled, to, when = always|busy|noanswer|unreachable|all_conditional, delay 5–30 in steps of 5, default 20
the whole section is discarded if any value is invalid
dnd (every one, in file order)
enabled, from, to, all_day, days, mode, repeat_min, allow
8 windows, 20 numbers across all the allow lists
Rules the daemon applies across options
rule
what happens
flash_max_ms must be at least flash_min_ms + 100
if it is not, both fall back to their defaults
the recordings folder and the messages folder must not be the same
the daemon moves one. If only one can move, messages go to <record_path>/.messages; if they still collide, machine_enabled is turned off
an invalid value anywhere
the log names the option and the compiled default is used
Settings the page does not show
at_interface and led are the two that usually matter, and both ship with working values for the
AW1000. Also clir, level_trace, the four web_* values beyond the port, mic_gain_db and
earpiece_gain_db, page_refresh_s (which is in Phone settings → Advanced ), and the whole
forwarding section.
uci show awvoice # everything as stored
uci set awvoice.main.conference= 1 # turn the three-way join on
uci commit awvoice
/etc/init.d/awvoice restart
A shell commit does not reload the page
uci commit writes the file. Only the page's own save applies and reloads, and a hand edit needs
the service restart above. See first-boot defaults for the same
trap in the other direction.
Next