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

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), которые поддерживаются драйвером SPI.

ADI_DEV_CMD_GET_2D_SUPPORT. Позволяет определить, поддерживает ли драйвер буферы 2D (двумерный буфер). Value - u32* (указывает на ячейку памяти, где будет сохранено значение TRUE/FALSE).

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

ADI_DEV_CMD_SET_STREAMING. Разрешает/запрещает режим стриминга драйвера. Valie - TRUE/FALSE.

ADI_DEV_CMD_GET_INBOUND_DMA_CHANNEL_ID. Возвратит идентификатор канала DMA для входящего канала DMA. Value - u32* (указывает на ячейку памяти, где будет сохранено значение идентификатора канала).

ADI_DEV_CMD_GET_OUTBOUND_DMA_CHANNEL_ID. Возвратит идентификатор канала DMA для исходящего канала DMA. Value - u32* (указывает на ячейку памяти, где будет сохранено значение идентификатора канала).

ADI_DEV_CMD_SET_INBOUND_DMA_CHANNEL_ID. Установит идентификатор канала DMA для входящего канала DMA. Value - u32 (значение идентификатора канала).

ADI_DEV_CMD_SET_OUTBOUND_DMA_CHANNEL_ID. Установит идентификатор канала DMA для исходящего канала DMA. Value - u32 (значение идентификатора канала).

ADI_DEV_CMD_GET_INBOUND_DMA_PMAP_ID. Возвратит PMAP ID - идентификатор периферийного устройства, привязанного к входящему каналу DMA. Value - u32* (указывает на ячейку памяти, где будет сохранено значение PMAP ID).

ADI_DEV_CMD_GET_OUTBOUND_DMA_PMAP_ID. Возвратит PMAP ID - идентификатор периферийного устройства, привязанного к исходящему каналу DMA. Value - u32* (указывает на ячейку памяти, где будет сохранено значение PMAP ID).

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

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

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

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

ADI_SPI_CMD_SET_BAUD_RATE. Устанавливает скорость обмена (baud rate). Value = частота следования тактов в Гц.

ADI_SPI_CMD_SET_SLAVE_FLAG. Устанавливает регистр флагов подчиненного устройства (SPI slave flag register). Value = значение для регистра.

ADI_SPI_CMD_SET_CONTROL_REG. Напрямую устанавливает значение регистра управления SPI (SPIx_CTL). Value = значение для регистра.

ADI_SPI_CMD_SET_BAUD_REG. Напрямую устанавливает значение регистра скорости. Value = значение для регистра.

ADI_SPI_CMD_ENABLE_SLAVE_SELECT. Разрешает сигнал выборки подчиненного устройства. Value = номер подчиненного устройства.

ADI_SPI_CMD_DISABLE_SLAVE_SELECT. Запрещает сигнал выборки подчиненного устройства. Value = номер подчиненного устройства.

ADI_SPI_CMD_SELECT_SLAVE. Делает выборку подчиненного устройства. Value = номер подчиненного устройства.

ADI_SPI_CMD_DESELECT_SLAVE. Снимает выборку подчиненного устройства. Value = номер подчиненного устройства.

ADI_SPI_CMD_SET_EXCLUSIVE_ACCESS. Предотвращает постороннее использование этого устройства SPI. Value = TRUE означает эксклюзивный доступ, FALSE означает разрешение общего доступа.

ADI_SPI_CMD_SET_TRANSFER_INIT_MODE. Устанавливает значение TIMOD (принцип запуска процедуры переноса данных).

Value = 0 - запуск при чтении ядром регистра SPI_RDBR (приходящие данные под управлением прерываний).
Value = 1 - запуск при записи ядром регистра SPI_TDBR (исходящие данные под управлением прерываний).
Value = 2 - запуск чтением DMA регистра SPI_RDBR (приходящие данные под управлением DMA).
Value = 3 - запуск записью DMA регистра SPI_TDBR (исходящие данные под управлением DMA).

