SI470X Arduino Library
It is an Arduino Library for Si4701/02/03 FM tuner. This Silicon Labs device family integrates the complete functionalities for FM receivers, including RDS (Si4703). You can compile and run this library on most of board available on Arduino IDE (Examples: ATtiny85, boards based on ATmega328 and ATmega-32u4, ATmega2560, ARM Cortex, STM32, Arduino DUE, ESP32 and more).
This library can be freely distributed using the MIT Free Software model.
Copyright (c) 2019 Ricardo Lima Caratti.
Contact: pu2clr@gmail.com.
Contents
- Preface
- API Documentation
- MIT License
- Thanks
- Si470X Library features
- Installation
- SI470X and Registers
- SCHEMATIC
- Examples
- References
Preface
This project is about an Arduino library for the SI470X device. The communication protocol used by this library is the I²C. This library can be freely distributed using the MIT Free Software model. The SI470X is a FM DSP receiver from Silicon Labs with RDS/RBDS support. This document is aimed at the Arduino developers, radio experimenters, hobbyists and anyone interested in building a receiver based on the Si470X and will show you Arduino source codes, schematics, examples and tips to help you to build a receiver based on Arduino board and the SI470X devices.
{% include video01.html %}
I think the best way to start a project based on this device is to acquire a breakout board like the one shown in the following figure.
The board above or similar can be found on Sparkfun, eBay and Aliexpress. Also, there is the Si4703 Evaluation Kit from Silicon Labs.
See also
- PU2CLR Si4735 Library for Arduino. This library was built based on “Si47XX PROGRAMMING GUIDE; AN332” and it has support to FM, AM and SSB modes (LW, MW and SW). It also can be used on all members of the SI47XX family respecting, of course, the features available for each IC version;
- PU2CLR SI4844 Arduino Library. This is an Arduino library for the SI4844, BROADCAST ANALOG TUNING DIGITAL DISPLAY AM/FM/SW RADIO RECEIVER, IC from Silicon Labs. It is available on Arduino IDE. This library is intended to provide an easier interface for controlling the SI4844.
- PU2CLR AKC695X Arduino Library. The AKC695X is a family of IC DSP receiver from AKC technology. The AKC6955 and AKC6959sx support AM and FM modes. On AM mode the AKC6955 and AKC6959sx work on LW, MW and SW. On FM mode they work from 64MHz to 222MHz.
- PU2CLR KT0915 Arduino Library.
- PU2CLR SI470X Arduino Library.
MIT License
Copyright (c) 2019 Ricardo Lima Caratti
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE ARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Thanks
I would like to thank Mr. Libor Tomsik for correction on RDS issues.
Si470X Library features
This library uses the I²C communication protocol and implements most of the functions offered by Si470X (SI4701/02/03) IC family from Silicon Labs. This library also has primitive functions that make it easier for you to implement commands that may not have been implemented yet. See setAllRegisters, getAllRegisters, getStatus functions. It is worth noting, however, that this library is constantly improving. Check the API documentation before implementing a new function. It is likely that your demand is already implemented. The main features of this library are listed below.
- Open Source. It is free. You can use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software. See MIT License to know more.
- Built based on Broadcast FM Radio Tuner for Portable Applications - Si4702/03-C19 and Si4702/03-C19 - BROADCAST FM RADIO TUNERFOR PORTABLE APPLICATIONS;
- C++ Language and Object-oriented programming. You can easily extend the SI470X class by adding more functionalities;
- Available on Arduino IDE (via Manage Libraries). Easy to install and use;
- Seek tuning;
- Automatic frequency control (AFC);
- Automatic gain control (AGC);
- Programmable FM Band ranges;
- Programmable SPACE Settings;
- Programmable de-emphasis (50/75 μs);
- Stereo / Mono control;
- Real time rssi report;
- Volume control (including mute audio);
- RDS/RBDS Processor;
- Well-documented API.
Library Installation
The easiest method to install this library is via your Arduino IDE. All you have to do is:
- Select Tools menu;
- Select Manage Libraries option;
- In the text box (top windows), type PU2CLR or SI470X;
- Select the PU2CLR SI470X.
The video below shows how you can install this library via your Arduino IDE from Manage Libraries tool.
{% include libinstalling.html %}
Installing via the repository
With this approach, you will have the most current version of the library. However, it may not be the most stable version. This is because the current version is always in development. Prefer releases. Do you need some old version (release) of this library? If yes, check here.
First, you have to download this library in zip format.
After, unzip the SI470X-master.zip file in your Arduino Library folder.
- On Windows: "My Documents\Arduino\libraries"
- On MAC OS: ˜/Documents/Arduino/libraries
- On Linux: ˜/Documents/Arduino/libraries
SI470X and Registers
The SI4701/02/03 can be controlled by deal with register via I2C interface. The tebla below was extracted from Silicon Labs; document Si4702/03-C19 - "BROADCAST FM RADIO TUNER FOR PORTABLE APPLICATIONS"; Rev 1.1; page 22. This table shows the set of register that you can used to controle the device.
Source: Silicon Labs; document Si4702/03-C19 - "BROADCAST FM RADIO TUNER FOR PORTABLE APPLICATIONS"; Rev 1.1; Page 22.
Except that you need something very specific, the PU2CLR SI470X Arduino Library offers all the functions necessary for you to build your own FM receiver using an Arduino Board. If you need something else, this library implemented some basic functions to deal direct with the device registers shown above. See getShadownRegister, setShadownRegister, setAllRegisters, getAllRegisters and getStatus functions on https://pu2clr.github.io/SI470X/extras/apidoc/html/.
Schematic
As previously reported, in general, the SI4703 device is already sold in kit or breakout board format. So, the circuit below can help you to connect the arduino to the shield. In this case, you will not need the crystal, pull up resistors, capacitors and audio jack output. Also, the labels will guide you. The table bellow shows the connections.
Wire up on Arduino UNO, Pro mini or other based on ATmega 328.
SI4703 / Description | Arduino Pin |
---|---|
RESET (pin 5) | 14 / A0 |
SDIO (pin 8) | A4 |
SCLK (pin 7) | A5 |
Other schematics
Arduino Pro Mini and TFT 1.8 ST7735 SCHEMATIC
Attiny84, Encoder and Push Buttons Schematic
Attiny85 and Push Buttons Schematic
See examples here
Voltage operation
- The SI470X device is a 3.3V part. If you are not using a 3.3V version of Arduino, you have to use a kind of 5V to 3.3V bidirectional converter. It is important to say that just power the Si470X device with 3.3V from Arduino board is not enough. You have to be aware that the Arduino that operates with 5V, the digital pins and the I2C bus will send 5V signals to the Si470X device. That configuration can make the system unstable or damage the Si47XX device. If you are using a breakout board based on SI470X, check its operating voltage before connecting it to you 5V Arduino Board.