SI4844

Silicon Labs SI4844 (BROADCAST ANALOG TUNING DIGITAL DISPLAY AM/FM/SW RADIO RECEIVER) Library

View on GitHub

Si4844 Library for Arduino

Leia este documento em Português

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 to control the SI4844.

This library can be freely distributed using the MIT Free Software model. Copyright (c) 2019 Ricardo Lima Caratti

Contact: pu2clr@gmail.com

By Ricardo Lima Caratti, Oct 2019.

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. License Copyright
  2. Your support is important
  3. About the SI4844 Architecture
  4. Terminology
  5. Labrary Features
  6. Library Installation
  7. Hardware Requirements and Setup
  8. API Documentation
  9. API Documentation Legacy
  10. References
  11. Source code - Arduino Examples
  12. Videos


PU2CLR SI4844 Arduino Library


Example using LCD16x02


See also

More Arduino Projects developed by author

Important

The SI4844 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 converter. See Hardware Requirements and Setup.

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.

Your support is important.

If you would like to support this library development, consider joining this project via Github. Alternatively, make suggestions on features you would like available in this library. Thank you!

About the SI4844 Architecture

The Si4844 is an analog-tuned digital-display AM/FM/SW radio receiver. It has an analog-tune while frequency, band, and setero/mono information can be displayed on LCD. It works with a I2C protocol that allows a microcontroller send command and receive data. Also, with a 100K variable resistor, you can simulate a dial mechanical tuning wheel found in old or traditional receiver. In this way, you will be able to offer a look similar to the old radios.

See more about SI4844 on BROADCAST ANALOG TUNING DIGITAL DISPLAY AM/FM/SW RADIO RECEIVER

Terminology

Term Description
Arduino Libraries Libraries are files written in C or C++ (.c, .cpp) which provide your sketches with extra functionality. The SI4844 Library provides extra functionalities to make easier the Arduino deal with Si4844 device
CTS Clear to send
IDE Integrated Development Environment
I²C I²C - Inter-Integrated Circuit
Sketch Name that Arduino environment uses for a program
ATDD Analog Tune Digital Display. Sometimes used to refer the Si4844 device
interrupt In this context, it is a Arduino Resource. Allows important tasks to be performed regardless of the flow of your program
C++ A object-oriented programming (OOP) language. It is a superset of the C language with an additional concept of “classes.”
programming guide In this context it refers to Si48XX ATDD PROGRAMMING GUIDE
POC Proof of Concept
SDIO / SDA Serial data in/data out pin
SCLK / SCL Serial clock pin

Library Features

  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 Si48XX ATDD PROGRAMMING GUIDE
  3. More than 30 Si48XX functions (methods)
  4. Extended SW band frequency ranges: 2.3–5.6 MHz and 22–28.5 MHz
  5. C++ Lenguage and Object-oriented programming
  6. Available on Arduino IDE (Manage Libraries)
  7. Simplifies SI4844 based projects

Library Installation

You can install the library via the Arduino Library Manager. Go to the menu Sketch > Include Library > Manage Libraries…, and in the search box, type “PU2CLR SI4844”.

The images below show that actions

IDE 01

IDE 01

IDE 01

You can also download this library or old version of it via this repository or via Arduino Library List.

Hardware Requirements and Setup

This library has been written for the Arduino platform and has been successfully tested on Pro Mini 3.3V (8MHz). I beleave it will work on any other Arduino with I2C support.

Arduino 5V and Si4844

The Si4844 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 Si4844 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 Si4844 device. That configuration can make the system unstable or damage the device.

I have tested it with success the SI4844 with a 5V Arduino using the I2C Multiplexer TCA9548A, that also can work as a bidirectional converter.

See that approach here.

Schematic

Schematic with Arduino Pro Mini 3.3V and OLED

To use this labrary you need to build a radio based on SI4844 connected to Arduino. The schematic and photos below show the hardware and setup requirments for start using this library.

Arduino and OLED circuit

schematic Arduino and OLED

SI4844 minimal circuit