ADI_SPI_CMD_SEND_ZEROS. Настраивает отправку нулей, когда регистр передачи SPI_TDBR пуст. Value =TRUE означает отправку нулей, FALSE означает отправку последних данных, записанных в регистр.

ADI_SPI_CMD_SET_GET_MORE_DATA. Устанавливает режим получения данных, когда предыдущие данные еще не прочитаны. Value = TRUE означает, что старые данные будут перезаписываться новыми (gets more date), FALSE - новые приходящие данные будут отбрасываться.

ADI_SPI_CMD_SET_PSSE. Устанавливает управляющий бит PSSE. Value = TRUE означает, что SPISS разрешен, FALSE - SPISS запрещен.

ADI_SPI_CMD_SET_MISO. Разрешает/запрещает MISO. Value = TRUE - MISO разрешен, FALSE - MISO запрещен.

ADI_SPI_CMD_SET_WORD_SIZE. Устанавливает размер слова фрейма в битах. Value = 8 .. 16.

ADI_SPI_CMD_SET_LSB_FIRST. Команда настраивает очередность следования бит по старшинству (MSB/LSB). Value = TRUE - младший бит слова (LSB) будет отправлен первым, FALSE - первым будет отправлен MSB.

ADI_SPI_CMD_SET_CLOCK_PHASE. Устанавливает формат передачи (фаза тактов). Value = TRUE - начало с переключением, FALSE - переключение посередине.

ADI_SPI_CMD_SET_CLOCK_POLARITY. Устанавливает полярность тактов. Value = TRUE - активный уровень лог. 0, FALSE - активный уровень лог. 1.

ADI_SPI_CMD_SET_MASTER. Устанавливает режим работы в качестве главного (master) или подчиненного устройства (slave). Value = TRUE - master, FALSE – slave.

ADI_SPI_CMD_SET_OPEN_DRAIN_MASTER. Управляет битом WOM в регистре управления SPIx_CTL. Value = TRUE - открытый сток (open drain) выходов master, FALSE - обычные выходы.

ADI_SPI_CMD_EXECUTE_DUMMY_READ. Выполняет фиктивное чтение SPI. Value = 8 - 8-битное чтение, 16 - 16 битное чтение.

ADI_SPI_CMD_PAUSE_DATAFLOW. Ставит на паузу или снимает с паузы поток данных. Value = TRUE - пауза, FALSE - снятие с паузы.

ADI_SPI_CMD_SET_PIN_MUX_MODE. Устанавливает специфичный для процессора режим мультиплексирования выводов. Value = значение из перечисления типа ADI_SPI_PIN_MUX_MODE.

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

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

ADI_DEV_EVENT_DMA_ERROR_INTERRUPT. Оповещает callback-функцию, что произошла ошибка DMA. Value - NULL (не используется).

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

ADI_SPI_EVENT_TRANSMISSION_ERROR. Означает, что произошло детектирование события TXE. Value не используется.

ADI_SPI_EVENT_RECEIVE_ERROR. Было детектировано событие RBSY. Value не используется.

ADI_SPI_EVENT_MODE_FAULT_ERROR. Было детектировано событие MODF. Value не используется.

ADI_SPI_EVENT_TRANSMIT_COLLISION_ERROR. Было детектировано событие TXCOL. Value не используется.

ADI_SPI_EVENT_ERROR_INTERRUPT. Была сгенерирована ошибка SPI. ВНИМАНИЕ: это событие больше не используется и заменено индивидуальными событиями, которые были описаны выше. Value не используется.

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

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. Менеджер Прерываний [1] не смог подцепить обработчик прерывания.

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

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. Требуется, чтобы устройство было открыто только для двунаправленного трафика - и входящего, и исходящего.

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

ADI_SPI_RESULT_ALREADY_EXCLUSIVE. Эксклюзивный доступ не предоставлен.

ADI_SPI_RESULT_BAD_SLAVE_NUMBER. Ошибочный номер подчиненного устройства (slave number), ожидается значение номера в диапазоне 1 .. 7.

