Documentation

This is the documentation for NanoRDS

Installation

Dependencies

NanoRDS needs a few dependency packages in order to work.

Debian-based distros:

Arch-based distros:

Fedora-based distros:

Downloading

You can either download the software using the download button on this website, or using git:

Compilation

The Makefile shipped with NanoRDS provides a few options:

• make - compiles the program.
• make install - compiles the program and installs it system-wide, so that running nanords anywhere in the system, runs the encoder.
• make uninstall - uninstalls the program system-wide, so that running nanords anywhere in the system, won't run the encoder anymore.
• make clean - removes all the .o files and the executable file from NanoRDS directory.

To run the encoder that was installed system-wide, run this anywhere:

To run the encoder that wasn't installed system-wide, run this in the NanoRDS directory:

Notice: both make install and make uninstall have to be run as root (e.g. sudo make install or sudo make uninstall)

Command-line arguments

To list all the available command-line arguments, run:

FIFO creation

Create the control pipe:

Run NanoRDS with the appropriate flag:

Now you can send commands to fifo, to control the RDS (manually, or using some automated script). Every line must start with a valid command, followed by one space character, and the desired value. Any other line format is silently ignored.

Notice: If you create the FIFO pipe in a directory other than where the NanoRDS executable is located, be sure to specify the full path to the FIFO pipe when running NanoRDS.

FIFO Commands

PS - stands for Program Service name and it allows to broadcast a 'title' for the station that is displayed on every receiver with RDS support (that's the most basic feature). Its length can be up to 8 characters. This is how you can set it in NanoRDS via fifo

RT - stands for RadioText and is basically a longer message that is displayed in most RDS receivers. It can contain up to 64 characters, and here's how you can set it

RTPF - a 2-bit integer, applicable when you want to transmit RT+. It sets RT+ flags - 'running' and 'toggle'

• RTPF 0 - unsets both flags,
• RTPF 1 - sets the toggle flag,
• RTPF 2 - sets the running flag,
• RTPF 3 - sets both flags

Example usage:

RTP - provides data for the RT+ group (in NanoRDS, RT+ is transmitted in 11A group). Its format is

It takes data from the RT. Example usage:

PTY - defines Program Type, so basically what content does the station broadcast. In NanoRDS, PTY is set using a code.

PTYN - basically a PTY extension. Able to hold up to 8 characters, typically used to add some additional info about the broadcast content type.

PI - Program Identification is a unique 16-bit hexadecimal, 4-character code that identifies the station. Here's how you can set it in NanoRDS

AF - AF stands for Alternative Frequencies and allows the receiver to switch between pointed frequencies when the signal weakens. AF has two methods - both are supported by NanoRDS.

This is how you can use AF method A in NanoRDS. It is recommended that the first frequency on the list is the one your current transmitter is on

This is how you can set AF method B. In method B, you create frequency pairs. So as in the given example, 87.7 will be the main frequency and it will define paired 87.7 with 96.4

If you wish to clear the AF list, use

ECC - 8-bit hexadecimal code that defines country of origin of the station. It can be the same for many countries, since the second condition for country identification is the PI code. If you want to disable it, set its value to 0

LIC - 8-bit hexadecimal code - its value defines the language of the station. If you want to disable it, set its value to 0

MS - music/speech flag. Music is 1 and speech is 0.

TP - Traffic Program flag. Defines whether station broadcasts traffic info. If yes, it's set to 1; if no, it's set to 0

TA - Traffic Announcement flag - signals that there are traffic announcements being broadcasted at the moment

DI - Decoder Information - identifies different operating modes. This enables controlling of individual decoders. Additionally it indicates if static or dynamic PTY codes are transmitted.

STEREO - controls the stereo pilot volume.

If you want to disable Stereo pilot, simply set its value to 0.

RDS - controls the RDS subcarrier volume.

If you want to disable RDS subcarrier, simply set its value to 0.

RESET - doesn't take any arguments - resets all the encoder parameters to the default ones

PTY codes