PU2CLR SI4735 Library for Arduino

Se você estiver entendendo este texto, talvez queira ler este documento em Português

Preface

	This document is aimed at the Arduino developers, radio experimenters, hobbyists and anyone interested in building a receiver based on the Si473X IC family from Silicon Labs. This project is about an Arduino library for the SI473X BROADCAST AM, SSB and FM/RDS RADIO RECEIVERS. Frequency ranges of AM and SSB modes are 150kHz to 30MHz, and FM mode is 64 to 108 MHz.

This library is intended to provide an easy-to-use interface for controlling the SI47XX (including the boards "PL102BA-S V:2.1 10628" and "NE928-10A V:01" based on SI4730) by using Arduino platform. It also has support to the SSB mode on SI4735-D60 and SI4732-A10 devices. The communication protocol used by this library is the I²C.

This library was built based on "AN332 Si47XX PROGRAMMING GUIDE REV 1.0" and AN332 REV 0.8 UNIVERSAL PROGRAMMING GUIDE AMENDMENT FOR SI4735-D60/SI4732-A10 SSB AND NBFM PATCHES. It also can be used on all members of the SI473X family respecting, of course, the features available in each IC version. Please, follow the contents below to get the most out of this document.

This library can be freely distributed using the MIT Free Software model.

Copyright (c) 2019 Ricardo Lima Caratti.

Contact: [email protected].

Contents

1. SI4735 Library construction history
2. Thanks
3. Library Features
4. License Copyright
5. Library Installation
6. Command line arduino-cli and setup
7. Other Arduino Libraries Developed by the Author
8. Groups and Forums
9. Your support is important
10. About the SI4732 and SI4735
11. Basic Schematic
12. Terminology
13. Documentation

• API Documentation
• About Class, Methods(functions) and custom data type structures
• PU2CLR SI4735 Arduino Library methods (functions)
• RDS support
• SSB support
• EEPROM support
• Digital Audio Support
• Using an external active crystal or signal generator with SI47XX
• Customizing PU2CLR Arduino Library

15. Hardware Requirements and Setup
16. SCHEMATIC

• All schematics
• Component Parts
• Tips to build
• Other schematics
  • Atmega328 based board and OLED
  • ESP32 based board
  • Standalone ATmega328 with or without external Crystal (SI4735-D60 and LCD 16x2)
  • Arduino / ATmega328 with Nokia 5110
  • Basic schematic with TFT
  • Arduino DUE/MEGA and touch TFT display
  • Attiny85 basic circuit
  • Bluepill - STM32F103C8 basic schematic
  • Android and iOS Remote Control for PU2CLR Arduino Library DSP receivers
  • External Mute Circuit
  • SI473X and external active crystal oscillator or signal generator
  • Band Pass Filter controlled by Arduino
  • Storing data into the internal EEPROM before shutdowning

17. Most Frequent Problems
18. Boards where this library has been successfully tested
19. Photos (Tools and Accessories)
20. References
21. Examples
    • Using Arduino Serial Monitor
    • LCD20x4, Encoder and buttons
    • OLED, Encoder and button
    • TFT and touch screen
    • ATTINY85
    • ESP32
    • ESP8266
    • STM32
    • FM RDS/RBDS
    • About the board based on SI4730-D60 labeled "PL102BA-S V:2.1 10628"
    • About the board based on Si4730 labeled "NE928-10A V:01"
    • Mobile Device as Remote Control to the SI4735 prototype
    • Auto Band Pass Filter examples
    • Famous sketches and kits from third parties based on this Library
    • Tools
22. Third Party Projects
23. Videos
    • Project examples made by the author
    • Third-party projects using this library
24. Commercial Receivers based on Si47XX Family

Attention

• The SI473X device can work from 1.6V to 3.6V. If you are not using a 3.3V Arduino board, that Arduino will send 5V signals to the SI473X device through the digital pins and the I2C bus. That configuration can make the system unstable or damage the Si473X device. To fix this, use a logic shifter chip that converts between 3.3V and 5V logic.
• This library has been successfully tested on many boards including: ESP32; STM32; Mega 2560; DUE; ATmega328 and Atmega32u4 based boards; ATtiny85, Raspberry Pi Pico (RP2040) and more. See Boards where this library has been successfully tested.
• The Si47XX IC family functionalities can be seen in the comparison matrix shown in table 1 (Product Family Function); pages 2 and 3 of the “Si47XX PROGRAMMING GUIDE; AN332 (REV 1.0)”.

Why do skilled developers generally use libraries?

Technically, no Arduino application needs a library. In some cases, not using libraries may be the correct decision. But there are some good reasons to consider using a library.

Libraries typically allow for easier design and maintenance of code. A library may also implement the functionality you need on multiple hardware choices, thus making the code more portable.

Imagine that you want to use an LCD or other display device in a project that monitors temperature and atmospheric pressure conditions. There are several good libraries for display devices available for Arduino users, most of the features you might want are implemented in these libraries. There is no point in re-inventing the wheel by avoiding a library. Unless you have require a feature that no library supports, it is generally wise to use a library, especially since a library can make porting code to different hardware easier.

Use of a library can reduce the programming complexity and boost application robustness. It makes life easier for other developers, and also for youself. You do not have to be a software engineer to understand why this is the case. A library in this way is similar to an IC. It is often possible to manually implement the functionality of many IC chips in a circuit, but it would dramatically increase cost, complexity, size and sometimes failure rate of a project. Circuits are often better when some functions are abstracted away inside an off-the-shelf IC chip. The user of an IC only needs to know how to interact with the chip, and not how the chip itself is wired.

Finally, if you already use a library to handle the IC2 bus (Wire.h), TFT, OLED, SPI devices, and Serial UART communication, then it makes sense to use a library to handle the SI473X devices. The PU2CLR Arduino Library can offer more comfort, development agility, and robustness to your project. Unlike closed source solutions, this library is open source. This means you can learn how the library works by studying the code, if you choose.

SI4735 Library construction history

I started my work on building an Arduino library for SI473X family devices in early November 2019. The initial idea was to build a receiver by using an Arduino board, a few components and the SI4735 device made by Silicon Labs. Checking some videos on Youtube, I realized that the receiver besed on Si4735-D60 could go far beyond the initial proposal, including listening to amateur radio and citizens band stations on SSB mode. Via forums and websites, I also realized that there was a great demand for experimenters who would like to see the SI4735 device working on SSB mode. So, instead of developing a simple receiver based on the SI4735, I decided to develop a library for the Arduino platform that would provide full support to the SI4735 and all SI473X device family as well.

With this library, more than 60 examples were developed using various display types. These examples can assist the experimenter in building their own receiver.

Judging by the groups created around the SI47XX devices, I estimate that this library is currently being used by thousands of experimenters, applications and commercial receivers. If you are an experimenter or a radio enthusiast and want to try to build your own receiver based on the SI473X devices, then this library is for you.

The following video is a little joke that shows the trajectory of the construction of this library. "PU2CLR SI4735 Arduino Library. IT IS OPEN SOURCE IT IS FREE. IT IS FOR YOU".

{% include libhistory.html %}

Thanks

