Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions .github/workflows/releases.yml
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,9 @@ jobs:
run: |
echo "Updating version to ${{ needs.update-version.outputs.version }}"
sed -i 's/"version": "[^"]*"/"version": "${{ needs.update-version.outputs.version }}"/' lib/lilka/library.json
sed -i 's/"version": "[^"]*"/"version": "${{ needs.update-version.outputs.version }}"/' lib/lilka_modules/library.json
cat lib/lilka/library.json
cat lib/lilka_modules/library.json

- name: Generate version_auto_gen.h
run: |
Expand All @@ -113,8 +115,8 @@ jobs:

- name: Publish to PlatformIO Registry
run: |
cd lib/lilka
pio pkg publish --non-interactive
(cd lib/lilka && pio pkg publish --non-interactive)
(cd lib/lilka_modules && pio pkg publish --non-interactive)
echo "Published to PlatformIO Registry"

github-releases-to-discord:
Expand Down
5 changes: 3 additions & 2 deletions .github/workflows/sdk.yml
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,10 @@ jobs:
~/.platformio/.cache
./lib/lilka/.pio
key: ${{ runner.os }}-lilka
- uses: actions/setup-python@v4
- uses: actions/setup-python@v5
with:
python-version: '3.9'
# 3.9 isn't available for the current ubuntu-latest image
python-version: '3.11'
- name: Install PlatformIO Core
run: pip install --upgrade platformio

Expand Down
67 changes: 67 additions & 0 deletions addons/lualilka/library/can.lua
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---@meta

---Шина CAN на вбудованому контролері TWAI (модуль 008 CAN, трансивер SN65HVD232).
---@class can
can = {}

---@class can.Options
---@field bitrate? integer 25000, 50000, 100000, 125000, 250000, 500000 (за замовчуванням), 800000 або 1000000
---@field mode? string ``"normal"`` (за замовчуванням), ``"listen"`` (лише прийом, без ACK) або ``"no_ack"`` (самотест)
---@field tx? integer GPIO TX (за замовчуванням 43)
---@field rx? integer GPIO RX (за замовчуванням 44)
---@field filter? can.Filter

---@class can.Filter
---@field code? integer acceptance code (за замовчуванням 0)
---@field mask? integer acceptance mask, 1 = біт не перевіряється (за замовчуванням 0xFFFFFFFF - приймати все)
---@field single? boolean один 32-бітний фільтр (за замовчуванням true)

---@class can.SendOptions
---@field extended? boolean 29-бітний ідентифікатор (за замовчуванням - якщо id > 0x7FF)
---@field rtr? boolean remote frame; тоді ``data`` - запитувана довжина (число)
---@field timeout? integer мс очікування місця в черзі (за замовчуванням 100)

---@class can.Message
---@field id integer
---@field data string до 8 байт
---@field dlc integer
---@field extended boolean
---@field rtr boolean

---@class can.Bus
local Bus = {}

---Запускає контролер CAN.
---@param options? can.Options
---@return can.Bus|nil bus
---@return string? error
---@usage
--- local bus = can.new({bitrate = 500000})
--- bus:send(0x123, "\xAB\xCD")
function can.new(options) end

---Ставить кадр у чергу на передачу.
---@param id integer
---@param data? string|integer[] до 8 байт
---@param options? can.SendOptions
---@return boolean ok
---@return string? error
function Bus:send(id, data, options) end

---Повертає прийнятий кадр або ``nil``.
---@param timeout_ms? integer скільки чекати (за замовчуванням 0)
---@return can.Message|nil
function Bus:receive(timeout_ms) end

---Стан контролера: ``state`` (``"stopped"``, ``"running"``, ``"bus_off"``, ``"recovering"``), лічильники помилок і черг.
---@return table|nil
function Bus:status() end

---Виходить зі стану BUS_OFF або перезапускає зупинений контролер.
---@return boolean
function Bus:recover() end

---Зупиняє контролер і звільняє контакти.
function Bus:close() end

return can
66 changes: 66 additions & 0 deletions addons/lualilka/library/cc1101.lua
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---@meta

---Субгігагерцове радіо CC1101 (модуль 004 RF з CC1101) на шині SPI2.
---
---Діапазони 300-348, 387-464 і 779-928 МГц. Пакети змінної довжини до 61 байта.
---Перевіряйте, які частоти дозволені у вашій країні.
---@class cc1101
cc1101 = {}

