Metadata-Version: 2.1
Name: ezdevice
Version: 0.0.7
Summary: Python tool & library for using ESP32 based Ezdevice.net projects
Home-page: https://github.com/geeksville/ezdevice-python
Author: Kevin Hester
Author-email: kevinh@geeksville.com
License: MIT
Description: # EZDevice-python
        
        This project is in alpha test - you probably don't want this yet.
        
        # Installation
        
        You can install this package with the [pip utility](https://pypi.org/project/ezdevice/) (this project requires python 3):
        
        pip install ezdevice-python
        
        Once 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 Python
        
        You 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) for
        the 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 logo
        ezdevice --target JXXXX --claim --displayfile github.png
        # show an HTML file
        ezdevice --target JXXXX --claim --displayfile myfile.html
        ```
        
        ## Programming new devices
        
        This tool _should_ automate the process of installing a ezdevice binary onto a new device. You run it as follows
        
        ezdevice --install BOARDTYPE
        
        Where 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 board
        
        Support for other device types will be released soon.
        
        Example session:
        
        ```
        mymachine:~$ ezdevice --install L
        Downloading firmware for board type L from https://joyfirmware.s3.amazonaws.com/firmware-L.bin
        esptool.py v2.6
        Found 1 serial ports
        Serial port /dev/ttyUSB0
        Connecting......
        Detecting chip type... ESP32
        Chip is ESP32D0WDQ6 (revision 1)
        Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme None
        MAC: XXX
        Uploading stub...
        Running stub...
        Stub running...
        Changing baud rate to 921600
        Changed.
        Configuring flash size...
        Auto-detected Flash size: 4MB
        Compressed 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.6
        Found 1 serial ports
        Serial port /dev/ttyUSB0
        Connecting........_
        Detecting chip type... ESP32
        Chip is ESP32D0WDQ6 (revision 1)
        Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme None
        MAC: XXX
        Uploading stub...
        Running stub...
        Stub running...
        Changing baud rate to 921600
        Changed.
        Erasing region (may be slow depending on size)...
        Erase completed successfully in 3.4 seconds.
        Hard resetting via RTS pin...
        No preconfigured wifi settings found
          Please use your phone to connect to the wifi from your new device and tell it your wifi settings
          The SSID will be EZdevice-XXXX
        ```
        
        # Author
        
        Kevin Hester, kevinh@geeksville.com
        
        # License
        
        FIXME add MIT license
        
        # Contributing
        
        The root repository for this project is located at https://github.com/geeksville/ezdevice-python. Issues and pull requests are gratefully accepted.
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3
Description-Content-Type: text/markdown
