​

 

📻 Introducing the APPYDROID_TEA5767 Radio Library

 

Welcome to the home of the APPYDROID_TEA5767 library! If you're looking to build an Arduino project with the popular TEA5767 FM radio module, you're in the right place. This library is a powerful, advanced tool that gives you full control over the chip, making it easy to build everything from a simple digital radio to more complex projects like a "Ghost Box" scanner.

It's built to be easy to use while unlocking the advanced features of the TEA5767 chip.

 

🚀 Library Features

 

Our library is packed with functions to make your radio project a success:

• Full Frequency Control: Tune directly to any frequency (e.g., 98.5 MHz) with or without muting to prevent static "pops" between stations.

• Powerful Scanning: Automatically scan up or down the FM band to find the next available station. You can even set the sensitivity (stop level) to find only strong stations or all weak ones.

• Audio Quality Control: Force mono reception to reduce hiss on weak signals, enable high-cut filters to remove noise, or turn on the built-in stereo noise cancelling.

• Channel Muting: Mute the left, right, or both audio channels independently.

• Rich Status Info: Get the current signal strength (0-15), check if a broadcast is in stereo, and read the currently tuned frequency at any time.

• Power Management: Put the chip into a low-power standby mode and wake it up on command to save battery.

 

🛠️ How to Install

 

Since this is a custom library, you'll need to install it from the .zip file.

1. Download the Library: Grab the latest APPYDROID_TEA5767.zip file from our download link.

2. Open the Arduino IDE: Launch the Arduino application on your computer.

3. Add the .ZIP Library: Navigate to the menu Sketch > Include Library > Add .ZIP Library...

4. Select the File: A file browser will open. Find the APPYDROID_TEA5767.zip file you just downloaded, select it, and click "Open".

That's it! The IDE will copy the library files to the correct folder, and it will be ready to use in your projects.

 

📂 How to Open the Demos (Examples)

 

The best way to learn the library is to see it in action. We've included several example sketches, including a simple demo and the Ghost Box.

1. After installing the library, you may need to restart the Arduino IDE.

2. Go to the menu File > Examples.

3. Scroll down until you see APPYDROID_TEA5767 in the list.

4. Hover over it to see the included demos, like Comprehensive_Demo and Ghost_Box_Demo.

5. Click on one to open it in a new window, ready to upload to your Arduino!

 

👻 Example Spotlight: The Ghost Box Demo

 

One of the most popular projects for the TEA5767 is a "Ghost Box" or "Shack Scanner," and our library makes it easy. This demo is included in the examples folder.

 

What it Does

 

A Ghost Box continuously scans through radio frequencies. This demo creates a 3-mode scanner controlled by a 3-way toggle switch and a potentiometer for speed.

 

Hardware Required

 

• An Arduino (Uno, Nano, etc.)

• The TEA5767 module (SDA, SCL, 5V, GND)

• A 3-way toggle switch (connected to pins D2 and D3)

• A 10k potentiometer (connected to pin A0)

 

The 3 Modes

 

The loop() function constantly checks the switch and the potentiometer to decide what to do.

1. Mode 1 (Scan): Uses the radio.searchNext() function. It scans up the FM band, stopping briefly on any station it finds. The sound is on during the scan, so you hear the static and station snippets. The potentiometer controls how long it pauses on a found station.

2. Mode 2 (Mute Scan): Uses the radio.searchNextMuting() function. This does the same scan, but the audio is muted between stations. It only unmutes when a station is found, giving you a much cleaner "seek" effect. The pot again controls the pause duration.

3. Mode 3 (Random Jump): This mode uses radio.selectFrequency() and random() to jump to a completely random frequency on the FM band. The pot controls the "jump speed"—how quickly it hops from one random frequency to the next.