schematic SI4844 minimal circuit

As you can see above, that is a very simple circuit with minumum component parts. The push button are used with the internal Arduino pull up resistors. The OLED display and the SI4844 are connected on the A4 (SDA) and A5 (SCL) Arduino Pro Mini pins. Pay attention to the I2C bus pull up resistors. This experiment used 10K pull up resistors. However, you can use lower values.

No front-end was added to this receiver. However, you will be surprised with the its performance. You can connect to the audio output a mono or stereo amplifier or an earphone to listen to the radio. On article How to Build an Arduino-Controlled AM/FM/SW Radio [May 26, 2016], Mr. Raymond Genovese, suggests a better SI4844 setup, including a RF amplifier.

Another good source is the Silicon Labs Document AN602 “Si4822/26/27/40/44 ANTENNA, SCHEMATIC, LAYOUT, AND DESIGN GUIDELINES” Rev 0.3. This document also suggests better circuits. Check the AN602 pages: 8, 9 and 10 .

Arduino Pro Mini 3.3V and SI4844 connections

The table below shows the pin connections between the Si4844 and Arduino Pro Mini.

SI4844 pin Arduino pin Description
2 2 Arduino interrupt pin
15 12 Regurlar arduino digital pin used to RESET control
16 A4 (SDA) I2C bus (Data)
17 A5 (SCL) I2C bus (Clock)
OLED Arduino pin
SDA A4
CLK D5
Buttons Arduino pin
BAND_UP 8
BAND_DOWN 9
VOL_UP 10
VOL_DOWN 11

Schematic with Arduino Nano 5V and LCD16x02

This circuit uses the Arduino Nano or UNO, LCD16-02 with SI4844 device. Arduino Nano and the LCD16x02 operate with 5V. So, these two devices can be connected direct. However, you need a bi-directonal logic converter to connect the Arduino Nano or UNO to the SI4844 device. The schematic below shows the circuit with Arduino Nano 5V and LCD16x02. You can use the SI4844 minimal circuit as SI4844 setup reference. It is important to say if you have an LCD that operates with 3.3V, you can use Arduino Pro Mini or other similar that also operates with 3.3V. In this case, you do not need any bidirectional converter strategy.

schematic SI4844 LCD16x02

The schematic below shows a suggestion to the bi-directional converter strategy.

schematic SI4844 LCD16x02

It is important to say that a voltage divider will work for the Si4844 RST pin. However, for the I2C bus as well as the SI4844 IRQ pin, this approach may not work.

See also: Bi-Directional Logic Level Converter Hookup Guide for more details.

Arduino Nano, LCD16x02, Push Buttons and SI4844 pin connections

You will find two versions of LCD16x2 on the market. The most common 5V version and the 3.3V version. The most direct way to use the SI4844 is to select the components that operate with the same working voltage. Otherwise, you must use some type of voltage conversion strategy.

SI4844 pin Arduino pin Description
2 2 Arduino interrupt pin
15 12 Arduino A0 (Digital pin 14) for SI4844 RESET
16 A4 (SDA) I2C bus (Data)
17 A5 (SCL) I2C bus (Clock)
LCD 16x02 Arduino pin  
D4 D7 Arduino Digital Pin 7
D5 D6 Arduino Digital Pin 6
D6 D5 Arduino Digital pin 5
D7 D4 Arduino Digital Pin 4
RS D3 Arduino Digital Pin 3 for LCD RESET controle
E/ENA D13 Arduino Digital Pin 13
RW & VSS & K GND  
A & VDD +Vcc  
VO   (see 10K tripot connection)
Buttons Arduino pin
BAND_UP 8
BAND_DOWN 9
VOL_UP 10
VOL_DOWN 11

Attention: If you are not using an Arduino Pro Mini, pay attention to the appropriated Arduino pinout to select the correct interrupt (IRQ), RST, SDIO and SCLK pins. The table below shows some Arduino board pinout.

