Для переданной в эту функцию частоты системной шины (system clock, SCLK) вычисляются и устанавливаются следующие параметры для SDRAM: TRAS, TRP, TRCD и TWR в регистре EBIU_SDGCTL, и значение RDIV в регистре EBIU_SDRRC. Эта функция вычисляет и устанавливает следующие параметры для DDR: RAS, RP, RFC, REFI и RC в регистре DDRCTL0, и RCD, MRD и WR в регистре DDRCTL1.

Эта функция используется главным образом модулем управления питанием [2], чтобы гарантировать, что настройки SDRAM оптимальны для текущей частоты SCLK процессора.

Функция adi_ebiu_AdjustSDRAM выполнит возврат, не делая никаких изменений, если SDRAM не была ранее успешно инициализирована вызовом adi_ebiu_Init.

ADI_EBIU_RESULT adi_ebiu_AdjustSDRAM (u32 fsclk);

Аргумент:

Возвращаемое значение:

Функция adi_ebiu_Control() позволяет конфигурировать регистры EBIU SDRAM и EBIU DDR в соответствии с парами команда-значение, которые могут передаваться в эту функцию тремя разными способами (см. также описание типа ADI_EBIU_COMMAND_PAIR).

• Передается одна пара команда-значение:

adi_ebiu_Control (ADI_EBIU_CMD_SET_SDRAM_SRFS,
                  (void*)ADI_EBIU_SDRAM_SRFS_ENABLE);

• Передается структура с одной парой команда-значение:

ADI_EBIU_COMMAND_PAIR cmd =
{
   ADI_EBIU_CMD_SET_SDRAM_SRFS, (void*)ADI_EBIU_SDRAM_SRFS_ENABLE
};
adi_ebiu_Control (ADI_EBIU_CMD_PAIR, (void*)&cmd);

• Передается таблица структур ADI_EBIU_COMMAND_PAIR. Последняя запись в этой таблице должна быть {ADI_EBIU_CMD_END, 0}.

ADI_EBIU_COMMAND_PAIR table[] =
{
   { ADI_EBIU_CMD_SET_SDRAM_FBBRW, (void*)ADI_EBIU_SDRAM_FBBRW_ENABLE },
   { ADI_EBIU_CMD_SET_SDRAM_CDDBG, (void*)ADI_EBIU_CDDBG_ENABLE },
   { ADI_EBIU_CMD_END, 0 }
};
adi_ebiu_Control (ADI_EBIU_CMD_TABLE, (void*)table);

См. также описание ADI_EBIU_COMMAND и раздел "Перечисления для параметра Value команд" для получения полного списка команд и связанных с ними значений для обоих типов интерфейсов, SDRAM и DDR, и для интерфейса асинхронной памяти (FLASH).

Прототип функции:

ADI_EBIU_RESULT adi_ebiu_Control (ADI_EBIU_COMMAND Command,
                                  void *Value);

Аргументы:

Возвращаемое значение:

Функция adi_ebiu_GetConfigSize() вернет количество байт, требуемое для сохранения данных текущей конфигурации. Это значение также доступно через макрос ADI_EBIU_SIZEOF_CONFIG.

size_t adi_ebiu_GetConfigSize (void);

Возвращаемое значение: размер структуры данных конфигурации.

Функция adi_ebiu_Init инициализирует модуль EBIU. В настоящее время модуль конфигурируется для поддержки либо контроллера DDR, либо контроллера SDRAM, плюс для поддержки контроллера асинхронной памяти. Для службы EBIU, которая поддерживает SRDRAM, функция adi_ebiu_Init устанавливает значения регистров EBIU_SDGCTL, EBIU_SDBCTL и EBIU_SDRRC, чтобы их содержимое отражало корректную конфигурацию памяти SDRAM, подключенной к процессору. Для службы EBIU, которая поддерживает DDR, функция adi_ebiu_Init настраивает регистры управления контроллера DDR: DDRCTL0, DDRCTL1 и DDRCTL2. Для успешной инициализации контроллера SDRAM или DDR в функцию adi_ebiu_Init должен быть передан определенный набор значений, как это обозначено таблицами 4-1 (для SDRAM) и 4-2 (для DDR).

