7fa322afb8
ESP-NOW is a proprietary wireless communication protocol which supports connectionless communication between ESP32 and ESP8266 devices, using vendor specific WiFi frames. This commit adds support for this protocol through a new `espnow` module. This commit builds on original work done by @nickzoic, @shawwwn and with contributions from @zoland. Features include: - Use of (extended) ring buffers in py/ringbuf.[ch] for robust IO. - Signal strength (RSSI) monitoring. - Core support in `_espnow` C module, extended by `espnow.py` module. - Asyncio support via `aioespnow.py` module (separate to this commit). - Docs provided at `docs/library/espnow.rst`. Methods available in espnow.ESPNow class are: - active(True/False) - config(): set rx buffer size, read timeout and tx rate - recv()/irecv()/recvinto() to read incoming messages from peers - send() to send messages to peer devices - any() to test if a message is ready to read - irq() to set callback for received messages - stats() returns transfer stats: (tx_pkts, tx_pkt_responses, tx_failures, rx_pkts, lost_rx_pkts) - add_peer(mac, ...) registers a peer before sending messages - get_peer(mac) returns peer info: (mac, lmk, channel, ifidx, encrypt) - mod_peer(mac, ...) changes peer info parameters - get_peers() returns all peer info tuples - peers_table supports RSSI signal monitoring for received messages: {peer1: [rssi, time_ms], peer2: [rssi, time_ms], ...} ESP8266 is a pared down version of the ESP32 ESPNow support due to code size restrictions and differences in the low-level API. See docs for details. Also included is a test suite in tests/multi_espnow. This tests basic espnow data transfer, multiple transfers, various message sizes, encrypted messages (pmk and lmk), and asyncio support. Initial work is from https://github.com/micropython/micropython/pull/4115. Initial import of code is from: https://github.com/nickzoic/micropython/tree/espnow-4115.
186 lines
5.2 KiB
C
186 lines
5.2 KiB
C
/*
|
|
* This file is part of the MicroPython project, http://micropython.org/
|
|
*
|
|
* The MIT License (MIT)
|
|
*
|
|
* Copyright (c) 2014 Damien P. George
|
|
* Copyright (c) 2015-2016 Paul Sokolovsky
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
* THE SOFTWARE.
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
|
|
#include "py/builtin.h"
|
|
#include "py/compile.h"
|
|
#include "py/runtime.h"
|
|
#include "py/stackctrl.h"
|
|
#include "py/mperrno.h"
|
|
#include "py/mphal.h"
|
|
#include "py/gc.h"
|
|
|
|
// This needs to be defined before any ESP SDK headers are included
|
|
#define USE_US_TIMER 1
|
|
|
|
#include "extmod/misc.h"
|
|
#include "shared/readline/readline.h"
|
|
#include "shared/runtime/pyexec.h"
|
|
#include "gccollect.h"
|
|
#include "user_interface.h"
|
|
|
|
#if MICROPY_ESPNOW
|
|
#include "modespnow.h"
|
|
#endif
|
|
|
|
STATIC char heap[38 * 1024];
|
|
|
|
STATIC void mp_reset(void) {
|
|
mp_stack_set_top((void *)0x40000000);
|
|
mp_stack_set_limit(8192);
|
|
mp_hal_init();
|
|
gc_init(heap, heap + sizeof(heap));
|
|
mp_init();
|
|
mp_obj_list_append(mp_sys_path, MP_OBJ_NEW_QSTR(MP_QSTR__slash_lib));
|
|
mp_obj_list_append(mp_sys_path, MP_OBJ_NEW_QSTR(MP_QSTR__slash_));
|
|
#if MICROPY_EMIT_XTENSA || MICROPY_EMIT_INLINE_XTENSA
|
|
extern void esp_native_code_init(void);
|
|
esp_native_code_init();
|
|
#endif
|
|
pin_init0();
|
|
readline_init0();
|
|
dupterm_task_init();
|
|
|
|
// Activate UART(0) on dupterm slot 1 for the REPL
|
|
{
|
|
mp_obj_t args[2];
|
|
args[0] = MP_OBJ_NEW_SMALL_INT(0);
|
|
args[1] = MP_OBJ_NEW_SMALL_INT(115200);
|
|
args[0] = MP_OBJ_TYPE_GET_SLOT(&pyb_uart_type, make_new)(&pyb_uart_type, 2, 0, args);
|
|
args[1] = MP_OBJ_NEW_SMALL_INT(1);
|
|
mp_uos_dupterm_obj.fun.var(2, args);
|
|
}
|
|
|
|
#if MICROPY_ESPNOW
|
|
espnow_deinit(mp_const_none);
|
|
#endif
|
|
|
|
#if MICROPY_MODULE_FROZEN
|
|
pyexec_frozen_module("_boot.py", false);
|
|
pyexec_file_if_exists("boot.py");
|
|
if (pyexec_mode_kind == PYEXEC_MODE_FRIENDLY_REPL) {
|
|
pyexec_file_if_exists("main.py");
|
|
}
|
|
#endif
|
|
}
|
|
|
|
void soft_reset(void) {
|
|
gc_sweep_all();
|
|
mp_hal_stdout_tx_str("MPY: soft reboot\r\n");
|
|
mp_hal_delay_us(10000); // allow UART to flush output
|
|
mp_reset();
|
|
#if MICROPY_REPL_EVENT_DRIVEN
|
|
pyexec_event_repl_init();
|
|
#endif
|
|
}
|
|
|
|
void init_done(void) {
|
|
// Configure sleep, and put the radio to sleep if no interfaces are active
|
|
wifi_fpm_set_sleep_type(MODEM_SLEEP_T);
|
|
if (wifi_get_opmode() == NULL_MODE) {
|
|
wifi_fpm_open();
|
|
wifi_fpm_do_sleep(0xfffffff);
|
|
}
|
|
|
|
#if MICROPY_REPL_EVENT_DRIVEN
|
|
uart_task_init();
|
|
#endif
|
|
mp_reset();
|
|
mp_hal_stdout_tx_str("\r\n");
|
|
#if MICROPY_REPL_EVENT_DRIVEN
|
|
pyexec_event_repl_init();
|
|
#endif
|
|
|
|
#if !MICROPY_REPL_EVENT_DRIVEN
|
|
soft_reset:
|
|
for (;;) {
|
|
if (pyexec_mode_kind == PYEXEC_MODE_RAW_REPL) {
|
|
if (pyexec_raw_repl() != 0) {
|
|
break;
|
|
}
|
|
} else {
|
|
if (pyexec_friendly_repl() != 0) {
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
soft_reset();
|
|
goto soft_reset;
|
|
#endif
|
|
}
|
|
|
|
void user_init(void) {
|
|
system_timer_reinit();
|
|
system_init_done_cb(init_done);
|
|
}
|
|
|
|
#if !MICROPY_VFS
|
|
mp_lexer_t *mp_lexer_new_from_file(const char *filename) {
|
|
mp_raise_OSError(MP_ENOENT);
|
|
}
|
|
|
|
mp_import_stat_t mp_import_stat(const char *path) {
|
|
(void)path;
|
|
return MP_IMPORT_STAT_NO_EXIST;
|
|
}
|
|
|
|
mp_obj_t mp_builtin_open(size_t n_args, const mp_obj_t *args, mp_map_t *kwargs) {
|
|
return mp_const_none;
|
|
}
|
|
MP_DEFINE_CONST_FUN_OBJ_KW(mp_builtin_open_obj, 1, mp_builtin_open);
|
|
|
|
#endif
|
|
|
|
void MP_FASTCODE(nlr_jump_fail)(void *val) {
|
|
printf("NLR jump failed\n");
|
|
for (;;) {
|
|
}
|
|
}
|
|
|
|
// void __assert(const char *file, int line, const char *func, const char *expr) {
|
|
void __assert(const char *file, int line, const char *expr) {
|
|
printf("Assertion '%s' failed, at file %s:%d\n", expr, file, line);
|
|
for (;;) {
|
|
}
|
|
}
|
|
|
|
#if !MICROPY_DEBUG_PRINTERS
|
|
// With MICROPY_DEBUG_PRINTERS disabled DEBUG_printf is not defined but it
|
|
// is still needed by esp-open-lwip for debugging output, so define it here.
|
|
#include <stdarg.h>
|
|
int mp_vprintf(const mp_print_t *print, const char *fmt, va_list args);
|
|
int DEBUG_printf(const char *fmt, ...) {
|
|
va_list ap;
|
|
va_start(ap, fmt);
|
|
int ret = mp_vprintf(MICROPY_DEBUG_PRINTER, fmt, ap);
|
|
va_end(ap);
|
|
return ret;
|
|
}
|
|
#endif
|