Board InterrupT (IRQ) Pins I2C / TWI pins
328-based
(Nano, Mini or Uno)		 D2 and D3 A4 (SDA/SDIO), A5 (SCL/SCLK)
Mega 2, 3, 18, 19, 20 and 21 20 (SDA/SDIO), 21 (SCL/SCLK)
32u4-based
(Micro, Leonardo or Yum)		 0, 1, 2, 3 and 7 2 (SDA/SDIO), 3 (SCL/SCLK)
Zero all digital pins except pin 4 D8 (SDA/SDIO) and D9 (SCL/SCLK)
Due all digital pins 20 (SDA/SDIO), 21 (SCL/SCLK)
101 all digital pins.
Only pins 2, 5, 7, 8, 10, 11, 12, 13 work with CHANGE		  

Again, pay attention to the operating voltage of the Arduino that you will use. The SI4844 device works with +3.3V. See Making the Si4844 works with 5V Arduino UNO or similar if you itend to use a 5V Arduino board.

Parts (for OLED and LCD16x02 versions)

Parts list used by the minimal schematic

Part Description
IC1 Si4844-A10 radio receiver
Arduino Arduino Pro Mini, 3.3V, 8MHz for OLED version or Nano for LCD16x02 version
Bi-Directional module Only if you are using the Arduino Nano or Uno
C1 22pF ceramic capacitor
C2 22pF ceramic capacitor
C3 100nF ceramic capacitor
C4 4.7uF Electrolytic or ceramic capacitor
C5 4.7uF Electrolytic or ceramic capacitor
C6 100nF ceramic capacitor
C7 470nF ceramic capacitor
R1 3.3K ~ 10K resistor
R2 3.3K ~ 10K resistor
R3 100K linear potentiometer
L1 ferrite AM antenna
L2 100mH
Y1 32.768 kHz crystal
S1…S4 4 push buttons

Photos

SI4844 soldered on adapter

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

SI4844 soldered on adapter 01

SI4844 soldered on adapter 03

prototyping

SI4844 soldered on adapter 04

SI4844 soldered on adapter 05

SI4844 soldered on adapter 06

OLED/I2C and Arduino Pro Mini

SI4844 and Arduino on protoboard 01

LCD16x02 5V and Arduino Nano

SI4844 and LCD16x02 devices

Playing with Arduino UNO or Pro Mini 5v and SI4844

During my tests, I have used the TCA9548A as an alternative to regular bi-directional converter on I2C bus. Actually the TCA9548A is an I2C Multiplexer Breakout Board 8 Channel Expansion Board, but you can use it as a bi-directional converter for I2C bus. Some features:

  1. 1-to-8 Bidirectional Translating Switches
  2. I2C Bus and SMBus Compatible
  3. Active-Low Reset Input
  4. Three Address Pins, Allowing up to Eight TCA9548A Devices on the I2C Bus
  5. Channel Selection Through an I2C Bus, In Any Combination
  6. Power Up With All Switch Channels Deselected
  7. Low RON Switches
  8. Allows Voltage-Level Translation Between 1.8-V, 2.5-V, 3.3-V, and 5-V Buses
  9. Supports Hot Insertion
  10. Low Standby Current
  11. Operating Power-Supply Voltage Range of 1.65 V to 5.5 V
  12. 5-V Tolerant Inputs
  13. 0- to 400-kHz Clock Frequency

You can use a voltage divider for reset (RST) and connect the IRQ direct to the Arduino pin 2 (configures as input).

API Documentation

Index

This labrary was developed in C++. To use it, you must declare in your Sketch a variable of the class SI4844. The code below shows that.

#include <SI4844.h>

// Arduino Pin (tested on pro mini)
#define INTERRUPT_PIN 2
#define RESET_PIN 12


#define DEFAULT_BAND 4

SI4844 si4844; 

void setup() {

    // Initiate and connect the device ATDD (SI4844) to Arduino
    si4844.setup(RESET_PIN, INTERRUPT_PIN, DEFAULT_BAND);

}

