https://github.com/charmitro/busier
ESP32 web server and OLED display application for managing and showing availability status. Built with Rust.
https://github.com/charmitro/busier
embedded esp-idf esp32 iot microcontroller oled-display rust ssd1306 wifi
Last synced: about 1 month ago
JSON representation
ESP32 web server and OLED display application for managing and showing availability status. Built with Rust.
- Host: GitHub
- URL: https://github.com/charmitro/busier
- Owner: charmitro
- License: mit
- Created: 2025-03-15T12:30:54.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2025-03-15T12:58:55.000Z (about 2 months ago)
- Last Synced: 2025-03-15T13:33:28.850Z (about 2 months ago)
- Topics: embedded, esp-idf, esp32, iot, microcontroller, oled-display, rust, ssd1306, wifi
- Language: Rust
- Homepage:
- Size: 14.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Busier - ESP32 Status Display and Web Server
A Rust application for ESP32 microcontrollers that creates a web interface for controlling your availability status, with real-time display on an SSD1306 OLED screen.
## Features
- 🌐 WiFi connectivity to your local network
- 🖥️ Built-in HTTP server with a responsive web interface
- 📱 Toggle between "Free" and "Do Not Disturb" status from any device
- 📊 OLED display showing real-time status, IP address, and request count
- 🛠️ Built entirely in Rust using the ESP-IDF framework
## Hardware Requirements
- ESP32 development board
- SSD1306 OLED display (128x32 or 128x64)
- I2C connection wires
## Wiring
Connect the SSD1306 OLED display to the ESP32:
- SDA to GPIO21
- SCL to GPIO22
- VCC to 3.3V
- GND to GND
## Building and Flashing
### Prerequisites
1. Install Rust and Cargo (https://rustup.rs/)
2. Install ESP-IDF toolchain using `espup` (https://github.com/esp-rs/espup)
3. Add the ESP32 target: `rustup target add xtensa-esp32-espidf`
### Building
1. Clone this repository:
```
git clone https://github.com/charmitro/busier.git
cd busier
```
2. Configure your WiFi credentials (use environment variables for security):
```
export WIFI_SSID="your_wifi_name"
export WIFI_PASS="your_wifi_password"
```
3. Build and flash:
```
cargo build --release
cargo espflash flash --release
```
4. Monitor the serial output (optional):
```
cargo espflash monitor
```
## Usage
1. After the ESP32 boots, it will display the IP address on the OLED screen
2. Open a web browser and navigate to the displayed IP address
3. Use the web interface to toggle between "Free" and "Do Not Disturb" status
4. The OLED display will update to show the current status
## Project Structure
- `src/main.rs` - Main application code
- `build.rs` - Build script for embedding environment variables
- `Cargo.toml` - Project dependencies and configuration
## Configuration
The project uses the following environment variables:
- `WIFI_SSID`: Your WiFi network name
- `WIFI_PASS`: Your WiFi password
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- [esp-rs](https://github.com/esp-rs) - Rust support for ESP32
- [embedded-graphics](https://github.com/embedded-graphics/embedded-graphics) - Graphics library for embedded displays
- [ssd1306](https://github.com/jamwaffles/ssd1306) - SSD1306 OLED driver