• Mrs. Nancy Daniels Yoga, for sharing experiences and suggestions for noise reduction on the I2C bus and also for sharing the excellent board projects for the SI4732-A10 device
• Mr. Tom Nardi, for his great article "Multi-Band Receiver On A Chip Controlled By Arduino" on Hackaday website
• Mr. Gert Baak, PE0MGB, for library improvements suggestions and the Article Arduino All band radio with SI4735 by Gert PE0MGB
• Dr. George R Steber, WB9LVI for his great article NanoSSB RX - An Ultra Low Cost SSB Multiband Receiver on ARRL QEX Magazine (November/December 2021)
• Mr. Benjamin Neveu, for his article SSB Receiver Controlled by a Smartphone publised on ARRL QEX Magazine(September/October 2022)
• Mr. Jim Reagan, W0CHL, for contributions on circuit design and user interface
• Mr. Vadim Afonkin, for making available the SSBRX patches for SI4735-D60 on his Dropbox repository
• Mr. Luiz Carlos, PT2MC, for guidance on external mute circuits
• Mr. Thiago Lima, for sharing his board project based on the ESP32 and SI4732-A10 devices
• Mr. Francisco Scaramella, for the suggestions and contributions provided in the electronics field as well as for the testing of the functions implemented in this library
• Mr. David Kellmer (USA), for suggesting corrections on the documentation and sketches
• WH2Q, Morikaku Gotoh, for his suggestion about Automatic Volume Control on AM mode
• Mr. Diego Stanfield, for testing the SI4732-A10 with SSB
• All members of the Facebook groups "Si47XX for radio experimenters" and "Si47XX para radioescutas" for the suggestions and corrections during the development of this project.
• Mr. Toni, for his post SI4735 SI4732 all band radio receiver LW MW FM SW
• Mr. Scacchi Ugo, for the post HAM RADIO - ARDUINO SI4735 Based Radio
• Mr. Miguel Angelo Bartié, PY2OHH, for the post RECEIVER FM/MW/SW(AM SSB and CW) with SI4735 prototype
• Mr. Felix Angga, for his great receiver based on SI4735 interface - SlametRadio
• Mr. DAVID W ZANTOW, N9EWO, for his Reviews about ATS-25 / ATS25 / LW / MW / SW / FM DSP Receiver
• Mr. Dalton Herrewynen for documentation corrections and improvements.

Your support is important.

If you want to support this library development, consider joining this project via Github. Alternatively, make suggestions on new features and report errors if you find them. Thank you!

Go to contents

SI4735 Arduino Library Features

This library uses the I²C communication protocol and implements most of the functions offered by Si47XX (BROADCAST AM / FM / SW / LW RADIO RECEIVER) 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 setProperty, getProperty sendCommand, getCommandResponse and getStatusResponse functions and also How to customize PU2CLR Arduino Library. 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 function is already implemented. See the API documentation for this library. 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 AN332 SI47XX PROGRAMMING GUIDE (REV 1.0) and AN332 REV 0.8 UNIVERSAL PROGRAMMING GUIDE AMENDMENT FOR SI4735-D60 SSB AND NBFM PATCHES
3. C++ Language and Object-oriented programming. You can easily extend the SI4735 class by adding more functionalities. See Customizing PU2CLR Arduino Library
4. Available on Arduino IDE (via Manage Libraries). Easy to install and use. See Library Installation
5. Cross-platform. You can compile and run this library on most of boards supported by the Arduino IDE (Examples: ATtiny85, boards based on ATmega328 and ATmega-32u4, ATmega2560, ARM Cortex, STM32, Arduino DUE, ESP32 and more). See Boards where this library has been successfully tested
6. Simplifies projects based on SI4735
7. I²C communication protocol and Automatic I²C bus address detection
8. More than 120 functions implemented. You can customize almost every feature available on Si47XX family
9. More than 60 examples to guide the user
10. RDS support
11. SSB (Single Side Band) patch support
12. Clock reference selection (crystal or external clock reference)
13. FM Receive de-emphasis to 50 or 75 μs selection, AGC, AVC and filter controls, and more...

Go to contents

Groups and Forums

There is a Facebook group called Si47XX for Radio Experimenters where the purpose is exchanging experiences with projects based on Silicon Labs SI47XX IC family. You will be welcome to the group Si47XX for Radio Experimenters.

You can also be a member of group.io SI47XX for hobbyists

{% include groupio.html %}

Follow a project using this library on hackaday.io

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 WARRANTIES 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.

Go to contents

Library Installation

You can install this library on your Arduino environment using different methods. The best ways to do that are described below.

Installing via Arduino IDE

This is the easiest method to install this library.

The image below shows the Arduino IDE Manage Libraries interface.

The image below shows the PU2CLR Si4735 Library finding process.

The video below shows how to install the PU2CLR Arduino Library on your Arduino IDE.

{% include libinstalling.html %}

Installing via this repository

First, you have to download this library in zip format. After, unzip the SI4735-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

With that 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 so, check here.

Installing the most current version via arduino-cli

The commands below Install the latest version of the PU2CLR SI4735 Arduino Library from github. As said before, unlike a release (installed from Arduino IDE) this method installs the current version of the PU2CLR SI4535 Arduino Library (latest modifications even if not yet released).

On macOS or Linux

curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | sh
export ARDUINO_LIBRARY_ENABLE_UNSAFE_INSTALL=true
./bin/arduino-cli lib install --git-url https://github.com/pu2clr/SI4735

On Windows 10 or 11

Run the command shell (cmd / Command Prompt) and follow the steps below.

echo off  
curl -fsSL https://downloads.arduino.cc/arduino-cli/arduino-cli_latest_Windows_64bit.zip --output arduinocli.zip
tar -xf arduinocli.zip 
set ARDUINO_LIBRARY_ENABLE_UNSAFE_INSTALL=true
.\arduino-cli lib install --git-url https://github.com/pu2clr/SI4735

About library installation and programming setup see also:

• More about arduino-cli click here.
• About Arduino IDE, arduino-cli, SI4735 Arduino Library examples and programming setup, see the scripts below
  • On macOS or Linux
    • examples/lib_si4735_basic_install.sh - Installs arduino-cli and some libraries and boards used by some the examples
    • examples/install_all_libraries_and_boards.sh - Installs all libraries and all boards used by the examples
    • examples/compile_all.sh - compiles all examples and save the binaries in your Downloads folder
  • On Windows 10 or 11
    • examples/lib_si4735_basic_install.bat - Installs arduino-cli and some libraries and boards used by some the examples
    • examples/install_all_libraries_and_boards.bat - Installs all libraries and all boards used by the examples
    • examples/compile_all.bat - compiles all examples and save the binaries in your Downloads folder

Bords setup on your Arduino IDE

It will be useful if you intend to use ESP32, ESP8266, Teensy, Raspbery PI PICO, Arduino DUE, ATTiny etc.

On Arduino IDE, preferences, Aditional boards manager URls. See image below.

The list below refers to the board URLs used by the examples. You can remove the boards you do not want to use.

http://arduino.esp8266.com/stable/package_esp8266com_index.json 
http://dan.drown.org/stm32duino/package_STM32duino_index.json 
http://drazzy.com/package_drazzy.com_index.json 
https://files.seeedstudio.com/arduino/package_seeeduino_boards_index.json 
https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json 
https://github.com/stm32duino/BoardManagerFiles/raw/main/package_stmicroelectronics_index.json 
https://github.com/stm32duino/BoardManagerFiles/raw/master/STM32/package_stm_index.json 
https://mcudude.github.io/MegaCore/package_MCUdude_MegaCore_index.json 
https://mcudude.github.io/MightyCore/package_MCUdude_MightyCore_index.json 
https://mcudude.github.io/MiniCore/package_MCUdude_MiniCore_index.json 
https://raw.githubusercontent.com/DavidGuo-CS/OSOYOO_Arduino/main/package_osoyoo_boards_index.json 
https://raw.githubusercontent.com/VSChina/azureiotdevkit_tools/master/package_azureboard_index.json 
https://raw.githubusercontent.com/damellis/attiny/ide-1.6.x-boards-manager/package_damellis_attiny_index.json 
https://raw.githubusercontent.com/dbuezas/lgt8fx/master/package_lgt8fx_index.json 
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json 
https://raw.githubusercontent.com/nulllaborg/arduino_nulllab/master/package_nulllab_boards_index.json 
https://www.pjrc.com/teensy/package_teensy_index.json

