Cardputer ADV UHF Expansion Firmware
简体中文 · Product page
This repository contains the Cardputer ADV ESP32-S3 firmware. It is not a Cardputer Zero Linux/APPLaunch application.
Portable UHF RFID EPC inventory firmware for the M5Stack Cardputer ADV, designed for the MTools Tec UHF Expansion for Cardputer Zero / ADV. The hardware supports EPC Gen2 / ISO 18000-6C across 840–960 MHz; use only frequencies and power levels permitted in your region.
Quick install with M5Burner
No local build is required:
- Open M5Burner Web.
- Search for
UHF Expansion.
- Select the firmware and flash it to your Cardputer ADV.
Make sure the selected serial port belongs to the Cardputer ADV before flashing.
Features
- Real-time EPC inventory with unique-tag, total-read, and reads-per-second statistics
- Persistent table and animated radar/count views
- Up to 64 tags with EPC, RSSI, hit count, and first/last-seen timestamps
- Audible feedback when a tag is detected
- CSV export to microSD or LittleFS, with automatic fallback to LittleFS
- A0 command protocol with BB-frame receive compatibility
- UHF module firmware version and Cardputer ADV battery status
Controls
| Key | Action |
|---|---|
| Space | Start or stop inventory |
| Tab | Switch between the EPC table and radar/count view |
| Up / Down | Scroll the EPC list |
| C, Del, or Backspace | Clear tags and counters |
| W | Save the current inventory as CSV |
| T | Switch storage between LittleFS and microSD |
CSV files are stored under /uhf/ with the fields epc,count,rssi,first_seen_ms,last_seen_ms.
Manual download and flash
If you prefer a local workflow, output/firmware.bin is a complete merged image. Flash it from address 0x0000. Its SHA-256 checksum is available in output/firmware.sha256.
You can also flash it locally with esptool:
esptool.py --chip esp32s3 --port /dev/cu.usbmodemXXXX --baud 460800 \
write_flash 0x0000 output/firmware.bin
Confirm that the selected serial port belongs to the Cardputer ADV ESP32-S3 before flashing.
Build from source
Install PlatformIO Core, then run:
pio run
A successful build automatically regenerates:
output/firmware.bin: merged bootloader, partition table, OTA data, and application image
output/firmware.sha256: SHA-256 checksum for the merged image
To upload during development and monitor the serial port:
pio device list
pio run -t upload --upload-port /dev/cu.usbmodemXXXX
pio device monitor -b 115200 --port /dev/cu.usbmodemXXXX
Firmware pin assignment
| Cardputer ADV | Firmware function |
|---|---|
| GPIO 15 | UHF UART RX, connected to module TX |
| GPIO 13 | UHF UART TX, connected to module RX |
| GPIO 12 | microSD CS |
| GPIO 14 | microSD MOSI |
| GPIO 40 | microSD SCK |
| GPIO 39 | microSD MISO |
The UHF UART uses 115200 baud, 8-N-1.
Hardware references
Responsible use
Use this firmware only with RFID tags and systems you own or are authorized to test. Follow local radio, privacy, and data-protection requirements.