Быстрый старт по скриптам

Скрипт Lua 5.4 — это воспроизводимая стендовая процедура. Начните с чтения одного DID, затем развивайте её в routine, операцию с памятью или рецепт прошивки.

Запуск скрипта

1. Откройте Tools → Lua Scripts.
2. Создайте скрипт в workspace (<workspace>/scripts/*.lua) или в проекте (<project>/scripts/*.lua). Проектные скрипты имеют приоритет.
3. Вставьте пример ниже.
4. Нажмите Run и прочитайте вывод под редактором; ошибки также попадают в лог приложения.

-- Read one DID and print the decoded value
local ecu = 0x100 -- txid; a unit string such as "ENGINE" also works
local p = bm.ecu.read_did(ecu, 0xF190)
print(string.format("%04X", 0xF190), p.value or p.hex)

Селектор блока — имя блока ECU или его ID передачи. Передавайте его явно; скрытого «выбранного ECU» нет.

Полезные шаблоны

-- Read all parameters and report each DID
local unit = "ENGINE"
for _, item in ipairs(bm.ecu.list_parameters(unit)) do
  local p = bm.ecu.read_did(unit, item.did)
  bm.log(string.format("%04X", item.did), p.value or p.hex)
end

-- Fault count with a toast
local dtcs = bm.ecu.read_dtcs("ENGINE")
bm.log("DTC count:", #dtcs)
bm.toast("DTC read: " .. #dtcs)

-- Routine and raw request
bm.ecu.routine_start("ENGINE", 0x0203, "00")
bm.sleep(1000)
bm.ecu.routine_stop("ENGINE", 0x0203)
bm.ecu.raw_uds("ENGINE", "3E00")

Lua работает в песочнице без произвольного доступа к файлам, процессам и ОС. Живые операции требуют разрешения автоматизации и подтверждения.

Кнопки действий

File → Load Actions загружает JSON-файл с кнопками:

{
  "tab_name": "Actions",
  "action_buttons": [
    { "name": "Session 03", "comment": "Extended session", "group": "Session", "data": "10 03" },
    { "name": "Read VIN", "comment": "Lua action", "group": "Scripts", "script": "read_vin.lua" }
  ]
}

data — необработанный запрос UDS; script — файл .lua из папки scripts/ проекта или workspace. Кнопки с data требуют подтверждения.

AI и MCP

Бэкенд чата — HTTP, совместимый с OpenAI, или OpenCode ACP; ключ API хранится в Диспетчере учетных данных Windows. Изменения проекта и живые записи в ECU включаются отдельно в Settings → Automation, а опасные операции требуют подтверждения. Каждый вызов инструмента виден в логе.

Связанное

• Скрипты и автоматизация
• Набор инструментов UDS
• Прошивка