8000 GitHub - burakcan/MeshCore-mishmesh: Standalone companion firmware for MeshCore radios. · GitHub
[go: up one dir, main page]

Skip to content

About

Standalone companion firmware for MeshCore radios.

Resources

Contributing

Security policy

Stars

143 stars

Watchers

10 watching

Forks

Latest commit

 

History

3,766 Commits

Folders and files

Repository files navigation

mishmesh

Standalone companion firmware for MeshCore radios.

Buy Me a Coffee at ko-fi.com

This is a fork of MeshCore that adds mishmesh, a standalone user interface. MeshCore's companion firmware normally leans on a paired phone for most things; mishmesh puts messaging, contacts, and configuration on the device, so the radio is useful on its own and the phone is optional. It can currently do almost everything without a phone.

It targets the Seeed Wio Tracker L1 / L1 Pro (128x64 OLED), the Wio Tracker L1 E-Ink (2.13", 250x122), which also gets portrait orientation, a larger interface size, and a face left on the glass while the panel sleeps, and the GAT562 30S Mesh Kit (128x64 OLED, with the joystick and buzzer populated). In theory we can support more devices with enough buttons.

The underlying MeshCore firmware is mostly unchanged; see About MeshCore below.

Screens


Home

App menu

Contacts

Contact detail

Conversation

Quick replies

Keypad

Repeater status

Settings

Stopwatch

Timer

Alarm

World clock

mishmesh features

  • Messaging - direct messages, channels, and room servers, with delivery status, auto-retry, and path reset when a route goes stale.
  • Text entry - Nokia-style multi-tap keypad with symbols and emoji, in 18 keyboard layouts. Latin (English, German, French, Spanish, Italian, Portuguese, Swedish, Norwegian, Turkish, Polish, Czech, Hungarian) and Cyrillic (Russian, Ukrainian, Belarusian, Bulgarian, Serbian, Macedonian). Channel keys get a hex-only pad.
  • Contacts - favourites and per-kind tabs (people, repeaters, rooms), rename, ping, telemetry requests, and path management.
  • Repeater management - log in to a repeater and configure it from the device: settings, access list, neighbours, region.
  • Clock - stopwatch, timer, alarm, and a world clock with DST-aware timezones.
  • Airtime - live duty-cycle and airtime usage against the TX budget.
  • Adverts and sharing - send adverts and share contacts/channels as QR.
  • Settings on-device - radio config (frequency, bandwidth, spreading factor, TX power), screen sleep, sound, and timezone.
  • First-boot onboarding - a short wizard for name, region, and time.

Install

Grab the latest .uf2 for your board from Releases - WioTrackerL1_companion_radio_*_mishmesh_mm-*.uf2 for the OLED board, WioTrackerL1Eink_companion_radio_*_mishmesh_mm-*.uf2 for the e-ink one, GAT562_30S_Mesh_Kit_companion_radio_*_mishmesh_mm-*.uf2 for the GAT562 - then:

  1. Plug the board into USB.
  2. Double-tap reset. It mounts as a USB drive.
  3. Drop the .uf2 onto it. It reboots into mishmesh.

The ble build pairs with the phone/web app over Bluetooth; the usb build talks over USB serial. Either way the device is fully usable on its own.

Or build it yourself.

Building from source

A PlatformIO project. With the repo cloned:

export FIRMWARE_VERSION=mishmesh-dev
pio run -e WioTrackerL1_companion_radio_usb_mishmesh -t upload   # or _ble_mishmesh

On the e-ink board swap WioTrackerL1_ for WioTrackerL1Eink_ in the env name, on the GAT562 for GAT562_30S_Mesh_Kit_.

Package the .uf2 / .zip like a release does (lands in out/):

export FIRMWARE_VERSION=mishmesh-dev
sh build.sh build-firmware WioTrackerL1_companion_radio_usb_mishmesh

Emoji

Emoji use the EmojiMania glyph set - a purchased license that doesn't allow redistributing the art, so the glyphs live outside this repository. Official release builds compile them in. Building from source, or any fork, is fully supported and looks identical, except emoji render as a placeholder block instead of the glyph.

If you own EmojiMania, you can build with emoji yourself: drop your sheet in and run the generator per mishmesh/text/emoji-tools/README.md.

How mishmesh fits

The framework lives under mishmesh/; a thin adapter in examples/companion_radio/ui-mishmesh/ bridges it to the companion app without touching main.cpp. Screens are Applet subclasses on a fixed stack managed by AppletHost; all drawing goes through Canvas. Text and icons are bitmap fonts rendered with mcufont (Nokia Cellphone FC, Tom Thumb, hand-edited Cyrillic, Pixelarticons); the logo wordmark is set in the LastPriestess pixel font by Christina Antoinette Neofotistou.

Font sources and reproducible generators live in mishmesh/text/fonts. Run build_cyrillic.py to rebuild the Cyrillic ranges and preview_fonts.py to render review sheets. Open font_editor.html directly from disk to edit Body.c, Subtitle.c, or Caption.c; the single-file editor does not require a web server.

AI disclosure

It's mixed. I use AI a lot at work. Side projects are a way for me to keep my programming skills alive. This project contains a mix of manually written and AI generated (but manually reviewed) code. I used it more heavily in brainstorming ideas and discovering the original codebase. Don't use this if you're a purist.


About MeshCore

mishmesh is a fork of MeshCore, a lightweight, portable C++ library for multi-hop packet routing over LoRa and other packet radios. The mesh core, the companion firmware, supported hardware and the flasher, the phone/web apps, and the protocol documentation all come from that project. For anything about MeshCore itself, see the upstream repository:

https://github.com/meshcore-dev/MeshCore

License

MIT, the same as MeshCore.

About

Standalone companion firmware for MeshCore radios.

Resources

Contributing

Security policy

Stars

143 stars

Watchers

10 watching

Forks

Releases

Sponsor this project

Contributors

Languages

0