---@class cc1101.Options
---@field frequency? number МГц (за замовчуванням 433.92)
---@field modulation? string ``"gfsk"`` (за замовчуванням), ``"2fsk"``, ``"ask"`` (OOK), ``"4fsk"`` або ``"msk"``
---@field rate? integer бод, 600-500000 (за замовчуванням 38400)
---@field deviation? integer Гц (за замовчуванням 20000)
---@field bandwidth? integer Гц, смуга приймача (за замовчуванням 100000)
---@field power? integer дБм, -30...10 (за замовчуванням 0)
---@field sync_word? integer (за замовчуванням 0xD391)
---@field crc? boolean (за замовчуванням true)

---@class cc1101.Packet
---@field data string
---@field rssi number дБм
---@field lqi integer
---@field crc_ok boolean

---@class cc1101.Radio
local Radio = {}

---@param options? cc1101.Options
---@return cc1101.Radio|nil radio
---@return string? error
---@usage
--- local radio = assert(cc1101.new({frequency = 433.92}))
--- radio:send("hello")
function cc1101.new(options) end

---Надсилає пакет до 61 байта.
---@param data string|integer[]
---@param timeout_ms? integer (за замовчуванням 500)
---@return boolean
function Radio:send(data, timeout_ms) end

---Вмикає прийом (``receive()`` теж вмикає його автоматично).
function Radio:listen() end

---Повертає прийнятий пакет або ``nil`` (без очікування).
---@return cc1101.Packet|nil
function Radio:receive() end

---Поточний RSSI, дБм.
---@return number
function Radio:rssi() end

---@param mhz number
---@return boolean
function Radio:set_frequency(mhz) end

---@param dbm integer
function Radio:set_power(dbm) end

function Radio:idle() end

---Звільняє SPI і контакти.
function Radio:close() end

return cc1101
85 changes: 85 additions & 0 deletions addons/lualilka/library/gps.lua
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
---@meta

---Приймач GNSS (модуль 005 GPS, u-blox NEO-M8N) на UART2.
---
---Об'єкт тримає контакти зайнятими, доки його не закрито (``close()``) або доки скрипт не завершився.
---@class gps
gps = {}

---@class gps.Options
---@field baud? integer швидкість UART (за замовчуванням 9600)
---@field rx? integer GPIO входу (TX модуля), за замовчуванням 44
---@field tx? integer|false GPIO виходу (RX модуля), за замовчуванням 43; ``false`` - лише прийом

---@class gps.Fix
---@field valid boolean є фіксація (RMC status = A)
---@field latitude number градуси, південь < 0
---@field longitude number градуси, захід < 0
---@field altitude number метри над рівнем моря
---@field speed number км/год
---@field course number градуси від півночі
---@field satellites integer супутники, що використовуються
---@field quality integer 0 - немає, 1 - GPS, 2 - DGPS, 4/5 - RTK, 6 - оцінка
---@field fix_type integer 1 - немає, 2 - 2D, 3 - 3D
---@field hdop number
---@field vdop number
---@field pdop number
---@field year integer UTC
---@field month integer
---@field day integer
---@field hour integer
---@field minute integer
---@field second integer
---@field millis integer
---@field updates integer кількість розібраних GGA/RMC

---@class gps.Satellite
---@field system string ``"gps"``, ``"glonass"``, ``"galileo"``, ``"beidou"`` або ``"other"``
---@field prn integer
---@field elevation integer градуси
---@field azimuth integer градуси
---@field snr? integer дБГц, відсутній, якщо супутник не відстежується

---@class gps.Receiver
local Receiver = {}

---Запускає UART і повертає об'єкт приймача.
---@param options? gps.Options
---@return gps.Receiver|nil receiver
---@return string? error
---@usage
--- local g = gps.new()
function gps.new(options) end

---Читає все, що надійшло з модуля, і розбирає NMEA. Викликайте часто (наприклад, у ``lilka.update``).
---@return integer sentences кількість нових речень
function Receiver:update() end

---Повертає останні відомі дані про розташування.
---@return gps.Fix
function Receiver:fix() end

---Повертає супутники в полі зору (з повідомлень GSV).
---@return gps.Satellite[]
function Receiver:satellites() end

---Останнє прийняте NMEA-речення (без ``$`` і кінця рядка) - для налагодження.
---@return string
function Receiver:last_sentence() end