After adding the Board URL you want to use, go to Tools menu, select the Boards item and then select Boards Manager... option. Finally, look for your board and install it.

See the ESP32 setup example on Arduino IDE

Go to contents

About the SI4732 and SI4735

The SI4732-A10 and SI4735-D60 are DSP receivers IC from Silcon Labs. They have great performance on AM, SSB (LW/MW/SW) from 150kHz to 30MHz and FM (VHF) from 64 to 108 MHz. It is important to note that the engineers and programmers at Silicon Labs did an excellent job by implementing all the internal resources in this IC family. This library implements just the interface that allows you to use the SI473X resources with Arduino based board controller. The SI473X can be programmed by sending commands and getting responses. You can control it via a microcontroller like Arduino using I²C communication protocol. To make the SI473X perform an action, the microcontroller has to send a set of bytes (command and arguments) that the device interprets and executes the given command. The image below illustrates the interaction between the MCU and the SI473X device.

Interaction between Arduino based board and SI473X devices via I²C interface

Functional Block Diagram

The image below shows the SI473X-D60 block diagram. It was extracted from Silicon Labs Si4730/31/34/35-D60 / BROADCAST AM/FM/SW/LW RADIO RECEIVER (page 21). Note that the author of this Library highlights in red the pin operating voltages that can be connected to the Arduino. Be aware of the operating voltage of the Arduino pins you will use in your project. Preferably use an Arduino with 3.3V operating voltage. If you are not using a 3.3V version of Arduino, you must use a kind of 5V to 3.3V converter on RST, SCLK, SDIO and SEN (depending on your project).

According to the Si47XX PROGRAMMING GUIDE/AN332, the Si4732-A10 has the same firmware FMRX component and AM_SW_LW RX component as that of Si4735-D60. It is considered as the most recent revision as D60. So, all descriptions related to the SI4735-D60 also apply to Si4732-A10. Including SSB patch support. See the Si4732-A10 block diagram below.

SI4735-D60 and SI4732-A10 I²C bus address

While the Si4735-D60 provides the 0x11 I²C bus address when the SEN pin is connected to the ground, the SI4732-A10 provides the same address when the SEN pin is connected to the +VCC. Also, this library provides the function getDeviceI2CAddress to detect the I²C bus address automatically. This way, you don't need to worry about this setup if you use this function. See getDeviceI2CAddress().

Hardware Requirements and Setup

This library has been written for the Arduino platform and has been successfully tested on many boards. See Boards where this library has been successfully tested

Arduino 5V and Si4735

• THE SI4735 IS A 3.3V PART. IF YOU ARE NOT USING A 3.3V VERSION OF ARDUINO or anothe board, YOU HAVE TO USE A KIND OF 5V-3.3V BIDIRECTIONAL CONVERTER. Also pay attention to the appropriated pinout of your board to select the correct interrupt (IRQ- if you are using), RST, SDIO and SCLK pins. The table below shows some Arduino board pinout.

Schematic

The main purpose of the schematic below (prototype) is to test the Si4735 Arduino Library. It does not intend to be a real radio for exigent listeners. However, it is possible to start with it and then, if you wish, you can include some devices to the circuit to improve, for example, its sensibility beyond other desired features. Click here to see a complete set of schematics and tips

The image below shows a version of Silicon Labs SSOP Typical Application Schematic connect to the host MCU (Arduino Pro Mini 3.3V). Pay attention to the Si4735-D60 SEN pin (16). When the SEN pin is connected to the ground, the I²C bus address is 0x11. When the SEN pin is connected to +3.3V, the I²C bus address is 0x63. By default, the "Si4735 Arduino Library" uses the 0x11 I²C bus address (SEN pin connected to GND). If you want to use the address 0x63 (SEN connected on +3.3V), see the functions (methods) getDeviceI2CAddress, setDeviceI2CAddress and setDeviceOtherI2CAddress.

Basic Schematic with SI4735-D60

Basic Schematic with SI4732-A10

Please, check the folder extras/schematic/. There, you will find other schematics with OLED, LCD, Nokia 5110, TFT, buttons and encoders setup. Also, check the comments at the beginning of each sketch example. You will find the SI473X, button, encoder, display and Arduino settings.

The picture below shows the SI4735-D60/SI4730-D60 pinout (SSOP)

The picture below shows the SI4732-A10 pinout (16L SOIC Package)

The picture below shows the SI473X pinout (QFN)

• The SI4735-D60 and SI4732-A10 have SSB patch support

• See some Shortwave antenna configuration on Si47XX ANTENNA, SCHEMATIC, LAYOUT, AND DESIGN GUIDELINES; AN383

• Pay attention to the appropriated Arduino pinout to select the correct interrupt (IRQ), RST, SDIO and SCLK pins. The previous table shows some Arduino board pinout.

• Be sure about the pinout of your device and Arduino connections. For example: the Si4735-D60/Si4730_D60 SEN pin (16 on SSOP version and 6 on QFN version) when connected to the ground, the I²C bus address is 0x11. When this pin is connected to +3.3V, the I²C bus address is 0x63. See the functions getDeviceI2CAddress and setDeviceI2CAddress to correct setup. If you follow the schematic used in this project, you do not need to do anything (the default I²C bus address is 0x11). If you do not know how this pin is configured on the board, use getDeviceI2CAddress.

The image bellow shows the Silicon Labs SSOP Typical Application Schematic.

Parts

The table below shows the component parts used to build the radio prototype based on Si4735 and used the Silicon Labs SSOP Typical Application Schematic as main source. However, some parts were included by the author of this project.

• *1: C7 and C8 are ceramic capacitors included by the author of this project. They are not present on the original Silicon Labs schematic. Actually, you can use also electrolytic capacitors. Values between 2.2uF to 10uF will work well.
• *2: R4 and R5 are pull-up resistor included by the author of this project. They are not present on the original Silicon Labs schematic. This will also depend on other devices connected to the same I²C bus. Always try to use the lowest possible value.

Notes from Silicon Labs Broadcast AM/FM/SW/LW Radio Receiver documentation (page 12):

• Place C1 close to VA and C4 close to VD pin.
• All grounds connect directly to GND plane on PCB.
• Pins 6 and 7 are not connects, leave floating.
• Pins 10 and 11 are unused. Tie these pins to GND.
• To ensure proper operation and receiver performance, follow the guidelines in “AN383: Si47xx Antenna, Schematic,
• Layout, and Design Guidelines.” Silicon Laboratories will evaluate schematics and layouts for qualified customers.
• Pin 8 connects to the FM antenna interface, and pin 12 connects to the AM antenna interface.
• Place Si473x-D60 as close as possible to the antenna and keep the FMI and AMI traces as short as possible.

Go to contents

The main Si4735-D60 and Si4732-A10 features

• FM (VHF) support (64–108 MHz)
• AM (MW) band support (520–1710 kHz)
• SW band support (2.3–26.1 MHz)
• LW band support (153–279 kHz)
• Allows firmware upgrade. Including the possibility of adjustments to demodulate SSB.
• Advanced AM/FM seek tuning
• Automatic frequency control (AFC)
• Automatic gain control (AGC)
• Digital FM stereo decoder
• AM/FM/SW/LW digital tuning
• SSB patch support
• RDS/RBDS processor
• Digital audio out (Attention: Crystal and digital audio mode cannot be used at the same time)
• I²C and SPI interface
• Great Programming Guide and additional documentation to deal with the device

Go to contents

Terminology

Go to contents

Documentation

{% include apidoc.html %}

This library has two documentation sources:

• SI4735 Arduino Library documentation generated by Doxygen (updated)
• Legacy documentation (not updated frequently)

Doxygen is a tools that can generate documentation from source code. This tools help the development team to keep the documentation updated.

If you prefer, you can also read the documentation directly from the SI4735.cpp and SI4735.h. These files are also well documented.

Main functions

