Просмотр кода страницы Использование CRC на примере алгоритма CRC-32Q

В примере будут записаны данные в основной массив OTP, тестовый столбец и тестовую строку, после чего они будут считаны.

== Работа с конфигуратором (В разработке) ==
Для начала настроем в конфигураторе тактирование mik32, например, от внешнего кварца 32МГц. Затем настроем делители шины. Так как CRC тактируется от шины AHB_CLK, то зададим делитель AHB_DIV. В данном примере оставим делители по умолчанию. В итоге вкладка с тактированием должна выглядеть так:

(Картинка тактирования из конфигуратора. В работе)

Затем перейдем к настройке самого CRC. Для этого откроем вкладку CRC и нажмем включить.

Появится поле с выбором алгоритма и его настройками. Тут можно настроить свой собственный алгоритм или выбрать один из стандартных, которые приведены в таблице ниже.

* Название алгоритма (''name'');

* Степень порождающего контрольную сумму многочлена (''width'');

* Сам производящий полином (''poly''). Для того, чтобы записать его в виде значения, его сначала записывают как битовую последовательность, при этом старший бит опускается — он всегда равен 1. 

* Стартовые данные (''init''), то есть начальное значение в регистре данных.

* Флаг (''RefIn''), указывающий на начало и направление вычислений. Существует два варианта: False — начиная со старшего значащего бита (MSB-first) или True — с младшего (LSB-first);

* Флаг (''RefOut''), определяющий, инвертируется ли порядок битов регистра при входе на элемент XOR;

* Число (''XorOut''), с которым складывается по модулю 2 полученный результат;

* Значение CRC (''check'') для строки «123456789» .

{| class="wikitable"
|+Стандартные алгоритмы CRC32
!Name
!Width
!Poly
!Init
!RefIn
!RefOut
!XorOut
!Check
|-
|CRC-32/zlib
|32
|0x04C11DB7
|0xFFFFFFFF
|true
|true
|0xFFFFFFFF
|0xCBF43926
|-
|CRC-32/BZIP2
|32
|0x04C11DB7
|0xFFFFFFFF
|false
|false
|0xFFFFFFFF
|0xFC891918
|-
|CRC-32C
|32
|0x1EDC6F41
|0xFFFFFFFF
|true
|true
|0xFFFFFFFF
|0xE3069283
|-
|CRC-32D
|32
|0xA833982B
|0xFFFFFFFF
|true
|true
|0xFFFFFFFF
|0x87315576
|-
|CRC-32/MPEG-2
|32
|0x04C11DB7
|0xFFFFFFFF
|false
|false
|0x0
|0x376E6E7
|-
|CRC-32/POSIX
|32
|0x04C11DB7
|0x0
|false
|false
|0xFFFFFFFF
|0x765E7680
|-
|CRC-32Q
|32
|0x814141AB
|0x0
|false
|false
|0x0
|0x3010BF7F
|-
|CRC-32/JAMCRC
|32
|0x04C11DB7
|0xFFFFFFFF
|true
|true
|0x0
|0x340BC6D9
|-
|CRC-32/XFER
|32
|0xAF
|0x0
|false
|false
|0x0
|0xBD0BE338
|}
[[Файл:Настройки CRC32 в конфигураторе.png|мини|Рисунок 2 - настройки CRC32 в конфигураторе|310x310px]]
Выберем алгоритм CRC-32Q.

В итоге настройки CRC в конфигураторе должны выглядеть как на рисунке.

Нажимаем кнопку сохранения и генерации. В итоге у нас появится проект для PlatformIo. Далее работа идет в visual studio code.

== Использование библиотеки HAL_OTP ==
В сгенерированном проекте в файле main.c должна быть функция CRC_Init, в которой будут заданы настройки для OTP. Выглядит она так:
{{#spoiler:show=Развернуть код|hide=Свернуть код|
<syntaxhighlight lang="c" line="1">
static void CRC_Init(void)
{

    hcrc.Instance = CRC;
    
    /* Настройки вычисления CRC */                    
    /*******************************************CRC-32Q*******************************************/
    hcrc.Poly = 0x814141AB;                             
    hcrc.Init = 0x00000000;                                 
    hcrc.InputReverse = CRC_REFIN_FALSE;                 
    hcrc.OutputReverse = CRC_REFOUT_FALSE;                          
    hcrc.OutputInversion = CRC_OUTPUTINVERSION_OFF;

    HAL_CRC_Init(&hcrc);

}
</syntaxhighlight>
}}
Кроме этого в функции SystemClock_Config приведены настройки для тактирования. Убедитесь что в PeriphClkInit.PMClockAPB_M присутствует PM_CLOCK_OTP_CONTROLLER_M. Сама функция должна выглядеть примерно так:
{{#spoiler:show=Развернуть код|hide=Свернуть код|
<syntaxhighlight lang="c" line="1">
void SystemClock_Config(void)
{
    RCC_OscInitTypeDef RCC_OscInit = {0};
    RCC_PeriphCLKInitTypeDef PeriphClkInit = {0};

    RCC_OscInit.OscillatorEnable = RCC_OSCILLATORTYPE_OSC32K | RCC_OSCILLATORTYPE_OSC32M; // Включение 32К и 32М источников
    RCC_OscInit.OscillatorSystem = RCC_OSCILLATORTYPE_OSC32M;                          
    RCC_OscInit.AHBDivider = 0;                             
    RCC_OscInit.APBMDivider = 0;                             
    RCC_OscInit.APBPDivider = 0;                             
    RCC_OscInit.HSI32MCalibrationValue = 0;                  
    RCC_OscInit.LSI32KCalibrationValue = 0;
    HAL_RCC_OscConfig(&RCC_OscInit);

    PeriphClkInit.PMClockAHB = PMCLOCKAHB_DEFAULT | PM_CLOCK_CRC32_M;    
    PeriphClkInit.PMClockAPB_M = PMCLOCKAPB_M_DEFAULT | PM_CLOCK_WU_M;     
    PeriphClkInit.PMClockAPB_P = PMCLOCKAPB_P_DEFAULT | PM_CLOCK_UART_0_M;     
    PeriphClkInit.RTCClockSelection = RCC_RTCCLKSOURCE_NO_CLK;
    PeriphClkInit.RTCClockCPUSelection = RCC_RTCCLKCPUSOURCE_NO_CLK;
    HAL_RCC_ClockConfig(&PeriphClkInit);
}
</syntaxhighlight>
}}
Для демонстрации вывода текста в PeriphClkInit.PMClockAPB_P присутствует PM_CLOCK_UART_0_M. У вас его может не быть так как UART нужно включить отдельно. Для этого нужно подключить библиотеки uart_lib и xprintf.
{{#spoiler:show=Развернуть код|hide=Свернуть код|
<syntaxhighlight lang="c" line="1">
#include "mik32_hal_rcc.h"
#include "mik32_hal_crc32.h"

#include "uart_lib.h"
#include "xprintf.h"
</syntaxhighlight>
}}
Для инициализации UART в функции main, после функции тактирования SystemClock_Config, следует написать:
<syntaxhighlight lang="c" line="1" start="1">
UART_Init(UART_0, 3333, UART_CONTROL1_TE_M | UART_CONTROL1_M_8BIT_M, 0, 0);
</syntaxhighlight>
Скорость UART задается делителем во втором аргументе функции. При такой записи скорость будет 9600 бод.

