Thanks to visit codestin.com
Credit goes to github.com

Skip to content
/ Reverb Public

A web interface to view and replay sub-GHz RF signals, connecting to your ESP32/CC1101 device over BLE.

License

Notifications You must be signed in to change notification settings

YM2992/Reverb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Reverb Icon

Reverb

A companion web app for ESP32 + CC1101, enabling BLE connection, RF signal analysis, and replay from your browser.


Quickstart

  1. Flash Firmware:
    Download and flash the latest firmware code to your ESP32.

  2. Open the App:
    Go to reverb.yasir.com.au on a mobile or Bluetooth-enabled device.

  3. (Optional) Install as PWA:
    Add the app to your device's home screen (see PWA Installation).

  4. Connect:
    Press the connect button
    Main page - disconnected

  5. Pair:
    Follow the pairing process
    Pairing process

  6. Enjoy!
    Main page - connected


Features

  • Web Interface: Use the app directly from your mobile browser.
  • BLE Connection: Connect/disconnect to your ESP32 device via BLE.
  • Record Signals: View received signals with Frequency, Data, and RSSI.
  • Transmit Signals: Send custom RF signals via the web interface.
  • Replay Signals: Replay signals from a selected time range.

Coming Soon

  • Wardriving: Map and analyse RF signals in your area.
  • Signal Map: Visualise recorded signals on a map.

Use Cases

  • Signal Analysis: Analyze and visualize sub-GHz RF signals for research or hobbyist purposes.
  • Remote Control: Use the ESP32 as a remote control for other devices by transmitting custom RF signals.
  • Learning Tool: Learn about RF communication and signal processing using the ESP32 and CC1101.

Hardware

Required Components:

  • ESP32: Main microcontroller for BLE and signal processing.
  • CC1101: Sub-GHz RF transceiver for receiving/transmitting RF signals.

Hardware Diagram

Hardware Diagram


App Screenshots

Main Screen Signal History Modal
Main screen Signal History Modal

Self-hosting/Development

Prerequisites

  • Node.js (v18 or newer recommended)
  • npm
  • An ESP32 flashed with the provided firmware (reverb_esp32.ino)

ESP32 Firmware

Firmware is at reverb_esp32/reverb_esp32.ino. Flash using Arduino IDE or PlatformIO.

Running the Web App

  1. Navigate to the reverb directory:
    cd reverb
  2. Install dependencies:
    npm install
  3. Start the development server:
    npm run dev

Building for Production

npm run build
npm start

Using the App Locally

On your Bluetooth-enabled device:

  1. Open http://HOST_IP:3000 in your browser.
    (Replace HOST_IP with the actual IP address of the machine running the app.)

PWA Installation

  • On mobile, open the app in Chrome or Safari and use "Add to Home Screen" or "Install App" to install as a PWA.

License

MIT License.


Credits

About

A web interface to view and replay sub-GHz RF signals, connecting to your ESP32/CC1101 device over BLE.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Languages