This library has more than 120 functions. The table below shows the mains functions used in a regular receiver. Full details on the functions shown below can be read on https://pu2clr.github.io/SI4735/extras/apidoc/html/.

Go to contents

Defined Data Types and Structures

The Si47XX family works with many internal data that can be represented by data structure or defined data type in C/C++. These C/C++ resources have been used widely here. This approach made the library easier to build and maintain. Each data structure created here has its reference (name of the document and page on which it was based). In other words, to make the SI47XX device easier to deal with, some defined data types were created to handle byte and bits to process commands, properties and responses. The goal of this approach is separating data from code.

All data types defined in Si4735 Arduino Library are explained here

Public methods

This library was developed using the C++ language and the Object-oriented Programming approach. Methods are functions that belong to the class, in this case SI4735 class. Click here to go to API docummentation.

All methods defined in Si4735 class are explained here. The list below refers to the method groups implemented by the Si4735 class.

Si47XX device setup and startup

Methods of this group are useful to configure the way that the Si47XX devices have to be initiate.

Firmware Information

Allows to query the part number, chip revision, firmware revision, patch revision and component revision numbers.

Current Status

The Si4735 class has a set of methods to query the current frequency, RSSI, SNR, multipath, and the antenna tuning capacitance value (0-191).

Current AGC Status

Methods to query AGC status. Returns whether the AGC is enabled or disabled and it returns the gain index.

Si4735 filters configuration

The SI4735 class has a set of methods to setup filters on AM and SSB mode.

Audio

Methods to setup the audio mode (Digital or Analog), volume, mute etc.

RDS

This library implements some RDS features of the SI4735. All functions to deal with RDS are documented here. Below you have some videos showing the RDS functionalities implemented by the PU2CLR Si4735 Arduino Library.

{% include videoRDS2.html %}

{% include videoRDS1.html %}

See RDS example implementations for more details.

The list below points to some sketch examples that use RDS implementation.

• ATS-20 and 20+
• All band receiver with Nokia Display and RDS
• All Band receiver with Arduino DUE or Arduino Mega2560, TFT Touch and RDS
• TFT and Touch examples with RDS support

ATTENTION: While utilizing interrupts is often the preferred approach for capturing RDS messages, applications using Arduino based on ATmega328 face limitations as they can only utilize two pins for interrupts (D2 and D2). These pins are typically allocated for encoder control, leaving no interrupt-capable pins available for FM/RDS application control. In such scenarios, resorting to the polling approach becomes necessary for retrieving RDS messages.

The code below shows the polling approach to get RDS messages.

#include <SI4735.h>

#define RESET_PIN 16 // Arduino Nano / UNO pin A2

SI4735 rx;
void setup()
{
  rx.setup(RESET_PIN, FM_FUNCTION);
  rx.setFM(8400, 10800, currentFrequency, 10);
  delay(500);
  rx.setRdsConfig(3, 3, 3, 3, 3);
  rx.setFifoCount(1);
}


char *utcTime;
char *stationName;
char *programInfo;
char *stationInfo;

void showStationName() {
  if (stationName != NULL) {
    // do something
  }
}

void showStationInfo() {
  if (stationInfo != NULL) {
    // do something
  }
}

void showProgramaInfo() {
  if (programInfo != NULL) {
    // do something
  }
}

void showUtcTime() {
  if (rdsTime != NULL) {
    // do something
  }
}

void checkRds() {
 // The char pointer variables above will be populate by the call below. So, these variable (pointers) need to be passed by reference (pointer to pointer). 
 if (rx.getRdsAllData(&stationName, &stationInfo , &programInfo, &rdsTime) ) {
      showStationName(stationName); // you need check if stationName is null in showStationName
      showStationInfo(stationInfo); // you need check if stationInfo is null in showStationInfo
      showProgramaInfo(programInfo); // you need check if programInfo is null in showProgramaInfo
      showUtcTime(rdsTime); // you need check if rdsTime is null in showUtcTime
 }
}

void loop()
{
  .
  .
  .
  if (rx.isCurrentTuneFM()) {
    checkRds();
  }
  .
  .
  .
  delay(5);
}

SI4735 Patch Support for Single Side Band

The SI4735 class implements a set of methods to apply patches and deal with SSB mode. All API documentation about patches can be seen here.

The SSB patches used in some examples of this library were tested only on SI4735-D60 and SI4732-A10 devices. The updates used in those examples are unlikely to work on other SI47XX devices.

First of all, it is important to say that the SSB patch content is not part of this library. The patches used with test purpose here were made available by Mr. Vadim Afonkin on his Dropbox repository. Also, on Silcon Labs website, support and community, there is a topic called "SSB and/or ASK/FSK/nPSK demodulation on Si radio chips". If you follow that topic, you will see a post from a member called "DASM" making available a link to a patch for the SI4735-D60 and SI4732-A10. The structure of this file is a bit different if compared with Vadim's files amrx_6_0_1_ssbrx_patch_full_0x9D29.csg and amrx_6_0_1_ssbrx_patch_init_0xA902.csg. However, they have the same idea and can be easily adjusted for patching. If you have some experience with C, all you have to do is follow the recommendations of the SI47XX PROGRAMMING GUIDE AN332; page 219.

PLEASE NOTE THAT THE AUTHOR OF THIS LIBRARY DOES NOT ENCOURAGE ANYONE TO USE THE SSB PATCHES CONTENT FOR COMMERCIAL PURPOSES. IN OTHER WORDS, WHILE THIS LIBRARY SUPPORTS SSB PATCHES, THE PATCHES THEMSELVES ARE NOT A PART OF THIS LIBRARY.

What does SSB patch mean?

In this context, a patch is a piece of software used to change the behavior of the SI4735-D60 and SI4732-A10 device.

There is little information available about patching the SI4735-D60 and SI4732-A10. The following information is the understanding of the author of this project and it is not necessarily correct.

A patch is executed internally (run by internal MCU) of the device. Usually, patches are used to fix bugs or add improvements and new features over what the firmware installed in the internal ROM of the device offers. Patches for the SI4735 are distributed in binary form and are transferred to the internal RAM of the device by the host MCU (in this case, Arduino boards). Since the RAM is volatile memory, the patch stored into the device gets lost when you turn off the system. Consequently, the content of the patch has to be transferred to the device every time the device is powered up.

I would like to thank Mr Vadim Afonkin for making the SSBRX patches available for SI4735-D60 on his Dropbox repository. On this repository you have two files, amrx_6_0_1_ssbrx_patch_full_0x9D29.csg and amrx_6_0_1_ssbrx_patch_init_0xA902.csg. Please note that the patch content of the original file is in const hexadecimal representation in an ASCII text file. If you are not using C/C++ or if you want to load the files directly to the SI4735, you must convert the supplied hexadecimal constants into their numerical equivalents.

For example:

ATTENTION: The author of this project cannot guarantee that procedures shown here will work in your development environment. Proceed at your own risk. This library works with the I²C communication protocol to send an SSB extension PATCH to SI4735-D60 and SI4732-A10 devices. Once again, the author disclaims any and all liability for any damage or effects this procedure may have on your devices. Procced at your own risk.

All methods/functions to deal with SSB on Si4735-D60 can be seen here.

This library implements many SSB examples. See the table below.

{% include videoSSB.html %}

See SSB example implementations here.

Go to contents

EEPROM support

Depending on your MCU memory size, to use SSB mode may not be possible due to the large amount of memory required by the patch. To solve this problem this library implemented the function downloadPatchFromEeprom. This function reads the patch content from an external EEPROM and transfers it to the SI4732-A10 or SI4735-D60 devices. To run this function you must have an external I2C EEPROM device configured with your MCU and the Si4732/35 device on I²C bus. Also, the EEPROM must have the patch content generated by the sketch SI47XX_09_SAVE_SSB_PATCH_EEPROM stored in it. See folder TOOLS.

