mPWRD-OS

Armbian + Meshtastic == mPWRD-OS

Spudgunman Fork

• Has meshing-around BBS loaded
• Full set of common dev tools needed to load mesh projects

Features

• 🐧 Debian 13 trixie based.
• ❤️ Built with Armbian userpatches framework.
• Ⓜ️ meshtasticd pre-installed and working out of the box.
• 🐍 meshtastic CLI pre-installed.
• 📡 contact Meshtastic TUI pre-installed.
• 🧙 mpwrd-menu simple OS / Meshtastic management utility.
• 🔵 BLE WiFi provisioning via the Meshtastic Apps / Flasher.
  • Powered by 🏠 Nymea-NetworkManager.
  • Supported on Raspberry Pi.
• 🛜 Web provisioning via temporary armbiansetup hotspot.
  • Powered by 🌐 armbian-web-config.
  • Supported on Luckfox Lyra Zero W and Luckfox Lyra Ultra W with more to come.

Board Support

Tip

Some boards require preparation before mPWRD-OS can be used, see the Board Support wiki page.

Chipset	Board	Status	meshtasticd status
BCM2711	🍓 Raspberry Pi (64-bit)	Supported	✅ beta
RK3506G	🛜 EByte ECB41-PGE	Supported	✅ beta
RK3506G	🦊 Luckfox Lyra Plus	Supported	✅ beta
RK3506B	🦊 Luckfox Lyra Ultra W	Supported	✅ beta
RK3506B	🦊 Luckfox Lyra Zero W	Supported	✅ beta
RK3506J	🐈 ForLinx OK3506-S12	Supported	✅ beta
RV1106G	🦊 Luckfox Pico Max	Supported	✅ beta
RV1103G	🦊🤏 Luckfox Pico Mini	Supported	✅ beta
RV1103B	🧅 OnionIOT Omega4	Todo
UEFI	🖥️ Generic x86_64 UEFI	Dev	✅ beta

Default Credentials

Username	Password
root	1234

Using mPWRD-OS

See Also: mPWRD-OS Provisioning

1. Flash the latest image from the build tool, using balenaEtcher or a similar tool.
   • For boards with eMMC: Flash with rkdevtool. (Guide coming soon).
2. SSH into the device (or connect with Serial), login with default credentials. You will be prompted to change this upon first login.
3. Run mpwrd-menu to setup Meshtastic, change settings, and more!

🥔 Using this repo 🥔

To get a image to flash to SDcard for the femtofox follow these directions. I use a Ubuntu 24.04 Virtual Image to follow the steps below.

1. Checkout armbian/build and enter the dir

git clone https://github.com/armbian/build.git
cd build

2. Checkout this repo as "userpatches"

git clone https://github.com/SpudGunMan/mPWRD-OS-dev-kit userpatches

3. Compile!

./compile.sh luckfox-pico-mini build KERNEL_CONFIGURE=no

This example will build the configuration at config-luckfox-pico-mini.conf

🥔🥔🥔 To build other boards with a wider selection, run 🥔🥔🥔

./userpatches/run-build.sh build

The output image will go into .. build/output/images

🥔🥔 Once booted and system is setup radio is lit up and working..

• Edit the /opt/meshing-around/config.ini as needed
• To install sercvice run from the /opt/meshing-around directory
  • sudo bash etc/install_service.sh

Your mPWRD-OS device should now be running meshing-around bot! 🥔🥔🥔