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

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

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


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

В данном примере приведено, как выполнить инициализация PLL ядра, PLL внешней шины и PLL портов связи.

Макроопределения частот XTI_KHZ, CCLK_HZ и SCLK_HZ задаются в настройках проекта:
пункт "C/C++ Build -> Settings -> Hardware -> Generic hardware settings".

Частота PLL портов связи устанавливается с помощью макроопределения LINK_PLL_KHZ в файле main.c.
Частота работы портов связи FLINK в 2 раза меньше выходной частоты PLL, поэтому для достижения желаемой 
выходной частоты работы портов связи FLINK следует запрограммировать LINK_PLL на выдачу частоты 2*FLINK.

Обратите внимание, что функции HAL для настройки PLL подбирают наиболее подходящую выходную частоту PLL, 
которую можно получить на основе опорной частоты XTI, однако устанавливаемая выходная частота PLL и 
реальная выходная частота PLL могут отличаться.


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

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


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

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


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

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

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