ADI_SPI_RESULT_BAD_TRANSFER_INIT_MODE. Ошибочное значение режима инициализации передачи.

ADI_SPI_RESULT_BAD_WORD_SIZE. Ошибочное значение размера фрейма данных (ожидается 8 или 16).

ADI_SPI_RESULT_BAD_VALUE. Передано ошибочное значение (ожидалось TRUE или FALSE).

ADI_SPI_RESULT_DATAFLOW_ENABLED. Недопустимо, потому что поток данных уже активен.

ADI_SPI_RESULT_NO_VALID_BUFFER. Нет буфера для перемещения данных.

ADI_SPI_RESULT_BAD_BAUD_NUMBER. Ошибочное значение для определения скорости передачи.

Пример кода ниже показывает, как использовать DMA-версию драйвера SPI для организации входящего потока данных в процессор Blackfin. Используется метод пока данных с цепочками буферов и переходом на начало цепочки (chained with loopback dataflow method). С использованием такого метода достаточно предоставить буферы только один раз, и они будут наполняться циклически по кругу снова и снова, без необходимости их повторного предоставления.

#define BUFFER_COUNT (4)

#define DATA_COUNT   (512)

static u16                   Data[DATA_COUNT * BUFFER_COUNT];

static ADI_DEV_1D_BUFFER     Buffer[BUFFER_COUNT];

static ADI_DEV_DEVICE_HANDLE SPIHandle;

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

Функция: Callback

Описание: обработка принимаемых данных.

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

static void Callback(void *AppHandle, u32 Event, void *pArg)
{
   ADI_DEV_1D_BUFFER *pBuffer;
   switch (Event)
   {
   // Событие завершения обработки буфера
   case ADI_DEV_EVENT_BUFFER_PROCESSED:
      pBuffer = pArg;   // избегаем приведения типов
      // Обработка данных, которые были приняты:
      ProcessBuffer(pBuffer);
      break;
   }
}

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

Функция: DriverApp

Описание: открывает, конфигурирует и запускает драйвер

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

void DriverApp(void)
{
   ADI_DEV_CMD_VALUE_PAIR SPIConfig[] = {
      { ADI_DEV_CMD_SET_DATAFLOW_METHOD, (void *)ADI_DEV_MODE_CHAINED_LOOPBACK }, // цепочка с переходом в начало
      { ADI_SPI_CMD_SET_BAUD_REG,        (void *)0x7ff                         }, // настройка скорости
      { ADI_SPI_CMD_SET_WORD_SIZE,       (void *)16                            }, // размер слова 16 бит
      { ADI_SPI_CMD_SET_MASTER,          (void *)TRUE                          }, // режим master
      { ADI_SPI_CMD_ENABLE_SLAVE_SELECT, (void *)4                             }, // внешнее устройство подключено
                                                                                  // к выборке SS 4
      { ADI_SPI_CMD_SELECT_SLAVE,        (void *)4                             }, // активировать выборку устройства
      { ADI_DEV_CMD_END, NULL }
   };

   u32 Result;
   int i;

   // Открыть DMA-версию драйвера SPI:
   Result = adi_dev_Open(adi_dev_ManagerHandle,    // хендл ранее инициализированного Менеджера Устройств
                         &ADISPIDMAEntryPoint,     // точка входа в драйвер SPI с поддержкой DMA
                         0,                        // номер SPI0
                         NULL,                     // аргумент для callback-функции
                         &SPIHandle,               // указатель на место хендла DM (для драйвера SPI)
                         ADI_DEV_DIRECTION_INBOUND,// входящие данные
                         DMAHandle,               // хендл Менеджера DMA
                         NULL,                     // Менеджер DCB не используется
                         Callback);                // функция обратного вызова

   // Конфигурирование SPI:
   Result = adi_dev_Control(SPIHandle, ADI_DEV_CMD_TABLE, SPIConfig);

   // Подготовка буферов:
   for (i = 0; i < BUFFER_COUNT; i++)
   {
      Buffer[i].Data              = &Data[i * DATA_COUNT];
      Buffer[i].ElementCount      = DATA_COUNT;
      Buffer[i].ElementWidth      = 2;
      Buffer[i].CallbackParameter = &Buffer[i];
      Buffer[i].pNext             = &Buffer[i+1];
   }
   Buffer[BUFFER_COUNT-1].pNext = NULL;

   // Предоставление буферов драйверу:
   Result = adi_dev_Read(SPIHandle, ADI_DEV_1D, (ADI_DEV_BUFFER *)Buffer);
   // Разрешить поток данных:
   Result = adi_dev_Control(SPIHandle, ADI_DEV_CMD_SET_DATAFLOW, (void *)TRUE);
   // Бесконечный цикл:
   while (1) ;
}

