Repository navigation
WMBus RX
Receives and decodes Wireless M-Bus (wM-Bus) telemetry from utility meters — water, gas, heat and electricity meters that report over radio in the 868 MHz band.
This is an external app (.ppma file on the SD card).
Wireless M-Bus (EN 13757) is the European standard that smart utility meters use to transmit consumption and status data by radio. The app receives these packets, validates each one with the wM-Bus CRC, and decodes the meter's identity and — for unencrypted frames — the reported values.
Select the mode that matches the meter, tune to the matching frequency, and received packets appear in the console.
| Mode | Frequency | Notes |
|---|---|---|
| T-Mode | 868.95 MHz | 3-of-6 chip coding (default mode) |
| C-Mode | 868.95 MHz | compact mode |
| S-Mode | 868.3 MHz | slower, stationary mode |
The app does not retune automatically — set the frequency field to the frequency shown above for the selected mode.
| Control | Description |
|---|---|
| Mode | wM-Bus mode: T / C / S (see table above). |
| Frequency | Tune to the mode's frequency (10 kHz steps). |
| RF Amp | RF amplifier: 0 = off, 1 = on (+14 dB). |
| LNA | IF gain (0–40 dB). See Receive Quality Issues. |
| VGA | Baseband gain (0–62 dB). |
| RSSI / Channel | Signal strength and channel power meters. |
| Last Err | Reason the last frame was rejected (CRC fail, length error, coding error …) or None. |
For each valid packet the console shows:
| Field | Meaning |
|---|---|
| Mfr | Manufacturer — 3-letter flag code decoded from the meter header |
| ID | Meter serial number (hex) |
| Ver | Device version byte |
| Type | Device / medium type — e.g. Water, Cold water, Hot water, Gas, Electricity, Heat, Heat cost allocator, Smoke detector |
| CI / Enc | Control-information byte and encryption status: None, AES-128, DES or Mode n
|
| V: | Up to three decoded data values (shown only for unencrypted frames) |
| Hex | Raw hex dump of the frame |
Encrypted frames (AES-128 / DES) are identified but their values cannot be read without the key.
Wireless M-Bus (EN 13757-4) operates in the 868 MHz short-range band using FSK. T-Mode uses 3-of-6 chip coding, C-Mode is the newer compact mode, and S-Mode is the slower stationary mode. Each frame is verified with the wM-Bus CRC (polynomial 0x3D65) before it is decoded.
- ERT — decodes North-American (ERT / IDM / SCM) utility-meter telemetry
How to collaborate
Contributing Guidelines
Trusted contributors
How to ask questions correctly
- PortaPack Versions (which one to buy)
- Features
- HackRF Versions
-
Description of the hardware
- Enclosure/cases
- Care of PortaPack/HackRF
- Repairs
- Mods
🔧 Troubleshooting
- FAQ
- SolveBoard
- 🔌 Boot & power
- 💾 Firmware & recovery
- 📡 Receive & transmit
- 💳 SD card
- 🔗 USB connectivity
- 🧩 Apps
📥 Receivers
- 2-Tone-RX
- ACARS
- ADS-B
- AFSK
- AIS Boats
- Analog TV
- APRS RX
- Audio
- BLE RX
- Detector
- EPIRB RX
- ERT Meter
- Flex RX
- Fox-Hunt
- FPV-Detect
- FT8 RX
- gfxEQ
- Level
- Meteor
- Morse RX
- NOAA
- NRF
- POCSAG
- ProtoView
- Radio
- Radiosonde
- RDS RX
- RTTY RX
- Scanner
- Search
- Signal Hunter
- Spectrum Analyzer
- SSTV RX
- SubCar
- SubGhzD
- Tetra RX
- Time Sink
- TPMS RX
- VOR RX
- Weather
- WeFax
- WMBus RX
📤 Transmitters
- 2-Tone-TX
- ADS-B(S) TX
- Adult Toys
- APRS TX
- BHT Xy/EP
- BLE TX
- BLESpam
- Burger Pager
- CVS Spam
- EPIRB TX
- Flex TX
- FlipperTX
- GPS Sim
- Hopper
- Jammer
- KeeLoq TX
- Key fob TX
- LGE Tool
- MDC-1200 TX
- Morse TX
- OOK
- OOK Brute
- OOK Editor
- P25 TX
- POCSAG TX
- RDS
- RTTY TX
- SAME TX
- Security+ TX
- Signal gen
- Soundboard
- Spectrum Painter
- SSTV
- TEDI/LCR
- TouchTunes
- TPMS TX
- VOR TX
- 🔄 Transceivers
- 🟡 Recon
- 🔴 Capture
▶️ Replay- 🖲️ Remote
- 🔍 Looking Glass
🛠️ Utilities
↳ 🐛 Debug Menu (in Utilities)
🎮 Games
⚙️ Settings
Compilation of the firmware
- Compile on WSL with ninja
- How to compile on Windows faster with WSL 2
- Compile on macOS (Docker)
- Compile on macOS (Homebrew)
- Using Docker and Kitematic
- Docker command-line reference
- Using Buddyworks and other CI platforms
- Notes for Buddy.Works (and other CI platforms)
- Using ARM on Debian host
- All in one script for ARM on Debian host
- Compile on Kali Linux (Debian-based)
- Compile on Arch based distro (exclude Asahi), or other weird distros
- General compiling guide (Linux, for experts)
- Dev build versions
- Notes About ccache
Software Dev Guides
- Code contribution rules
- Documentation standards & guidelines
- Create a Simple App
- Create a Simple External App
- External Apps informations
- Widgets
- UI positioning with macros
- SD Card (DEV)
- Access Radio Hardware
- Interpret Guru meditation crashes
- Create a Complex App
- Theme-system
- Debug via SWD & JTAG
- Debug with serial
- I2C drivers
- Unit tests
Tools
- Research
- UI Screenshots
-
Maintaining
- Creating a prod/stable release (Maintainers only)
- Maintaining rules
- Development States Notes