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

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

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


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

В данном примере демонстрируется работа с внешней SDRAM памятью MT48LC32M16A2 (4x).

В примере показана процедура настройки процессора для работы с внешней памятью SDRAM. На отладочной плате для 
1967ВН028 подключение 4 микросхем памяти SDRAM выполнено для 64-разрядной шины данных, поэтому при настройке 
ширины шины данных внешней памяти выбирается 64-разрядный режим работы. 

В примере реализованы 9 тестов, которые выполняют запись и чтение различных паттернов данных с последующей 
проверкой. По умолчанию каждый тест проводится 1 раз (параметр NUM_OF_REPEAT) для всего объёма SDRAM памяти.

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


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

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


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

    - Интегрированная среда разработки CM-LYNX.
    - Отладочная плата для процессора 1967ВН028.
    
    Обратите внимание, что согласно паспорту на комплект отладочный для микросхемы 1967ВН028, пункт 7.2.8 
    "Использование SDRAM памяти", для безошибочного доступа к памяти на чтение/запись рекомендуется установить 
    режим тактирования SCLK не более 25 МГц (переключатели SA10-SA11). Для экспериментальных целей возможно 
    увеличить режим тактирования SCLK до 100 МГц, но обязательно проверить память в необходимых режимах работы 
    с помощью программного обеспечения.
    
    Для того чтобы микросхема SDRAM корректно работала, она должна быть предварительно проинициализирована. 
    Процедура инициализации SDRAM выполняется процессором сразу же после включения контроллера SDRAM. 
    Так как процессор 1967ВН028 предназначен для работы в кластере, то чтобы каждый процессор при включении 
    контроллера SDRAM не выполнял процедуру инициализации, было предусмотрено ограничение, согласно которому 
    процедуру инициализации SDRAM выполняет только процессор с ID == 000. Таким образом перед запуском примера
    необходимо установить для используемого процессора ID = 000 с помощью соответствующего переключателя: 
    SA12 для процессора D5 и SA13 для процессора D6.

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

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

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