Skip to content

The handset

This page is the line as an ordinary telephone behaves: what you hear, what the keys do, and what the settings behind each behaviour are. The browser's own phone is a separate page, and what happens when nobody answers is the answering machine.

The states the line reports

The page's Overview tab shows one word for the line, and every other control follows from it.

state what it means
Idle the handset is on the hook and the line is ready. A dial tone is available
Handset lifted off hook: the line is open, dialling is accepted, nothing is connected yet
Ringing an incoming call is announcing itself to the handset
In call a call is up, and the audio path is carrying it
No service the modem is not registered, so the line cannot be used until it is
Phone service down the daemon is not running. The line chip is in reset, so the phone cannot ring

A dead service is a silent line, by design

When awvoice-phoned stops, the kernel module's watchdog puts the line chip back into reset within milliseconds. A phone that keeps ringing after its daemon dies is the failure this prevents. See how it works.

Tones

Dial tone while off hook and idle, ringing tone toward the caller you are dialing, busy and congestion at the ends of a failed attempt. What you hear while waiting for a answered call is decided by one option:

ringback what you hear before the other side answers
auto (default) the router's own progress tone until the network's audio arrives, then the network's
on the local tone, always
off nothing until the call is answered

Tone levels and the modem's receive gain are settings on the Settings tab; two of them, earpiece_volume and modem_rx_gain, are written to the modem only when you set them, and are unset out of the box.

Dialling

Digits are collected while you dial and released to the network when the number ends. A number ends on a pause: dial_pause_s, between 3 and 15 seconds, 6 by default. A handset that sends digits slowly needs the longer end of that range; a fast keypad can go shorter.

Three-digit service codes need a longer hook break than a flash. The two windows are separate on purpose: the handset's flash window (flash_min_ms 80 to flash_max_ms 300 by default) decides what counts as a flash, and a code typed inside the window that follows it is read as a code, not as a digit. That is why a flash followed by 3 joins two calls and a long hook break followed by a service code reaches the network.

A hotline number goes out by itself when the handset is lifted: set the number, and hotline_delay_s (10 by default) is the window in which you can still dial somewhere else.

Hook-flash codes

Press the handset's flash (R) key during a call, then one digit:

after the flash what happens
1 end the current call and take the other one — the waiting call, or the held one
2 put the current call on hold and take the other; with two live calls this swaps them, with one held call it takes it back
0 refuse the waiting call, or release the held one
3 join the two calls into one three-way conversation. Needs two calls up and 3-way calling switched on in Phone settings, which it is not as installed

The same codes are on the browser page's Flash button, which is the handset's flash key in the same slot.

Refusing a second call while it still rings

Giving up a ringing second call ends every call on the line. The modem cannot release a ringing leg on its own, so the network releases the dialog. Take the call first, then hang up.

Call waiting, hold and three-way

call_waiting is on by default. A second call is announced during a call — a 500 ms tone every five seconds — and you can hold the first call and take the second, swap between them, or refuse the newcomer. With call_waiting off the second call is refused on arrival.

The three-way join is a separate switch: conference, off as installed. A flash and 3 with it off does nothing but log three-way calling is off, so the key is not lost, it is declined. Turn it on in Phone settings → Features → 3-way calling if you want it.

Recall

Put the handset down while a call is on hold and the call is not lost: the phone rings back until you lift it, which takes the call back, or the other side ends it.

This is also the rule that decides who owns a call the browser page put on hold. A lift during a page call carries the call on at the handset — the log records the handset as the one that answered it, and the page's microphone and speaker stop with it. A call the page held is not taken by a lift: the lift gets the recall dial tone and the held call stays the page's.

Caller id

The number and name are sent to the handset's display as a message on the line. Two settings decide it, and both are visible on the Settings tab:

cid the signalling the handset expects
dtmf (default) the DTMF variant, which most cheap handsets understand
bellcore FSK, Bellcore framing
etsi FSK, ETSI framing
off nothing is sent
cid_when where the message sits relative to the first ring
ring1 (default) after the first ring
prering in the gap before it, which some handsets need and some networks ignore

