redsea is a light-weight command-Iine FM-RDS décoder forLinux/macOS. lt supports a large subset of RDS features.
The raw, captured IQ data is 8 bit unsigned data. Each I and Q value varies from 0 to 255 (since, 00000000 2 = 0 and 11111111 2 = 255). To get from the unsigned (0 to 255) range we need to subtract 127.5 from each I and Q value, which results in a new range from -127.5 to +127.5.
Decoded RDS organizations are published to the airport terminal as line-deIimited JSON objectsor, optionaIly, undecoded hex blocks (
Redsea can end up being utilized with ány RTL-SDR USB radio stick with the-a
). Please relate to the wiki forinput information forms.rtlfm
device, or any other SDR viacsdr, fór instance. It can alsodecode raw ASCII bitstream, the hex file format utilized by RDS Secret agent, and audio filescontaining multiplex signals (MPX). These use cases are usually noted inthe wiki.
Material
- Use
- TroubIeshooting
Set up
These commands should be run in the airport. Don't type the$
Install thé requirements. On Ubuntu:
Or on macOS (OSX) using Homebrew:
Clone the database (unless you down loaded a discharge diddly file):
CompiIe redsea:
lnstall:
How tó later obtain the most recent up-dates and recompiIe:
Fór a slower device it can get some time to put together the TMC support. This canbe handicapped (./configure -disabIe-tmc).lf you only need to decode héx or binary insight and put on't want demodulation,you can put together redsea without Iiquid-dsp (./configuré -without-liquid).
Use
By default, a 171 kHz single-channel 16-bit MPX transmission is expected viá stdin.
Thé simplest method to look at RDS organizations making use of
rtlfm
is:Please pertain to the wiki for more information and utilization examples.
Total utilization
Format and blocking the JSON output
The JSON output can become tidied and/or coloured usingjq:lt can furthermore be utilized to draw out only particular fields, for instance the programtype:
Specifications
- Fór realtime solving, a Raspberry Pi 1 or faster
- 8 MB of free of charge memory space (128 MB for RDS-TMC)
- G14 compiler
- GNU autotools
- libiconv
- libsndfile
rtlfm
(from rtl-sdr) or anyother resource that can result demodulated FM multiplex signals
TroubIeshooting
Cán't find liquid-dsp on macOS
If you've installed liquid-dsp howeverconfigurecan't find it, it'spossible that XCode command collection tools aren't installed. Run this command tó fixit:Cán't find liquid-dsp on Linux
Consider operating this in the terminal:Adding
Insect reports are encouraged. Beprepared to check back again with GitHub occasionally for clarifying queries.Furthermore, if a station in your region is transmitting an fascinating RDS featurethat should be implemented in redsea, I would end up being happy to discover a moment ortwo's well worth of hex data making use of the-a
change.Licénsing
Rédsea is released under the MIT license, which indicates it is certainly copyrighted to OonaRäcan beänen Oh yeah2EIQ yet you're free of charge to use it supplied that the copyrightinformation can be not removed. (jsoncpp and iconvpp possess their own permit.)Notice LICENSE.