https://github.com/tuemb/mqtt-esp-rs-example
the example for MQTT on esp and Rust
https://github.com/tuemb/mqtt-esp-rs-example
esp32 mqtt-client tls-certificate
Last synced: 4 months ago
JSON representation
the example for MQTT on esp and Rust
- Host: GitHub
- URL: https://github.com/tuemb/mqtt-esp-rs-example
- Owner: TuEmb
- Created: 2025-02-11T16:14:45.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-03-01T02:34:01.000Z (4 months ago)
- Last Synced: 2025-03-01T03:23:09.256Z (4 months ago)
- Topics: esp32, mqtt-client, tls-certificate
- Language: Rust
- Homepage:
- Size: 9.77 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MQTT ESP Rust Example
- This repository provides an example of using **MQTT** on **ESP32** with **Rust**, including **TLS support** for secure communication.
- This repo only supports **MQTT3** now. I'm planning for **MQTT5** in the future.
## Features
- Connect ESP32 to an MQTT broker using **Rust**.
- Secure communication with **TLS support**.
- Lightweight and efficient implementation.
## Requirements
- **Rust toolchain** (nightly recommended)
- **ESP32 toolchain** (esp-rs)
- **Cargo** and **cargo-espflash**
- An MQTT broker (e.g., [Mosquitto](https://mosquitto.org/), [EMQX](https://www.emqx.io/), or [HiveMQ](https://www.hivemq.com/))
## Installation & Setup
### 1. Install Rust for ESP32
Follow the official [esp-rs setup guide](https://esp-rs.github.io/book/installation/index.html) to install the necessary tools.
### 2. Clone the Repository
```sh
git clone https://github.com/TuEmb/mqtt-esp-rs-example.git
cd mqtt-esp-rs-example
```
### 3. Setup MQTT client
- put your certs at `certs`
- Update your MQTT info at `src/tasks/mod.rs`
### 4. Build & Flash
Run the following command to build and flash the firmware:
```sh
SSID="your-wifi" PASSWORD="your-wifi-password" cargo r --release
```
## Usage
Once flashed, the ESP32 will:
1. Connect to the configured Wi-Fi network.
2. Establish a **TLS-secured** MQTT connection.
3. Publish to a topic.
## Roadmap
- [ ] Add support for all ESP variants (esp32c6 for now)
## License
This project is licensed under the **MIT License**.
## Contributions
Contributions are welcome! Feel free to open an issue or submit a pull request.