— style='color:

WiFi.scanDelete — Очистить результат последнего сканирования (не надо, это автоматически происходит)

echo {WIFI.scan} — Вернуть список сетей одной командой (с ожиданием, устаревший способ)




РАБОТА С UDP и NTP (синхронизация часов)




NTP.update (url) — Синхронизировать время по WiFi или LAN, url можно указать (по умолчанию time.nist.gov), порт всегда 123, пример:


<?php
NTP.update mysite.com
NTP.update 192.168.100.200
loop 600 NTP.update


UDP.send [url:port] [Data] — отправить пакет Data по UDP на url:port, ответ не принимать, пример:

UDP.send 10.8.0.72:8313 The Text Of Packet for Sending

UDP.ping [url:port] [Data] — отправить пакет Data по UDP на url:port, в ответ принять консольные команды и выполнить их процедурой MOTO(), пример:

UDP.send 10.8.0.72:8313 Ask

UDP.get [url:port] [Data] — отправить пакет Data по UDP на url:port, в ответ принять некие данные и сохранить их в переменной UDP_result, при получении выполнить процедуру UDP_func, пример:


<?php
set UDP_result =
set UDP_func = {
  if {UDP_result} = OK play D.R.M
  else play mmm
}
UDP.get mysite.com:8813 Erase_all





РАБОТА С MDNS

MDNS.begin [name] — Запустить сервис https://[name].local или остановить если указано пустое имя. Скажем прямо — бессмысленная вещь в реальной жизни.




РАБОТА СО ЗВУКОМ

play (pin) [music] — сыграть ноты music на пине pin (если не указан, берется по умолчанию soundpin), музыка кодируется в формате гаммы: DRMFSLCdrmfslc Точка и запятая обозначают паузы длинную и короткую. Если pin не указан (в нормально написанных скриптах его не надо указывать), то используется ранее установленная переменная {sound.pin}. Важно заметить, что переменная {sound.pin.0} указывает, в какое состояние вернуть pin по окончании звучания — по умолчанию это 0, но для устройств, которые используют, например, инвертер для звука, это важно., пример:

play 4 M,d,d,d,d,dd.C,C,r,r,d,C,CC.L,L,L,LS,F,MM.d,dCCC.drddd...M,d,d,d,d,dd.C,C,r,r,d,C,CC.L,L,L,LS,F,MM.d,M,M,L,CCCCC

playip (пин) — высвистеть последние три цифры полученного IP в местной сети в пине (если не указан, то soundpin)"), например для 10.9.0.203 это эквивалентно цепочке команд: repeat 2 play 4 M, ; play 4 .. ; repeat 0 play 4 L, ; play 4 .. ; repeat 3 play 4 d,, пример:

{2}

mp3 [файл.mp3] — Воспроизвести в эмулированном пине RX файл mp3. Увы, только очень короткие файлы можно, иначе катастрофически не хватает памяти., пример:

mp3 /pes.mp3

mp3stop — Остановить воспроизведение mp3, пример:

mp3stop

mp3web [урл] — Отключено, потому что чип, скомпилированный в Ардуине, да еще со всем остальным фреймфорком, висящим в памяти, банально не тянет., пример:

mp3web http://radio.4duk.ru/4duk128.mp3




РАБОТА С SERIAL

SERIAL.begin (speed) — инициализировать Serial с нужной скоростью, есмлит не указана, то 115200 по умолчанию, пример:

SERIAL.begin 9600

SERIAL.end — остановить Serial, пример:

SERIAL.end

SERIAL.flush — очистить буффер, пример:

SERIAL.flush

SERIAL.swap (конфигурация) — переключить GPIO Serial с RX=3,TX=1 (конфигурация 0) на RX=13,TX=15 (конфигурация 1) и обратно, но также можно строго указать номер конфигурации, пример:

SERIAL.swap 1 # RX=13,TX=15
SERIAL.swap 0 # RX=3,TX=1

echo [string] — напечатать строку, пример:

echo Только что пришла по Serial строка: {SERIAL}





РАБОТА С СЕРВО

attach [номер серво] [пин] — подключить сервопривод к gpio [пин], пример:

attach 1 5

detach [номер серво] — отключить сервопривод к gpio [пин], пример:

detach 1

go [номер серво] [градус] — повернуть сервопривод в нужное положение, пример:

go 1 180





Считыватель бесконтактных карт WIEGAND

WIEGAND.start [pin0] [pin1] [mode] — Активировать считыватель Wiegand. pin0 — gpio для получения 0, pin1 — gpio для получения 1, mode — битность 26 или 34, пример:

