Mongoose OS welcomes Hackster Apps users
Mongoose OS - is an open source operating system for connected microcontrollers
It reduces IoT firmware development time up to 90%
- Supported microcontrollers: ESP32, ESP8266, STM32, TI CC3200
- Code in JavaScript or C
- Built-in support for any public or private MQTT server
- Supports TCP, UDP, HTTP, Websocket, MQTT, CoAP, DNS, mDNS-SD, SNTP protocols
- Filesystem with POSIX API and built-in encryption for device data protection
Download and install
Installation on Windows Download mos.exe
Download mos.exe by clicking on the button above, then
choose installation type:
- For simple Mongoose OS installation double-click
mos.exeand follow a Web UI wizard.
OR
- For advanced Mongoose OS installation copy
mos.exeto yourc:\Windowsfolder, start command line prompt and use extendedmos.exefunctionality:mos flash mos-esp8266 mos wifi YOUR_WIFI_NETWORK YOUR_WIFI_PASSWORD mos console
Windows, Web UI
Windows, command prompt
Installation on Linux or MacOS
Start terminal, copy-paste the following command and press enter:
curl -fsSL https://mongoose-os.com/downloads/mos-release/install.sh | /bin/sh
This will download and install the mos tool into ~/.mos/bin/ directory.
Choose installation type:
- For simple Mongoose OS installation start terminal and enter:
~/.mos/bin/mos
- For advanced Mongoose OS installation start terminal and enter:
~/.mos/bin/mos flash mos-esp8266 ~/.mos/bin/mos wifi YOUR_WIFI_NETWORK YOUR_WIFI_PASSWORD ~/.mos/bin/mos console
Linux/Mac, Web UI
Linux/Mac, terminal
Video Tutorials Watch Seedstudio Grove tutorials
Tutorial 1. Install Mongoose OS
Video duration: 1 min 25 sec
Hardware: ESP32 DevKitC dev board
Commands used:
mos flash mos-esp32 # Install on ESP32
mos flash mos-esp8266 # Install on ESP8266
mos flash mos-cc3200 # Install on TI CC3200
mos flash mos-stm32-nucleo-F746ZG # Install on STM32 Nucleo
mos flash mos-stm32-disco-F746G # Install on STM32 Discovery
Tutorial 2.Work with files
Video duration: 1 min 42 sec
Hardware: ESP32 DevKitC dev board
Commands used:
mos ls # List files
mos get FILENAME # Print contents of FILENAME
mos put FILENAME # Copy FILENAME to the device
mos rm FILENAME # Delete FILENAME
Tutorial 3. Configure WiFi
Video duration: 49 sec
Hardware: ESP32 DevKitC dev board
Commands used:
mos wifi WIFI_NETWORK_NAME WIFI_PASSWORD
Tutorial 4. Built-in web server
Video duration: 1 min 20 sec
Hardware: ESP32 DevKitC dev board
Commands used:
mos get index.html > a # Fetch index.html
vim a # Edit local file
mos put a index.html # Upload back to index.html
Tutorial 5. Using Configuration
Video duration: 2 min 21 sec
Hardware: ESP8266 NodeMCU v3
Commands used:
mos config-get
mos config-set debug.level=3
mos config-set mqtt.server=a.b.c:12345
Tutorial 6. Programming in JavaScript
Video duration: 5 min 41 sec
Hardware: ESP8266 NodeMCU v3
Commands used:
mos call Control '{"state": 0}'
mos call GetNetworkStatus
curl -d '{"state": 1}' ws://IP/rpc/Control
mos --port ws://IP/rpc call Control '{"state": 0}'
mos --port mqtt://MQTT_SERVER:PORT/DEVICE_ID call Control '{"state": 0}'
Tutorial 7. Programming in C
Video duration: 6 min 28 sec
Hardware: ESP8266 NodeMCU v3
Commands used:
mos init --arch esp8266 # Initialise empty project
mos build # Build firmware
mos flash # Flash firmware
mos call Control '{"state": 0}' # See prev. tutorial
Tutorial 8. Built-in services
Video duration: 3 min 43 sec
Hardware: ESP8266 NodeMCU v3
Commands used:
mos call RPC.List
mos call RPC.Describe '{"name": "GPIO.Write"}'
mos call GPIO.Write '{"pin": 16, "value": 0}'
Tutorial 9. Over-the-Air update (OTA)
Video duration: 7 min 42 sec
Hardware: CC3200 LaunchPad
Commands used:
mos --port ws://DEVICE_IP/rpc call OTA.Update '{"url": "http://MYSITE/fw.zip", "commit_timeout": 100}'
mos --port ws://DEVICE_IP/rpc call OTA.Commit
Tutorial 10. MQTT publish & subscribe
Video duration: 3 min 30 sec
Hardware: ESP8266 NodeMCU
init.js code:
load('api_mqtt.js');
load('api_gpio.js');
let pin = 0, topic = 'my/topic';
GPIO.set_button_handler(pin, GPIO.PULL_UP, GPIO.INT_EDGE_NEG, 200, function() {
MQTT.pub('my/topic', JSON.stringify({ a: 1, b: 2 }));
}, null);
MQTT.sub('my/topic/#', function(conn, topic, msg) {
print('Topic:', topic, 'message:', msg);
}, null);
Tutorial 11. AWS device shadows
Tutorial 12. ESP32 flash encryption
Video duration: 3 min 55 sec
Hardware: ESP32 DevKitC
Commands used:
mos flash esp32
mos flash-read --arch esp32 0x190000 2000 -
mos -X esp32-gen-key flash_encryption_key fe.key \
--esp32-enable-flash-encryption --dry-run=false
mos flash esp32 --esp32-encryption-key-file fe.key
