STM32F4. DMX v2

[teplofizik]

Я хотел всё написать про протокол DMX на STM32. Я всё же сделал это>< Протокол сей используется большей частью в освещении (в театрах и типа того) и подобных некритических к потерям пактов областям. Один пакет DMX содержит информацию о уровнях 512 каналов (0-255), посылается он 44 раза в секунду, если без перерывов.
В качестве физической линии используется стандарт RS-485 (дифференциальная линия), программно же это последовательный асинхронный протокол (UART) со скоростью передачи данных 250 кбит/сек с двумя стоповыми битами и без контроля чётности.

Пакет состоить из трёх частей: сброс линии (BREAK), стартовый код (байт 0x00) и данные (512 байт с уровнями каналов). То есть достаточно просто. Тайминги установлены тоже не жёстко, только на минимум: ширина BREAK не менее 92 мкс (лучше ~120 мкс), перерыв между BREAK и стартовым кодом - не менее 12 мкс. В остальном полная свобода.



Приём пакета заключается в ожидании сброса линии (определяется как Frame Error, FE) и последовательном приёме 513 байт в буфер (но их может быть и меньше). Если нулевой байт равен нулю, то это пакет DMX и его можно передать дальше в устройство. Если нет, пакет отбрасывается (так как это пакет какого-то другого формата).
Отправка тоже незамысловата: передаём BREAK нужной длины, передаём Mark After Break (время между BREAK и стартовыйм кодом) нужной длины, передаём ноль и 512 байт данных. После чего всё начинается с начала.

Самая хитрость заключается в создании BREAK и MAB. Некоторые контроллеры, в частности и STM32, хвастаются, что умеют делать BREAK аппаратно. В общем-то, это хорошо, но BREAK отличается от нулевого байта только отсутствием стопового бита (вместо 1 там 0), длина же байта остаётся той же. Для DMX такое положение дел не годится — байт при заявленной скорости занимает 44 мкс, что в два раза меньше минимально необходимой. потому его надо генерировать как-то иначе.
Раньше я использовал для таких целей таймер, но это нерационально - целый таймер на уарт, жуть. А если надо 4 DMX генерировать? Не вариант.
Если вспомнить, что в уарте есть встроенный таймер (протокол-то асинхронный), то можно воспользоваться и им. Алгоритм таков:
1. Передача BREAK.
Переводим линию в низкий уровень, знаменующий собой стартовый бит, используя режим GPIO.
Выбираем такую скорость UART, чтобы передача одного байта занимала требуемое нам время в 120 мкс. Передаём какой-нибудь байт (так как он никуда не улетит всё равно).
Окончание передачи в линию ознаменует и конец заданного интервала времени.
2. Передача Mark After Break.
Всё то же самое, только уровень на линии дефолтный: высокий.
Переводим линию в высокий уровень, знаменуя возврат линии в неактивное состояние, используя режим GPIO.
Выбираем такую скорость UART, чтобы передача одного байта занимала требуемое нам время в 24 мкс (да, с запасом). Передаём какой-нибудь байт.
Окончание передачи завершит данный этап.
3. Передача стартового кода.
Линия переводится в режим UART, желательно таким образом, чтоб промежуточных состояний не было (никаких отклонений от высокого уровня на линии быть не должно). В частности, в СТМ обратите внимание на переключение в альтернативную функцию: сначала выбираем номер, потом переводим режим! Если номер выбирать после, то кто знает, какая периферия подключится на это время и что будет на выводе.
Выбирается скорость передачи данных 250 кбит/сек.
Передаётся нулевой байт 0x00.
4. Передача данных.
По очереди передаются данные, все 512 байт.

Всё. В итоге получается, что передача DMX осуществляется только на прерываниях/флагах статуса самого приёмопередатчика, без привлечения посторонней периферии. К сожалению, в некоторых контроллерах (типа LPC23xx) нет прерываний о завершении передачи в линию, потому там данный алгоритм применим с некоторыми ограничениями и костылями. Но это уже древний хлам, так что не будем о нём.

Расчёт времени передачи байта по UART выполняется примерно так: 1 бит передаётся за (1000000 / скорость) микросекунд. В байте с двумя стоповыми битами всего 11 бит: один стартовый, восемь бит данных и два стоповых. То есть в 11 раз больше времени передачи одного бита. Обратив эту формулу, получим формулу для расчёта скорости по заданной длине.

Собственно, пример приёма и передачи DMX. проект сейчас настроен на передачу сигнала (который ещё надо драйвером RS485 сконвертировать в дифференциальный вид).

// Запуск тестовой программы, test.c
#define DMX 2 // 2 канал, USART3, см. dmx.c

void test_Init(void)
{
    memset(&Buffer[0], 0, sizeof(Buffer));
    
    dmx_Init(DMX);
    dmx_SetHandler(DMX, DMX_EVENT_ONRECEIVE, &test_onDMXReceive);
    dmx_SetHandler(DMX, DMX_EVENT_ONTRANSMIT, &test_onDMXTransmit);
    
    dmx_Transmit(DMX);
    //dmx_Receive(DMX);
}

Если dmx_Transmit закомментировать, а dmx_Receive наоборот, то плата начнёт принимать DMX.

