Команды, перечисленные ниже, поддерживаются напрямую Менеджером Устройств, и не передаются драйверу для обработки. Таким образом, все драйверы устройств поддерживают эти команды.

ADI_DEV_CMD_TABLE. Команда предоставляет таблицу пар команд, которые будут переданы драйверу. Здесь Value это указатель на таблицу пар команд (ADI_DEV_CMD_VALUE_PAIR *).

ADI_DEV_CMD_END. Обозначает конец таблицы пар команд. Value игнорируется.

ADI_DEV_CMD_PAIR. Команда передает одну пару команда-значение. Value это указатель на одну пару команда-значение (ADI_DEV_CMD_PAIR *).

ADI_DEV_CMD_SET_SYNCHRONOUS. Эта команда разрешает/запрещает синхронный режим работы драйвера. Value – TRUE/FALSE.

Идентификаторы команд, описанные в этой секции, являются общими для многих драйверов устройств. Ниже в списке перечислены всех общие идентификаторы команд (command ID), которые поддерживаются этим драйвером TWI.

ADI_DEV_CMD_SET_DATAFLOW_METHOD. Задает используемый метод потока данных устройства. Value – одно из поддерживаемых значений перечисления ADI_DEV_MODE (таблица 3).

ADI_DEV_CMD_SET_DATAFLOW. Разрешает/запрещает поток данных через устройство. Value – TRUE/FALSE.

ADI_DEV_CMD_GET_PERIPHERAL_DMA_SUPPORT. Позволяет вызывающему коду определить, поддерживается ли драйвер периферийным DMA. Value – u32*, указывает на ячейку, куда помещается ответ (TRUE/FALSE). В ответ на эту команду драйвер всегда вернет FALSE.

Идентификаторы команд, перечисленные ниже, поддерживаются и обрабатываются драйвером TWI, они уникальны именно для этого драйвера устройства.

ADI_TWI_CMD_SET_HARDWARE. Устанавливает, какой из аппаратных интерфейсов TWI будет использоваться драйвером. Value - ADI_INT_PERIPHERAL_ID (id прерывания аппаратуры TWI). В ответ на эту команду программный драйвер TWI вернет ошибку.

ADI_TWI_CMD_SET_PSEUDO. Устанавливает TWI в псевдо-режим (программная реализация TWI). Value - структура adi_twi_pseudo_port * (структура псевдо-порта, определенная в adi_twi.h).

ADI_TWI_CMD_SET_RATE. Установит частоту порта TWI. Value - указатель на структуру adi_twi_bit_rate (структура определена в adi_twi.h, она содержит частоту и скважность).

ADI_TWI_CMD_SET_SLAVE_ADDR. Установит адрес подчиненного устройства, когда драйвер работает в slave mode. Value - u32 (здесь находится 7-разрядное значение адреса подчиненного устройства). В ответ на эту команду программный драйвер TWI вернет ошибку.

ADI_TWI_CMD_SET_GCAL. Разрешает общую адресацию (general call addressing) в slave mode. Value не используется.

ADI_TWI_CMD_SET_SCCB. Разрешает SCCB-совместимость в master mode. Value не используется. SCCB это сокращение от Serial Camera Control Bus, шина для подключения видеокамер фирмы OmniVision.

ADI_TWI_CMD_SET_SCLOVR. Отменяет флаг SCL, когда установка выхода на выводе SCL будет выдавать лог. 0. Value - TRUE/FALSE.

ADI_TWI_CMD_SET_SDAOVR. Отменяет флаг SDA, когда установка выхода на выводе SDA будет выдавать лог. 0. Value - TRUE/FALSE.

ADI_TWI_CMD_SET_FIFO. Установит для буфера режим работы FIFO. Value - u32 (0x0008 разрешает прием прерывания на границе слова, 0x0004 разрешает прерывания при передаче слова, драйвер автоматически обрабатывает нечетные передачи байта).

ADI_TWI_CMD_SET_LOSTARB. Устанавливает количество повторных попыток для событий потери арбитража перед запуском callback-функции. Value - u32 (0 никогда не генерировать вызов callback, иначе значение показывает количество событий потери арбитража, после чего будет запущена функция callback).

