Skip to main content
Documentation Status

Description

Cloudmanger provides a single point of managment for micropython systems that minimizes the security attack surface and offloads resource intensive operations from the micropython clients to the server.

Quickstart

Here is a quickstart for setting up cloudmanager with popular esp8266 boards

Install

Use pip to install the server and client flash utility:

$ pip install micropython-cloudmanager micropython-cloudmanager-esp8266
$

Start Server

Start the server process with the default settings:

$ mbm server-start
Cloudmanager service is listening on: 192.168.1.127:18266
$

Flash and Configure esp8266 board as a client

Plug in the esp8266 board, into the usb port.

NOTE: Some boards may need to be manually put into flash mode per the vendor instructions.

The flash tool will generally determine the correct serial device to flash as long as only one usb serial device is connected to the system.

Flash and configure the board specifying the wifi connection settings:

$ flash_esp_image --wifi_ssid mywifi --wifi_password mywifipassword
esptool.py --port /dev/ttyUSB0 --baud 115200 erase_flash
esptool.py v1.2.1
Connecting...
Running Cesanta flasher stub...
Erasing flash (this may take a while)...
Erase took 9.0 seconds
esptool.py --port /dev/ttyUSB0 --baud 115200 write_flash --verify --flash_size=32m --flash_mode=qio 0 /tmp/cloudmanager-micropython-esp8266/local/lib/python2.7/site-packages/cloudmanager_micropython_esp8266/firmware/firmware-combined.bin
esptool.py v1.2.1
Connecting...
Running Cesanta flasher stub...
Flash params set to 0x0040
Writing 557056 @ 0x0... 557056 (100 %)
Wrote 557056 bytes at 0x0 in 48.3 seconds (92.3 kbit/s)...
Leaving...
Verifying just-written flash...
Verifying 0x8734c (553804) bytes @ 0x00000000 in flash against /tmp/cloudmanager-micropython-esp8266/local/lib/python2.7/site-packages/cloudmanager_micropython_esp8266/firmware/firmware-combined.bin...
-- verify OK (digest matched)
>>>
>>> import os
>>> os.mkdir('etc')
>>> from bootconfig.config import get, set
>>> set('wifi_ssid', 'mywifi')
>>> set('wifi_password', 'mywifipassword')
>>> set('redis_server', '192.168.1.127')
>>> import bootconfig.service
>>> bootconfig.service.autostart()
>>> import redis_cloudclient.service
>>> redis_cloudclient.service.autostart()
>>> import machine
>>> machine.reset()

NOTE: At this point some boards need to be manually reset.

Verify the board is registered with the server

After a few seconds the board should connect to the wifi network and register with the cloudmanager server:

$ mbm board-list
Name       Platform                                           State
esp8266-1  esp8266                                            idle
$

See the full documentation to use cloudmanager to install packages, upload files or execute commands on the board.

Release files for micropython-cloudmanager 0.0.165

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for micropython-cloudmanager 0.0.165
File Size Uploaded
micropython-cloudmanager-0.0.165.tar.gz 14.0 kB Details

Release files / micropython-cloudmanager-0.0.165.tar.gz

Download URL micropython-cloudmanager-0.0.165.tar.gz
Size 14.0 kB
Tags Source
SHA-256 checksum
How to use checksums
3dd3f04b3cb94da69657a73fa3316e68efb867f0aa4137a8bc5c87b90ab61dee
BLAKE2b-256 checksum
How to use checksums
e52e6092fac150c3eb38b1a2d6bf0c8cea6ef1fbf8aac516ea52fcb6299b998c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.0.165 This release

1 release file

0.0.140

1 release file

0.0.108

1 release file

0.0.107

1 release file

0.0.106

1 release file

0.0.105

1 release file

0.0.104

1 release file

0.0.103

1 release file

0.0.102

1 release file

0.0.96

1 release file

0.0.93

1 release file

0.0.92

1 release file

0.0.16

1 release file

0.0.5

1 release file

0.0.4

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page