В начале main.c можно видеть объявление структуры с набором настроек для CRC, которую использует функция инициализации CRC_Init.
{{#spoiler:show=Развернуть код|hide=Свернуть код|
<syntaxhighlight lang="c" line="1">
CRC_HandleTypeDef hcrc;

void SystemClock_Config(void);
static void CRC_Init(void);
</syntaxhighlight>
}}
Так как в таблице со стандартными алгоритмами приведена контрольная сумма для стоки "123456789", то используем ее в нашем примере. Нам понадобятся следующие функции:

HAL_CRC_WriteData - запись данных в регистр данных по байтам;

HAL_CRC_ReadCRC - чтение значения CRC.

Функция main должна выглядеть примерно так:
{{#spoiler:show=Развернуть код|hide=Свернуть код|
<syntaxhighlight lang="c" line="1">
int main()
{    

    SystemClock_Config();

    UART_Init(UART_0, 3333, UART_CONTROL1_TE_M | UART_CONTROL1_M_8BIT_M, 0, 0);

    CRC_Init();

    uint8_t  message[] ={'1', '2', '3', '4', '5', '6', '7', '8', '9'};
    uint32_t CRCValue = 0;
    
    /* Запись по байтам */
    HAL_CRC_WriteData(&hcrc, message, sizeof(message));
    CRCValue = HAL_CRC_ReadCRC(&hcrc);
    xprintf("CRC32 = 0x%08x, ожидалось 0x3010BF7F\n", CRCValue);
    
    while (1)
    {    

    }
       
}
</syntaxhighlight>
}}
[[Файл:CRC. Вывод в UART.png|мини|Рисунок 3 - вывод в UART]]
Если у вас включен UART, то можно видеть вывод как на рисунке 3. Полученное значение CRC совпадает с табличным значением в столбце Check.

Кроме записи по байтам можно записывать по словам. Для этого используем функцию HAL_CRC_WriteData32. Получим значение CRC для данных из двух слов - 0xABCDABCD и 0xA1B2C3D4.

Для проверки можно воспользоваться этим онлайн [https://crccalc.com/ калькулятором CRC] или [http://www.sunshine2k.de/coding/javascript/crc/crc_js.html этим]. Введя в него 0xABCDABCD и 0xA1B2C3D4 можно видеть результат CRC 0x6311BC18 на рисунке 4.

Функция main должна выглядеть так:

[[Файл:Калькулятор CRC.png|мини|Рисунок 4 - калькулятор CRC]][[Файл:CRC по словам. Вывод в UART .png|мини|Рисунок 5 - вывод в UART второго примера]]
{{#spoiler:show=Развернуть код|hide=Свернуть код|
<syntaxhighlight lang="c" line="1">
int main()
{    

    SystemClock_Config();

    UART_Init(UART_0, 3333, UART_CONTROL1_TE_M | UART_CONTROL1_M_8BIT_M, 0, 0);

    CRC_Init();

    uint8_t  message[] ={'1', '2', '3', '4', '5', '6', '7', '8', '9'};
    uint32_t data[] = {0xABCDABCD, 0xA1B2C3D4};
    uint32_t CRCValue = 0;
    
    /* Запись по байтам */
    HAL_CRC_WriteData(&hcrc, message, sizeof(message));
    CRCValue = HAL_CRC_ReadCRC(&hcrc);
    xprintf("CRC32 = 0x%08x, ожидалось 0x3010BF7F\n", CRCValue);
    
    /* Запись по словам */
    HAL_CRC_WriteData32(&hcrc, data, sizeof(data)/sizeof(*data));
    CRCValue = HAL_CRC_ReadCRC(&hcrc);
    xprintf("CRC32 = 0x%08x, ожидалось 0x6311BC18\n", CRCValue);
    
    while (1)
    {    

    }
       
}
</syntaxhighlight>
}}
Вывод в UART изображен на рисунке 5.