WIEGAND.start 2 3 34

WIEGAND.end — Отключить считыватель WIEGAND, пример:

WIEGAND.end

{WIEGAND} — Переменная, из которой считывается полученный код, если есть, пример:


<?php
set CARD = {WIEGAND}
if.!empty {CARD} echo Введена карта, ее номер: "{CARD}"!






РАБОТА С NFC-СКАНЕРОМ БЕСКОНТАКТНЫХ КАРТ RFID-RC522

RC522.init — Активировать сканер карт RC522, подключенный как RST=GPIO5, SDA(SS)=GPIO4, MOSI=GPIO13, MISO=GPIO12, SCK=GPIO14, GND=GND, 3.3V=3.3V, пример:

RC522.init

{RC522.ver} — чтение байта версии в 16-ричном коде (обычно 91 или 92), пример:

if {RC522.ver} != 91 {
  echo Кажется, наш сканер подвис, тихонько перезапустим его
  RC522.init
}


{RC522.card} — чтение карты: возвращает пустое знаечние, если карта еще не была поднесена, или ее номер, если недавно была поднесена, пример:


<?php
set CARD = {RC522.card}
if.!empty {CARD} echo Введена карта, ее номер: "{CARD}"!


{KEY:[filename] [key]} — Простой способ организовать элементарные базы данных (и не только для NFC-сканнера). Если в файле filename найдется строка, первое слово которой — ключ key, то вернуть значение (остальную часть строки), иначе вернуть пустое значение. ВАЖНО: при извлечении даже цифровых переменных всегда используйте оператор set. set X = {KEY:...}, а не просто X = {KEY:...}, пример:


<?php
set CARD = {RC522.card}
if.!empty {CARD} {
  echo Поднесли карту номер: "{CARD}"
  set NAME = {KEY:/keybasa.txt {CARD}}
  if.empty {NAME} echo Ключа нет в списке доступа!
  else {
      echo Добро пожаловать, уважаемый {NAME}!
      /DOOR_OPEN_ENGINE
  }
}





РАБОТА MQTT

MQTT.connect [url:port] [login] [password] — соединиться с сервером MQTT, если порт не указан, то 1883. Параметры при вызове этой процедуры также запоминаются в системных переменных

MQTT_server, — MQTT_port,

MQTT.reconnect — выполнить пересоединение с MQTT

MQTT.publish [topic] [string] — Публикация в топике

MQTT.subscribe [topic] — подписка на топик

MQTT.unsubscribe [topic] — отписка от топика




РАБОТА MODBUS/TCP SLAVE

MODBUS.begin — запустить иницилизацию

MODBUS.add [reg] (value) — создать регистр (номер от 1 до 9999), можно указать ему сразу значение для инициализации

MODBUS.save [reg] (value) — записано новое значение в созданный ранее регистр




РАБОТА C ДАТЧИКАМИ




DS18B20.begin — запустить инициализацию датчика температуры DS18B20, датчик поключают по onewire к GPIO4, и только к нему, уж извините. Схема подключения:

, пример:

— style='color:, пример:

#0000BB'><?php

РАБОТА C АНАЛОГОВЫМ ВХОДОМ A0

calibrate [пин] [N] [имя] — Провести калибровку: рассчитать среднее арифметическое от N измерений пина (конечно он всегда A0) каждые 10 мс и сохроанить в переменную с указанным именем, пример:

calibrate A0 20 SREDNEE
echo Сейчас среднее значение измерений = {SREDNEE}

MOTORSTOP [N] — Установить значение внутренней переменной для срабатывания для системы контроля мгновенной остановки мотора, пример:

{2}

TIMER.start (ms) — Запустить таймер кольцевой записи параметров всех пинов. Это сложная процедура, которая проводит очень частые (можно указать время в ms, по умолчанию 50) проверки состояния пинов. При этом проводится вычисление Z-фильтра на появление пиков, а также обработка некоторых случаев с вызовом соответствующих процедур., пример:

TIMER.start 50

TIMER.stop — Остановить кольцевую запись пинов, пример:

TIMER.stop

set.FLT [lag] [TOL] [THRESHOLD] [INFLUENCE] — Установить параметры сглаживающего фильтра измерений, пример:

set.FLT 15 64 6 1.5

echobuf [N] — Выдать содержимое кольцевого буфера измерений, начиная с N, пример:

echobuf 0

Операции текстовых строк