Пример кода ниже показывает, как использовать DMA-версию драйвера SPI для организации исходящего потока данных из процессора Blackfin. Этот пример идентичен предыдущему, разница лишь в том, что вместо функции adi_dev_Read() для предоставления буферов здесь используется функция adi_dev_Write(). Как и в предыдущем примере, здесь используется метод пока данных с цепочками буферов и переходом на начало цепочки (chained with loopback dataflow method). С использованием такого метода достаточно предоставить буферы только один раз, и они будут передаваться циклически по кругу снова и снова, без необходимости их повторного предоставления.

#define BUFFER_COUNT (4)

#define DATA_COUNT   (512)

static u16                   Data[DATA_COUNT * BUFFER_COUNT];

static ADI_DEV_1D_BUFFER     Buffer[BUFFER_COUNT];

static ADI_DEV_DEVICE_HANDLE SPIHandle;

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

Функция: Callback

Описание: заполняет буферы передаваемых данных.

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

static void Callback(void *AppHandle, u32 Event, void *pArg)
{
   ADI_DEV_1D_BUFFER *pBuffer;
   switch (Event)
   {
   // Событие завершения обработки буфера
   case ADI_DEV_EVENT_BUFFER_PROCESSED:
      pBuffer = pArg;   // избегаем приведения типов
      // Заполнение буфера новыми данными:
      FillBuffer(pBuffer);
      break;
   }
}

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

Функция: DriverApp

Описание: открывает, конфигурирует и запускает драйвер

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

void DriverApp(void)
{
   ADI_DEV_CMD_VALUE_PAIR SPIConfig[] = {
      { ADI_DEV_CMD_SET_DATAFLOW_METHOD, (void *)ADI_DEV_MODE_CHAINED_LOOPBACK }, // цепочка с переходом в начало
      { ADI_SPI_CMD_SET_BAUD_REG,        (void *)0x7ff                         }, // настройка скорости
      { ADI_SPI_CMD_SET_WORD_SIZE,       (void *)16                            }, // размер слова 16 бит
      { ADI_SPI_CMD_SET_MASTER,          (void *)TRUE                          }, // режим master
      { ADI_SPI_CMD_ENABLE_SLAVE_SELECT, (void *)4                             }, // внешнее устройство подключено
                                                                                  // к выборке SS 4
      { ADI_SPI_CMD_SELECT_SLAVE,        (void *)4                             }, // активировать выборку устройства
      { ADI_DEV_CMD_END, NULL }
   };

   u32 Result;
   int i;

   // Открыть DMA-версию драйвера SPI:
   Result = adi_dev_Open(adi_dev_ManagerHandle,     // хендл ранее инициализированного Менеджера Устройств
                         &ADISPIDMAEntryPoint,      // точка входа в драйвер SPI с поддержкой DMA
                         0,                         // номер SPI0
                         NULL,                      // аргумент для callback-функции
                         &SPIHandle,                // указатель на место хендла DM (для драйвера SPI)
                         ADI_DEV_DIRECTION_OUTBOUND,// исходящие данные
                         DMAHandle,                 // хендл Менеджера DMA
                         NULL,                      // Менеджер DCB не используется
                         Callback);                 // функция обратного вызова

   // Конфигурирование SPI:
   Result = adi_dev_Control(SPIHandle, ADI_DEV_CMD_TABLE, SPIConfig);

   // Подготовка буферов:
   for (i = 0; i < BUFFER_COUNT; i++)
   {
      Buffer[i].Data              = &Data[i * DATA_COUNT];
      Buffer[i].ElementCount      = DATA_COUNT;
      Buffer[i].ElementWidth      = 2;
      Buffer[i].CallbackParameter = &Buffer[i];
      Buffer[i].pNext             = &Buffer[i+1];
   }
   Buffer[BUFFER_COUNT-1].pNext = NULL;

   // Предоставление буферов драйверу:
   Result = adi_dev_Write(SPIHandle, ADI_DEV_1D, (ADI_DEV_BUFFER *)Buffer);
   // Разрешить поток данных:
   Result = adi_dev_Control(SPIHandle, ADI_DEV_CMD_SET_DATAFLOW, (void *)TRUE);
   // Бесконечный цикл:
   while (1) ;
}

