Provided by: osmocom-analog_0.0~git20240908.8f91ed1-1_amd64 
NAME
pocsag - http://osmocom-analog.eversberg.eu/docs/
SYNOPSIS
pocsag -k <kanal/channel> -k 466.230 | -k list [options] [station_id]
Global options:
-h --help
This help
--config [~/]<path to config file>
Give a config file to use. If it starts with '~/', path is at home dir. Each line
in config file is one option, '-' or '--' must not be given! Default:
'~/.osmocom/analog/pocsag.conf'
--no-config
Even if a config file exists, don't use it.
-v --verbose <level> | <level>,<category>[,<category>[,...]] | list
Use 'list' to get a list of all levels and categories. Verbose level: digit of
debug level (default = '3') Verbose level+category: level digit followed by one or
more categories -> If no category is specified, all categories are selected
-v --verbose date
Show date with debug output
-k --kanal <channel>
-k --channel <channel>
Channel (German = Kanal) number of "Sender" (German = Transceiver)
-a --audio-device hw:<card>,<device>[/hw:<card>.<rec-device>]
Sound card and device number (default = 'hw:0,0') You may specify a different
recording device by using '/'. Don't set it for SDR!
-s --samplerate <rate>
Sample rate of sound device (default = '48000')
-i --interval 0.1..25
Interval of processing loop in ms (default = '1.0' ms) Use 10 to drastically reduce
CPU usage. In case of buffer underrun, increase buffer accordingly.
-b --buffer <ms>
How many milliseconds are processed in advance (default = '50') A buffer below 10
ms requires low interval like 0.1 ms.
--rx-gain <dB>
Raise/lower receiver's RX level by given gain in dB. (Works with sound card only.)
--tx-gain <dB>
Raise/lower transmitters's RX level by given gain in dB. (Works with sound card
only.)
-e --echo-test
Use echo test, to send back audio from mobile phone's microphone to the speaker.
(German: 'Blasprobe').
-c --call-device hw:<card>,<device>[/hw:<card>.<rec-device>]
Sound card and device number for headset (default = '') You may specify a different
recording device by using '/'.
--call-samplerate <rate>
Sample rate of sound device for headset (default = '48000')
--call-buffer <ms>
How many milliseconds are processed in advance (default = '50')
-x --osmocc-cross
Enable built-in call forwarding between mobiles. Be sure to have at least one
control channel and two voice channels. Alternatively use one combined
control+voice channel and one voice channels.
-o --osmocc-sock
Disable built-in call control and offer socket
--cc "<osmo-cc arg>" [--cc ...]
Pass arguments to Osmo-CC endpoint. Use '-cc help' for description.
--no-l16
Disable L16 (linear 16 bit) codec.
-t --tones 0 | 1
Connect call on setup/release to provide classic tones towards fixed network
(default = '1')
-l --loopback <type>
Loopback test: 1 = internal | 2 = external | 3 = echo
-r --realtime <prio>
Set prio: 0 to disable, 99 for maximum (default = 0)
--fast-math
Use fast math approximation for slow CPU / ARM based systems.
--write-rx-wave <file>
Write received audio to given wave file.
--write-tx-wave <file>
Write transmitted audio to given wave file.
--read-rx-wave <file>
Replace received audio by given wave file.
--read-tx-wave <file>
Replace transmitted audio by given wave file.
--limesdr
Auto-select several required options for LimeSDR
--limesdr-mini
Auto-select several required options for LimeSDR Mini
SDR options:
--sdr-soapy
Force SoapySDR driver
--sdr-channel <channel #>
Give channel number for multi channel SDR device (default = 0)
--sdr-device-args <args>
--sdr-stream-args <args>
--sdr-tune-args <args>
Optional SDR device arguments, separated by comma e.g. --sdr-device-args
<key>=<value>[,<key>=<value>[,...]]
--sdr-samplerate <samplerate>
Sample rate to use with SDR. By default it equals the regular sample rate.
--sdr-lo-offset <Hz>
Give frequency offset in Hz to move the local oscillator away from the target
frequency. (default = -1000000)
--sdr-bandwidth <bandwidth>
Give IF filter bandwidth to use. If not, sample rate is used.
--sdr-rx-antenna <name>
SDR device's RX antenna name, use 'list' to get a list
--sdr-tx-antenna <name>
SDR device's TX antenna name, use 'list' to get a list
--sdr-clock-source <name>
SDR device's clock sourc name, use 'list' to get a list
--sdr-rx-gain <gain>
SDR device's RX gain in dB (default = 0.0)
--sdr-tx-gain <gain>
SDR device's TX gain in dB (default = 0.0)
--write-iq-rx-wave <file>
Write received IQ data to given wave file.
--write-iq-tx-wave <file>
Write transmitted IQ data to given wave file.
--read-iq-rx-wave <file>
Replace received IQ data by given wave file.
--read-iq-tx-wave <file>
Replace transmitted IQ data by given wave file.
--sdr-swap-links
Swap RX and TX frequencies for loopback tests over the air.
--sdr-timestamps 1 | 0
Use TX timestamps on UHD device. (default = 1)
Network specific options:
-T --tx
Transmit POCSAG signal on given channel, to page a receiver. (default)
-R --rx
Receive POCSAG signal on given channel, so we are the receiver. If none of the
options -T nor -R is given, only transmitter is enabled.
-B --baud-rate 512 | 1200 | 2400
Choose baud rate of transmitter.
-D --deviation wide | 4.5 | narrow | 2.5 | <other KHz>
Choose deviation of FFSK signal (default 4 KHz).
-P --polarity -1 | nagative | 1 | positive
Choose polarity of FFSK signal. 'negative' means that a binary 0 uses positive and
a binary 1 negative deviation. (default negative KHz).
-F --function 0..3 | A..D | numeric | beep1 | beep2 | alphanumeric
Choose default function when 7 digit only number is dialed. (default 0 = numeric)
-M --message "..."
Send this message, if no caller ID was given or of built-in console is used.
(default "1234").
-L --language
Translate German spcial characters from/to UTF-8.
-S --scan <from> <to>
Scan through given IDs once (no repetition). This can be useful to find the RIC of
a vintage pager. Note that scanning all RICs from 0 through 2097151 would take
about 16.5 Hours at 1200 Baud and known sub RIC. Use -F to select function of the
pager. Short messages with 5 numeric or 2 alphanumeric characters are sent without
increase in scanning time. The upper 5 digits of the RIC are sent as message, if
numeric function was selected. The upper 3 digits of the RIC are sent as message (2
digits hexadecimal), if alphanumeric function was selected.
--padding 4 | 0 | ...
Text message padding uses 4 (EOT) by default. Old pagers want 0 (NUL).
File: /tmp/pocsag_msg_send
Write "<ric>,0,message" to it to send a numerical message. Write "<ric>,3,message"
to it to send an alphanumerical message. alphanumeric messages may contain any
character except LF and CR. Any control character can be sent by using pointed
brackets:
'<NUL>' '<SOH>' '<STX>' '<ETX>' '<EOT>' '<ENQ>' '<ACK>' '<BEL>' '<BS>' '<HT>'
'<LF>' '<VT>' '<FF>' '<CR>' '<SO>' '<SI>' '<DLE> '<DC1>' '<DC2' '<DC3>'
'<DC4>' '<NAK>' '<SYN>' '<ETB>' '<CAN>' '<EM>' '<SUB>' '<ESC>' '<FS>' '<GS>'
'<RS>' '<US>' '<DEL> Example: Hello,<LF><CR>World!'
File: /tmp/pocsag_msg_received
Read from it to see received messages.
station_id: Give 7 or 8 digits of station ID,
so you don't need to enter it for every start of this application. Give 7 digits
for RIC with default function. Give 8 digits for RIC with function (append 0..3 or
A..D).
Press digits '0'..'9' and then 'd' key to dial towards mobile station. Press 'h' key to
hangup. Press 'w' key to toggle display of RX wave form. Press 'c' key to toggle display
of channel status. Press 'm' key to toggle display of measurement value. Press 'q' key
to toggle display of RX I/Q vector. Press 's' key to toggle display of RX spectrum.
Press 'b' key to remove DC level.
pocsag(1)