{GET:[url]} — загрузить страницу из сети (очень короткую! памяти не хватит!) по адресу url, также можно первым аргументом перед url через пробел указать таймаут в мс: {GET: 500 http://lenta.ru/robots.txt}, если не указан, то по умолчанию 5000мс., пример:

set unixtime = {GET: 2000 http://lleo.me/ESP8266/index.php?unixtime=1}

{FILE:[файл]} — Загрузить (с внутренней флешки) содержимое файла с именем «файл», пример:

set num = {FILE:/numer.txt}

{FILEMD5:[файл]} — подсчитать хэш MD5 файла с именем «файл», пример:

set md5string = {FILEMD5:/ESP.jpg}

{PARSE:[переменная] [шаблон]} — ищет в строковой переменой данные по шаблону, где нужный кусок обозначен * Также понимает обозначения: \n \r, пример:

set time = 06:40
set h = {PARSE:time *:}
set m = {PARSE:time :*}
echo m={m} h={h}

{TAKE:[name] [num] [sep]} — Разобрать текстовую переменную с именем [name] на аргументы по сепаратору [sep] (если не указан, то разделить по пробелам) и взять аргумент номер [num], пример:

{2}

{SET} — вывести дамп всех переменных в формате «имя = [значение]\n», пример:

{2}

{INFO} — вывести полное инфо, как /info, пример:

{2}

{dir} — дать список всех файлов на внутренней флешке в формате «[имя] [размер]\n», пример:

{2}

{WIFI.scan} — дать список WiFi-сетей вокруг в формате «[доступ] [имя сети]\n», где доступ «free» для открытых и «pass» для закрытых, пример:

{2}

Служебные переменные

Команда формата {имя} покажет значение пользолвательской переменной.
Но в системе есть различные предопределенные переменные, динамические значения, результаты сложных взаимодействий с внешними устройстами и так далее. У них есть свои имена, вот они:

GPIO

{gpio[N]} — прочесть значение gpio 1,2,3,4,5,12,13,14,15,16 и A0

Сеть

{ip} — полученные IP WiFi.localIP().toString()

{ip_mask} — WiFi.subnetMask()

{ip_gateway} — WiFi.gatewayIP()

{macAddress} — WiFi.macAddress()

{ip_connected} — 1 или 0 WiFi.isConnected() ? 1 : 0

{ip_autoconnect} — 1 или 0 WiFi.getAutoConnect() ? 1 : 0

{ip_dns} — WiFi.dnsIP(0) + WiFi.dnsIP(1)

{ip_hostname} — WiFi.hostname()

{ip_status} — WiFi.status()

{ip_ssid} — WiFi.SSID()

{ip_psk} — WiFi.psk()

{ip_bssid} — WiFi.BSSIDstr()

{ip_rssi} — WiFi.RSSI()

{softAPIP} — WiFi.softAPIP()

{softAPmacAddress} — WiFi.softAPmacAddress()

{softAPgetStationNum} — WiFi.softAPgetStationNum()

{mdns} — return String(mdns);

{LAN.started} — Есть ли внешний Ethernet через подключенное устройство

Внутренние параметры чипа ESP

{ESP_TYPE} — тип ESP, например: ESP-12, ESP-32, ESP32S2, ESP32S3, ESP32C3

{FreeHeap} — ESP.getFreeHeap()

{FreeSketchSpace} — ESP.getFreeSketchSpace()

{SketchSize} — ESP.getSketchSize()

{chip} — ESP.getChipId() HEX

{FlashChipId} — ESP.getFlashChipId()

{FlashChipSize} — ESP.getFlashChipSize()

{FlashChipRealSize} — ESP.getFlashChipRealSize()

{FlashChipSpeed} — ESP.getFlashChipSpeed()

{cycles} — ESP.getCycleCount()

{CoreVersion} — ESP.getCoreVersion()

{FullVersion} — ESP.getFullVersion()

{BootVersion} — ESP.getBootMode()

{BootMode} — ESP.getCycleCount()

{CpuFreq} — ESP.getCpuFreqMHz()

{FlashChipSizeByChipId} — ESP.getFlashChipSizeByChipId()

{getSketchMD5} — ESP.getSketchMD5()

{ResetReason} — ESP.getResetReason()

{ResetInfo} — ESP.getResetInfo()

{flashmode} — ESP.getFlashChipMode() — возвращает QIO, QOUT, DIO, DOUT, UNKNOWN

{vcc} — ESP.getVcc()

Файловая система

{Files} — Список всех файлов внутренней флешки в формате " [имя]"

{Files_count} — число файлов внутренней флешки

{SPIFFStotal} — общее количество байт в файловой системе

{SPIFFSused} — количество занятых байт в файловой системе

{SPIFFSfree} — количество свободных байт в файловой системе

Прошивка и ее опции

{VER} — номер версии прошивки (число)

{VERNAME} — имя версии прошивки

{MOTORSTOP} — флаг остановки мотора

{NBUF} — константа — размер буфера

{NLOOP} — константа — максимальное количество циклов

{NSET} — константа — максимальное количество переменных

{NSERV} — константа — максимальное количество серв

{EchoMOTO} — return EchoMOTO;

Обработка данные аналогового входа A0

{MaxA0} — Значение максимума для срабатывания прерывания по максимуму

{MinA0} — Значение минимума для срабатывания прерывания по минимуму

{FltA0} — Значение фильтра

Время

{UnixTime} — текущее время UnixTime (начинает тикать с 0 в момент старта, нопозже можно записать настоящее время)

{hh} — текущие часы

{mm} — текущие минуты

{ss} — текущие секунды

{dn} — день недели, номер 0-6

{ddn} — день недели su mo tu we th fr sa

{Time} или {hhmmss} — время в формате hhmmss

{millis} — число миллисекунд millis();

Внешние устройства

{MQTT} — если сервис MQTT поднят, то 1, иначе 0

{DS18B20} — считать показания температурного датчика Dallas

{WIEGAND} — код последней введенной беспроводной карты

{RC522.ver} — версия прошивки считывателя rc522 ( 0x91 или 0x92 )

{RC522.card} — код последней прочитанной беспроводной карты со считывателя rc522

{SERIAL} — прочесть строку из внутреннего Serial, если была

MODBUS

{MODBUS.started} — если сервис ModBus уже был инициализирован, то 1, иначе 0

{MODBUS.last} — показать дамп последнего запроса

{MODBUS:[reg]} — значение регистра reg

ПРИМЕРЫ

{LOOP:[N]} — Число оставшихся секунд до срабатывания цикла по его номеру, пример:

echo До обновления сфота осталось {LOOP:1} секунд

{LOOP:[действия]} — Возвращает число оставшихся секунд до срабатывания цикла по его исполняемой команде (если ее помним или это было имя файла, неудобная команда), пример:

echo {LOOP:/MOTOR_STOP.txt}

{LOOP} — вывести дамп всех циклов в формате «Loop #[N] [count] of [value] [тело] ONE\n» ONE добавляется — если цикл однократный, пример:

{LOOP}

Системная часть — edge

Также есть системная веб-часть по обращению к веб-сайту чипа, например http://192.168.4.1/info

GET /FM?a=login&password=MYPASSWORD — логиниться админом, получить в ответ hash пароля — доступно всем, не только админу

GET /FM?a=loop&n=3 — показать сколько осталось секунд до выполнения цикла номер (например 1) — доступно всем, не только админу

GET /FM?a=WIFIconn1 — переконнектиться по WiFI если сеть была «ESP-HELP», передает «net»+«pass», записывает их в «wifi_last.txt» — доступно всем, не только админу

GET /info — страница полной информации о чипе и системе

GET /dir — список файлов на флешке

POST /upload — загрузка файлов на флешку методом POST

POST / — выполнить скрипт, которые передается методом POST

GET /MOTO?script — выполнить скрипт, в котором разделители строк заменены на знак «

GET /MOTO?hash=5fd310ef5fd7e6ab523&script — то же, но выполнить скрипт от незалогиненного пользователя, указав правильный парольный hash

Авторизация

Система позволяет выполнить произвольный скрипт на устройстве, но для этого надо знать пароль, установленный в config.txt («set password = ...»). Сам пароль используется только во время логина, при этом чип возвращает 32-символьный hash MD5, который зависит не только от пароля, но и от уникального серийного номера каждого чипа (для ESP12 это серийный номер чипа и памяти, для ESP32 — МАК-сдрес). В дальнейшем система считает запрос от админа, если правильный хэш передан в куках «ESP=...», либо указан в строке параметров «hash=...»

Вот один из способов управлять устройством с компьютера, зная лишь IP и пароль админа. Сперва надо получить хэш, затем исполнять скрипты — их можно передавать методом POST на эндпоинт «/», либо в строке запроса на эндпоинт «/MOTO», заменяя переводы строк на знак «|».

#!/bin/sh

# change password

hash=`wget -q -O - "http://10.9.0.133/FM?a=login&password=Zyablik123"`

wget -q -O - "http://10.9.0.133/MOTO?hash=${hash}&echo Old Password:{FILE:wifi_last.txt}|
FILE.save.text wifi_last.txt kv121\\nPassword12345|echo New Password{FILE:wifi_last.txt}|pinmode 4 OUTPUT|play 4 DRM"