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

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

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


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

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

В примере показана процедура настройки процессора для работы с внешней памятью SDRAM. Если раскомментировано
макроопределение "SDRAM_MODEL_MT48LC16M16A2", то внешняя шина настраивается для работы с одной микросхемой
MT48LC16M16A2, шина данных - 16 бит. Если раскомментировано макроопределение "X2_SDRAM_MODEL_MT48LC16M16A2", 
то внешняя шина настраивается для работы с двумя микросхемами MT48LC16M16A2, шина данных - 32 бит. 

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

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


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

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


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

    - Интегрированная среда разработки CM-LYNX.
    - Отладочная плата для процессора 1967ВН044.

    Обратите внимание, что согласно паспорту на комплект отладочный для микросхемы 1967ВН044, пункт 7.3.4 
    "Использование SDRAM и NAND FLASH-памяти", для безошибочного доступа к памяти на чтение/запись 
    рекомендуется установить режим тактирования SCLK не более 25 МГц. Для экспериментальных целей возможно 
    увеличить режим тактирования SCLK до 80 МГц, но обязательно проверить память в необходимых режимах работы
    с помощью программного обеспечения.

    На отладочной плате для 1967ВН044 установлено 3 микросхемы памяти: 2 микросхемы SDRAM MT48LC16M16A2 и 
    1 микросхема NAND Flash K9F8G08U0M. По умолчанию реализован доступ к одной микросхеме памяти SDRAM и 
    к микросхеме памяти NAND Flash, вследствие чего доступ к SDRAM осуществляется только с использованием 
    16-разрядной шины данных. Вторая микросхема памяти SDRAM может быть подключена только вместо микросхемы 
    NAND Flash. Чтобы задействовать обе микросхемы памяти SDRAM и работать с 32-разрядной шиной данных, 
    согласно паспорту на комплект отладочный для микросхемы 1967ВН044, пункт 7.3.4, необходимо установить 
    резистор R32 = 0 Ом (smd перемычка) и убрать резистор R29.


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

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

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