В данный момент используется USART3 с выводами PB10, PB11:

// uart.c
// Таблица UART'ов
static const TUartPort Ports[] = {
    { USART1, &clock_GetAPB2, &RCC->APB2ENR, RCC_APB2ENR_USART1EN, USART1_IRQn, 7, {PA, 9}, {PA, 10} },
    { USART2, &clock_GetAPB1, &RCC->APB1ENR, RCC_APB1ENR_USART2EN, USART2_IRQn, 7, {PD, 5}, {PD, 6} },
    { USART3, &clock_GetAPB1, &RCC->APB1ENR, RCC_APB1ENR_USART3EN, USART3_IRQn, 7, {PB, 10}, {PB, 11} },
};

Линия управления направлением драйвера RS485 (~RE/DE) выведена на PA2:

// dmx.c
static const TDMXPort  Ports[] = {
    { UART1, { PA, 0 } },
    { UART2, { PA, 1 } },
    { UART3, { PA, 2 } }
};

UART в STM32 достаточно прост (несмотря на широкие возможности) и имеет всего несколько управляющих регистров:
USART_SR — регистр статуса, текущее состояние приёмопередатчика;
USART_DR —- регистр данных;
USART_BRR — регистр настройки скорости, делитель, 4 бита дробной части и 12 целой, но по сути, туда надо просто записать результат деления (частота шины/нужная скорость);
USART_CR1 — включение/выключение модуля, разрешение генерации прерываний;
USART_CR2 — для настройки генерации синхросигнала, количества стоповых бит и LIN;
USART_CR3 — для DMA и всяких хитрых режимов работы (IrDA, линии CTS, RTS);
USART_GTPR — какие-то тайминги для работы со смарт-картами.

Чтоб UART заработал, достаточно подать на него тактирование, включить (USART_CR1: UE, RE, TE), настроить скорость (USART_BRR) и передавать/принимать данные (USART_DR). Ну и, если надо, настроить режимы чётности и всякие там стоповые биты.
Вот.

Интересные файлы:
uart.c
uart.h
dmx.c
dmx.h

Проект.

@темы: arm, программизмы, электроника, stm32f4discovery, stm32

Comments

[Jerioma]

teplofizik, Zdrastvujte, nemnoga nejasno, kakimi funcijami otpravit znacenije dapustim "channal - 1 value - 255" ???? escio v programirovanije neocen prodvinut, nemogu razobrat, no skompilirevat udalos, pakety idut

[teplofizik]

Jerioma, вот функция, где задаётся новое значение отправляемых данных:

static void test_onDMXTransmit(void)
{
    Buffer[0]++;
    
    dmx_Update(DMX, &Buffer[0], sizeof(Buffer));
}

dmx_Update копирует данные из передаваемого массива в буфер отправки. Индекс 0 массива — это первый канал DMX. И дальше по нарастающей. То есть чтоб задать первому каналу значение 255 надо написать вместо Buffer[0]++; Buffer[0] = 255. Если хотим, например, задать каналу 100 значение 123, то пишем: Buffer[99] = 123;

[Jerioma]

Rabotajet, spasibo bolsoje

[Jerioma]

teplofizik, Escio tupoj vopros, kak priniat sias ?

dmx_Init(uint32_t Port);
dmx_Receive(uint32_t Port);

tak my nastrajevajem


A v cikle uze kakto etoj komandoj prinimajem?

dmx_SetHandler(DMX, TDMXEvent Event, void * Handler);

Event i Handler cto tuda vpisyvat?

[teplofizik]

Jerioma, dmx_SetHandler вызывается при инициализации один раз и говорит библиотеке, какие функции при каких событиях вызывать. Для приёма есть пример:
dmx_SetHandler(DMX, DMX_EVENT_ONRECEIVE, &test_onDMXReceive);

Когда будет принят пакет DMX, будет вызвана функция test_onDMXReceive:
static void test_onDMXReceive(const uint8_t * Data, uint16_t Length)
{

}

[pvman123]

teplofizik

, здравствуйте! Поясните пожалуйста, как работает строка void (* onReceive)(uint8_t *, uint16_t) в структуре TDMXState. Это функция? Если функция, то не вижу ее самой.

[teplofizik]

pvman123, это указатель на функцию формата void UserFunc(uint8_t* data, uint16_t length). Ему присваивается указатель на функцию, написанную пользователем библиотеки, с помощью функции dmx_SetHandler, и вызывается при получении данных. Если там 0, то не вызывается ничего.

Концепция callback, функций обратного вызова.

[pvman123]

Спасибо за ответ, примерно так и думал, но конструкция была до конца непонятной )
Еще вопрос, разбираю прием пакета, не увидел условия " Если нулевой байт равен нулю, то это пакет DMX". Вижу что в прерывании проверяется USART_ISR_RXNE, затем если также возвелся USART_ISR_FE, то States.Index = 0.
Если USART_ISR_FE не возвелся, то идет прием пакета, а условие по приему первого байта на равенство нулю, что то не увидел. Может подскажете где смотреть?

[teplofizik]

pvman123, в dmx_Main, но, наверное, лучше это делать в другом месте.