Таблица 4-1. Значения для инициализации SDRAM.

Примечания к таблице 4-1:

1 Строб адреса столбца (Column address strobe).
2 Требуемая задержка между выдачей команды Bank Activate и команды Precharge, и между командой Self-Refresh и командой выхода из состояния самообновления данных (self-refresh).
3 Требуемая задержка между выдачей команды Precharge и командами Bank Activate, Auto-Refresh или Self-Refresh.
4 Требуемая задержка между выдачей команды Bank Activate и началом первой команды чтения/записи.
5 Требуемая задержка между командой Write и командой Precharge.

Таблица 4-2. Значения для инициализации DDR.

При успешной инициализации модуля EBIU последующие вызовы adi_ebiu_AdjustSDRAM подстраивают скорость обновления данных SDRAM (refresh rate) в регистрах EBIU_SDRRC или DDRCTL0, чтобы они соответствовали указанной частоте системной шины SCLK. Когда используется несколько банков памяти, для каждого банка должны быть указаны соответствующие пары команда-значение ADI_EBIU_CMD_SET_SDRAM_BANK_SIZE и ADI_EBIU_CMD_SET_SDRAM_BANK_COL_WIDTH.

Если конфигурация системы использует SDRAM с низким потреблением энергии (low power 2.5V), то должны быть инициализированы следующие значения:

В функцию adi_ebiu_Init могут быть переданы дополнительные пары команда-значение, которые могут быть переданы впоследствии в функцию adi_ebiu_Control. См. описание функции adi_ebiu_Control для получения описания этих пар команда-значение.

Функция adi_ebiu_Init должна быть вызвана только 1 раз, но вызовов настроек службы управления питанием, чтобы SDRAM была настроена в соответствии с изменениями SCLK. Последующие вызовы функции adi_ebiu_Init игнорируются.

Прототип функции:

ADI_EBIU_RESULT adi_ebiu_Init (const ADI_EBIU_COMMAND_PAIR *ConfigData,
                               const u16 Reserved);

Аргументы:

В режиме отладки при инициализации SDRAM функция adi_ebiu_Init возвращает следующие значения:

В режиме отладки при инициализации DDR функция adi_ebiu_Init возвращает следующие значения:

В режиме отладки при инициализации контроллера асинхронной памяти (FLASH) функция adi_ebiu_Init возвращает следующие значения:

Функция adi_ebiu_LoadConfig восстанавливает значения текущей конфигурации из области памяти, на которую указывает аргумент hConfig. Контроллер SDRAM сбрасывается.

ADI_EBIU_RESULT adi_ebiu_LoadConfig (ADI_EBIU_CONFIG_HANDLE hConfig,
                                     size_t szConfig);

Аргументы:

Возвращаемое значение:

Функция adi_ebiu_SaveConfig() сохраняет значения текущей конфигурации в область памяти, на которую указывает аргумент hConfig. В настоящее время сохраняется только конфигурация SDRAM.

ADI_EBIU_RESULT adi_ebiu_SaveConfig (ADI_EBIU_CONFIG_HANDLE hConfig,
                                     size_t szConfig);

Аргументы:

Возвращаемое значение:

Функция adi_ebiu_Terminate() завершает использование модуля EBIU.

ADI_EBIU_RESULT adi_ebiu_Terminate (void);

Возвращаемое значение:

Все публичные функции модуля EBIU возвращают код из перечисляемого типа ADI_EBIU_RESULT. Обратите внимание, что коды возврата, относящиеся к SDRAM, обычно начинаются с текста ADI_EBIU_RESULT_INVALID_SDRAM, в то время как коды возврата, относящиеся к DDR, начинаются с текста ADI_EBIU_RESULT_INVALID_DDR. В таблице 4-3 перечислены возможные значения кодов возврата модуля EBIU.

