https://github.com/WebThingsIO/webthing-upy

MicroPython implementation of a Web Thing server
https://github.com/WebThingsIO/webthing-upy

Last synced: 3 months ago
JSON representation

MicroPython implementation of a Web Thing server

• Host: GitHub
• URL: https://github.com/WebThingsIO/webthing-upy
• Owner: WebThingsIO
• License: mit
• Created: 2018-05-15T16:21:49.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2021-01-07T17:38:20.000Z (about 4 years ago)
• Last Synced: 2024-01-24T04:54:20.084Z (about 1 year ago)
• Language: Python
• Size: 65.4 KB
• Stars: 52
• Watchers: 7
• Forks: 16
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-web-of-things - MicroPython

README

        
# webthing-upy

This is a MicroPython version of webthing-python.

This has been tested on an ESP-WROVER-KIT and a SparkFun ESP32 Thing using the

loboris version of ESP32 MicroPython.

The loboris port has a forked copy of https://github.com/jczic/MicroWebSrv and

this requires some further changes which can be found here:

https://github.com/dhylands/MicroPython_ESP32_psRAM_LoBo/tree/rest-improvements

# Building and Flashing MicroPython

Using https://github.com/dhylands/MicroPython_ESP32_psRAM_LoBo/tree/rest-improvements follow

the directions in the [README.md](https://github.com/dhylands/MicroPython_ESP32_psRAM_LoBo/tree/rest-improvements/README.md) file

# Installing webthing-upy

I used version 0.0.12 of [rshell](https://github.com/dhylands/rshell) to copy the webthing-upy files to the board. The

ESP-WROVER-KIT board advertises 2 serial ports. Use the second port (typically /dev/ttyUSB1). The SparkFun ESP32 Thing only advertises a single serial port.

Edit the config.py with an appropriate SSID and password. Edit main.py to be appropriate for the board you're using.

Sample main.py for the SparkFun ESP32 Thing:

```

import start

start.thing()

```

Sample main.py for the ESP-WROVER-KIT:

```

import start

start.rgb()

```

For debugging, remove main.py and enter commands at the REPL manually.

```

$ cd webthing-upy

$ rshell -a --buffer-size=30 --port=/dev/ttyUSB1

webthing-upy> rsync -v . /flash

webthing-upy> repl

>>> Control-D

```

Pressing Control-D will cause the board to soft reboot which will start executing main.py.

# Adding to Gateway

To add your web thing to the WebThings Gateway, install the "Web Thing" add-on and follow the instructions [here](https://github.com/WebThingsIO/thing-url-adapter#readme).