[Из песочницы] MicroPyServer простой HTTP сервер для ESP8266 и ESP3201.12.2019 23:48

Промо

Всем привет!

Хочу рассказать о библиотеке MicroPyServer написанной на Python, которая позволяет взаимодействовать с устройствами ESP8266 и ESP32 посредством простого HTTP сервера.


Что такое MicroPyServer?

MicroPyServer это простой HTTP сервер предназначенный для проектов написанных на Micropython.

Основная концепция работы с библиотекой — это перехватывание запросов к устройству при помощи создания роутов (route) и функций обработчиков (handler).

Основные действия с библиотекой:


  • Создание сервера

    srv = MicroPyServer()

    По умолчанию сервер работает на 80-ом порту.


  • Добавление роута, который будет обрабатывать запросы по заданному урлу

    def do_something(request):
  pass()
srv.add_route("/url_path", do_something)

    По умолчанию обрабатываются GET запросы.


  • Отправка данных клиенту

    def do_something(request):
 srv.send("OK")

    По умолчанию отправляется код ответа 200 и Content-Type: text/plain.


  • Запуск сервера

    srv.start()

Исходники MicroPyServer можно скачать тут https://github.com/troublegum/micropyserver


Список методов MicroPyServer

Конструктор — srv = MicroPyServer (host=»0.0.0.0», port=80)
Запустить сервер — srv.start ()
Добавление роута — srv.add_route (path, handler, method=«GET»)
Отправить ответ — srv.send (response, status=200, content_type=«Content-Type: text/plain», extra_headers=[])
Отправить 404-ю ошибку — srv.not_found ()
Отправить 500-ю ошибку — srv.internal_error (error)


Примеры

Рассмотрим несколько небольших примеров работы с библиотекой MicroPyServer.


Hello world

Классический пример hello world.

from micropyserver import MicroPyServer
import esp
import network

''' Код подключения к WiFi '''
wlan_id = "Your WiFi"
wlan_pass = "Your WiFi password"

wlan = network.WLAN(network.STA_IF)
wlan.active(True)
if wlan.isconnected() == False:
    wlan.connect(wlan_id, wlan_pass)
    while wlan.isconnected() == False:
        time.sleep(1)
print('Device IP:', wlan.ifconfig()[0])

def show_message(request):
    ''' request handler '''
    server.send("HELLO WORLD!")

server = MicroPyServer()
''' add request handler '''
server.add_route("/", show_message)
''' start server '''
server.start()

Набрав у браузере адрес http://IP_вашего_устройства/ вы получите сообщение «HELLO WORLD!»


Простой пример настройки роутинга и управления выводом GPIO

В данном примере настроим обработку двух урлов которые будут делать: «включение» (/on) и «выключение» (/off) светодиода подключенного к выходу D7 ESP8266.

схема подключения светодиода

from machine import Pin
from micropyserver import MicroPyServer

''' Тут должен быть код подключения к WiFi '''

def do_on(request):
    ''' on request handler '''
    pin.value(1)
    server.send("ON")

def do_off(request):
    ''' off request handler '''
    pin.value(0)
    server.send("OFF")

pin = machine.Pin(13, machine.Pin.OUT)
server = MicroPyServer()
''' add request handlers '''
server.add_route("/on", do_on)
server.add_route("/off", do_off)
''' start server '''
server.start()

В итоге набрав у браузере адрес http://IP_вашего_устройства/on вы включите подключенный к выходу D7 светодиод и в браузере выведется сообщение «ON». Соответственно набрав у браузере адрес http://IP_вашего_устройства/off вы выключите светодиод.


Вывод информации с датчика DHT в JSON

В данном примере показано как получить данные с датчика влажности и температуры DHT22 в виде JSON.

схема подключения датчика

import json
import dht
from machine import Pin
from micropyserver import MicroPyServer

''' Тут должен быть код подключения к WiFi '''

def show_data(request):
    ''' request handler '''
    d = dht.DHT22(machine.Pin(4))
    d.measure()
    data = {"temperature":  d.temperature(), "humidity": d.humidity()}
    json_str = json.dumps(data)
    server.send(json_str,  content_type="Content-Type: application/json")

server = MicroPyServer()
''' add request handler '''
server.add_route("/data", show_data)
''' start server '''
server.start()

Набрав у браузере адрес http://IP_вашего_устройства/data получим JSON строку с данными


Опыт использования

Данная библиотека используется в нескольких моих устройствах, которые работают в режиме 24/7 уже более полугода. На данный момент никаких проблем с сервером я не обнаружил и надеюсь, что в будущем код сервера будет работать также без проблем как и сейчас.

© Habrahabr.ru