Таблица 4-3. Значения перечисления ADI_EBIU_RESULT.

Структура ADI_EBIU_SDRAM_BANK_VALUE определяет настройки, которые применяются для определенного банка.

typedef struct ADI_EBIU_SDRAM_BANK_VALUE
{
   u16 bank;
   Union
   {
      ADI_EBIU_SDRAM_BANK_SIZE size;
      ADI_EBIU_SDRAM_BANK_COL_WIDTH width;
   } value;
} ADI_EBIU_SDRAM_BANK_VALUE;

См. описание ADI_EBIU_SDRAM_BANK_SIZE и ADI_EBIU_SDRAM_BANK_COL_WIDTH для получения подробной информации о полях size и width.

Примечание: поле bank предназначено для использования только с теми процессорами Blackfin, у которых есть несколько банков SDRAM.

Структура ADI_EBIU_TIME разрешает пользователям указывать значение времени как интегральное число в указанных единицах units.

typedef struct ADI_EBIU_TIME
{
   u32 value;
   ADI_EBIU_TIMING_UNIT units;
} ADI_EBIU_TIME;

Здесь тип ADI_EBIU_TIMING_UNIT это перечисление, значения которого определены в таблице ниже.

Действительные значения в этом перечислении используются как множители в целочисленной арифметике модуля. Для значения в миллисекундах, которое используется как значение управления логикой, здесь имеется исключение, потому что в данном случае значение перечисления не используется как множитель.

Разработчики могут использовать полный диапазон единиц, чтобы указывать значения интервалов времени как беззнаковое 32-битное целое число. Например, SDRAM на плате разработчика ADSP-BF533 EZ-KIT Lite имеет минимальное значение TWR, равное 1 такт SCLK и 7.5 нс. Передаваемое значение времени должно быть указано как 7500 пс. Таким образом, значение ADI_EBIU_TIME должно быть указано следующим образом:

ADI_EBIU_TIME time = {7500, ADI_EBIU_TIMING_UNIT_PICOSEC};

Определенные значения времени требуются для корректной установки регистров управления SDRAM в соответствии с подходящим даташитом на процессор. Время указывается как количество тактов SCLK в комбинации со значением времени, указанном в одной из возможных единиц (например, в наносекундах или миллисекундах).

Чтобы упростить передачу таких значений в функцию adi_ebiu_Init, определена структура ADI_EBIU_TIMING_VALUE:

typedef struct ADI_EBIU_TIMING_VALUE
{
   u32 cycles;
   ADI_EBIU_TIME time;
} ADI_EBIU_TIMING_VALUE;

Здесь ADI_EBIU_TIME определено так, как показано в предыдущей врезке. Например, SDRAM на плате разработчика ADSP-BF533 EZ-KIT Lite имеет минимальное значение TWR, равное 1 такт SCLK и 7.5 нс. С использованием структуры ADI_EBIU_TIMING_VALUE это значение времени может быть передано следующим образом:

ADI_EBIU_TIMING_VALUE twrmin = {1, {7500, ADI_EBIU_TIMING_UNIT_PICOSEC}};

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

Если параметр указывается в тактах, то значение напрямую записывается в регистр. Если значение указывается в единицах времени, то они преобразуются в такты на базе системной частоты 133 МГц, и преобразованное значение записывается в регистр.

Значения времени для настройки регистров управления асинхронной памятью, должны быть вычислены на основе даташита на используемое устройство памяти.

Эта структура используется для указания параметров времени интерфейса асинхронной памяти, как это показано ниже. Она содержит другие 2 структуры ADI_EBIU_BANK_NUMBER и ADI_EBIU_TIMING_VALUE (см. их описание в соответствующих врезках).

typedef struct ADI_EBIU_ASYNCH_BANK_TIMING
{
   ADI_EBIU_BANK_NUMBER  bank_number;
   ADI_EBIU_TIMING_VALUE bank_time;
} ADI_EBIU_ASYNCH_BANK_TIMING;

