/*************************************************************************************************************
  Copyright (C) 2016-2022 JSC "ICC Milandr" 

*************************************************************************************************************/

/*
 *
 *  Файл:      readme.txt
 *  Описание:  Описание примера LINK_DMA_Transmit_Receive
 *
 *  История:
 *             27.09.22  - cоздан
 *
 */


/* Описание примера ----------------------------------------------------------------------------------------*/

В данном примере приведено, как настроить порт связи и выполнить с его помощью передачу массива данных. 

Для перемещения данных между внутренней памятью и буферами порта связи используется DMA. Для передачи данных 
задействуются приёмник и передатчик 2 порта связи. После окончания отправки и приёма данных выполняется 
верификация принятых данных.

Если данные были переданы успешно, то в отладочную консоль будет выведено сообщение "Result: Success". 
Если в ходе работы примера была зафиксирована ошибка, то в отладочную консоль будет выведено сообщение
"Result: Error - <Описание проблемы>".

Обратите внимание, что переменные для хранения конфигурации tcb должны быть выровнены на границу квадраслова!
Работа с буферами порта связи всегда осуществляется квадрословами, поэтому для корректной работы DMA 
соответствующие буферы для хранения данных приёмника и передатчика порта связи также должны быть выровнены на 
границу квадраслова, при этом количество передаваемых данных должно быть кратно 4!


/* Содержание каталога -------------------------------------------------------------------------------------*/

    - main.c               Основная программа
    - project.ldf          Файл сценария для компоновщика
    - session.lldbinit     Файл инициализации периферии до запуска отладки
    - .cproject, .project  Файлы конфигурации проекта


/* Аппаратная и программная среда --------------------------------------------------------------------------*/

    - Интегрированная среда разработки CM-LYNX.
    - Отладочная плата для процессора 1967ВН028, кабель DVI.
      
      При работе с процессором D5 необходимо подключить кабель DVI между разъёмами XS4 (передатчик Link2) и 
      XS5 (приёмник Link2). 
      При работе с процессором D6 необходимо подключить кабель DVI между разъёмами XS8 (передатчик Link2) и 
      XS9 (приёмник Link2).


/* Использование -------------------------------------------------------------------------------------------*/

Для запуска примера необходимо выполнить следующие действия:
    - Создать новое или открыть существующее рабочее пространство (Workspace).
    - Выполнить импорт проекта "LINK_DMA_Transmit_Receive" в соответствии с 
      "ML_GUI_Руководство_пользователя_R_Vx", п. "Импорт существующего проекта".
    - Выполнить сборку проекта.
    - Создать конфигурацию отладки в соответствии с "ML_GUI_Руководство_пользователя_R_Vx", п. "Настройка 
      конфигурации и запуск отладки".
    - Запустить пример в режиме отладки.

Подробное описание библиотеки HAL с примерами использования функций приведено в каталоге по пути:
"CM-LYNX.x.yy.zz\toolchain\1967VN028\HAL\doc".
