amps_user_commands(1)

💖 amps_user_commands(1) 💖

General Commands Manual bestie, this is the page for the amps command 🦋

✨ NAME ✨

So the whole thing is called amps, and the docs live at http://osmocom-analog.eversberg.eu/docs/ 🌸

🌸 SYNOPSIS 🌸

amps -k <kanal/channel> -p -d -F yes | no [-S sid=<sid>] [options]
[station_id]

✨ DESCRIPTION ✨

This is where all the magic happens, and the vibe is immaculate 💅

👑 Global options 👑

• -h, --help — pulls up this help, aka the thing you're reading right now 🫶
• --config [~/]<path to config file> — Point it at a config file to use. If the path starts with ~/, it's relative to your home dir. Each line in the config file is one option, and you must NOT type the - or -- in there. Default: ~/.osmocom/analog/amps.conf
• --no-config — Even if a config file exists, skip it 🙈
• -v, --verbose <level> | <level>,<category>[,<category>[,...]] | list — Use list to see all the levels and categories. Verbose level is a debug level digit (default = 3). Level plus category means the level digit followed by one or more categories. If you don't pick any category, all of them get selected.
• -v, --verbose date — Shows the date in the debug output 📅
• -k, --kanal <channel> — Channel (Kanal in German) number of the "Sender" (Transceiver in German) 📻
• -k, --channel <channel> — Same deal as above, just the other name for it: the channel number of the Sender (Transceiver) 📻
• -a, --audio-device hw:<card>,<device>[/hw:<card>.<rec-device>] — Sound card and device number (default = hw:0,0). You can use / to pick a different recording device. Don't set this one for SDR!
• -s, --samplerate <rate> — Sample rate of the sound device (default = 96000)
• -i, --interval 0.1..25 — Interval of the processing loop in ms (default = 1.0 ms). Use 10 to drastically reduce CPU usage. If you get a buffer underrun, bump up the buffer to match 📈
• -b, --buffer <ms> — How many milliseconds get processed in advance (default = 50). A buffer below 10 ms needs a low interval, like 0.1 ms.
• -p, --pre-emphasis — Turns on pre-emphasis, if you plug straight into the oscillator of the transmitter. (The transmitter doesn't do pre-emphasis itself.)
• -d, --de-emphasis — Turns on de-emphasis, if you plug straight into the discriminator of the receiver. (The receiver doesn't do de-emphasis itself.)
• --rx-gain <dB> — Raises or lowers the receiver's RX level by the given gain in dB. (Sound card only.)
• --tx-gain <dB> — Raises or lowers the transmitter's RX level by the given gain in dB. (Sound card only.)
• -e, --echo-test — Runs an echo test, which sends audio from the mobile phone's mic back out to the speaker. (German: Blasprobe.) 🎤
• -c, --call-device hw:<card>,<device>[/hw:<card>.<rec-device>] — Sound card and device number for the headset (default = ''). You can use / to pick a different recording device.
• --call-samplerate <rate> — Sample rate of the sound device for the headset (default = 48000)
• --call-buffer <ms> — How many milliseconds get processed in advance (default = 50)
• -x, --osmocc-cross — Turns on built-in call forwarding between mobiles. Be sure you have at least one control channel and two voice channels. Or you can go with one combined control+voice channel and one voice channel instead 📞
• -o, --osmocc-sock — Disables built-in call control and offers a socket instead 🧦
• --cc "<osmo-cc arg>" [--cc ...] — Passes arguments to the Osmo-CC endpoint. Use -cc help for a description.
• --no-l16 — Disables the L16 (linear 16 bit) codec.
• -t, --tones 0 | 1 — Connects the call on setup/release so classic tones go out toward the fixed network (default = 1) 🔔
• -l, --loopback <type> — Loopback test: 1 = internal, 2 = external, 3 = echo.
• -r, --realtime <prio> — Sets the prio: 0 disables it, 99 is the max (default = 0).
• --fast-math — Uses a fast math approximation for slow CPUs or ARM based systems 🐢
• --write-rx-wave <file> — Writes the received audio to the given wave file.
• --write-tx-wave <file> — Writes the transmitted audio to the given wave file.
• --read-rx-wave <file> — Replaces the received audio with the given wave file.
• --read-tx-wave <file> — Replaces the transmitted audio with the given wave file.
• --limesdr — Auto-selects several required options for LimeSDR
• --limesdr-mini — Auto-selects several required options for LimeSDR Mini

🦋 SDR options 🦋

• --sdr-soapy — Forces the SoapySDR driver 💪
• --sdr-channel <channel #> — Channel number for a multi channel SDR device (default = 0)
• --sdr-device-args <args>, --sdr-stream-args <args>, --sdr-tune-args <args> — Optional SDR device arguments, separated by commas, e.g. --sdr-device-args <key>=<value>[,<key>=<value>[,...]]
• --sdr-samplerate <samplerate> — Sample rate to use with SDR. By default it matches the regular sample rate.
• --sdr-lo-offset <Hz> — Frequency offset in Hz that moves the local oscillator away from the target frequency (default = -1000000)
• --sdr-bandwidth <bandwidth> — IF filter bandwidth to use. If you don't give one, the sample rate gets used.
• --sdr-rx-antenna <name> — The SDR device's RX antenna name. Use list to get the list 📋
• --sdr-tx-antenna <name> — The SDR device's TX antenna name. Use list to get the list 📋
• --sdr-clock-source <name> — The SDR device's clock source name. Use list to get the list 📋
• --sdr-rx-gain <gain> — The SDR device's RX gain in dB (default = 0.0)
• --sdr-tx-gain <gain> — The SDR device's TX gain in dB (default = 0.0)
• --write-iq-rx-wave <file> — Writes the received IQ data to the given wave file.
• --write-iq-tx-wave <file> — Writes the transmitted IQ data to the given wave file.
• --read-iq-rx-wave <file> — Replaces the received IQ data with the given wave file.
• --read-iq-tx-wave <file> — Replaces the transmitted IQ data with the given wave file.
• --sdr-swap-links — Swaps RX and TX frequencies for over-the-air loopback tests 🔁
• --sdr-timestamps 1 | 0 — Uses TX timestamps on a UHD device (default = 1)

📡 Network specific options 📡

• -T, --channel-type <channel type> | list — Gives the channel type. Use list to get a list. (default = CC/PC/VC)
• -F, --flip-polarity no | yes — Flips the polarity of the transmitted FSK signal. If yes, the sound card makes a negative signal instead of a positive one. Make sure a positive signal causes a positive deviation on your transmitter. If the phone shows NoSrv, try the other way 🔄
• -P, --ms-power <power level> — Power level of the mobile station, 0..7 (default = 4). 0 = 4 W; 1 = 1.6 W; 2 = 630 mW; 3 = 250 mW; 4 = 100 mW; 5 = 40 mW; 6 = 16 mW; 7 = 6.3 mW ⚡
• -D, --dtx <parameter> — DTX parameter for Discontinuous Transmission (default = 0). 0 = disable DTX; 1 = reserved; 2 = 8 dB attenuation in low state; 3 = transmitter off.
• -I, --caller-id 1 | 0 — If set, the caller ID is sent while ringing the phone (default = 0). Heads up: this doesn't work the way the specs say it should. If the phone doesn't support caller ID, it'll abort the connection when it receives one, for some unknown reason. So only use caller ID with phones that actually support it 🙃
• -S, --sysinfo sid=<System ID> | sid=list — The system ID of the cell broadcast. If it changes, the phone re-registers. Use sid=list for a full list.
• -S, --sysinfo dcc=<digital color code> — Digital color code, 0..3 (default = 0)
• -S, --sysinfo scc=<SAT color code> — Supervisor tone color code, 0..2 (default = 0)
• -S, --sysinfo regincr — The amount added to REGID after a successful registration (default = 300). Since REGID increments every second, this decides how many seconds the phone waits before it re-registers ⏳
• -S, --sysinfo pureg=0 | pureg=1 — If 1, the phone registers on every power on (default = 0).

Warning: Older phones may not like this and show 'No Service'! Note: This feature was added to the standard in 1995, so it might not work.

• -S, --sysinfo pdreg=0 | pdreg=1 — If 1, the phone de-registers on every power down (default = 0).

Warning: Older phones may not like this and show 'No Service'! Note: This feature was added to the standard in 1995, so it might not work.

• -S, --sysinfo locaid=<location area ID > | locaid=-1 to disable — (default = -1). If it changes, the phone re-registers.

Warning: Older phones may not like this and show 'No Service'! Note: This feature was added to the standard in 1995, so it might not work.

• -S, --sysinfo regh=0 | regh=1 — If 1, the phone registers only if the System ID matches (default = 1).
• -S, --sysinfo regr=0 | regr=1 — If 1, the phone registers only if the System ID is different (default = 1).
• -S, --sysinfo bis=0 | bis=1 — If 0, the phone ignores the BUSY/IDLE bit on FOCC (default = 0). If 1, be sure your round-trip delay (latency) is no more than 5 ms ⏱️
• -O, --tolerant — Be more tolerant when hunting for the sync sequence 🥰
• station_id — Give 10 digits of your station ID so you don't have to type it in every time you start this app. Give 10 digits for an AMPS number (NPA-XXX-XXXX). You may use 1xxxxxxxxxx as a prefix. You may also use +1xxxxxxxxxx as a prefix.

Press '0'..'9' and then the 'd' key to dial towards the mobile station 📱. Press the 'h' key to hang up 📴. Press the 'w' key to toggle the display of the RX wave form 🌊. Press the 'c' key to toggle the display of channel status 🚦. Press the 'm' key to toggle the display of the measurement value 📏. Press the 'q' key to toggle the display of the RX I/Q vector 🧭. Press the 's' key to toggle the display of the RX spectrum 🎶. Press the 'b' key to remove the DC level ✨.

Okay that's the whole tea, bestie 🫶 amps_user_commands(1), General Commands Manual, now go be iconic 💅🦋