void loop() {

  // if something changed on ATDD (SI4844), do something  
  if (si4844.hasStatusChanged())
  {
    Serial.print("Band Index: ");
    Serial.print(si4844.getStatusBandIndex());
    Serial.print(" - ");
    Serial.print(si4844.getBandMode());
    Serial.print(" - Frequency: ");    
    Serial.print(si4844.getFrequency(),0);
    Serial.print(" KHz");
    Serial.print(" - Stereo ");
    Serial.println(si4844.getStereoIndicator());
  }

}

See Proof of Concept for SI4844 Arduino Library to get the entire exemple.

Defined Data Types and Structures

To make the SI4844 device easier to deal, some defined data types were built to handle byte and bits responses.

/* 
 * The structure below represents the four bytes response got by command ATDD_GET_STATUS
 * See Si48XX ATDD PROGRAMMING GUIDE, pages 14 and 15
 */
typedef struct
{
  byte BCFG0 : 1;     // Bit 0
  byte BCFG1 : 1;     // bit 1
  byte STEREO : 1;    // bit 2
  byte STATION : 1;   // bit 3
  byte INFORDY : 1;   // bit 4
  byte HOSTPWRUP : 1; // bit 5
  byte HOSTRST : 1;   // bit 6
  byte CTS : 1;       // bit 7
  byte BANDIDX : 6;   // Form bit 0 to 5
  byte BANDMODE : 2;  // From bit 6 to 7
  byte d2 : 4;        // Frequency digit 2
  byte d1 : 4;        // Frequency digit 1
  byte d4 : 4;        // Frequency digit 4
  byte d3 : 4;        // frequency digit 3
} si4844_get_status;

/*
 * Uses a C language feature to represent two way for the 4 response bytes (status) sent by the ATDD_GET_STATUS.
 * It is needed to undertand the C language union concept.
 * See Si48XX ATDD PROGRAMMING GUIDE, pages 14 and 15 
*/
typedef union {
  si4844_get_status refined;
  byte raw[4];
} si4844_status_response;

// English:
// GET_REV structure. The structure below represents 9 bytes response for GET_REV command.
// STATUS and RESP1 to RESP8.  See Si48XX ATDD PROGRAMMING GUIDE; AN610, page 22.
// Portuguese:
typedef struct
{
  byte RESERVED : 6; // Bit 0 to 5
  byte ERR : 1;      // bit 6
  byte CTS : 1;      // bit 2
  byte PN;           // Final 2 digits of Part Number (HEX).
  byte FWMAJOR;      // Firmware Major Revision (ASCII).
  byte FWMINOR;      // Firmware Minor Revision (ASCII).
  byte CMPMAJOR;     // Component Major Revision (ASCII).
  byte CMPMINOR;     // Component Minor Revision (ASCII).
  byte CHIPREV;      // Chip Revision (ASCII).
} si4844_firmware_info;

typedef union {
  si4844_firmware_info refined;
  byte raw[9];
} si4844_firmware_response;

Public Methods

setup

/*
* Initiate the SI4844 instance and connect the device (SI4844) to Arduino. 
* Calling this library should be the first thing to do to control the SI4844.
*
* @param resetPin  arduino pin used to reset the device
* @param interruprPin arduino pin used to handle interrupr      
* @param defaultBand band that the radio should start
*/
void setup(unsigned int, unsigned int, byte)

Example:

  si4844.setup(12, 2, 4);

reset

/*
 * reset
 * English
 * See pages 7, 8, 9 and 10 of the programming guide.
 */
void reset(void )

Example:

  si4844.reset();

powerDown

/*
 * Moves the device from power up to power down mode. 
 * See Si48XX ATDD PROGRAMMING GUIDE; AN610; page 45
 */
void SI4844::powerDown(void)

setBand

/*
 * Set the radio to a new band. 
 * See Table 8. Pre-defined Band Table in Si48XX ATDD PROGRAMMING GUIDE; AN610; pages 17 and 18  
 */
void setBand(byte);

Example:

  si4844.setBand(4); // FM

setCustomBand

