How bxnxm/micros works
micrOS is a local-first automation runtime for Wi-Fi MicroPython boards, with DevToolKit as its desktop setup and management client. The main workflow is to deploy a node, configure it, connect over Wi-Fi, and invoke dynamically loaded Load Module behavior through the shell or web interface; schedules, interrupts, and background jobs provide additional execution paths. The graph also preserves hardware I/O, device-to-device communication, and USB/OTA updates. Some subsystem links are documented rather than visible in sampled implementation excerpts.
Main entry points: modules Load Modules · Web.py Web interface · Server.py Socket server · micrOSloader.py Boot loader
Components 24
DevToolKit
- DevToolKit CLI/GUI
devToolKit.py - Device management
toolkit/MicrOSDevEnv.py - Socket client
toolkit/socketClient.py - Dashboard
toolkit/micrOSdashboard.py
Node runtime
- Runtime entry
micrOS/source/main.py - Boot loader
micrOS/source/micrOSloader.py - Network setup
micrOS/source/Network.py - Configuration
micrOS/source/Config.py - Node files
micrOS/source/Files.py
Automation execution
- Load Modules
micrOS/source/modules - Async tasks
micrOS/source/Tasks.py - Scheduling
micrOS/source/Scheduler.py - Interrupt handlers
micrOS/source/Interrupts.py - Node interconnect
micrOS/source/InterConnect.py
Client interfaces
- Socket server
micrOS/source/Server.py - Command shell
micrOS/source/Shell.py - Web interface
micrOS/source/Web.py - Web applications
micrOS/source/web - Authentication
micrOS/source/Auth.py
Hardware and connectivity
- Pin mapping
micrOS/source/microIO.py - Board drivers
micrOS/source/modules
Other components
- Developer
- MicroPython node
- Other nodes
Connections 25
- Developer → DevToolKit CLI/GUI: uses
README.md - DevToolKit CLI/GUI → Device management: manages
devToolKit.py - Device management → MicroPython node: deploys USB/OTA
README.md - Developer → Dashboard: controls
README.md - Dashboard → Socket client: sends commands
toolkit/micrOSdashboard.py - Socket client → Socket server: connects over socket
- MicroPython node → Runtime entry: boots
micrOS/source/main.py - Runtime entry → Boot loader: starts
micrOS/source/main.py - Boot loader → Network setup: initializes
micrOS/source/micrOSloader.py - Boot loader → Configuration: loads
micrOS/source/micrOSloader.py - MicroPython node → Socket server: serves clients
README.md - Socket server → Command shell: dispatches shell
micrOS/source/Server.py - Socket server → Web interface: dispatches web
micrOS/source/Server.py - Web interface → Web applications: serves
README.md - Web interface → Authentication: authenticates
- Command shell → Load Modules: invokes
README.md - Web interface → Load Modules: invokes
README.md - Scheduling → Load Modules: invokes
README.md - Interrupt handlers → Load Modules: invokes
README.md - Async tasks → Load Modules: runs
micrOS/source/Tasks.py - Load Modules → Pin mapping: maps pins
README.md - Pin mapping → Board drivers: selects board I/O
- Load Modules → Node interconnect: uses device commands
README.md - Node interconnect → Other nodes: communicates
README.md - Configuration → Node files: persists settings
micrOS/source/Config.py