ADI_TWI_CMD_SET_ANAK. Установит количество повторных попыток адресации при событиях отрицательного подтверждения (NACK), после которых будет запущен callback. Value - u32 (0 никогда не генерировать вызов callback, иначе значение показывает количество событий NACK, после чего будет запущена функция callback).

ADI_TWI_CMD_SET_DNAK. Установит количество повторных попыток перемещения данных при событиях отрицательного подтверждения (NACK), после которых будет запущен callback. Value - u32 (0 никогда не генерировать вызов callback, иначе значение показывает количество событий NACK, после чего будет запущена функция callback).

ADI_TWI_CMD_GET_SENSE. Получит состояние флагов SDA, SCL и BUSBUSY. Value - u32 * (адрес ячейки, где хранятся биты остояния: 0x0100=BUSBUSY, 0x0080=SCL и 0x0040=SDA).

В этой секции описаны события, которые являются общими для многих драйверов устройств. Ниже перечислены те общие события, которые поддерживаются этим драйвером TWI.

ADI_DEV_EVENT_BUFFER_PROCESSED. Оно оповещает callback-функцию, что буфер I/O цепочки был обработан драйвером устройства. Это событие также используется для оповещения о том, что весь кольцевой буфер был обработан, если драйверу было указано генерировать вызов callback при завершении обработки всего кольцевого буфера. Value – для цепочечного метода потока данных это значение параметра CallbackParameter, предоставленное в буфере, который был передан в API-функцию adi_dev_Read(), adi_dev_Write() или adi_dev_SequentialIO(). Для кольцевого метода это значение адреса буфера, предоставленного в API-функцию adi_dev_Read() или adi_dev_Write().

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

[События master mode]

ADI_TWI_EVENT_BUFWRERR. Переполнение буфера приема, обычно это событие показывает, что больше нет предоставленных для приема буферов. Value - значение CallbackParameter, предоставленное в буфере, который был передан в функцию adi_dev_SequentialIO().

ADI_TWI_EVENT_BUFRDERR. Недогрузка буфера передачи, обычно это событие показывает, что больше не было предоставлено доступных буферов передачи. Value - значение CallbackParameter, предоставленное в буфере, который был передан в функцию adi_dev_SequentialIO().

ADI_TWI_EVENT_DNAK. Получен x раз сигнал отрицательного подтверждения данных (Data Negative Acknowledge, DNACK), где x это значение, установленное командой ADI_TWI_CMD_SET_DNAK. Value - значение CallbackParameter, предоставленное в буфере, который был передан в функцию adi_dev_SequentialIO().

ADI_TWI_EVENT_ANAK. Получен x раз сигнал отрицательного подтверждения адреса (Address Negative Acknowledge, ANACK), где x это значение, установленное командой ADI_TWI_CMD_SET_ANAK. Value - значение CallbackParameter, предоставленное в буфере, который был передан в функцию adi_dev_SequentialIO().

ADI_TWI_EVENT_LOSTARB. TWI потерял арбитраж x раз, здесь x это значение, установленное командой ADI_TWI_CMD_SET_LOSTARB. Value - значение CallbackParameter, предоставленное в буфере, который был передан в функцию adi_dev_SequentialIO().

ADI_TWI_EVENT_YANKED. Буфер был удален из очереди передачи или приема. Это событие происходит, когда произошла ошибка передачи/приема буфера, и есть последующие буферы в цепочке, которые требуют повтора Start с адресом устройства. Value - буфер, который был удален.

Описанные здесь коды возврата API-функций драйвера являются общими для многих драйверов устройств. Список ниже перечисляет все общие коды возврата, поддерживаемые драйвером TWI.

ADI_DEV_RESULT_SUCCESS. Выполнение функции было успешным.

ADI_DEV_RESULT_NOT_SUPPORTED. Эта функция не поддерживается драйвером.

ADI_DEV_RESULT_DEVICE_IN_USE. Запрошенное устройство уже используется.