Того, о чем Вы прочтете здесь, нет в оригинальной документации ADI.

1. После вызова adi_dev_Open драйвер настраивает ножки выбранного SPI под использование аппаратурой SPI. Поэтому если Вы думаете программно управлять выборкой SPI (как GPIO), и подключили выборку к сигналу ~SPIxSEL1, то для программного управления этим выводом после инициализации драйвера требуется соответствующая настройка регистра PORTnIO_FER. Пример:

// Открытие драйвера SPI1 на передачу с использованием DMA
Result = adi_dev_Open(
            adi_dev_ManagerHandle,     // Хендл Менеджера Устройств
            &ADISPIDMAEntryPoint,      // Точка входа драйвера SPI с поддержкой DMA
            1,                         // Номер устройства: используется SPI1
            NULL,                      // Аргумент для callback-функции
            &DevHandleSPI1,            // Указатель на место хендла DM (для драйвера SPI)
            ADI_DEV_DIRECTION_OUTBOUND,
            adi_dma_ManagerHandle,     // Хендл Менеджера DMA
            NULL,                      // Менеджер DCB не используется
            spiCallbackFunctionTX      // Callback-функция
);

if (Result!=ADI_DEV_RESULT_SUCCESS)
{
   VDK::KernelPanic(VDK::kThreadError, (VDK::SystemError)errSPI1_dev_Open, Result);
}
Result = adi_dev_Control( DevHandleSPI1, ADI_DEV_CMD_TABLE, (void*)SPIConfig );

if (Result!=ADI_DEV_RESULT_SUCCESS)
{
   VDK::KernelPanic(VDK::kThreadError, (VDK::SystemError)errSPI1_dev_Control1, Result);
}

//Настройка ножки ~SPI1SEL1 как выход под управление GPIO:

*pPORTDIO_FER |= PD4;

*pPORTDIO_DIR |= PD4;

2. Драйвер SPI, работающий через DMA, будет вызывать функцию callback только в том случае, если функцией adi_dev_Read или adi_dev_Write предоставлена цепочка из не менее чем двух буферов ADI_DEV_1D_BUFFER. Тогда callback будет срабатывать на обработку каждого буфера. Если же предоставлена цепочка буферов, в которой находится только 1 буфер, то функция callback по окончании обработки буфера вызвана не будет.

Таким образом, если Вы намерены использовать блокировку на семафоре в ожидании окончания передачи блока данных (в callback семафор должен выбираться, чтобы ожидающий поток семафор разблокировался), то это можно реализовать только для блоков, у которых размер больше 1 элементарной посылки (u8 или u16, в зависимости от настройки SPI). Если нужно передать через DMA данные из одной элементарной посылки, то блокировку и callback использовать нельзя.

Ниже приведен пример кода, который передает через DMA блок данных произвольной длины байтовыми посылками (u8). Если в блок размером в 1 байт, то создается цепочка из одного буфера ADI_DEV_1D_BUFFER. Если же блок больше 1 байта (2 байта и больше), то вся передача распределяется на 2 буфера, и используетс блокировка потока в расчете на срабатывание callback.

