ua1zbe
/
PiFmRds
mirror of https://github.com/ChristopheJacquet/PiFmRds
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge remote-tracking branch 'refs/remotes/origin/master'

This commit is contained in:
Christophe Jacquet 2026-02-01 10:52:33 +00:00
parent c8b775423a cd6d744a94
commit 777f8e5264
1 changed files with 15 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
README.md
View File

@ -16,15 +16,19 @@ PiFmRds has been developed for experimentation only. It is not a media center, i
## How to use it?
Pi-FM-RDS, depends on the `sndfile` library. To install this library on Debian-like distributions, for instance Raspbian, run `sudo apt install libsndfile1-dev`.
Pi-FM-RDS is tested under Raspberry Pi OS Lite (the version without desktop environment). You should be able to run it under other distributions, but the author provides no guarantees nor support. Latest Raspberry Pi OS version successfully tested: 13.1 (based on Debian Trixie).
Pi-FM-RDS also depends on the Linux `rpi-mailbox` driver, so you need a recent Linux kernel. The Raspbian releases have this starting from August 2015.
Dependencies:
**Important.** The binaries compiled for the Raspberry Pi 1 are not compatible with the Raspberry Pi 2/3, and conversely. Always re-compile when switching models, so do not skip the `make clean` step in the instructions below!
* `sndfile` library, provided by package `libsndfile1-dev` under Raspberry Pi OS and other Debian-like distributions.
* Linux `rpi-mailbox` driver, so you need a Linux kernel built after approximately August 2015.
Clone the source repository and run `make` in the `src` directory:
**Important.** The binaries compiled for one Raspberry Pi model and ARM architecture are not compatible with other models and architectures. Always re-compile when switching models, so do not skip the `make clean` step in the instructions below!
These should be the complete instructions assuming a clean Raspberry Pi OS Lite install:
```bash
sudo apt install git libsndfile1-dev
git clone https://github.com/ChristopheJacquet/PiFmRds.git
cd PiFmRds/src
make clean
@ -146,6 +150,11 @@ then your locale variables are not set correctly and Pi-FM-RDS is incapable of w
with non-ASCII characters.
### Compiling on distributions with different float ABIs
The makefile uses `-mfloat-abi=hard`, which is suited for Raspberry Pi OS. Different distributions might require different values, namely `soft` or `softfp`.
## Warning and Disclaimer
PiFmRds is an **experimental** program, designed **only for experimentation**. It is in no way intended to become a personal *media center* or a tool to operate a *radio station*, or even broadcast sound to one's own stereo system.
@ -207,13 +216,13 @@ The samples are played by `pi_fm_rds.c` that is adapted from Richard Hirst's [Pi
### References
* [EN 50067, Specification of the radio data system (RDS) for VHF/FM sound broadcasting in the frequency range 87.5 to 108.0 MHz](http://www.interactive-radio-system.com/docs/EN50067_RDS_Standard.pdf)
* EN 50067, Specification of the radio data system (RDS) for VHF/FM sound broadcasting in the frequency range 87.5 to 108.0 MHz.
## History
* 2026-02-01: add support for Raspberry Pi Zero and Zero 2.
* 2024-02-21: properly support non-ASCII characters.
* 2024-02-21: properly handle non-ASCII characters.
* 2015-09-05: support for the Raspberry Pi 2 and later models
* 2014-11-01: support for toggling the Traffic Announcement (TA) flag at run-time
* 2014-10-19: bugfix (cleanly stop the DMA engine when the specified file does not exist, or it's not possible to read from stdin)