/* 
 * This method allows you to customize the frequency range of a band.
 * The SI4844 can work from 2.3–28.5 MHz on SW, 64.0–109.0 MHz on FM
 * You can configure the band index 40, for example, to work between 27 to 28 MHz.
 * See Si48XX ATDD PROGRAMMING GUIDE, pages 17, 18, 19 and 20.
 * 
 * (top – button)/(bandSpace) must be betwenn 50 and 230
 * 
 * @param byte bandIndes; Predefined band index (valid values: betwenn 0 and 40)
 * @param unsigned button; Band Bottom Frequency Limit
 * @param unsigned top; Band Top Frequency Limit
 * @param byte bandSpace; Channel Spacing (use 5 or 10 - On FM 10 = 100KHz)
 * @return void
 */
void SI4844::setCustomBand(byte, unsigned, unsigned, byte )

Example:

SI4844 si4844; 

void setup() {
  Serial.begin(9600);
  delay(500);  
  si4844.setup(RESET_PIN, INTERRUPT_PIN, DEFAULT_BAND);
  // Configure the Pre-defined Band (band index 40) to work between 27.0 to 27.5 MHz
  // See Si48XX ATDD PROGRAMMING GUIDE, pages 17,18,19 and 20.
  si4844.setCustomBand(40,27000,27500,5);  

}

changeVolume

/*
 *  Up or down the sound volume level/  
 *  @param char '+' up and '-' down 
 */
void changeVolume(char);

Example:

  si4844.changeVolume('+');

setVolume

/*
 * Set the sound volume level. 
 * @param byte volumeLevel (domain: 0 to 63) 
 */
setVolume(byte level)

Example:

  si4844.setVolume(55);

volumeUp

/*
 *  Set sound volume level Up   
 *  
 */
void SI4844::volumeUp()

Example:

  si4844.volumeUp();

volumeDown

/*
 *  Set sound volume level Down   
 *  
 */
void SI4844::volumeDown()

Example:

  si4844.volumeDown();

setAudioMode

/*
 * Set audio mode 
 * See Si48XX ATDD PROGRAMMING GUIDE; AN610; page 21
 * @param byte audio_mode 
 *             0 = Digital volume mode (no bass/treble effect, volume levels from 0 to 63) 
 *             1 = Bass/treble mode (no digital volume control, fixed volume level at 59)
 *             2 = Mixed mode 1 (bass/treble and digital volume coexist, max volume = 59) 
 *             3 = Mixed mode 2 (bass/treble and digital volume coexist, max volume = 63) 
 *             Default is 3 (Mixed mode 2)
 * @param byte opcode 
 *             0 = Set audio mode and settings
 *             1 = Get current audio mode and settings without setting
 * @param byte attenuation (0 => -2db; 1 => 0db)
 */
void setAudioMode(byte opcode, byte attenuation )

Example:

  si4844.setAudioMode(1,1);

setAudioMute

/*
 * Mutes the audio output.
 * 
 * @param bool on - false = normal (no mute); true = mute 
 */
void setAudioMute(bool on)

setBassTreeble

/*
 * Set bass and treeble. 
 * @param byte bass and treeble (domain: 0 to 8)
 *      0 -Bass boost +4 (max)
 *      1- Bass boost +3
 *      2- Bass boost +2
 *      3- Bass boost +1 (min)
 *      4- Normal (No Bass/Treble effect) (Default) 5- Treble boost +1 (min)
 *      6- Treble boost +2
 *      7- Treble boost +3
 *      8- Treble boost +4 (max)
 */