---Надсилає сирі байти в модуль (наприклад, команду ``$PUBX``).
---@param data string
---@return boolean
function Receiver:write(data) end

---Надсилає UBX-повідомлення (контрольна сума додається автоматично).
---@param class integer
---@param id integer
---@param payload? string
---@return boolean
function Receiver:send_ubx(class, id, payload) end

---Зупиняє UART і звільняє контакти.
function Receiver:close() end

return gps
49 changes: 49 additions & 0 deletions addons/lualilka/library/imu.lua
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
---@meta

---Акселерометр і гіроскоп BMI260 (модуль 006 GYRO MAGNET) на шині I2C.
---@class imu
imu = {}

---@class imu.Options
---@field sda? integer (за замовчуванням 44)
---@field scl? integer (за замовчуванням 43)
---@field address? integer 0x68 або 0x69 (за замовчуванням - знайти автоматично)
---@field config? boolean|string ``true`` - вбудований конфігураційний блоб Bosch (за замовчуванням), шлях до файлу - завантажити з файлу, ``false`` - без блобу (не перевірено, чи дані тоді коректні)
---@field accel_range? integer g: 2, 4, 8 (за замовчуванням), 16
---@field gyro_range? integer °/с: 125, 250, 500, 1000, 2000 (за замовчуванням)
---@field accel_odr? integer Гц: 12, 25, 50, 100 (за замовчуванням), 200, 400, 800, 1600
---@field gyro_odr? integer Гц: 25, 50, 100, 200 (за замовчуванням), 400, 800, 1600, 3200

---@class imu.Data
---@field ax number g
---@field ay number g
---@field az number g
---@field gx number °/с
---@field gy number °/с
---@field gz number °/с

---@class imu.Sensor
local Sensor = {}

---@param options? imu.Options
---@return imu.Sensor|nil sensor
---@return string? error
---@usage
--- local sensor = assert(imu.new())
--- local d = sensor:read()
function imu.new(options) end

---@return imu.Data|nil
function Sensor:read() end

---@return number °C
function Sensor:temperature() end

---``true``, якщо блоб завантажено і чип його прийняв.
---@return boolean
function Sensor:initialized() end

---Звільняє I2C і контакти.
function Sensor:close() end

return imu
55 changes: 55 additions & 0 deletions addons/lualilka/library/ir.lua
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---@meta

---ІЧ-передавач і приймач (модуль 002 IR: KY-005 + KY-022) на периферії RMT.
---
---Протоколи: NEC (8- і 16-бітна адреса), Samsung, Sony SIRC (12/15/20 біт). Невідомі протоколи можна приймати
---і відтворювати як сирі тривалості.
---@class ir
ir = {}

---@class ir.Options
---@field tx? integer|false GPIO передавача (за замовчуванням 43), ``false`` - без передавача
---@field rx? integer|false GPIO приймача (за замовчуванням 44), ``false`` - без приймача
---@field carrier? integer частота несучої, Гц (за замовчуванням 38000)

---@class ir.Code
---@field protocol string ``"NEC"``, ``"SAMSUNG"``, ``"SONY"`` або ``"UNKNOWN"``
---@field address? integer
---@field command? integer
---@field ["repeat"]? boolean кадр повторення NEC (кнопку утримують)
---@field bits? integer
---@field raw integer[] тривалості, мкс: імпульс, пауза, імпульс, ...

---@class ir.Transceiver
local Transceiver = {}

---@param options? ir.Options
---@return ir.Transceiver|nil transceiver
---@return string? error
---@usage
--- local remote = ir.new()
--- remote:send("NEC", 0x04, 0x08)
function ir.new(options) end

---Кодує й надсилає кадр.
---@param protocol string ``"NEC"``, ``"SAMSUNG"`` або ``"SONY"``
---@param address integer
---@param command integer
---@param repeats? integer скільки разів повторити (за замовчуванням 0, для SONY - 2)
---@return boolean
function Transceiver:send(protocol, address, command, repeats) end

---Надсилає сирі тривалості (до 380), наприклад ``raw`` з ``receive()``.
---@param durations integer[] мкс, починаючи з імпульсу
---@param carrier? integer Гц
---@return boolean
function Transceiver:send_raw(durations, carrier) end

---Повертає прийнятий кадр або ``nil`` (без очікування).
---@return ir.Code|nil
function Transceiver:receive() end

---Звільняє RMT і контакти.
function Transceiver:close() end

return ir
Loading
Loading