cid_when matters only for the two FSK modes. With cid on the DTMF variant the message goes out while the phone is ringing, and the page shows the timing control disabled, because there is nothing for it to decide.

A caller-id message carries digits only. How those digits are displayed — national form, international form, with or without the name from your phone book — is decided by the numbering plan, region: auto (default) follows the network the line registers on, across 43 regions, or you can name one. The number the network sent is never rewritten; the plan decides the shape it is shown in.

Nothing appears on the handset display

Check cid first: a handset that expects FSK shows nothing when the router sends the DTMF variant, and the other way round. Then check cid_when. The Tools tab can transmit a caller-id message on demand, which tells you whether the line is sending it at all.

The numbers you do not show

Calling-line restriction (CLIR) hides your number on the calls you place: clir takes network (the default, which asks nothing), hide or show, and maps to AT+CLIR=0|1|2. It has no control on the page — it is set in /etc/config/awvoice, and saving the page leaves whatever is stored there untouched. The Health tab reports what the network provisioned, as not_provisioned, provisioned, unknown, restricted or allowed, so a restriction that the operator will not carry is visible rather than assumed.

Network service codes are dialled as you would dial them on any phone. A prefix of #31# or *31# on a dialled number is understood as a per-call restriction request and is stripped before any blocking rule looks at the number.

my_number is a display-only setting. Whatever you put there appears on the page so you know which number this line is; nothing is ever dialled from it.

The phone LED

The front-panel phone LED follows the line, and one option names it: led, which ships as green:phone. Set it to an empty value and the LED is left alone entirely.

the line the LED
ready solid
a call is ringing fast blink — ring_rate_ms, 300 by default
the handset is off hook slow blink — offhook_rate_ms, 1000 by default

The other five lamps on the panel belong to LED Management, which does not touch this one while AWvoice is running.

Settings on this page

option (awvoice.main) values default the page calls it
dial_pause_s 3–15 6 Dial pause
flash_min_ms / flash_max_ms 20–500 / 300–3000 80 / 300 Flash window
call_waiting 0 | 1 1 Call waiting
conference 0 | 1 0 3-way calling
cid dtmf | bellcore | etsi | off dtmf Caller id mode
cid_when ring1 | prering ring1 Caller id timing
ringback auto | on | off auto Ringback
region auto | a region name auto Numbering plan
hotline_delay_s seconds 10 Hotline delay
led an LED name, or '' green:phone Phone LED
ring_rate_ms milliseconds 300 Ring blink rate
offhook_rate_ms milliseconds 1000 Off-hook blink rate
my_number digits unset My number

flash_max_ms must be at least 100 ms above flash_min_ms; the page refuses a pair that is not. The full option list, including the ones the page does not show, is in the settings reference.

When it misbehaves

symptom the one check that decides it
No dial tone with the handset lifted is the service running and the modem registered? The Overview word tells you which of the two it is
Digits are cut off, or the call dials early dial_pause_s is too short for your handset
A flash does nothing the handset's flash is shorter than flash_min_ms or longer than flash_max_ms; the Tools tab reads the chip's hook state
Nothing on the handset display cid, then cid_when, then the transmit test
The LED will not follow the line led names a lamp that exists on this board; '' means leave it alone
A restriction you set is not honoured health reports the network's provisioning word. That is the operator, not the router

Questions people ask

Can I use any phone on the AW1000's RJ11 socket?

An ordinary analogue phone with a tone dial and an RJ11 plug. A handset with a display shows the caller id, if the signalling mode matches what the phone expects. Pulse-dialling phones are not supported.

How do I get a three-way call on the AW1000?

Switch on 3-way calling in Phone settings → Features — it is off as installed — then take the second call and press the handset's flash key followed by 3. Both calls must be up.

Why does my phone not ring back a held call?

Recall works when the call was put on hold by the handset. A call the browser page put on hold stays the page's — lifting the handset gives you the recall dial tone for the handset's own held call, not the page's.

Does the caller id work with the number in international form?

The message on the line carries digits. The numbering plan decides how they are displayed, and region set to auto follows the network the line registered on.