Andrey
f17c124f0e
Обнови спецификацию GAS 0x3/0x4, реестр устройств и описание загрузочных сервисов одновременно в Markdown, HTML и XLSX. Свяжи новые аппаратные порты, глобальное время и сборку C2000/ПЛИС с корневыми инструкциями, чтобы проекты подключались по одному актуальному контракту.
13 KiB
Общее адресное пространство: GAS и GAS SLOT
Дата редакции: 2026-10-23. Номер типа однозначно определяет единицу адресации:
| MsgType | Имя | MsgBody | Payload |
|---|---|---|---|
0x3 |
GAS | адрес первого 16-битного регистра | 1…4 последовательных регистра, DLC 2/4/6/8 |
0x4 |
GAS SLOT | адрес слота | Word0 — маска; Word1…Word3 — три значения; DLC 8 |
В обоих случаях запрос чтения — extended data frame с DLC=0, Route=0.
Ответ имеет Route=1, тот же узел и адрес. Прикладного ACK записи нет;
успех применения уставки проверяется прикладным ответом или последующим чтением.
RTR, error frame, стандартный 11-битный ID и нечётные длины не исполняются.
GAS 0x3: отдельные регистры
MsgBody=RegisterAddress[15:0]. Адреса 0…65535 (0x0000…0xFFFF)
обозначают 65 536 отдельных 16-битных регистров, логически 128 КиБ на узел.
Это адреса протокола, а не указатели RAM MCU; provider подключает только существующие регионы.
Payload содержит значения с адресов addr, addr+1, addr+2, addr+3
в порядке little-endian. Количество равно DLC/2, допускаются DLC 2, 4, 6, 8.
Для изменения одной уставки по адресу 0x0001 на 0x1234 передаются
MsgBody=0x0001, DLC=2, Data=34 12; соседние слова не изменяются.
Чтение возвращает до четырёх существующих последовательных регистров,
останавливаясь на первом недоступном адресе или границе 0xFFFF.
Запись, пересекающая 0xFFFF, отвергается до изменения данных.
Регионы карты, права и значения проверяет pcan_gas; callback остаётся
ответственностью приложения. Блочная запись может остановиться на первом отказе provider:
атомарность нескольких регистров не обещается. Связанные u32/float32 и команды
требуют согласованной прикладной операции. Основной контракт: c/set-protocol/docs/legacy/GAS.md.
GAS 167/v1, GAS Logger, GAS_WATCH2, NAND и Altera Logic сохраняют регистровые адреса.
Номер mode задаёт адрес узла; его нельзя автоматически прибавлять к адресу регистра.
GAS SLOT 0x4: маска в Word0
MsgBody=SlotAddress[15:0]. Восемь октетов имеют фиксированное расположение:
| Октеты | Wire-слово | Назначение |
|---|---|---|
| 0…1 | Word0 | 16-битная маска, little-endian |
| 2…3 | Word1 | первое значение |
| 4…5 | Word2 | второе значение |
| 6…7 | Word3 | третье значение |
Биты маски 1, 2, 3 соответствуют Word1, Word2, Word3. Бит 0 и биты 4…15
зарезервированы и должны быть нулевыми. Маска непустая; все допустимые маски:
0x0002, 0x0004, 0x0006, 0x0008, 0x000A, 0x000C, 0x000E.
При записи отмеченные значения применяются, неотмеченные позиции игнорируются
и сохраняют текущие значения устройства. Нули не являются специальными маркерами.
При чтении маска ответа отмечает достоверные/доступные значения.
Например, изменить только Word2 на 0x1234: Data=04 00 00 00 34 12 00 00.
Word1 и Word3 сохраняются. Полная запись трёх значений использует маску 0x000E.
Передаются всегда восемь октетов, кроме пустого запроса чтения. Сжатия или сегментации нет.
Provider проверяет все выбранные права и значения до первого изменения, затем применяет
выбранные слова под общей блокировкой. Невыбранные readonly-поля не записываются.
Ядро не выполняет опасное чтение-изменение-запись слота на стороне клиента.
Полное пространство 0x4 содержит 65 536 слотов × 3 значения = 196 608 слов = 384 КиБ.
Word0 — метаданные кадра, не четвёртый хранимый регистр. Координата значения —
(SlotAddress, WordIndex), где WordIndex=1…3. Любой узел поддерживается общими
pcan_gas_slot_id() и pcan_gas_slot_handle_address(); адрес слота не ограничен страницами PERIPH.
Тип 0x4 MODBUS_COIL заменён этим сервисом. Modbus 0x5/0x6/0x7 сохраняет номера.
Старое оборудование с Coil 0x4 требует согласованного обновления; автоопределения формата нет.
PERIPH: проекция 200 слов на слоты 0x4
mode=0…31; DeviceType=1+mode/16, DeviceID=mode mod 16.
SlotAddress=(mode<<8)|LocalSlot. Маски не занимают места в карте значений.
На mode сохранены 200 слов, поэтому используются 67 слотов LocalSlot=0x00…0x42:
66 полных слотов и два значения последнего. В последнем разрешена только маска
из битов 1/2 (0x0002, 0x0004, 0x0006); Word3 не существует.
LocalSlot=0x43…0xFF — резерв. Узел и старший октет слота должны совпадать.
Смещение технологического слова: n=3*LocalSlot+(WordIndex-1).
Обратное преобразование: LocalSlot=n/3, WordIndex=1+n mod 3.
Соседние native-сервисы могут оказаться в одном слоте, поэтому provider проверяет
доступ и наличие каждой отмеченной позиции отдельно.
| mode | Назначение | DeviceType / DeviceID | Слоты 0x4 | Запрос первого слота |
|---|---|---|---|---|
| 0 | Резерв | 0x01 / 0x00 |
0x0000…0x0042 |
0x11040000 |
| 1 | Трансформатор 1 | 0x01 / 0x01 |
0x0100…0x0142 |
0x11140100 |
| 2 | Трансформатор 2 | 0x01 / 0x02 |
0x0200…0x0242 |
0x11240200 |
| 3 | Силовой узел 1 | 0x01 / 0x03 |
0x0300…0x0342 |
0x11340300 |
| 4 | Силовой узел 2 | 0x01 / 0x04 |
0x0400…0x0442 |
0x11440400 |
| 5 | УМП1 | 0x01 / 0x05 |
0x0500…0x0542 |
0x11540500 |
| 6 | УМП2 | 0x01 / 0x06 |
0x0600…0x0642 |
0x11640600 |
| 7 | ENG1 | 0x01 / 0x07 |
0x0700…0x0742 |
0x11740700 |
| 8 | Задатчик / пульт | 0x01 / 0x08 |
0x0800…0x0842 |
0x11840800 |
| 9 | Шкаф | 0x01 / 0x09 |
0x0900…0x0942 |
0x11940900 |
| 10 | Общий адрес: служебная роль | 0x01 / 0x0A |
0x0A00…0x0A42 |
0x11A40A00 |
| 11 | Терминал: служебная роль | 0x01 / 0x0B |
0x0B00…0x0B42 |
0x11B40B00 |
| 12 | Резерв назначения | 0x01 / 0x0C |
0x0C00…0x0C42 |
0x11C40C00 |
| 13 | Резерв назначения | 0x01 / 0x0D |
0x0D00…0x0D42 |
0x11D40D00 |
| 14 | Резерв назначения | 0x01 / 0x0E |
0x0E00…0x0E42 |
0x11E40E00 |
| 15 | Резерв назначения | 0x01 / 0x0F |
0x0F00…0x0F42 |
0x11F40F00 |
| 16 | Резерв назначения | 0x02 / 0x00 |
0x1000…0x1042 |
0x12041000 |
| 17 | Резерв назначения | 0x02 / 0x01 |
0x1100…0x1142 |
0x12141100 |
| 18 | Резерв назначения | 0x02 / 0x02 |
0x1200…0x1242 |
0x12241200 |
| 19 | Резерв назначения | 0x02 / 0x03 |
0x1300…0x1342 |
0x12341300 |
| 20 | Резерв назначения | 0x02 / 0x04 |
0x1400…0x1442 |
0x12441400 |
| 21 | Резерв назначения | 0x02 / 0x05 |
0x1500…0x1542 |
0x12541500 |
| 22 | Резерв назначения | 0x02 / 0x06 |
0x1600…0x1642 |
0x12641600 |
| 23 | Резерв назначения | 0x02 / 0x07 |
0x1700…0x1742 |
0x12741700 |
| 24 | Резерв назначения | 0x02 / 0x08 |
0x1800…0x1842 |
0x12841800 |
| 25 | Резерв назначения | 0x02 / 0x09 |
0x1900…0x1942 |
0x12941900 |
| 26 | Резерв назначения | 0x02 / 0x0A |
0x1A00…0x1A42 |
0x12A41A00 |
| 27 | Резерв назначения | 0x02 / 0x0B |
0x1B00…0x1B42 |
0x12B41B00 |
| 28 | Резерв назначения | 0x02 / 0x0C |
0x1C00…0x1C42 |
0x12C41C00 |
| 29 | Резерв назначения | 0x02 / 0x0D |
0x1D00…0x1D42 |
0x12D41D00 |
| 30 | Резерв назначения | 0x02 / 0x0E |
0x1E00…0x1E42 |
0x12E41E00 |
| 31 | Резерв назначения | 0x02 / 0x0F |
0x1F00…0x1F42 |
0x12F41F00 |
Назначения mode из periph_28335
Источники: 28335_periph/Source/Internal/Include/package.h, peripher.c:get_Mode(), cntrl_adr.c. Код платы Desk не участвует в вычислении адреса.
| mode | Назначение | Исходный символ |
|---|---|---|
| 0 | Резерв | Перемычками текущей платы не задаётся |
| 1 / 2 | Трансформаторные узлы 1 / 2 | adr_TRN1 / adr_TRN2 |
| 3 / 4 | Силовые узлы 1 / 2 | adr_POW1 / adr_POW2 |
| 5 / 6 | УМП1 / УМП2 | adr_LOA1 / adr_LOA2, Desk=dsk_LOAD=6 |
| 7 | ENG1 | adr_ENG1 |
| 8 | Задатчик / пульт | adr_PULT; имя «Задатчик» принято в реестре PERIPH |
| 9 | Шкаф | adr_SHKF |
| 10 | Общий адрес, служебная роль | CNTRL_ADDR_UNIVERSAL, ADDR_FOR_ALL; не отдельная плата |
| 11 | Терминал, служебная роль | ADDR_TERMINAL; не доказательство отдельной платы |
| 12…31 | Резерв назначения | Перемычки текущей платы дают только 1…16 |
Соответствия native-сервисам PERIPH
| Смещение n | Native-адрес | Назначение | Доступ |
|---|---|---|---|
| 0…127 | 0x0000…0x007F |
технологические данные, уставки, команды | по provider |
| 128…143 | 0x1000…0x100F |
статус регистратора УМП | R |
| 144…155 | 0x1200…0x120B |
паспорт прошивки | R |
| 156…163 | 0x1300…0x1307 |
защита УМП | W только 0x1302/0x1303 |
| 164…167 | 0x1000…0x1003 |
команды регистратора | по операции |
| 168…199 | нет | резерв | отказ |
pcan_gas_slot_native() принимает WordIndex=1…3; WordIndex=0 является маской
и не переводится в регистр. Наличие сервиса, права и блокировку проверяет приложение.
GAS 0x3 сохраняет собственные адреса подключённых регионов; эта проекция относится только к 0x4.
Архив УМП, окна 120/124 слова и физическая EEPROM сохраняют native-контракты.
Реализация и реестр
- GAS 0x3:
pcan_gas.h/.c, существующие ABI и клиенты. - GAS SLOT 0x4:
pcan_gas_slot.h/.c; тонкие PythonGasSlotsи Android/JNIGasSlots. - Формат определяется MsgType, параметр
gas_profileне используется. - C28x хранит wire-октеты в
uint_least8_t; DLC измеряется октетами линии. - Перенос в другую единицу адресации или fallback после отказа запрещены.
XLSX «Интерфейс протокола» содержит оба типа; «Общее адресное пространство» —
проекцию 0x4 и native-адреса её значений; «ОАП legacy» сохраняет исходный словный реестр 0x3.
Уникальный ключ реестра включает узел, MsgType, адрес и для 0x4 WordIndex.
Права, тип, единица, масштаб и порядок слов u32/float32 задаются явно.
Эталоны: examples/gas-slot-vectors.json; регистровые проверки — test_gas_register.c.