Meshtastic Plugins

Build-time plugin generation package for Meshtastic firmware.

This package automatically:

• Scans PlatformIO library dependencies for plugins (libraries with src/plugin.h)
• Generates protobuf files from .proto files found in plugins
• Generates DynamicModules.cpp for plugin module initialization

Installation

Install as a local symlink package:

cd vendor/firmware
pio pkg install --symlink ../meshtastic-plugins

Or add to platformio.ini:

lib_deps = 
    file://../meshtastic-plugins

Requirements

• Python package nanopb>=0.4.9 (automatically installed if missing)
• PlatformIO libraries installed in .pio/libdeps/<env>/

Plugin Structure

Plugins must:

1. Be PlatformIO libraries installed via lib_deps
2. Have an include/plugin.h file containing #pragma MPM_MODULE(ClassName, varName?)
3. Optionally have .proto files in src/ directory for protobuf generation

How It Works

1. Scans .pio/libdeps/<env>/*/include/plugin.h for plugins
2. Installs nanopb Python package if missing
3. Generates .pb.h and .pb.c files from .proto files
4. Generates src/mesh/generated/DynamicModules.cpp with module initialization code