Из-за того, что многие параметры EBIU привязаны к определенному банку памяти, и указывают двоичное значение наподобие разрешено и запрещено (enabled, disabled), предоставляется структура, которая содержит номер банка вместе с объединением (union) трех различных перечислений, которые имеют два возможных значения.

Структура ADI_EBIU_ASYNCH_BANK_VALUE, показанная ниже, используется для полярности ARDY, которая может быть либо low, либо high (см. описание ADI_EBIU_ASYNCH_BANK_ARDY_POLARITY). Она же используется для разрешения функции ARDY, которая может быть либо разрешена, либо запрещена (см. описание ADI_EBIU_ASYNCH_BANK_ARDY_ENABLE). Также она используется для поля разрешения 16-битной упаковки (относится только к процессорам ADSP-BF561), когда может быть либо разрешена 16-битная упаковка, либо запрещена (32-битная упаковка), см. описание ADI_EBIU_ASYNCH_BANK_DATA_PATH.

typedef struct ADI_EBIU_ASYNCH_BANK_VALUE
{
   u32 bank_number;
   union
   {
      ADI_EBIU_ASYNCH_BANK_ARDY_POLARITY ardy_polarity;
      ADI_EBIU_ASYNCH_BANK_ARDY_ENABLE ardy_enable;#if defined(__ADSP_TETON__)
      ADI_EBIU_ASYNCH_BANK_DATA_PATH data_path;#endif
   } value;
} ADI_EBIU_ASYNCH_BANK_VALUE;

The ADI_EBIU_COMMAND is used to control/access the configuration of the EBIU module. It is used in an ADI_EBIU_COMMAND_PAIR couplet to set a configuration value in calls to adi_ebiu_Init and adi_ebiu_Control. Note that SDRAM-related commands typically begin with the text ADI_EBIU_CMD_SET_SDRAM while DDR-related commands typically begin with the text ADI_EBIU_CMD_SET_DDR.

Таблица 4-4. Команды EBIU (Command) и связанные с ними значения (Value).

Тип данных ADI_EBIU_COMMAND_PAIR позволяет разработчикам генерировать таблицу команд управления для передачи в модуль EBIU с помощью функций adi_ebiu_Init и adi_ebiu_Control:

typedef struct ADI_EBIU_COMMAND_PAIR
{
   ADI_EBIU_COMMAND kind;
   void *value;
} ADI_EBIU_COMMAND_PAIR;

Это перечисление указывает, что нужно разрешить или запретить SDRAM. Это перечисление соответствует биту EBE в регистре EBIU_SDBCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_EBE_DEFAULT ADI_EBIU_SDRAM_EBE_DISABLE

Это перечисление указывает размер банка внешнего SDRAM. Это перечисление соответствует битам EBSZ в регистре EBIU_SDBCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_BANK_SIZE_DEFAULT ADI_EBIU_SDRAM_BANK_32MB

Это перечисление указывает размер ширину адреса столбца банка внешнего SDRAM. Это перечисление соответствует битам EBCAW в регистре EBIU_SDBCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_BANK_COL_WIDTH_DEFAULT ADI_EBIU_SDRAM_BANK_COL_9BIT

Это перечисление указывает тип модуля SDRAM, когда для инициализации контроллера SDRAM используется команда ADI_EBIU_CMD_SET_SDRAM_MODULE. Значение перечисления содержат относящуюся к модулю информацию, такую как скорость (speed grade) и настройки конфигурации. Размер банка внешней памяти также должен быть указан с помощью команды ADI_EBIU_CMD_SET_SDRAM_BANK_SIZE. Из-за того, что платы разработчика EZ-KIT Lite компании Analog Devices содержат SDRAM компании Micron, эта информация относится только к микросхемам памяти Micron. Список допустимых значений этого перечисления находится в заголовочном файле API adi_pwr.h.

