iot-mongoose

This repository contains notes and experiments involving Mongoose OS on embedded devices (like the ESP32).

mos Tips

The mos command is used for building, deploying and diagnostics. Here are some handy things to remember.

MOS_PORT

The MOS_PORT environment variable can be set so that you do not need to specify it all of the time when running the various mos commands.

export MOS_PORT=/dev/ttyUSB0

If your device is configured for network access and RPC over WebSockets, you can set your MOS_PORT so that many of the commands (including the mos IDE) will work remotely:

export MOS_PORT=ws://10.8.68.44/rpc

Unfortunately, as far as I can tell, the mos console command does not work remotely (MOS_PORT should be set to a USB device, not a WebSocket).

List mos Commands

mos --help

List mos Commands and Options

mos --helpfull 2>&1 | less

Start mos IDE (User Interface)

mos ui

Console

mos console

NOTE: As far as I can tell this requires a direct USB connection to an ESP32 (no remote access).

However, you can get output sent to a UDP port on a specific machine and this can all be done remotely as the config-set command will work over a WebSocket connection.

mos config-set debug.udp_log_addr=10.8.68.95:9993 debug.level=2
nc --listen --udp 9993

When you are done, you can turn off the UDP logging via:

mos config-set debug.udp_log_addr= debug.level=1

NOTE: Changing the UDP logging configuration appears to reset the device.

Build and Deploy

Cloud Build (requires Internet)

mos build

Local Build (requires ability to run Docker)

mos build --local

Deploy over USB connection:

mos flash

Deploy over the air (using a network connection). The project must include supporting libraries for this to work (ota-http-server). The firmware file should be found at build/fw.zip after a successful build.

export MOS_IP=192.168.4.1
curl -v -i -F filedata=@build/fw.zip http://${MOS_IP}/update

File Management

mos ls -l
mos get index.html > /tmp/index.html
mos put /tmp/index.html trash.html
mos rm trash.html

Configuration

mos config-get
mos config-get debug.udp_log_addr
mos config-set debug.udp_log_addr=10.8.68.95:9993 debug.level=2
mos config-set debug.udp_log_addr=  debug.level=1

RPC

mos call RPC.List
mos call Config.Get
mos call Sys.GetInfo
mos call Sys.Reboot

paul-blankenbaker/iot-mongoose