The example SI4735_06_SSB_EEPROM shows this functionality on an Arduino Pro Mini.

The example SI47XX_03_SSB_Tiny4kOLED implements this functionality on an ATtiny85.

To store the SSB patch content into an external EEPROM connected to your MCU via I2C bus, you need to run a special sketch first to program the EEPROM. See sketch SI47XX_09_SAVE_SSB_PATCH_EEPROM.

Attention: The full ssb patch needs about 16KB on eeprom. All data that you have stored before into your eeprom device will be lost after the execution of the sketch SI47XX_09_SAVE_SSB_PATCH_EEPROM.

The EEPROM device used for testing was the AT24C256 Serial I²C Interface

Watch the video: ATtiny85 working with SI4735-D60 and SSB

{% include eeprom.html %}

SAVING RECEIVER STATUS INTO THE INTERNAL EEPROM

You can store useful receiver data into the internal Arduino EEPROM. Current band information, Bandwidth, step, mode, audio volume and filter are examples of data that can be stored into the internal EEPROM and restored when you turn the receiver on again. See the section Storing data into the internal EEPROM before shutdowning for details.

Digital Audio support

First of all, passive Crystal and digital audio modes cannot be used at the same time on SI47XX devices. The document Si47XX ANTENNA, SCHEMATIC, LAYOUT, AND DESIGN GUIDELINES; AN383; rev 0.8; page 6; you will find the following note: "Crystal and digital audio mode cannot be used at the same time". So, for Digital Audio, you have to remove the crystal, and capacitors connected to the crystal from the circuit.

This library supports the external clock reference and has implemented the digital audio functions. You can configure digital audio and external clock reference by using the functions: setup, radioPowerUp, digitalOutputFormat, digitalOutputSampleRate, setRefClock and setRefClockPrescaler.

The schematic below shows the Digital Audio setup using an SI4735-D60 with an ESP32 Devkit.

You can check the schematic above via SI47XX_06_ESP32/DIGITAL_AUDIO_SERIAL_PLOTTER example

The table below shows the SI4735, DAC MAX98357A and ESP32 wireup

The table below shows the SI4735, DAC CJMCU and ESP32 wireup

See the API Documentation for more details.

Customizing PU2CLR Arduino Library

Maybe you need some Si47XX device functions that the PU2CLR SI4735 Arduino Library has not yet implemented. Also, you may want to change some existent function behaviors. This topic describes some approaches to add new SI473X features to your application.

Please, check the API documentation before implementing something you think is new. It is possible that what you want has already been implemented.

Primitive Functions

This library has primitive functions that make it easier for you to implement commands that may not have been implemented yet. The methods setProperty, getProperty sendCommand, getCommandResponse and getStatusResponse can be used to setup the SI473X devices directely. They can also be useful to check some features of the SI473X devices. To use those methods you have to be guided by the "AN332 Si47XX PROGRAMMING GUIDE REV 1.0" and AN332 REV 0.8 UNIVERSAL PROGRAMMING GUIDE AMENDMENT FOR SI4735-D60 SSB AND NBFM PATCHES Silicon Labs documentation. If you are familiar with bit operators in C / C ++, you will have no problem in using the above functions.

The example below configures the GPIO by sending the 0x81 (GPIO_SET) command(AN332 Si47XX Programming guide page 195).

SI4735 rx;
uint8_t args[] = {0b00001010} // will set the GPIO 1 and 3 to high
uint8_t response[0]

.
.
.

rx.sendCommand(0x81,1,args);
.
.
rx.getCommandResponse(1,response);
.
.
.

Extending the SI4735 class

The best way to customize the PU2CLR SI4735 Arduino Library for your needs is extending the current version of the library by using C++ OOP approach. For example:

#include <SI4735.h>
class MyCustomSI4735 : public SI4735 { // extending the original class SI4735
  public:
    // New functions / methods
    int methodA() {    // some SI47XX command that PU2CLR SI4735 Arduino Library does not implement
      return 0;
    }

    int methodB() {    // another SI47XX command that PU2CLR SI4735 Arduino Library does not implement
      return 1;
    }

    // Overwriting existent methods
    void setTuneFrequencyAntennaCapacitor(uint16_t capacitor) { 
      // Here, your setTuneFrequencyAntennaCapacitor code that will replace the original code 
      // Tip: currentFrequencyParams is a protected member of SI4735 class and can be referred in your code
      currentFrequencyParams.arg.ANTCAPH = 0;         // it is just an example 
      currentFrequencyParams.arg.ANTCAPL = capacitor; // it is just an example 
      return;
    }

    void reset() {
      /// your reset code that will replace the original reset code 
      pinMode(resetPin, OUTPUT);
      delay(1);
      digitalWrite(resetPin, LOW);
      delay(50);
      digitalWrite(resetPin, HIGH);
    }
};

MyCustomSI4735 radio; // the instance of your custom class based on SI4735 class

void setup()
{
  Serial.begin(9600);
  while (!Serial);
  Serial.println("Customizing Si4735 class example.");
  radio.setup(12, 0); // Arduino pin 12 as reset and FM mode (0)
  radio.setFM(8400, 10800, 10390, 10); 
  // Setting the tune capacitor with your code instead Si4735 library code.
  radio.setTuneFrequencyAntennaCapacitor(100);
  // Calling new functions implemented by you.
  Serial.println(radio.methodA());
  Serial.println(radio.methodB());
}

void loop() {
  // Your code with your custom SI4735 library.
}

If you use that approach, all you have to do is download the current version of PU2CLR SI4735 Arduino Library. Instead of using the PU2CLR SI4735 Arduino Library class directly, you can use your own class that extends the original class. This way, you always have the current version of the library customized for your needs. So, no extra work will be needed when you update the PU2CLR SI4735 Arduino Library. In other words, your custom code will always be synchronized with the PU2CLR SI4735 Arduino Library code.

Please, check the API documentation before implementing something you think is new. It is possible that what you want has already been implemented.

See also:

• How to use C++ Classes in Arduino IDE without creating a Library
• Arduino the Object Oriented way

Go to contents

Tips to build

• Try to follow what Silicon Labs recommends
• Start building the minimum circuit and test it
• Check if the Si47XX RESET pin (15 on SSOP version or 5 on QFN version) is connected on your MCU (Arduino) pin defined as RESET the (most of schematics and examples of this project this pin is the digital pin 12)
• Use the minimum sketch to test the minimum circuit. The first three examples of this project (see examples folder) can be used to test the minimum circuit
• Try not improvising the I²C bus connection. Start using a 3.3V MCU (Arduino Pro Mini 8MHz or DUE, ESP32 or other 3.3V device) to connect with SI4735
• If you are using the Arduino Pro Mini 3.3V board, select the correct Processor on Arduino IDE (ATmega328, 3.3V, 8MHz)
• Select the correct pullup resistor. Two variables to consider: the internal pullup resistors in some micro controllers, and the capacitance of the I²C bus. Some devices can enable or disable their pullup resistors. However, the bus capacitance is not easy to measure. As a result, it might be difficult to calculate the correct resistor value. To find a usable resistor value, start with a high pullup resistor to I²C bus and then reduce it until the best value. For example: start with 10K and try to reduce the value to 4,7K, 3,3K, 2.2K etc. Select the lowest resistor you can.
• I²C bus devices are available in different speeds. If you are using an I²C display device, check if its speed is compatible with the Si47XX and also with the current speed used by the master MCU
• Using different voltage levels between I²C devices can be unsafe and can destroy parts connected on I²C bus, specially the Si47XX
• It is important to wire all your I²C devices on the same common ground.
• If you are using Arduino Mini Pro, UNO or similar, pay attention to the pin 13 and the use of an internal pull-up resistor. This pin has a LED and a resistor connected on the board. When this pin is set to HIGH, the LED comes on. If you use the internal pull-up resistor of the pin 13, you might experience problems due to the voltage drop caused by the LED circuit. If this occurs in your project, you can do:
  • Use the pin 14 instead pin 13. This pin is the A0 (Analog). But you have to refer it by 14 to use it as digital pin
  • Change the circuit and sketch to use external pull-up on pin 13
  • Remove the LED or resitor connected to the LED from the board.