static ADI_DEV_1D_BUFFER BufferSPI1[2];

void blackfin_hw_spi_write_DMA (uint8_t *data, uint32_t datalen)
{
   static bool dataflow_enabled = false;
   u32 Result;

   if (0==datalen)
      return;
   
   BufferSPI1[0].Data              = data;
   BufferSPI1[0].ElementWidth      = 1;
   BufferSPI1[0].CallbackParameter = &BufferSPI1[0];
   if (1==datalen)
   {
      //Callback и блокировку использовать нельзя,
      // настраивается цепочка из 1 буфера:
      BufferSPI1[0].ElementCount      = datalen;
      BufferSPI1[0].pNext             = NULL;
   }
   else
   {
      //Используется Callback и блокировка потока на семафоре semaph 
      // в ожидании окончания передачи буфера:
      BufferSPI1[0].ElementCount      = datalen-1;
      BufferSPI1[0].pNext             = &BufferSPI1[1];
      BufferSPI1[1].Data              = &data[datalen-1];
      BufferSPI1[1].ElementCount      = 1;
      BufferSPI1[1].ElementWidth      = 1;
      BufferSPI1[1].CallbackParameter = &BufferSPI1[1];
      BufferSPI1[1].pNext             = NULL;
   }
   Result = adi_dev_Write(DevHandleSPI1, ADI_DEV_1D, (ADI_DEV_BUFFER *)BufferSPI1);
   if (Result!=ADI_DEV_RESULT_SUCCESS)
   {
      VDK::KernelPanic(VDK::kThreadError, (VDK::SystemError)errSPI1_dev_Write, Result);
   }
   if (!dataflow_enabled)
   {
      // Если поток данных еще не разрешен, разрешаем его:
      Result = adi_dev_Control(DevHandleSPI1, ADI_DEV_CMD_SET_DATAFLOW, (void *)TRUE);
      if (Result!=ADI_DEV_RESULT_SUCCESS)
      {
         VDK::KernelPanic(VDK::kThreadError, (VDK::SystemError)errSPI1_dev_Control2, Result);
      }
      dataflow_enabled = true;
   }
   if (1<datalen)
   {
      //Блокировка на ожидании окончания передачи:
      VDK::PendSemaphore(semaph, 0);
      delay_ms(1);
   }
}

static void spiCallbackFunctionTX(void *AppHandle, u32 Event, void *pArg)
{
   ADI_DEV_1D_BUFFER *pBuffer;
   switch (Event)
   {
   // Событие завершения обработки буфера
   case ADI_DEV_EVENT_BUFFER_PROCESSED:
      pBuffer = (ADI_DEV_1D_BUFFER*)pArg;
      if (pBuffer == &BufferSPI1[1])
      {
         //Данные переданы, выставление семафора для
         // разблокировки потока:
         VDK::C_ISR_PostSemaphore(semaph);
      }
      break;
   default:
      // Ошибка: вызвать исключение пользователя
      VDK::KernelPanic(VDK::kThreadError,
                       (VDK::SystemError)errSPI1_dev_callback,
                       Event);
      break;
   }
}

3. Недопустимо предоставлять цепочку буферов, где указано 0 элементов (поле буфера ElementCount) - поведение драйвера будет непредсказуемым.

4. Что делать, если Вы столкнулись с неожиданным поведением кода, использующего драйвер? Например, все API-функции adi_dev_xxx возвращают успешный результат, но драйвер не работает, либо программа ведет себя неустойчиво (срабатывает KernelPanic, блокируются потоки и происходят другие странные вещи).

Если это так, что определите 2 макроопределения ADI_DEV_DEBUG и ADI_SSL_DEBUG. Это подключит дополнительный код проверки ошибок, который кодами возврата из функций укажет Вам на возможные проблемы в использовании драйвера.

5. Для облегчения отладки сделайте копии файлов adi_spi.c, adi_dma.c, adi_dev.c в корневом каталоге проекта, и добавьте их в проект. Тогда станет доступна отладка по исходному коду драйверов.