void setBassTreeble(byte bass_treeble) {

Example:

  si4844.setBassTreeble(2);

getStatus

/*
 * Get tune freq, band, and others information, status of the device.
 * Use this method only if you want to deal with that information by yourself. 
 * This library has other methods to get that information easier. 
 * 
 * @return a pointer to a structure type si4844_status_response
 */
si4844_status_response *getStatus(void);

Example:

  si4844.getStatus();

getFirmware

/*
 * Get part number, chip revision, firmware, patch, and component revision numbers.
 * You do not need to call this method. It is executed just once at setup methos. 
 * There are other methods that give you that information.   
 * See page 22 of programming guide.
 * 
 * @return a pointer to a structure type  with the part number, chip revision, 
 *         firmware revision, patch revision, and component revision numbers.
 */
si4844_firmware_response *getFirmware(void);

Example:

  si4844.getFirmware();

getFrequency

/*
 * Get the current frequency of the radio in KHz. 
 * For example: FM, 103900 KHz (103.9 MHz);
 *              SW, 7335 KHz (7.34 MHz, 41m)   
 * 
 * @return float current frequency in KHz.  
 */
float getFrequency(void);

Example:

    Serial.print("Frequency: ");    
    Serial.print(si4844.getFrequency(),0);

hasStatusChanged

/*
*  Check if the SI4844 has its status changed. If you move the tuner, for example,
*  the status of the device is changed. 
*
*  return true or false  
*/
bool hasStatusChanged(void);

Example:

  if (si4844.hasStatusChanged())
  {
    Serial.print(" - Frequency: ");    
    Serial.print(si4844.getFrequency(),0);
    Serial.print(" KHz");
    Serial.print(" - Stereo ");
    Serial.println(si4844.getStereoIndicator());
  }

resetStatus

/*
 * Set the control variable to default status
 */
void resetStatus(void);

getBandMode

/*
 * Get te current band(FM/AM/SW)
 * @return char * "FM", "AM" or "SW".
 */ 
inline String getBandMode()

getStereoIndicator

/*
 * Get a string (char *) On or Off indicating stereo situation. 
 * return char * "On" or "Off"
 */
inline String getStereoIndicator()

getStatusBCFG0

/*
 * See Si48XX ATDD PROGRAMMING GUIDE, AN610, pages 15 and 16
 */
inline unsigned getStatusBCFG0()

getStatusBCFG1

/*
 * See Si48XX ATDD PROGRAMMING GUIDE, AN610, pages 15 and 16
 */
inline unsigned getStatusBCFG1()

getStatusStereo

/*
 * Return a integer indicating the stereo status (0 = Off and 1 = On).
 * See Si48XX ATDD PROGRAMMING GUIDE, AN610, pages 15 and 16
 */
inline unsigned getStatusStereo()

getStatusStationIndicator

/*
 * See Si48XX ATDD PROGRAMMING GUIDE, AN610, pages 15 and 16
 */
inline unsigned getStatusStationIndicator()

getStatusInformationReady

/*
 * See Si48XX ATDD PROGRAMMING GUIDE, AN610, pages 15 and 16
 */
inline unsigned getStatusInformationReady()

getStatusHostPowerUp

/*
 * See Si48XX ATDD PROGRAMMING GUIDE, AN610, pages 15 and 16
 */
inline unsigned getStatusHostPowerUp()

getStatusHostReset

/*
 * See Si48XX ATDD PROGRAMMING GUID, AN610, pages 15 and 16
 */
inline unsigned getStatusHostReset()

getStatusBandMode

/*
 * Return an integer (0 - FM; 1 = AM and 2 = SW) 
 * See Si48XX ATDD PROGRAMMING GUIDE, AN610, pages 15 and 16
 */
inline unsigned getStatusBandMode()

getStatusBandIndex

/*
 * return an integer with the currente band index in use. 
 * Set Table 13. Pre-defined Band Table in Si48XX ATDD PROGRAMMING GUID, AN610, pages 39 and 40
 */
inline unsigned getStatusBandIndex()

getStatusCTS

/*
 * See Si48XX ATDD PROGRAMMING GUIDE, AN610, pages 15 and 16
 */
inline unsigned getStatusCTS()

getFirmwareErr

inline unsigned getFirmwareErr()

getFirmwareCTS

inline unsigned getFirmwareCTS()

getFirmwarePartNumber

/*
 * Get Firmware Final 2 digits of Part Number (HEX).
 */ 
inline unsigned getFirmwarePartNumber()

See example below

getFirmwareMajorRevision

/*
 * Get Firmware Major Revision (ASCII).
 */ 
inline unsigned getFirmwareMajorRevision()

See example below

getFirmwareMinorRevision

/*
 * Get Firmware Minor Revision (ASCII).
 */
inline unsigned getFirmwareMinorRevision()

See example below

getFirmwareComponentMajorRevision

/*
 * Get Firmware Component Major Revision (ASCII).
 */ 
inline unsigned getFirmwareComponentMajorRevision()

See example below

getFirmwareComponentMinorRevision

/* 
 * Get Firmware Component Minor Revision (ASCII).
 */
inline unsigned getFirmwareComponentMinorRevision()

See example below

getFirmwareChipRevision

/*
 * Chip Revision (ASCII).
 */
inline unsigned getFirmwareChipRevision()

Example:


  Serial.println("\nSI4844 -  Firmware information\n");

  si4844.getFirmware();
  Serial.print("Final 2 digits of Part Number..: ");
  Serial.println(si4844.getFirmwarePartNumber());
  Serial.print("Firmware Major Revision........: ");
  Serial.println(si4844.getFirmwareMajorRevision());
  Serial.print("Firmware Minor Revision........: ");
  Serial.println(si4844.getFirmwareMinorRevision());
  Serial.print("Component Major Revision.......: ");
  Serial.println(si4844.getFirmwareComponentMajorRevision());
  Serial.print("Component Minor Revision.......: "); 
  Serial.println(si4844.getFirmwareComponentMinorRevision());
  Serial.print("Chip Revision..................: ");
  Serial.println(si4844.getFirmwareChipRevision());

  Serial.println("*****************************");

References

  1. Si48XX ATDD PROGRAMMING GUIDE
  2. BROADCAST ANALOG TUNING DIGITAL DISPLAY AM/FM/SW RADIO RECEIVER
  3. Si4822/26/27/40/44 ANTENNA, SCHEMATIC, LAYOUT, AND DESIGN GUIDELINES
  4. How to Build an Arduino-Controlled AM/FM/SW Radio
  5. I2C bi-directional level shifter
  6. Making the Si4844 works with 5V Arduino UNO or similar

Examples

On examples folder you will find some sketches that might help you in your project.

Firmware Information

The SI4844_FIRMWARE.ino start the radio on FM Band and shows the SI4844 firmware information.

Minimal Radio with SI4844 (SI4844_MINIMAL)

The SI4844_MINIMAL.ino is a sketch with just 35 lines. It is enough to make a simple radio based on SI4844.

Proof of Concept

The SI4844_POC.ino is a proof of concept for SI4844 controlled by Arduino and the SI4844 Library. This Arduino Sketch only works on your IDE (Arduino IDE). However, you can replace the Serial Monitor functions that deal the SI4844 and arduino with functions that will manipulate the LCD, encoder and push buttons appropriated for your project.

Extended SW band frequency ranges from 2.3–5.6 MHz and 22–28.5 MHz

The sketch SI4844_CUSTOM_BAND.ino shows how to extend a SW band frequency ranges. You can define band from from 2.3–5.6 MHz and 22–28.5 MHz.

SI4844 with OLED and buttons

The sketch SI4844_01_OLED.ino shows an example of using an I2C OLED display.

The schematic below shows how to insert the OLED and button on the original schematic.

OLED and Button with SI4844

SI4844 with Nano and LCD16x02

The sketch SI4844_02_LCD16x02.ino shows an example of using the traditional LCD16x02.

The schematic below shows the circuit used with this sketch.

Schematic LCD16x02

Sound Control

The sketch SI4844_BASS_TREBLE.ino shows how to use sound control (treble, bass, mute etc).

Videos

  1. Biblioteca Arduino para o Rádio SI4844 FM AM SW da Silicon Labs
  2. Prova de Conceito com SI4844 e Arduino (vídeo sobre este projeto)

Projects in which this library is used