Complete development environment for the ATS Mini radio receiver: Android companion app and custom Bluetooth-enabled firmware.
This repository contains two main components:
- Android Companion App - Remote control application for ATS Mini via USB Serial and Bluetooth LE
- Custom Firmware - Modified ATS Mini firmware with Bluetooth LE support and custom boot logo
Download APK v3.0 (Bluetooth Edition)
See Firmware README for detailed instructions on how to flash the Bluetooth-enabled firmware.
- Dual Connection Mode: USB Serial or Bluetooth LE
- Frequency Control: Precise tuning with +/- buttons and long-press support
- Band Management: Quick navigation between frequency bands
- Operating Modes: AM, FM, SSB mode switching
- Real-time Monitoring: RSSI, SNR, battery voltage display
- Full Remote Control: Volume, bandwidth, AGC, attenuator, backlight
- ✅ Bluetooth LE with Nordic UART Service
- ✅ WiFi/BLE automatic mutual exclusion (only one active at a time)
- ✅ Custom boot logo (2 seconds at startup)
- ✅ ESP32-S3-WROOM-1-N16R8 (16MB Flash + 8MB PSRAM)
- ✅ Logo embedded in firmware (no SPIFFS required)
ATS-Mini-Companion/
├── app/ # Android companion application
│ ├── src/ # React source code
│ ├── android/ # Native Android project
│ └── README.md # App build & dev instructions
│
├── firmware/ # ATS Mini custom firmware
│ ├── ats-mini/ # Arduino source code
│ ├── binaries/ # Compiled firmware files
│ ├── docs/ # Firmware documentation
│ └── README.md # Firmware build & flash instructions
│
├── releases/ # Prebuilt APK releases
│ └── ATS-Mini-Companion-BLE.apk
│
└── docs/ # General documentation
├── ANDROID-SETUP.md
└── images/
-
Install the Android App
- Download the APK from releases/
- Install on your Android device (enable "Unknown sources")
- Grant Bluetooth permissions
-
Flash the Firmware
- Follow instructions in firmware/README.md
- Use the precompiled binaries in firmware/binaries/
- Recommended: Flash
ats-mini.ino.merged.binat address0x0
-
Connect and Enjoy
- On ATS Mini: Settings > Bluetooth > Bluefruit
- Open the app and select "Bluetooth LE"
- Connect to "ATS-Mini"
- Android App Development: See app/README.md
- Firmware Development: See firmware/README.md
- Android device with USB OTG support
- USB OTG cable
- Android 7.0 or higher
- Android device with Bluetooth LE support
- Android 7.0 or higher
- ATS Mini with Bluetooth-enabled firmware (v1.4 or higher)
- React 19: JavaScript UI framework
- Vite 7: Build tool and bundler
- Capacitor 7: Cross-platform native framework
- TailwindCSS: CSS framework
- Capacitor Serial Plugin: USB Serial communication
- Capacitor Bluetooth LE Plugin: Bluetooth communication
- Arduino Framework: For ESP32-S3
- SI4735 Library: Radio chip control
- NimBLE: Bluetooth LE stack
- TFT_eSPI: Display driver
- WiFi: Network connectivity
- Android App Documentation
- Firmware Documentation
- Android Setup Guide
- Bluetooth Implementation Details
- Flashing Instructions
- Flash the Bluetooth-enabled firmware (v1.4) from firmware/binaries/
- Verify Bluetooth is activated: Settings > Bluetooth > Bluefruit
- Restart the ATS Mini (press RESET button)
- Stay within 2 meters range
- Reduce distance to less than 5 meters
- Remove metal obstacles between devices
- Verify ATS Mini battery level (> 3.5V)
- Close other Bluetooth apps
For more troubleshooting, see firmware/binaries/FLASH_INSTRUCTIONS.md
- NEW: Bluetooth LE support with Nordic UART Service
- NEW: Dual connection mode (USB Serial + Bluetooth LE)
- NEW: WiFi/BLE automatic mutual exclusion in firmware
- NEW: Custom boot logo on ATS Mini
- IMPROVED: Connection status indicator
- IMPROVED: Real-time data streaming via Bluetooth
- INCLUDED: Complete firmware source code
Previous versions: app/CHANGELOG.md
This project is under the MIT License.
Developed by EA5IYR - Miguel Cañadas
Contributions are welcome! Please open an issue to discuss important changes before creating a pull request.
If you encounter any problems or have suggestions, please open an issue in the GitHub repository.
This project is a companion application for the ATS Mini radio receiver, an amazing open-source project by the ESP32-SI4732 community.
ATS Mini Radio Receiver:
Special thanks to the ATS Mini development team for creating such an excellent and hackable radio receiver platform.
Entorno de desarrollo completo para el receptor de radio ATS Mini: aplicación Android y firmware custom con Bluetooth.
Este repositorio contiene dos componentes principales:
- Aplicación Android - Aplicación de control remoto para ATS Mini vía USB Serial y Bluetooth LE
- Firmware Custom - Firmware modificado del ATS Mini con soporte Bluetooth LE y logo personalizado
Descargar APK v3.0 (Edición Bluetooth)
Ver README del Firmware para instrucciones detalladas sobre cómo flashear el firmware con Bluetooth.
- Modo de Conexión Dual: USB Serial o Bluetooth LE
- Control de Frecuencia: Sintonización precisa con botones +/- y pulsación larga
- Gestión de Bandas: Navegación rápida entre bandas de frecuencia
- Modos de Operación: Cambio entre modos AM, FM, SSB
- Monitoreo en Tiempo Real: Visualización de RSSI, SNR, voltaje de batería
- Control Remoto Completo: Volumen, ancho de banda, AGC, atenuador, retroiluminación
- ✅ Bluetooth LE con Nordic UART Service
- ✅ Exclusión mutua WiFi/BLE automática (solo uno activo a la vez)
- ✅ Logo personalizado al arranque (2 segundos al inicio)
- ✅ ESP32-S3-WROOM-1-N16R8 (16MB Flash + 8MB PSRAM)
- ✅ Logo embebido en firmware (no requiere SPIFFS)
ATS-Mini-Companion/
├── app/ # Aplicación Android
│ ├── src/ # Código fuente React
│ ├── android/ # Proyecto Android nativo
│ └── README.md # Instrucciones de compilación
│
├── firmware/ # Firmware custom ATS Mini
│ ├── ats-mini/ # Código fuente Arduino
│ ├── binaries/ # Archivos de firmware compilados
│ ├── docs/ # Documentación del firmware
│ └── README.md # Instrucciones de compilación y flasheo
│
├── releases/ # Releases APK precompilados
│ └── ATS-Mini-Companion-BLE.apk
│
└── docs/ # Documentación general
├── ANDROID-SETUP.md
└── images/
-
Instalar la Aplicación Android
- Descarga la APK desde releases/
- Instala en tu dispositivo Android (habilita "Fuentes desconocidas")
- Otorga permisos de Bluetooth
-
Flashear el Firmware
- Sigue las instrucciones en firmware/README.md
- Usa los binarios precompilados en firmware/binaries/
- Recomendado: Flashea
ats-mini.ino.merged.binen dirección0x0
-
Conectar y Disfrutar
- En ATS Mini: Settings > Bluetooth > Bluefruit
- Abre la app y selecciona "Bluetooth LE"
- Conecta a "ATS-Mini"
- Desarrollo de la App Android: Ver app/README.md
- Desarrollo del Firmware: Ver firmware/README.md
- Dispositivo Android con soporte USB OTG
- Cable USB OTG
- Android 7.0 o superior
- Dispositivo Android con soporte Bluetooth LE
- Android 7.0 o superior
- ATS Mini con firmware Bluetooth habilitado (v1.4 o superior)
- React 19: Framework JavaScript de UI
- Vite 7: Herramienta de construcción
- Capacitor 7: Framework nativo multiplataforma
- TailwindCSS: Framework CSS
- Capacitor Serial Plugin: Comunicación USB Serial
- Capacitor Bluetooth LE Plugin: Comunicación Bluetooth
- Arduino Framework: Para ESP32-S3
- Librería SI4735: Control del chip de radio
- NimBLE: Stack Bluetooth LE
- TFT_eSPI: Driver de pantalla
- WiFi: Conectividad de red
- Documentación de la App Android
- Documentación del Firmware
- Guía de Setup Android
- Detalles de Implementación Bluetooth
- Instrucciones de Flasheo
- Flashea el firmware con Bluetooth (v1.4) desde firmware/binaries/
- Verifica que Bluetooth está activado: Settings > Bluetooth > Bluefruit
- Reinicia el ATS Mini (presiona botón RESET)
- Mantente a menos de 2 metros de distancia
- Reduce la distancia a menos de 5 metros
- Elimina obstáculos metálicos entre dispositivos
- Verifica el nivel de batería del ATS Mini (> 3.5V)
- Cierra otras apps de Bluetooth
Para más soluciones, ver firmware/binaries/FLASH_INSTRUCTIONS.md
- NUEVO: Soporte Bluetooth LE con Nordic UART Service
- NUEVO: Modo de conexión dual (USB Serial + Bluetooth LE)
- NUEVO: Exclusión mutua WiFi/BLE automática en firmware
- NUEVO: Logo personalizado al arranque en ATS Mini
- MEJORADO: Indicador de estado de conexión
- MEJORADO: Streaming de datos en tiempo real vía Bluetooth
- INCLUIDO: Código fuente completo del firmware
Versiones anteriores: app/CHANGELOG.md
Este proyecto está bajo licencia MIT.
Desarrollado por EA5IYR - Miguel Cañadas
¡Las contribuciones son bienvenidas! Por favor, abre un issue para discutir cambios importantes antes de crear un pull request.
Si encuentras algún problema o tienes sugerencias, por favor abre un issue en el repositorio de GitHub.
Este proyecto es una aplicación complementaria para el receptor de radio ATS Mini, un increíble proyecto de código abierto de la comunidad ESP32-SI4732.
Receptor de Radio ATS Mini:
Agradecimientos especiales al equipo de desarrollo del ATS Mini por crear una plataforma de receptor de radio tan excelente y modificable.