Package: ezdevice
# EZDevice-pythonThis project is in alpha test - you probably don't want this yet.# InstallationYou can install this package with the [pip utility](https://pypi.org/project/ezdevice/) (this project requires python 3):pip install ezdevice-pythonOnce installed you can use this executable either as a command-line tool or as a library for your own python applications.## Talking to your devices via the web from PythonYou can use the [EZDeviceClient class](/doc/ezdevice.client.html) as a wrapper for the REST API exposed by the server.Click the link to see the current crude generated HTML documention or see [the source code](/ezdevice/client.py) forthe current implemention. This library is not yet complete, essentially offering only an API to set the image shown on the screen.Send me a note if you'd like to use it and a feature is missing and I'll add it.All of the API operations are also available from the shell for testing. For instance, the following will show an image on the display.```# show a github logoezdevice --target JXXXX --claim --displayfile github.png# show an HTML fileezdevice --target JXXXX --claim --displayfile myfile.html```## Programming new devicesThis tool _should_ automate the process of installing a ezdevice binary onto a new device. You run it as followsezdevice --install BOARDTYPEWhere boardtype is a pair of letters:- JL for the TTGO T5 with a 2.13" eink screen- JK for the TTGO T5 with a 2.9" red and black eink screen- JY for the TTGO T5 with a 2.9" yellow and black eink screen- JM for the TTGO T5s with a two color eink screen- JR for the TTGO T4- JO for the TTGO with a 18650 battery and OLED screen (I'm not sure if this has a model number)- JG for the TTGO GROW plant sensor- JT for the TTGO Camera (the skinny one with no motion sensor)- JC for the TTGO Camera (the wider one with bigger screen and a motion sensor)- MS for the M5STICK board- MB for the M5BASIC boardSupport for other device types will be released soon.Example session:```mymachine:~$ ezdevice --install LDownloading firmware for board type L from https://joyfirmware.s3.amazonaws.com/firmware-L.binesptool.py v2.6Found 1 serial portsSerial port /dev/ttyUSB0Connecting......Detecting chip type... ESP32Chip is ESP32D0WDQ6 (revision 1)Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme NoneMAC: XXXUploading stub...Running stub...Stub running...Changing baud rate to 921600Changed.Configuring flash size...Auto-detected Flash size: 4MBCompressed 926960 bytes to 509378...Wrote 926960 bytes (509378 compressed) at 0x00010000 in 8.3 seconds (effective 898.4 kbit/s)...Hash of data verified.Leaving...Hard resetting via RTS pin...esptool.py v2.6Found 1 serial portsSerial port /dev/ttyUSB0Connecting........_Detecting chip type... ESP32Chip is ESP32D0WDQ6 (revision 1)Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme NoneMAC: XXXUploading stub...Running stub...Stub running...Changing baud rate to 921600Changed.Erasing region (may be slow depending on size)...Erase completed successfully in 3.4 seconds.Hard resetting via RTS pin...No preconfigured wifi settings foundPlease use your phone to connect to the wifi from your new device and tell it your wifi settingsThe SSID will be EZdevice-XXXX```# AuthorKevin Hester, kevinh@geeksville.com# LicenseFIXME add MIT license# ContributingThe root repository for this project is located at https://github.com/geeksville/ezdevice-python. Issues and pull requests are gratefully accepted.