pu2clr / SI470X

It is an Arduino Library for the SI4702 and SI4703, BROADCAST RECEIVER.
MIT License
28 stars 13 forks source link
arduino arduino-ide arduino-library dsp fm fm-receiver library radio receiver si4701 si4702 si4703

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.

Donate

If you find this project useful, consider making a donation so that the author of this library can purchase components and modules for improvements and testing of this library. Click here to donate.

About Me

I hold a Master's degree in Educational Technology from the Federal University of Ceará, where I delved into the ways technology can enhance learning experiences. My passion for computer science led me to specialize in it, focusing on Distributed Systems Development with an Object-Oriented approach, at the University of Brasília. My academic journey began with a Bachelor's degree in Information Systems from the União Pioneira de Integração Social (UPIS-Brasília). Outside the classroom, my main hobbies are electronics and Amateur Radio.

Contents

  1. Preface
  2. API Documentation
  3. MIT License
  4. Thanks
  5. Si470X Library features
  6. Installation
  7. SI470X and Registers
  8. SCHEMATIC
  9. Source code - Arduino examples
  10. 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 SI4703 is a FM DSP receiver from Silicon Labs with RDS/RBDS support. This document is intended for Arduino developers, radio enthusiasts, hobbyists, and anyone interested in constructing a receiver using the Si4702 or SI4703 with the Arduino development platform.

{% 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.

SI4703 Shield

The board above or similar can be found on Sparkfun, eBay and Aliexpress. Also, there is the Si4703 Evaluation Kit from Silicon Labs.

The SI4702

Except for the SDR/RDBS feature, the SI4702 has all the functions available in the SI4703. It is easily found in the market and can be a cheaper alternative if the RDS/RBDS function is not needed.

The photo below shows the SI4702 module.

SI4702 Module

See also

More Arduino Projects developed by author

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.

  1. 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.
  2. Built based on Broadcast FM Radio Tuner for Portable Applications - Si4702/03-C19 and Si4702/03-C19 - BROADCAST FM RADIO TUNERFOR PORTABLE APPLICATIONS;
  3. C++ Language and Object-oriented programming. You can easily extend the SI470X class by adding more functionalities;
  4. Available on Arduino IDE (via Manage Libraries). Easy to install and use;
  5. Seek tuning;
  6. Automatic frequency control (AFC);
  7. Automatic gain control (AGC);
  8. Programmable FM Band ranges;
  9. Programmable SPACE Settings;
  10. Programmable de-emphasis (50/75 μs);
  11. Stereo / Mono control;
  12. Real time rssi report;
  13. Volume control (including mute audio);
  14. RDS/RBDS Processor;
  15. Well-documented API.

Library Installation

The easiest method to install this library is via your Arduino IDE. All you have to do is:

  1. Select Tools menu;
  2. Select Manage Libraries option;
  3. In the text box (top windows), type PU2CLR or SI470X;
  4. 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 %}

Watch the video

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.


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.

SI4702/03 Register Summary

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.

schematic with TFT, push buttons and encoder

Wire up on Arduino UNO, Pro mini or other based on ATmega 328.

SI4703 / Description Arduino Pin
RESET (pin 5) 15 / A1
SDIO (pin 8) A4
SCLK (pin 7) A5

Other schematics

Arduino Pro Mini and TFT 1.8 ST7735 SCHEMATIC

schematic with TFT, push buttons and encoder

Attiny84, Encoder and Push Buttons Schematic

schematic Attiny84, buttons and encoder

Attiny85 and Push Buttons Schematic

schematic Attiny85 and buttons

See examples here

Voltage operation

References