ADI_DEV_RESULT_NO_MEMORY. Недостаточное количество доступной памяти.

ADI_DEV_RESULT_BAD_DEVICE_NUMBER. Недопустимый номер устройства.

ADI_DEV_RESULT_DIRECTION_NOT_SUPPORTED. Устройство не может быть открыто в заданном направлении.

ADI_DEV_RESULT_BAD_DEVICE_HANDLE. Недопустимый дескриптор для драйвера устройства.

ADI_DEV_RESULT_BAD_MANAGER_HANDLE. Недопустимый дескриптор для Менеджера Устройств.

ADI_DEV_RESULT_BAD_PDD_HANDLE. Недопустимый дескриптор для физического драйвера устройства.

ADI_DEV_RESULT_INVALID_SEQUENCE. Запрошенное действие не находится в допустимой последовательности.

ADI_DEV_RESULT_ATTEMPTED_READ_ON_OUTBOUND_DEVICE. Приложение сделало попытку предоставить входящий буфер для устройства, открытого только для исходящего трафика.

ADI_DEV_RESULT_ATTEMPTED_WRITE_ON_INBOUND_DEVICE. Приложение сделало попытку предоставить исходящий буфер для устройства, открытого только для входящего трафика.

ADI_DEV_RESULT_DATAFLOW_UNDEFINED. Еще не был декларирован метод поддержки потока данных.

ADI_DEV_RESULT_DATAFLOW_INCOMPATIBLE. Этот метод поддержки потока данных несовместим с запрошенным действием.

ADI_DEV_RESULT_BUFFER_TYPE_INCOMPATIBLE. Устройство не поддерживает этот тип предоставленного буфера.

ADI_DEV_RESULT_CANT_HOOK_INTERRUPT. Менеджер Прерываний [3] не смог подцепить обработчик прерывания.

ADI_DEV_RESULT_CANT_UNHOOK_INTERRUPT. Менеджер Прерываний [3] не смог отцепить обработчик прерывания.

ADI_DEV_RESULT_NON_TERMINATED_LIST. Предоставленная цепочка буферов не завершена NULL.

ADI_DEV_RESULT_NO_CALLBACK_FUNCTION_SUPPLIED. Потребовалась, но не была предоставлена callback-функция.

ADI_DEV_RESULT_REQUIRES_UNIDIRECTIONAL_DEVICE. Требуется, чтобы устройство было открыто только для одного направления трафика - либо только входящего, либо только для исходящего трафика.

ADI_DEV_RESULT_REQUIRES_BIDIRECTIONAL_DEVICE. Требуется, чтобы устройство было открыто только для двунаправленного трафика - и входящего, и исходящего.

Приведенные ниже коды возврата поддерживаются драйвером TWI, они уникальны для этого драйвера.

ADI_TWI_RESULT_BAD_RATE. Скорость данных (data rate), переданная команде ADI_TWI_CMD_SET_RATE, вышла за пределы допустимых значений. Частота (frequency) должна быть в диапазоне 20 .. 400, и скважность (duty cycle) в диапазоне 1 .. 99. В зависимости от частоты тактов Blackfin к этой ошибке могут приводить другие значения.

ADI_TWI_RESULT_BAD_ADDR. Был передан недопустимый адрес либо в режиме подчиненного устройства (slave mode, с командой ADI_TWI_CMD_SET_SLAVE), либо в режиме главного устройства (master mode, поле pAdditionalInfo). Адрес должен быть в диапазоне 8 .. 123, или ADI_TWI_RSTART_ADDR.

ADI_TWI_RESULT_NO_DATA. Предоставленный буфер (read/write/sequential) не содержит данных.

ADI_TWI_RESULT_SLAVE_DCB. Устройство было сконфигурировано для slave mode, и использует отложенные функции обратного вызова (deferred callbacks). Это может вызвать проблемы, потому что драйвер ждет другой буфер для передачи/приема данных от/в шину, и шина при этом занята драйвером TWI.