• Use only batteries to power your circuit. Receptions in LW, MW and SW can be interfered with by power supplies connected to the grid.
• See some Shortwave antenna configuration on Si47XX ANTENNA, SCHEMATIC, LAYOUT, AND DESIGN GUIDELINES; AN383

Go to contents

Most Frequent Problems

The system does not start.

Depending on your setup, the system can hang at the beginning.

It has been observed in several tests. Some tips:

1. Avoid using a computer connected to the mains during testing. The electrical grid can disturb the communication between the Arduino based board and the SI47XX device
2. The RESET pin is not configured properly. Check the connection of the SI47XX pin 15 (RST) and the Arduino based board
3. Try to use a 22K pull-up on Arduino Board pin used for resetting (RESET PIN). It may be needed if you are using some Arduino based boards like (Atmega32, Atmega128 etc)
4. If the SI47XX pin 16 (SEN) is grounded, the I²C bus address must be 0x11, otherwise it must be 0x63 (the default I2C bus address is 0x11). Preferably, keep this pin grounded
5. Check if the pins 17 (SCLK / SCL) and 18 (SDIO / SDA) of the SI47XX device are correctly connected to the Arduino board pins
6. Check the pull-up resistors connected to the pins 17 (SCLK / SCL) and 18 (SDIO / SDA) of the SI47XX device
7. Check the voltage on SI47XX pin 15 (RST). It should be 3.3V. All digital pins of your Arduino must have 3.3v when in HIGH condition. If it is greater than 3.3V, probably you are using an 5V board
8. If you are using the Arduino Pro Mini 3.3V (8MHz), be sure you selected the correct board on Arduino IDE Tools menu, Processor: "Atmega328P (3.3V, 8MHz)". By default, the Arduino IDE uses the 5V processor version
9. Do not try to power an ATmega328 Arduino Board designed to work with 5V and 16MHz with a 3.3V supply. That configuration will make your system unstable. See ATmega328P Datasheet
10. Do not try to power your Arduino based board designed to work with 3.3V with greater voltage. See the technical specifications of your Arduino Board and remember that the maximum voltage of the SI47XX MCU CONTROL INTERFACE is 3.6V
11. Check the external crystal and its capacitors connections.

Attention: The pins numbers above is considering Si473x-D60(SSOP) package.

On FM mode, the receiver jump from a station to another station without any action.

If you are using Arduino Mini Pro, UNO or similar, pay attention to the pin 13 and the use of on internal pull-up resistor. This pin has a LED and a resistor connected on the board. When this pin is set to HIGH, the LED comes on. If you use the internal pull-up resistor of the pin 13, you might experiment problem due to the voltage drop caused by the LED circuit. If this occurs in your project, do one of the following:

• Use the pin 14 instead of pin 13. This pin is the A0 (Analog). But you have to refer it by 14 to use it as digital pin
• Change the circuit and sketch to use external pull-up on pin 13 or
• Remove the LED or the resitor connected to the LED from the Arduino Board.

After power up or try to tune the receiver, the display shows LW and 0 kHz

This problem can be a little complicated to solve. It can occur in many situations. I have observed that very few times in my experiments:

• When I am powering the system using the computer USB and the computer is connected to the grid, it might occur. Please, test your system using only batteries.
• If you are using the Arduino Pro Mini 3.3V (8MHz), be sure you have selected the correct board on the IDE Tools menu, Processor: "Atmega328P (3.3V, 8MHz)". By default, the Arduino IDE uses the 5V processor version.
• Check if the RESET pin of the SI473X and the controller are well connected.
• This problem also can be caused by the external crystal connected to the SI473X device (in general 32768K). This crystal needs a minimum delay to become stable after a reset or power up command. Currently, this delay is 10ms. Try to increase that delay by using the method setMaxDelayPowerUp.

Example:

void setup() {
 
 si4735.setMaxDelayPowerUp(500); // now the delay after power up will be 500 ms
 si4735.setup(RESET_PIN, FM_FUNCTION);

}

• Also, for some reason, the frequency switching needs a little delay (the default value is 30ms). Try to increase that delay by using the method setMaxDelaySetFrequency.

Example:

void setup() {
  si4735.setMaxDelaySetFrequency(50);
  si4735.setup(RESET_PIN, FM_FUNCTION);
}

• Finally, if no previous attempt could not solve the issue, check that the crystal is working correctly.

I cannot tune satisfactorily to any station on LW, MW or SW

• Please, use only batteries to power your system up on LW, MW or SW
• Check your circuit on AMI pin of the Si47XX device
• Keep as far as possible from noise sources (LED light bulb, computers and any device connected to the power grid)
• Try to find a suitable size for the antenna wire. Too long can be a big noise pickup. If too short, it may not be enough to pick up radio stations.

When the receiver starts or when I switches it from FM to AM and vice-versa, I have loud click in the speaker

