Объедини реализацию DEIF в C99-ядре, чтобы Python и Android использовали один кодек и общие эталонные кадры. Добавь две GAS-проекции единой карты STM Invertor и аппаратные порты эмулятора и загрузчика для платы HOPE STM32G474VET6. Проверки: сборка MSVC Debug, 24 теста CTest, 30 тестов Python и 29 дополнительных проверок, синтаксис 16 файлов Python.
104 lines
20 KiB
C
104 lines
20 KiB
C
#include "set_invertor_gas.h" /* Проверяем два публичных представления одной карты инвертора. */
|
|
#include "pcan_id.h" /* Некорректные адреса узлов строятся тем же существующим кодеком ProtoCAN. */
|
|
#include <stdio.h> /* Ошибка теста выводит строку и возвращает ненулевой код также в Release. */
|
|
#include <string.h> /* Сравниваем исходные данные и неизменность выходного кадра при отказе. */
|
|
#define CHECK(condition) do { if (!(condition)) { printf("invertor_gas:%d: %s\n", __LINE__, #condition); return 1; } } while (0) /* Проверки не зависят от assert или NDEBUG. */
|
|
typedef struct { /* Этот массив существует только в тесте и не задаёт способ хранения прошивки. */
|
|
uint16_t values[SET_INVERTOR_GAS_REGISTER_COUNT]; /* Отличимые значения позволяют обнаружить запись лишнего соседа. */
|
|
unsigned reads; /* Счётчик выявляет скрытый read-modify-write при масочной записи. */
|
|
unsigned commits; /* Каждая успешная запись должна иметь один вызов прикладной транзакции. */
|
|
int unavailable; /* Отдельный адрес моделирует отсутствующее или недостоверное измерение. */
|
|
int readonly; /* Независимый адрес запрещён для записи, но остаётся доступен для чтения. */
|
|
} model; /* Все данные принадлежат тесту и отделены от общего wire-кодека. */
|
|
static int Read(void *context, uint16_t address, uint16_t *value) /* Моделируем provider одного значения с явным отказом. */
|
|
{ /* Чтение не меняет сами значения карты. */
|
|
model *state = (model *)context; state->reads++; /* Считаем обращения независимо от успеха для проверки пути записи. */
|
|
if (address >= SET_INVERTOR_GAS_REGISTER_COUNT || (int)address == state->unavailable) { return -1; } /* Отсутствие значения отличается от достоверного нуля. */
|
|
*value = state->values[address]; return 0; /* Возвращаем текущее значение общей модели. */
|
|
} /* Конец диагностического read-provider. */
|
|
static int Write(void *context, const uint16_t *addresses, const uint16_t *values, unsigned count) /* Выполняем согласованное применение только полностью проверенного набора. */
|
|
{ /* Тестовый provider реализует обязательный контракт проверки до изменения данных. */
|
|
model *state = (model *)context; unsigned i; /* Контекст и индекс не обращаются к аппаратуре или динамической памяти. */
|
|
if (count == 0U || count > PCAN_GAS_REGS_PER_FRAME) { return -1; } /* Пустая транзакция не считается успешной командой. */
|
|
for (i = 0U; i < count; ++i) { if (addresses[i] >= SET_INVERTOR_GAS_REGISTER_COUNT || (int)addresses[i] == state->readonly || values[i] == UINT16_MAX) { return -1; } } /* Граница, readonly и запрещённое тестовое значение проверяются для всего набора до первой записи. */
|
|
for (i = 0U; i < count; ++i) { state->values[addresses[i]] = values[i]; } /* Только полностью валидная транзакция изменяет выбранные адреса. */
|
|
state->commits++; return 0; /* Подтверждаем ровно одно применение набора без протокольного ACK. */
|
|
} /* Завершаем тестовый write-provider. */
|
|
static pcan_frame_t RegisterFrame(unsigned address, const uint16_t *values, unsigned count) /* Сериализация обычного GAS выполняется существующей функцией Templates. */
|
|
{ /* Нулевое число слов обозначает запрос чтения. */
|
|
pcan_frame_t frame = {0}; /* Избегаем неинициализированных флагов и неиспользуемых октетов. */
|
|
pcan_gas_regs_to_frame(&frame, set_invertor_gas_request_id(PCAN_MSG_GAS, address, 0U), (uint16_t)address, values, (uint16_t)count); /* Кодек задаёт little-endian и точную длину 0/2/4/6/8. */
|
|
return frame; /* Возвращаем готовый транспортный кадр без второго wire-builder в тесте. */
|
|
} /* Конец создания регистрового запроса. */
|
|
static pcan_frame_t SlotFrame(unsigned slot, const uint16_t words[4]) /* Масочный payload формируется тем же общим кодеком, что используют клиенты. */
|
|
{ /* NULL обозначает чтение слота без данных. */
|
|
pcan_frame_t frame = {0}; uint_least8_t data[8] = {0}; unsigned i; /* Локальные буферы ограничены одним Classic CAN-кадром. */
|
|
frame.id = set_invertor_gas_request_id(PCAN_MSG_GAS_SLOT, slot, 0U); frame.flags = PCAN_FLAG_IDE; /* Выбираем тип 0x4 отдельно от типа 0x3. */
|
|
frame.dlc = (uint8_t)pcan_gas_slot_encode(words, words == NULL ? 0U : 4U, data); /* Существующий кодек проверяет непустую маску перед формированием октетов. */
|
|
for (i = 0U; i < frame.dlc; ++i) { frame.data[i] = (uint8_t)data[i]; } /* Переносим готовые октеты в стандартный кадр тестового транспорта. */
|
|
return frame; /* Ни одной формулы endian или CRC здесь нет. */
|
|
} /* Конец создания слотного запроса. */
|
|
int main(void) /* Проверяем согласованность, границы, права и отсутствие fallback между двумя типами. */
|
|
{ /* Модель используется без подключения силовой электроники. */
|
|
model state = {0}; set_invertor_gas_port_t port = {&state, Read, Write}; /* Оба типа GAS используют один и тот же provider. */
|
|
pcan_frame_t request, response, unchanged; uint16_t pair[2], words[4], slot, word; unsigned i, reads, commits; pcan_id_t id; /* Все временные данные имеют фиксированные размеры. */
|
|
state.unavailable = -1; state.readonly = -1; /* В начале все значения доступны и разрешены для тестовой записи. */
|
|
for (i = 0U; i < SET_INVERTOR_GAS_REGISTER_COUNT; ++i) { state.values[i] = (uint16_t)(1000U + i); } /* Отличающиеся соседи показывают любую лишнюю запись. */
|
|
CHECK(SET_INVERTOR_GAS_REGISTER_COUNT == 750U && SET_INVERTOR_GAS_SLOT_COUNT == 250U); /* Word0-маски не считаются дополнительными хранимыми значениями. */
|
|
CHECK(set_invertor_gas_request_id(PCAN_MSG_GAS, 0U, 0U) == UINT32_C(0x17E30000)); /* Проверяем эталон первого запроса обычного GAS к узлу 7/E. */
|
|
CHECK(set_invertor_gas_request_id(PCAN_MSG_GAS_SLOT, 0U, 0U) == UINT32_C(0x17E40000)); /* Тип слота отличается только назначенным полем MsgType. */
|
|
CHECK(set_invertor_gas_request_id(PCAN_MSG_GAS, 749U, 1U) == UINT32_C(0x1FE302ED)); /* Проверяем последний регистр и направление ответа. */
|
|
CHECK(set_invertor_gas_request_id(PCAN_MSG_GAS, 750U, 0U) == 0U && set_invertor_gas_request_id(PCAN_MSG_GAS_SLOT, 250U, 0U) == 0U); /* Первые адреса за двумя картами отвергаются без усечения. */
|
|
CHECK(set_invertor_gas_request_id(5U, 0U, 0U) == 0U && set_invertor_gas_request_id(3U, 0U, 2U) == 0U); /* Другой MsgType и недопустимый Route не подменяются GAS. */
|
|
CHECK(set_invertor_gas_register(249U, 3U) == 749 && set_invertor_gas_register(250U, 1U) == -1 && set_invertor_gas_register(0U, 0U) == -1); /* Маска не адресует регистр, а последняя полезная координата существует. */
|
|
for (i = 0U; i < SET_INVERTOR_GAS_REGISTER_COUNT; ++i) { CHECK(set_invertor_gas_coordinate(i, &slot, &word)); CHECK(set_invertor_gas_register(slot, word) == (int32_t)i); } /* У каждой из 750 позиций есть ровно согласованная полезная координата. */
|
|
slot = 99U; word = 88U; CHECK(!set_invertor_gas_coordinate(750U, &slot, &word)); CHECK(slot == 99U && word == 88U); /* Ошибка координат не изменяет выходы вызывающего. */
|
|
pair[0] = 0x1234U; request = RegisterFrame(1U, pair, 1U); reads = state.reads; /* Одна уставка записывается обычным GAS без выбора слота. */
|
|
CHECK(set_invertor_gas_handle(&port, &request, NULL) == 0); CHECK(state.values[0] == 1000U && state.values[1] == 0x1234U && state.values[2] == 1002U); CHECK(state.reads == reads); /* Соседние регистры не меняются и предварительное чтение не выполняется. */
|
|
request = SlotFrame(0U, NULL); CHECK(set_invertor_gas_handle(&port, &request, &response) == 1); /* Тот же результат сразу виден через слотный доступ. */
|
|
CHECK(pcan_gas_slot_decode_words(response.id, response.flags, response.data, response.dlc, words) == 4); CHECK(words[0] == 0xEU && words[1] == 1000U && words[2] == 0x1234U && words[3] == 1002U); /* Маска и три значения не создают второй копии данных. */
|
|
words[0] = 4U; words[1] = 55U; words[2] = 4321U; words[3] = 66U; request = SlotFrame(0U, words); reads = state.reads; /* Выбираем только Word2; ненужные значения специально отличаются от текущих. */
|
|
CHECK(set_invertor_gas_handle(&port, &request, NULL) == 0); CHECK(state.values[0] == 1000U && state.values[1] == 4321U && state.values[2] == 1002U && state.reads == reads); /* Неотмеченные поля сохраняются без чтения слота на клиенте. */
|
|
request = RegisterFrame(1U, NULL, 0U); CHECK(set_invertor_gas_handle(&port, &request, &response) == 1); CHECK(pcan_gas_frame_to_regs(&response, words, 4U) == 4U && words[0] == 4321U); /* Изменение через 0x4 видно через обычный GAS 0x3. */
|
|
state.readonly = 3; words[0] = 4U; words[2] = 2222U; request = SlotFrame(1U, words); /* В слоте 1 Word1 соответствует readonly-регистру 3, но маска выбирает регистр 4. */
|
|
CHECK(set_invertor_gas_handle(&port, &request, NULL) == 0 && state.values[3] == 1003U && state.values[4] == 2222U); /* Неотмеченный readonly-сосед не мешает разрешённой записи. */
|
|
pair[0] = 77U; pair[1] = 88U; state.readonly = 7; commits = state.commits; request = RegisterFrame(6U, pair, 2U); /* Второе слово блока намеренно запрещено для записи. */
|
|
CHECK(set_invertor_gas_handle(&port, &request, NULL) == -1 && state.values[6] == 1006U && state.values[7] == 1007U && state.commits == commits); /* Весь блок отклоняется до применения первого корректного слова. */
|
|
state.readonly = -1; request = RegisterFrame(749U, pair, 2U); CHECK(set_invertor_gas_handle(&port, &request, NULL) == -1 && state.values[749] == 1749U && state.commits == commits); /* Пересечение конца карты не вызывает частичную запись. */
|
|
request = RegisterFrame(749U, NULL, 0U); CHECK(set_invertor_gas_handle(&port, &request, &response) == 1 && response.dlc == 2U); /* Конец обычной карты читается коротким корректным ответом из одного слова. */
|
|
request = SlotFrame(249U, NULL); CHECK(set_invertor_gas_handle(&port, &request, &response) == 1 && response.dlc == 8U); /* Последний слот содержит все три реальные позиции 747…749. */
|
|
state.unavailable = 1; request = SlotFrame(0U, NULL); CHECK(set_invertor_gas_handle(&port, &request, &response) == 1); /* Частичный ответ отмечает только реально доступные значения. */
|
|
CHECK(pcan_gas_slot_decode_words(response.id, response.flags, response.data, response.dlc, words) == 4 && words[0] == 10U && words[2] == 0U); /* Недостоверный Word2 отличается от достоверного числового нуля отсутствием бита 2. */
|
|
state.unavailable = -1; memset(&unchanged, 0xA5, sizeof(unchanged)); response = unchanged; /* Отмечаем выходной кадр для проверки всех отказов. */
|
|
words[0] = 4U; words[2] = 200U; request = SlotFrame(0U, words); request.data[0] = 0x10U; commits = state.commits; /* Устанавливаем зарезервированный бит маски в заранее корректном wire-кадре. */
|
|
CHECK(set_invertor_gas_handle(&port, &request, &response) == -1 && state.commits == commits && memcmp(&response, &unchanged, sizeof(response)) == 0); /* Отказ не меняет ни данные, ни предыдущий ответ. */
|
|
request = SlotFrame(0U, words); request.dlc = 2U; CHECK(set_invertor_gas_handle(&port, &request, &response) == -1); /* У типа 0x4 нет формата короткой записи отдельного значения. */
|
|
request = RegisterFrame(0U, pair, 1U); request.dlc = 1U; CHECK(set_invertor_gas_handle(&port, &request, &response) == -1); /* Нечётный обычный GAS не обрабатывается как корректное первое слово. */
|
|
request.dlc = 9U; CHECK(set_invertor_gas_handle(&port, &request, &response) == -1); /* Payload больше Classic CAN не выходит за фиксированные массивы. */
|
|
request = RegisterFrame(0U, pair, 1U); request.flags |= PCAN_FLAG_RTR; CHECK(set_invertor_gas_handle(&port, &request, &response) == -1); /* RTR не является командой записи. */
|
|
request.flags = PCAN_FLAG_IDE | PCAN_FLAG_ERR; CHECK(set_invertor_gas_handle(&port, &request, &response) == -1); /* Ошибка транспорта не становится прикладной командой. */
|
|
request.flags = 0U; CHECK(set_invertor_gas_handle(&port, &request, &response) == -1); /* Стандартный 11-битный кадр не совпадает с расширенным адресом инвертора. */
|
|
request.flags = PCAN_FLAG_IDE; pcan_id_unpack(request.id, &id); id.device_id = 13U; request.id = pcan_id_pack(&id); /* Меняем адрес на существующий конфигуратор 7/D. */
|
|
CHECK(set_invertor_gas_handle(&port, &request, &response) == -1 && state.commits == commits); /* Инвертор не исполняет запросы соседнего прибора. */
|
|
request = RegisterFrame(0U, pair, 1U); pcan_id_unpack(request.id, &id); id.route = PCAN_ROUTE_FROM_DEVICE; request.id = pcan_id_pack(&id); /* Ответ другого прибора не должен исполняться повторно как запись. */
|
|
CHECK(set_invertor_gas_handle(&port, &request, &response) == -1); /* Запросом считается только направление от верхнего уровня. */
|
|
request = RegisterFrame(0U, NULL, 0U); CHECK(set_invertor_gas_handle(&port, &request, NULL) == -1); CHECK(set_invertor_gas_handle(NULL, &request, &response) == -1); /* Проверяем отсутствие буфера ответа и отсутствующий provider. */
|
|
port.write = NULL; request = RegisterFrame(0U, pair, 1U); CHECK(set_invertor_gas_handle(&port, &request, NULL) == -1); /* Readonly-порт запрещает запись обоими представлениями данных. */
|
|
request = SlotFrame(0U, words); CHECK(set_invertor_gas_handle(&port, &request, NULL) == -1); /* Слотная маска не обходит отсутствие write-provider. */
|
|
{ /* Клиентский ABI использует те же wire-векторы, не создавая второго кодека для GUI. */
|
|
uint32_t identifier = 0U; uint8_t data[8] = {0}; unsigned metadata[2] = {99U, 88U}; int length; /* Буферы имеют точные пределы Classic CAN и одного ответа. */
|
|
CHECK(set_invertor_gas_limit(3U) == 750U && set_invertor_gas_limit(4U) == 250U && set_invertor_gas_limit(5U) == 0U); /* Размеры берутся из единственного профиля, а не дублируются клиентом. */
|
|
pair[0] = 0x1234U; length = set_invertor_gas_build(3U, 1U, pair, 1U, &identifier, data); /* Одна обычная уставка передаётся двумя октетами. */
|
|
CHECK(length == 2 && identifier == UINT32_C(0x17E30001) && data[0] == 0x34U && data[1] == 0x12U && data[2] == 0U); /* Проверяем эталонные ID, little-endian и очищенный хвост. */
|
|
CHECK(set_invertor_gas_decode(UINT32_C(0x1FE30001), 1U, data, 2U, metadata, words) == 1 && metadata[0] == 3U && metadata[1] == 1U && words[0] == 0x1234U); /* Клиентский разбор восстанавливает тот же тип, адрес и значение. */
|
|
words[0] = 4U; words[1] = 0U; words[2] = 0x1234U; words[3] = 0U; /* Масочный wire-набор выбирает только второе полезное значение. */
|
|
CHECK(set_invertor_gas_build(4U, 0U, words, 4U, &identifier, data) == 8 && identifier == UINT32_C(0x17E40000)); /* Builder использует именно слотный MsgType 0x4. */
|
|
CHECK(data[0] == 4U && data[1] == 0U && data[4] == 0x34U && data[5] == 0x12U); /* Фиксированный тестовый вектор подтверждает положение маски и Word2. */
|
|
CHECK(set_invertor_gas_decode(UINT32_C(0x1FE40000), 1U, data, 8U, metadata, words) == 4 && words[0] == 4U && words[2] == 0x1234U); /* Ответ проверяется тем же масочным кодеком. */
|
|
CHECK(set_invertor_gas_build(4U, 0U, words, 3U, &identifier, data) == -1); /* Неполный масочный payload не упаковывается как обычный GAS. */
|
|
CHECK(set_invertor_gas_decode(UINT32_C(0x17E40000), 1U, data, 8U, metadata, words) == -1); /* Эхо исходящего запроса не считается обновлением телеметрии. */
|
|
CHECK(set_invertor_gas_decode(UINT32_C(0x1FE30000), 1U, data, 3U, metadata, words) == -1); /* Нечётный обычный payload отвергается клиентской границей. */
|
|
} /* Клиентская проверка не обращается к реальному устройству. */
|
|
puts("invertor GAS 0x3 + GAS SLOT 0x4: OK"); return 0; /* Все проверки выполнены на реальном общем C-кодеке без оборудования. */
|
|
} /* Конец сценариев согласованности и защиты границ новой карты инвертора. */
|