ADI_TWI_RESULT_BAD_PSEUDO. Не может быть настроена конфигурация псевдо-порта, потому что предоставлены недопустимые значения для таймеров и/или флагов, или они уже используются.

[С арбитражем]

Конфигурирование TWI как псевдо-порта с сигналом SCL на флаге PG1 и сигналом SDA на флаге PG0. TWI тактируется от ADI_TMR_GP_TIMER_2, и прерывания флага происходят на ADI_INT_PORTG_B для арбитража мастера шины.

Замечание: при использовании арбитража следует следует соблюдать осторожность, когда происходят прерывания на банке флагов, и если они не сконфигурированы корректно. При этом прерывания могут вызывать другие выводы, что приведет к вызову обработчика флага pseudo TWI и зависанию процессора. Это может произойти, если обрабатывается другой флаг на том же банке, и прерывание вызывается слишком быстро (например, 8-разрядный PPI0 на BF537, когда используется ADI_INT_PORTFG_A или ADI_INT_PORTG_B).

adi_twi_pseudo_port port =
{
   ADI_FLAG_PG1,
   ADI_FLAG_PG0,
   ADI_TMR_GP_TIMER_2,
   ADI_INT_PORTG_B
};

// Конфигурационная таблица для драйвера TWI:
ADI_DEV_CMD_VALUE_PAIR config[] =
{
   {ADI_TWI_CMD_SET_PSEUDO,            (void *)(&port)},
   {ADI_DEV_CMD_SET_DATAFLOW_METHOD,   (void *)ADI_DEV_MODE_SEQ_CHAINED},
   {ADI_TWI_CMD_SET_FIFO,              (void *)0x0000},
   {ADI_TWI_CMD_SET_LOSTARB,           (void *)1},
   {ADI_TWI_CMD_SET_ANAK,              (void *)0},
   {ADI_TWI_CMD_SET_DNAK,              (void *)0},
   {ADI_DEV_CMD_SET_DATAFLOW,          (void *)TRUE},
   {ADI_DEV_CMD_END,                   NULL}
};

adi_dev_Open(ManagerHandle,
             &ADITWIEntryPoint,
             DeviceNumber,
             DeviceHandle,
             &PhysicalDevice,
             ADI_DEV_DIRECTION_BIDIRECTIONAL,
             NULL,
             DCBHandle,
             DMCallback);

adi_dev_Control(device, ADI_DEV_CMD_TABLE, config);

[Без арбитража]

Конфигурирование TWI как псевдо-порта с сигналом SCL на флаге PG1 и сигналом SDA на флаге PG0. TWI тактируется от ADI_TMR_GP_TIMER_2.

adi_twi_pseudo_port port =
{
   ADI_FLAG_PG1,
   ADI_FLAG_PG0,
   ADI_TMR_GP_TIMER_2,
   (ADI_INT_PERIPHERAL_ID)NULL
};

// Конфигурационная таблица для драйвера TWI:
ADI_DEV_CMD_VALUE_PAIR config[] =
{
   {ADI_TWI_CMD_SET_PSEUDO,            (void *)(&port)},
   {ADI_DEV_CMD_SET_DATAFLOW_METHOD,   (void *)ADI_DEV_MODE_SEQ_CHAINED},
   {ADI_TWI_CMD_SET_FIFO,              (void *)0x0000},
   {ADI_TWI_CMD_SET_LOSTARB,           (void *)1},
   {ADI_TWI_CMD_SET_ANAK,              (void *)0},
   {ADI_TWI_CMD_SET_DNAK,              (void *)0},
   {ADI_DEV_CMD_SET_DATAFLOW,          (void *)TRUE},
   {ADI_DEV_CMD_END,                   NULL}
};

adi_dev_Open(ManagerHandle,
             &ADITWIEntryPoint,
             DeviceNumber,
             DeviceHandle,
             &PhysicalDevice,
             ADI_DEV_DIRECTION_BIDIRECTIONAL,
             NULL,
             DCBHandle,
             DMCallback);

adi_dev_Control(device, ADI_DEV_CMD_TABLE, config);