Это перечисление указывает, что нужно разрешить или запретить контроллер SDRAM. Это перечисление соответствует биту SCTLE в регистре EBIU_SDGCTL.

Это перечисление указывает, что используется ли SDRAM с пониженным энергопотреблением (low power 2.5V). Это перечисление соответствует биту EMREN в регистре EBIU_SDGCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_EMREN_DEFAULT ADI_EBIU_SDRAM_EMREN_DISABLE

Когда используется SDRAM с пониженным энергопотреблением (low power 2.5V), это перечисление задает банк для обновления. Перечисление соответствует битам PASR в регистре EBIU_SDGCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_PASR_DEFAULT ADI_EBIU_SDRAM_PASR_ALL

Когда используется SDRAM с пониженным энергопотреблением (low power 2.5V), это перечисление задает температурно-компенсированное значение для самообновления. Перечисление соответствует битам TCSR в регистре EBIU_SDGCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_TCSR_DEFAULT ADI_EBIU_SDRAM_TCSR_45DEG

Это перечисление указывает, нужно ли разрешить или запретить для EBIU выполнять самообновление SDRAM во время периодов отсутствия активности. Это перечисление соответствует биту SRFS в регистре EBIU_SDGCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_SRFS_DEFAULT ADI_EBIU_SDRAM_SRFS_DISABLE

Это перечисление указывает, нужно ли для EBIU использовать внешние буферы, когда несколько устройств SDRAM подключены к внешней шине параллельно. Это перечисление соответствует биту EBUFE в регистре EBIU_SDGCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_EBUFE_DEFAULT ADI_EBIU_SDRAM_EBUFE_DISABLE

Это перечисление указывает, должна ли быть задержана на 15 тактов SCLK последовательность старта при включении питания power-up start sequence. Это перечисление соответствует биту PUPSD в регистре EBIU_SDGCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_PUPSD_DEFAULT ADI_EBIU_SDRAM_PUPSD_NODELAY

Это перечисление задает последовательность включения SDRAM (power-up sequence). Это перечисление соответствует биту PSM в регистре EBIU_SDGCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_PSM_DEFAULT ADI_EBIU_SDRAM_PSM_REFRESH_FIRST

Это перечисление задает, использует ли EBIU быстрый доступ back-to-back read-write, чтобы позволить операции чтения и записи SDRAM в следующих друг за другом циклах. Это перечисление соответствует биту FBBRW в регистре EBIU_SDGCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_FBBRW_DEFAULT ADI_EBIU_SDRAM_FBBRW_DISABLE

Это перечисление разрешает или запрещает сигналы управления SDRAM, когда к интерфейсу внешней памяти параллельно подключен внешний контроллер SDRAM. Это перечисление соответствует биту CDDBG в регистре EBIU_SDGCTL.

Значение по умолчанию задается следующим макросом:

#define ADI_EBIU_SDRAM_CDDBG_DEFAULT ADI_EBIU_SDRAM_CDDBG_DISABLE

Это перечисление используется, чтобы указать номер банка 0, 1, 2 или 3 для тех команд, в которых указывается номер банка. Это перечисление также можно использовать, чтобы указать все банки.

Это перечисление используется, чтобы указать, какие банки разрешены. Перечисление соответствует битам AMBEN в глобальном регистре управления асинхронной памятью.

Это перечисление задает, разрешен CLKOUT для доступа к внешней памяти. Перечисление соответствует битам AMCKEN в глобальном регистре управления асинхронной памятью.

Это перечисление относится только к процессору ADSP-BF561. Оно задает, разрешена ли 16-битная упаковка на шине асинхронной памяти. Перечисление соответствует битам BXPEN в глобальном регистре управления асинхронной памятью, где X это номер банка.