Some users may be uncomfortable with the loud popping of the speaker during some transitions caused by some Si47XX device commands. This problem occurs during the receivers transition from the power down to power up. Every time the user changes the mode (FM to AM or AM to FM, Si47XX devices mnust be powered down and powered back up which causes the click sound.

The SI473X devices have HIGH DC (DC bias) component in the analog audio output pins (SI4735-D60 pins 23 and 24). When the device goes to power down mode, the voltage on the audio pins drops to 0V. The device does it internally and there is no way to avoid that. When the device goes to power up, those audio pins suddenly go to the HIGH DC again. This transition causes the loud pop in the speaker. So far, the author of this library has not found an internal SI473X device solution to solve the loud popping of the speaker. The internal SI473X mute or volume commands will not stop the clicking sound. However, it is possible to solve this problem by adding an extra mute circuit and control it by the MCU (Atmega, ESP32, STM32, ATtiny85 etc).

The schematic below shows this approach.

Considering that you are using a MCU based on Atmega328. When the D14 (A0) is HIGH the Si47XX output audio will be drained to the ground. At that condition, no audio will be transferred to the amplifier input and, consequently, to the speaker. So, no loud click in the speaker.

When the D14 is LOW, most of signal audio output from the Si47XX will be transfered to the input of the amplifier.

The code below shows all you have to do in your sketch to implement this resource.

#include <SI4735.h>
#define AUDIO_MUTE 14      // Pin A0 - Switch AGC ON/OF

Si4735 r;

void setup() {
  .
  
  // It is all you have to do to control an external audio mute circuit if you have one. 
  r.setAudioMuteMcuPin(AUDIO_MUTE); // Tells the system to control an external audio mute circuit. 

  r.setup(RESET_PIN, -1, 1, SI473X_ANALOG_AUDIO); // Starts on FM mode and ANALOG audio mode. 
  .
  .
  .

} 

{% include audiomute.html %}

Some low power audio amplifiers IC also implement a mute circuit that can be controlled externally. You can find this resource on LM4906, LM4863, KA8602B, MC34119, PAM8403 and HT82V739 devices.

Go to contents

Saving Memory on ATmega328 applications

• Use MiniCore board setup instead regular Arduino Atmega328 setup. You can save about 1KB by removing the bootloader and using LTO option
• You can also use the regular Arduino setup and use the hex file without bootloader (use xloader application in this case)
• Do not use the String class, sprintf or dtostrf functions to format numbers. Use itoa function or your own implementation to convert number to char array. You can save about 2KB. See example below.

/**
  Converts a number to a char string and places leading zeros. 
  It is useful to mitigate memory space used by sprintf or generic similar function
*/
void convertToChar(uint16_t value, char *strValue, uint8_t len)
{
  char d;
  for (int i = (len - 1); i >= 0; i--)
  {
    d = value % 10;
    value = value / 10;
    strValue[i] = d + 48;
  }
  strValue[len] = '\0';
}

TIP: The SI4735 Arduino Library has a function to format numeric values like frequency, bfo, rssi etc. See convertToChar documentation

Example:

.
.
.
void showFrequency()
{
  char freqDisplay[10];

  if (band[bandIdx].bandType == FM_BAND_TYPE)
  {
    rx.convertToChar(currentFrequency, freqDisplay, 5, 3, ','); // Formats the FM frequency
  }
  else
  {
    if (band[bandIdx].bandType == MW_BAND_TYPE || band[bandIdx].bandType == LW_BAND_TYPE)
      rx.convertToChar(currentFrequency, freqDisplay, 5, 0, '.'); // Formats LW and MW frequency
    else
      rx.convertToChar(currentFrequency, freqDisplay, 5, 2, '.'); // Formats SW frequency
  }
  showValue(0, 0, oldFrequency, freqDisplay, 2, 11);
}
.
.
.

• Regarding SSB patch, use the patch_ssb_compressed.h and downloadCompressedPatch instead init.h and downloadPatch. It will save about 1K of memory.

Explanation: The first byte of each line of the original patch content is either a 0x15 or 0x16 command. To shrink the patch size stored on the controller, the first byte on each line is omitted. Since the first byte on each line is either 0x15 or 0x16, it is not necessary to explicitly store them. Since most lines start with the 0x16 byte, only the line numbers beginning with 0x15 must be stored. The downloadCompressedPatch method will insert the value 0x15 when it's on a line that is marked as beginning with 0x15, and will insert 0x16 on all other lines.

#include <patch_ssb_compressed.h> // SSB patch for whole SSBRX initialization string

const uint16_t size_content = sizeof ssb_patch_content; // See ssb_patch_content.h
const uint16_t cmd_0x15_size = sizeof cmd_0x15;         // Array of lines where the 0x15 command occurs in the patch content.



void loadSSB()
{
  .
  .
  rx.setI2CFastModeCustom(500000);
  rx.queryLibraryId(); // Is it really necessary here? I will check it.
  rx.patchPowerUp();
  delay(50);
  rx.downloadCompressedPatch(ssb_patch_content, size_content, cmd_0x15, cmd_0x15_size);
  rx.setSSBConfig(bandwidthSSB[bwIdxSSB].idx, 1, 0, 1, 0, 1);
  rx.setI2CStandardMode();
  .
  .

}

Boards where this library has been successfully tested

This library can be useful to develop cross-platform software. So far, it has been successfully tested on the architectures shown below.

The table below shows the some boards where this library has been successfully tested.

1. More about ESP boards on ESPRESSIF Development Boards.
2. More about BlueDuino on Seed.
3. On Arduino.cc you can see the technical specification about many board.
4. It seams that in some ESP32 board, the I²C bus is not configured properly by default. However, you can set almost any pin on ESP32 to setup I²C capabilities. All you have to do is call Wire.begin(SDA, SCL); where SDA and SCL are the ESP32 GPIO pins. See the folder examples to check how to use ESP32 devices.
5. You can use the pin 12 too.
6. Arduino Nano 33 BLE only supports 3.3V I/Os and is NOT 5V tolerant so please make sure you are not directly connecting 5V signals to this board or it will be damaged. Also, as opposed to Arduino Nano boards that support 5V operation, the 5V pin does NOT supply voltage but is rather connected, through a jumper, to the USB power input.

The table below shows some SI473X, SI474X devices and Si4730 based-boards where the PU2CLR SI4735 Arduino Library has been successfully tested.

1. Acording to Silicon Labs guide AN332, the SI4732-A10 has the same firmware FMRX component and AM_SW_LW RX component as that of SI4735-D60. See Si47XX PROGRAMMING GUIDE; AN332; page 2. So, like the SI4735-D60, it is possible to use it to listen to SSB mode with the SI4732-A10.

2. Although the SI4730-D60 does not officially support SW, several tests performed during the development of this library, as well as tests performed by other experimenters, it was observed excellent performance of this IC on HF/SW band. See "Si47XX PROGRAMMING GUIDE; pages 2 and 3; Table 1 - Product Family Function" for more details. See the video Si4730-D60 ultimate testing (FM/RDS + LW + SW). It is important to note that the author of this library does not guarantee all SI4730-D60 devices sold on the market will work in LW and SW bands and FM with RDS as well.

3. Digital Audio setup (I²S) did not work during the tests.

The videos below show the PU2CLR Si4735 Arduino Library working on some boards

{% include videocross.html %}

Go to contents

Photos (Tools and Accessories)

This item describes some tools and accessories you might need to build your radio based on SI4735. Most of the accessories used in this project you will find on eBay and AliExpress.

Arduino Pro Mini	Arduino Pro Mini

• Pro Mini 3.3V 8MHz Atmega328 Replace ATmega128 Arduino Compatible Nano

FT232 USB Adapter	FT232 USB Adapter

• FT232RL 3.3V/5.5V FTDI USB to TTL Serial Adapter Module for the Arduino Mini Port

Magnifier	Solder

• 50-1000X Magnifier Wireless WiFi Electric Microscope 2.0MP 8LED Endoscope Camera
• Soldering Iron Station with Temperature Control

Adapter for SI4735	Soldering Accessories

• SO SOP SOIC SSOP TSSOP 24 Pin to DIP 24 Adapter PCB Board Converter
• 50g Soldering Paste Solder Flux Paste Cream for PCB PGA SMD BGA
• BGA SMD Soldering Paste Flux

It was a bit hard to solder the kind of CI on adapter. However, by using a electronic magnifier it was possible.

SI4735 soldered on adapter

Si4735 on Adapter	Si4735 on Adapter

Go to contents

Protoboard

The basic circuit built on protoboard is based on the “SSOP Typical Application Schematic”, suggested by the Silicon Labs Documentation (Si4730/31/34/35-D60-BROADCAST AM/FM/SW/LW RADIO RECEIVER; page 19). Two pull-up 4.7K resistors were added on I²C bus (It is an arbitrary value. Actually, this value may vary depending on your devices connected to the bus). Also, it is recomended to add two 4.7uF capacitors between the CI audio output and audio amplifier. The photos below do not show these capacitors. See C7 and C8 on schematic.

The figure below shows a suggestion to shrink the prototype and connections. If you are just doing prototyping, I recommend this approach due to the short connections with the Si4735 (recommended by the manufacturer).

The configuration above connected to Arduino Pro Mini is shown below.

The following photo shows the most common prototyping approach. Use this approach if you don't want to solder the components on the adapter plate.

The figure above shows the very basic shematic implementation (no Button or Encoder). See the folder examples for more details and other configuration with LCD and OLED

References

1. Silicon Labs Si4737 WB/AM/FM Stereo/RDS single-chip receiver HAL library for Arduino
2. BROADCAST AM/FM/SW/LW RADIO RECEIVER
3. SI47XX PROGRAMMING GUIDE (REV 1.0)
4. AN332 REV 0.8 UNIVERSAL PROGRAMMING GUIDE AMENDMENT FOR SI4735-D60 SSB AND NBFM PATCHES
5. DIGITAL METHOD OF SSB MODULATION
6. Understanding the 'Phasing Method' of Single Sideband Demodulation
7. Design a modulator and demodulator SSB by DSP processor TMS320C50 for PLC systems
8. Installing Additional Arduino Libraries
9. Specification of the radio data system (RDS) for VHF/FM sound broadcasting in the frequency range from 87,5 to 108,0 MHz
10. Radio Data System
11. RDS Encoder
12. RDS in Europe, RBDS in the USA –What are the differences and how canreceivers cope with both systems?
13. RBDS & RDS PTY Codes and Program Types
14. Using RDS/RBDS with the Si4701/03
15. Si47XX ANTENNA, SCHEMATIC, LAYOUT, AND DESIGN GUIDELINES; AN383
16. Other implementations using Si4735 and Arduino
    • This is a git fork of [Michael Kennedy's]
    • Arduino Si4735 radio library
    • SI4735 AM & FM Receiver Shield
    • Si4735 Digital AM/FM Radio Receiver
    • Ryan Owens for SparkFun Electronics
    • Silicon Labs Si4737 WB/AM/FM Stereo/RDS single-chip receiver HAL library for Arduino
    • Enhanced Software for Elektor DSP-Radio (Si4735)
17. I²C
    • Taking The Leap Off Board: An Introduction To I²C Over Long Wires
    • Difference between I²C and SPI
    • Issues with the I²C (Inter-IC) Bus and How to Solve Them
    • I²C Manual; Application Note; AN10216-01
    • IMPROVING NOISE IMMUNITY FOR SERIAL INTERFACE; A Lattice Semiconductor White Paper; July 2014
    • Bus Buffers Simplify Design of Large, Noisy I²C Systems
    • Common Problems In Systems
    • Tutorial: Arduino and the I2C bus – Part One
18. Forums
    • How to reduce I²C bus noise
    • Radio interferes with I²C bus communication
    • Reducing Noise on an I²C bus line
    • Noise on I²C bus
    • Noises on the I²C BUS
19. "Multi-Band Receiver On A Chip Controlled By Arduino" commented by Tom Nardi on Hackaday
20. C/C++ for Arduino
    • How to use C++ Classes in Arduino IDE without creating a Library
    • Arduino the Object Oriented way
    • Arduino Object Oriented Programming (OOP)
    • Writing a Library for Arduino

Go to contents

Videos

Here you can see some experiments using this library. Watch them.

{% include video01.html %}

Project examples made by the author

• Si4735 All in One Receiver running on Arduino Pro Mini 3.3V (8MHz) and TFT Display
• Si4735 All in One Receiver with TFT Touch Screen
• Si4735 Arduino Library example. OLED Application.
• SI4735 Arduino Library and a simple FM and AM radio implementation
• SI4735 ARDUINO LIBRARY BANDWIDTH TEST
• Si4735 Arduino Library and SSB Support (Listening to a QSO on 20 meters)
• Evaluating SSB audio from the SI4735-based radio prototype
• How to "SI4735 Arduino Library and ATtiny85"
• SI4735 Arduino Library working with ATtiny85
• NE928-10A V:01 board working with "Si4735 Arduino Library"
• SI4730-D60 labeled "PL102BA-S V:2.1 10628"
• Si4735 Arduino Library and Bluepill STM32F103

Third-party projects using this library

• Si4735 - Si5351FM AM SSB / All-Mode Receiver By LZ1PPL
• SI4735 SSB
• All Band Radio with a Nice Interface
• SI4735 11 ALL IN ONE TEST OLED ver from jg3pup
• New HF SSB receiver made of Si4735 is done!
• SSB DSP radio (Si4735) version 5 revision 2
• Si4735 LCD版でSSBを受信
• Wefax576 via SI4735 with audio cable fldigi
• SI4735 Radio KIT prototype
• SI4735 KIT. First LF test
• SI4735 KIT. First SSB test
• SI4735 KIT - First FM test
• Great interface by Gert Baak
• Arduino All band radio with SI4735 by Gert PE0MGB
• si4735 betatest radio
• Dual Conversion HF Receiver Silabs Si4732/Si4735 and Si5351
• Manufacture of 50MHz AM QRP transceiver TRX-505 / JR0DBK
• Rádio FM V3 (LCD 16x2) by Andersom
• SI4735 SI4732 all band radio receiver LW MW FM SW
• HAM RADIO - ARDUINO SI4735 Based Radio
• RECEIVER FM/MW/SW(AM SSB and CW) with SI4735 prototype
• ATS-25 / ATS25 / LW / MW / SW / FM DSP Receiver (with Bernard Binns FREE 4.0 Firmware review
• SI4735 D60 TFT 2.8" ESP32 ALL BAND RADIO
• DSP RADIO Multi Band AM/MW/LW/SW-SSB/FM with RDS
• M5StickC Si4730 RADIO

Videos that powered the standalone SI473X devices:

• Prepper Radios: SI4732 All Band Shortwave Radio
• AM/FM/SW/LW радиоприемник Si4730/Si4735
• Si4735 All in One Receiver running on Arduino Pro Mini 3.3V (8MHz) and TFT Display

Go to contents

Commercial Receivers based on Si47XX Family

The table below shows some radios based on SI47XX

Go to contents

Other Arduino Libraries Developed by the Author

• 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. The KT0915 is a full band AM (LW, MW and SW) and FM DSP receiver that can provide you a easy way to build a high quality radio with low cost.
• PU2CLR BK108X. The BK1086 and BK1088 are DSP receivers from BAKEN. The BK1088 is a BROADCAST FM and AM (LW, MW and ) RECEIVER and BK1086 is a subset of the BK1088 (it does not have LW and SW acording to the Datasheet).
• PU2CLR RDA5807 Arduino Library. The RDA5807 is a FM DSP integrated circuit receiver (50 to 115MHz) with low noise amplifier support. This device requires very few external components if compared with other similar devices. It also supports RDS/RBDS functionalities, direct auto gain control (AGC) and real time adaptive noise cancellation function.
• PU2CLR SI470X Arduino Library. It is a Silicon Labs device family that integrates the complete functionalities for FM receivers, including RDS (Si4703).
• PU2CLR MCP23008 Arduino Library. It is an Arduino Library to control the MCP23008 8-Bit I/O Expander. The MCP23008 device provides 8-bit, general purpose, parallel I/O expansion. It can be controlled via I2C bus applications. It is a great and inexpensive device that allow you to add more devices to be controlled by your Arduino board via I2C protocol.
• PU2CLR - PCF8574 Arduino Library. It is an Arduino Library to control the PCF8574 8-Bit I/O Expander. The PCF8574 device provides 8-bit, general purpose, parallel I/O expansion. It can be controlled via I²C bus applications. It is a great and inexpensive device that allow you to add more peripherals to be controlled by your Arduino board via I²C protocol.

More Arduino Projects developed by author

• Multipurpose signal generator with SI5351. It is a multipurpose signal generator controlled by Arduino. This project uses the SI5351 from Silicon Labs. The Arduino sketch is configured to control the SI5351 with three channels from 32.768KHz to 160MHz and steps from 1Hz to 1MHz.
• Shortwave Arduino Transmiter. This project is about a shortwave transmitter from 3 MHz to 30 MHz. It uses the SI5351 oscillator from Silicon Labs controlled by Arduino. Also, you can use it with a crystal oscillator. In this case, you will not need the SI5351 device and Arduino.
• Android and iOS Bluetooth Remote Control for PU2CLR Arduino Library DSP receivers. This project is an extension of the Arduino library projects for: SI4735; AKC6959 and KT0915. It is a simple example that shows a way to use your smartphone as a remote control via Bluetooth. In order to follow the steps presented here, I am assuming that you have some knowledge in development for mobile devices. Also, you will need to be familiar with the Javascript programming language. The development environment used by this project is the Apache Cordova. Cordova is a open-source mobile development framework that allows you to develop cross-platform applications. That means you can code once and deploy the application in many system, including iOS and Android. Cordova provides an easy way to develop for iOS and Android.
• Band Pass Filter controlled by Arduino. It is a HF band pass filter controlled by Arduino. It is designed for HF receivers. With this project, you can use a set of up to four HF bandpass filters that can be selected by Arduino. To do that you will need just two digital Arduino pins.