Каждый асинхронный банк может быть запрограммирован для оцифровки входа ARDY, что позволяет расширить время доступа к банку. Анализ уровня на выводе ARDY определяет, насколько долго должно быть увеличено время доступа. Это перечисление указывает, должен или нет анализироваться сигнал ARDY. Оно соответствует биту BXRDYEN (где X это номер банка) в регистре 0 управления банком асинхронной памяти (для банков 0 и 1), или в регистре 1 управления банком асинхронной памяти (для банков 2 и 3).

Если анализ сигнала ARDY разрешен (см. предыдущую врезку), то это перечисление определяет, по какому уровню должен анализироваться сигнал ARDY (т. е. полярность ARDY). Перечисление соответствует биту BXRDYPOL (где X это номер банка) в регистре 0 управления банком асинхронной памяти (для банков 0 и 1), или в регистре 1 управления банком асинхронной памяти (для банков 2 и 3).

Время удержания для контроллера асинхронной памяти указывается в поле bank_time структуры ADI_EBIU_ASYNCH_BANK_TIMING. Это поле имеет тип ADI_EBIU_TIMING_VALUE, которое в данном случае может указывать либо количество тактов, либо значение ADI_EBIU_TIME, но одновременно оба способа указания времени использовать нельзя.

Когда используются такты, перечисление ADI_EBIU_ASYNCH_HOLD_TIME задает количество тактов времени удержания. Оно соответствует биту BXHT (где X это номер банка) в регистре 0 управления банком асинхронной памяти (для банков 0 и 1), или в регистре 1 управления банком асинхронной памяти (для банков 2 и 3).

Время установки для контроллера асинхронной памяти указывается в поле bank_time структуры ADI_EBIU_ASYNCH_BANK_TIMING. Это поле имеет тип ADI_EBIU_TIMING_VALUE, которое в данном случае может указывать либо количество тактов, либо значение ADI_EBIU_TIME, но одновременно оба способа указания времени использовать нельзя.

Когда используются такты, перечисление ADI_EBIU_ASYNCH_SETUP_TIME задает количество тактов времени установки. Оно соответствует биту BXST (где X это номер банка) в регистре 0 управления банком асинхронной памяти (для банков 0 и 1), или в регистре 1 управления банком асинхронной памяти (для банков 2 и 3).

Время перехода для контроллера асинхронной памяти указывается в поле bank_time структуры ADI_EBIU_ASYNCH_BANK_TIMING. Это поле имеет тип ADI_EBIU_TIMING_VALUE, которое в данном случае может указывать либо количество тактов, либо значение ADI_EBIU_TIME, но одновременно оба способа указания времени использовать нельзя.

Когда используются такты, перечисление ADI_EBIU_ASYNCH_TRANSITION_TIME задает количество тактов времени перехода. Оно соответствует биту BXTT (где X это номер банка) в регистре 0 управления банком асинхронной памяти (для банков 0 и 1), или в регистре 1 управления банком асинхронной памяти (для банков 2 и 3).

Это перечисление задает нагрузочную способность шины (drive strength) для устройства памяти. Это значение записывается в поле DS регистра EBIU_DDRCTL3. Перечисление ADI_EBIU_DDR_MOBILE_DS используется только для микросхем mobile DDR. Для не мобильных DDR см. ADI_EBIU_DDR_DS. Возможные значения перечисления ADI_EBIU_DDR_MOBILE_DS перечислены в таблице ниже.

Это перечисление задает нагрузочную способность шины (drive strength) для устройства памяти. Это значение записывается в поле DS регистра EBIU_DDRCTL3. Перечисление ADI_EBIU_DDR_DS используется только для микросхем не мобильных DDR. Для мобильных DDR см. ADI_EBIU_DDR_MOBILE_DS. Возможные значения перечисления ADI_EBIU_DDR_DS перечислены в таблице ниже.

Это перечисление задает значение для частичного самообновления массива (partial array self-refresh), которое записывается в поле PASR регистра EBIU_DDRCTL3. Это поле доступно только для микросхем мобильных DDR. Возможные значения перечисления ADI_EBIU_DDR_PASR перечислены в таблице ниже.