SAFP (Stand-Alone Flash Programmer) - специальная технология VisualDSP++, которая позволяет применять загружаемую в RAM программу (файл *.dxe) в качестве программатора энергонезависимой памяти программ (обычно это FLASH).

SAFP подключается к программируемой системе через JTAG, и управляет целевым процессором таким образом, что он становится программатором, выполняя простые команды хоста PC. Набор команд включает в себя действия стереть сектор или всю память, прочитать сектор, записать сектор, проверить содержимое сектора и т. п. Также существует соответствующее API, которое позволяет на различных языках программирования (в том числе и на VBasic script) писать скрипты, упрощающие программирование чипов в процессе производства (не требуется запускать среду VisualDSP++). В этой статье приведен перевод документации по SAFP (она доступна в справочной системе VisualDSP++, см. Help -> Contents -> Emulation Tools -> Stand-Alone Flash Programmer), а также приведен пример скрипта для программирования процессора Blackfin ADSP-BF538F.

SAFP основан на утилите программирования FLASH (Flash Programmer), встроенной в среду программирования VisualDSP++, поэтому для начала следуют рассмотреть функции и возможности этой утилиты

[Flash Programmer]

Утилита Flash Programmer открывается в среде VisualDSP через меню Tools -> Flash Programmer (если запущена сессия отладчика JTAG), предоставляя удобный графический интерфейс программирования для находящихся в системе устройств памяти flash. Используйте окно диалога Flash Programmer, чтобы посмотреть различную информацию о памяти flash, заполнить всю память (или её часть) повторяющимся значением, стереть память или загрузить в неё данные файла.

Компания Analog Devices поставляет драйверы FLASH (алгоритмы программирования) для множества оценочных плат разработчика (EZ-KIT Lite evaluation systems). Дополнительно Flash Programmer позволит Вам создать свои собственные драйверы flash, или модифицировать существующие драйверы для того, чтобы они подошли к Вашим конкретным программируемым системам (различным комбинациям процессоров и устройств памяти flash).

[Распределение секторов памяти (Sector Map)]

Как известно, память FLASH работает на запись и стирание исключительно блоками памяти, этот блок называется сектор. Отображение адресного пространства процессора на номера секторов памяти FLASH называется картой памяти секторов (sector map).

Sector Map состоит из информации о начальном и конечном адресе для каждого сектора устройства памяти FLASH. Начало одного сектора не то же самое, что конец предыдущего сектора. Например, если один сектор заканчивается на адресе 0x1FFF, то следующий сектор начнется с адреса 0x2000 (не 0x1FFF). Секторы памяти нумеруются начиная с 0, их размер кратен целому числу байт, и размер разных секторов может отличаться. К примеру, вот карта памяти секторов устройства S29AL008D (стоит в корпусе процессора ADSP-BF538F):

Примечание: очень важно, чтобы карта памяти секторов была правильной, потому что она используется для того, чтобы определить, на какие секторы будет влиять запись, и на основе карты секторов определяется размер всей памяти flash (размер flash определяется по конечному адресу последнего сектора). Имейте в виду, что начало памяти FLASH (адрес начала 0 сектора) размещается в памяти программ процессора ADSP-BF538F по абсолютному адресу адресу 0x20000000, и соответственно конец всей памяти FLASH (конечный адрес сектора 18) находится по адресу 0x200FFFFF.

[Как работает Flash Programmer]

Хорошее понимание внутренней работы Flash Programmer поможет Вам отладить свой собственный драйвер flash. Здесь будут рассмотрены следующие темы, касающиеся работы Flash Programmer:

• Загрузка драйвера.
• Выполнение команд хоста PC.
• Программирование flash.
• Сообщения об ошибках Flash Programmer.

Загрузка драйвера. Чтобы использовать Flash Programmer, сначала нужно загрузить его в процессор. Драйвер FLASH (flash driver) это приложение, которое служит интерфейсом с диалогом Flash Programmer и одновременно взаимодействует с программируемым устройством flash. Компания Analog Devices поставляет готовые драйверы flash для определенных оценочных плат разработчика (EZ-KIT Lite evaluation systems) вместе с их исходным кодом (в виде проекта VisualDSP++).

Здесь приведено пошаговое описание, что происходит при загрузке flash programmer driver.

1. Пользователь выбирает и запускает сессию отладчика JTAG, если она не запущена. Процессор останавливается и сбрасывается.
2. Через JTAG загружается и затем запускается приложение flash programmer driver (файл *.dxe).
3. Код окна диалога Flash Programmer проверяет драйвер на наличие в нем требуемых символов (AFP_BreakReady, AFP_Command, AFP_Offset, AFP_Buffer, AFP_Error, AFP_Size, AFP_Count, AFP_Stride и AFP_NumSectors).
4. Удаляются все публичные точки останова (public breakpoints) кроме тех, что используются для printf.
5. Ставится breakpoint на AFP_BreakReady, и процессор останавливается на этой точке программы.
6. Окно Flash Programmer проверяет дополнительные символы драйвера (AFP_Sector, AFP_Verify, AFP_Title, AFP_Description, AFP_DeviceCompany, AFP_BuildDate, AFP_DrvVersion, AFP_ManCode, and AFP_DevCode). Для правильной работы драйвера не требуется ни один из этих дополнительных символов.
7. В памяти должен быть как минимум 1 сектор. Это означает, что AFP_NumSectors должно быть больше или равно 1.
8. Посылается команда для получения кода производителя и кода устройства (или эта информация будет прочитана автоматически, если она уже существует). Она уже существует, если Ваш код вызовет GetCodes() перед входом в главный цикл main.
9. Отправляется команда, чтобы получить начало и смещение сектора или эта информация читается автоматически, если он уже существует. Она уже существует, если Ваш код вызвал GetSectorStartEnd() перед входом главный цикл main.
10. Обновляется карта секторов информацией о смещении начала и конца каждого сектора. Размер микросхемы определяется по смещению конца последнего сектора.

Выполнение команд хоста PC. Когда выполняются команды, flash programmer driver всегда стартует с AFP_BreakReady, и заканчивает обработку команды на той же самой метке. Перед выполнением команды все нужные значения из окна записываются в соответствующие символы драйвера, из затем процессор запускается на выполнение команды.

Например, чтобы выполнить заполнение памяти (fill), происходит следующее:

1. Записываются соответствующие значения из окна диалога в переменные AFP_Offset, AFP_Count, AFP_Stride и AFP_Buffer.
2. Значение переменной AFP_Command устанавливается в "4". Эта команда выполняет заполнение памяти.
3. Запускается программа драйвера, пока она снова не попадет в breakpoint на метке AFP_BreakReady.

Каждая команда выполняется тем же самым способом, но для неё могут быть другие связанные символы. В примерах драйверов, поставляемых вместе с VisualDSP++ (например, для процессора Blackfin ADSP-BF538 это папка VisualDSP 5.0\Blackfin\Examples\ADSP-BF538F EZ-KIT Lite\Flash Programmer\), символы, которые используются с каждой командой это те символы, которые переданы как параметры в функцию main. Если не было передано параметров, то программа установит AFP_Command и запустится.

Программирование flash. Если установлена опция очистки памяти перед программированием (pre-program erase option), то перед программированием flash происходит её очистка. Когда в flash программируется файл, программа записывает только количество байт, которое меньше или равно BUFFER_SIZE.

Если, например, BUFFER_SIZE равно 0x600, и размер файла 0x700, то команда WRITE выдается дважды для записи flash содержимым буфера. На первом проходе программа запишет 0x600 байт. На втором проходе будут записаны 0x100 байт. Отправка команды WRITE (запись) увеличивает время, требуемое для программирования файла в память flash.

Таким образом, если это возможно, делайте максимально большим значение BUFFER_SIZE - например, чтобы оно было не больше доступного размера памяти кучи (heap). Имейте в виду, что размер кучи (heap size) определяется в файле .LDF, который применялся для сборки кода flash programmer driver.

Flash is not large enough to fill < x > bytes.

Polling toggle bit failed.

The driver was not at AFP_BreakReady.

Could not allocate storage for the buffer.

There was a problem with one or more required expression in the driver.

Processing custom command failed. Make sure custom command is valid and try again.

[Функционал Flash Programmer]

Графический интерфейс диалога Flash Programmer (вызывается через меню Tools -> Flash Programming, если активна сессия отладчика JTAG) используют для следующих целей.

Load: загрузка в любой момент времени алгоритма прошивки flash (драйвера) в процессор.

View: просмотр кода производителя flash, кода устройства и описания микросхемы.

Reset: сброс flash.

Program: программирование устройства flash данными указанного файла.

Fill: заполнение участков памяти flash заданным значением.

Erase: очистка всей памяти flash.

Erase sector(s): очистка сектора (или нескольких секторов) на основе карты секторов (sector map).

Verify: сверка содержимого flash с данными файла.

Send: отправка команд пользователя драйверу, для пакетной обработки неких действий или для определенного поведения, заданного пользователем (который написал драйвер).

Save: сохранение содержимого flash в файл.

Утилита Flash Programmer сохраняет в реестре Windows самые последние используемые значения исходных параметров (имя файла драйвера, имя файла прошивки, начальный адрес, формат файла и другие опции), чтобы применить их при следующем запуске диалога Flash Programmer, и в окно Message center выводится информация о состоянии, в котором сейчас находится утилита.

По идее кнопки OK и Cancel в основном окне GUI Flash Programmer задуманы не просто так: кнопка OK при закрытии окна должна сохранить текущие настройки в реестре, а кнопка Cancel должна просто закрывать окно Flash Programmer без сохранения настроек. Однако из-за ошибки обе эти кнопки действуют совершено одинаково, настройки сохраняются в любом случае.

Примечание: устройство flash, используемое с утилитой Flash Programmer, должно поддерживать определенную функциональность.

Каждый раз, когда код драйвера Flash Programmer приостанавливается, среда IDDE запрашивает обновление содержимого своих окон.

[VisualDSP++ Flash Programmer API]

VisualDSP++ Flash Programmer API было разработано, чтобы предоставить стандартный интерфейс программирования между окном VisualDSP++ Flash Programmer и драйвером flash.

Для использования этого инструментария в процессор загружается сопутствующий драйвер flash. Драйвер это по сути написанная специальным образом программа (исполняемый код, файл *.DXE), который обрабатывает команды, поступающие от окна диалога Flash Programmer, и во время выполнения этих команд драйвер выполняет действительные манипуляции над содержимым памяти flash.

Компания Analog Devices предоставляет примеры таких драйверов, предназначенных для использования на аппаратуре отладочных плат EZ-KIT Lite evaluation systems (также их можно использовать без изменения и на пользовательской аппаратуре, если в ней используются подобные устройства памяти flash, как на платах EZ-KIT Lite).

Пользователи могут написать свои собственные драйверы flash, если это необходимо, путем выполнения следующих спецификаций по организации API. Это позволит Вам реализовать новые алгоритмы, модифицировать уже существующие, или добавить поддержку новых сочетаний устройства памяти и процессора, чтобы их можно было использовать в окне утилиты Flash Programmer обычным образом. Драйверы могут быть реализованы на языке C или ассемблера.

Следующие секции содержат всю необходимую информацию для того, чтобы разработчики могли создать свои собственные драйверы, совместимые с VisualDSP++ Flash Programmer. Рассматриваются необходимые для обязательной реализации функции в драйвере, описания поддерживаемых команд и другая полезная для программистов информация, а также пример драйвера.

Чтобы предоставить полностью стандартный интерфейс flash loader, VisualDSP++ Flash Programmer API использует набор определенным образом именованных символов, связанных с их адресами, и определенным образом пронумерованный набор команд.

Примечание: для получения подробного примера, как собрать загружаемый файл драйвера (bootable loader file) для памяти flash, см. проекты примеров (они часто называются "Power_On_Self_Test"), которые поставляются вместе с VisualDSP++. Эти примеры находятся в папках < корневой каталог инсталляции VisualDSP > \ < семейство процессоров> \ examples \ < тип_процессора_EZ KIT Lite >. См. содержимое файлов *readme.txt, которые находятся в папках проектов примеров.

[Указания для создания/модификации драйвера Flash]

При создании драйвера имейте в виду следующие моменты.

Драйвер это полностью функционирующая программа, а не просто куски кода с процедурами. Рекомендуемая архитектура для этого приложения обычная - выполнение всей работы по начальной инициализации при старте (startup), и затем вход в бесконечный цикл, где происходит ожидание поступления команды для обработки. Драйвер должен отслеживать поступление команд от окна утилиты Flash Programmer, и затем выполнять их, и возвращается к месту в программе AFP_BreakReady, где выполнение будет останавливаться, потому что туда устанавливается breakpoint утилитой Flash Programmer.

Разработчики драйвера должны учитывать ширину шин разных процессоров и устройств памяти flash. Утилита Flash Programmer читает или заполняет буфер данных только по байтам. Разработчик драйвер отвечает за передачу данных в память flash (и получение данных оттуда) определенным образом, учитывающим особенности технологии этой памяти.

Делайте размер AFP_Buffer максимально возможным (в идеале его размер должен быть равен размеру самого большого сектора flash), тогда утилита Flash Programmer сможет за один раз посылать и принимать больше данных, ускоряя тем самым обмен данными между памятью и хостом PC.

Если для драйверов на языке C память под AFP_Buffer выделяется из кучи, то компилятор не создает инициализированный массив, поэтому образ кода самого драйвера получается меньше, и он загрузится быстрее. Для того, чтобы сделать кучу большего размера, может потребоваться модифицировать файл настройки линкера (Linker Description File, файл .LDF).

Утилита Flash Programmer имеет заранее определенный набор команд для использования; однако пользователи могут также определить и свои собственные команды. Эта возможность может оказаться полезной для пакетной обработки каких-либо действий, или для того, чтобы задать некое особенное поведение для каких-либо особых приложений.

Символы. Эти символы (имена переменных и подпрограмм) являются частью исполняемого кода драйвера, который создается в инструментарием VisualDSP++. Эти символы могут запрашиваться утилитой Flash Programmer во время выполнения задач программирования (доступ осуществляется через JTAG-интерфейс отладчика). Чтобы поддерживать это, драйвер должен быть собран с поддержкой символьной информации, и эти символы должны быть определены глобально. Имейте в виду, что имена символов чувствительны к регистру.

Flash Programmer использует следующие символы.

while (1)
{
   asm( "AFP_BreakReady: nop;" );
   /* Получение и обработка команды */
   ...
   /* Очистка кода команды */
   AFP_Command = 0;
}

Команды. Flash Programmer определяет следующие символы, которые необходимы для реализации безошибочной работы драйвера.

case FILL:
   if(temp)
   {
      AFP_Error = FillData(AFP_Offset, AFP_Count, AFP_Stride, AFP_Buffer);
   }
   break;

[Особенность SAFP]

SAFP (Stand-Alone Flash Programmer) предоставляет программирование flash между стадией разработки/создания прототипа и ранними выпусками готовой продукции. SAFP использует тот же самый драйвер Flash, что и описанная выше утилита программирования Flash Programmer, входящая в состав среды разработки VisualDSP++.

Для чего нужен SAFP. Из-за сокращения времени разработки и времени, выделенного на выполнение заказа, часто требуется собрать и запрограммировать большое количество плат на ранней стадии разработки и оценки качества. Обычно это объемы готовых изделий размером до сотни штук. Программирования каждого такого образца в среде VisualDSP++ обычно выполняется сборщиком/монтажником, а не инженером разработки. Функционал SAFP позволяет разработчику написать скрипт, чтобы автоматизировать этот процесс с помощью свободного от лицензирования инструментария (т. е. для программирования не требуется запуск среды разработки VisualDSP++), что позволит сборщику просто повторно запускать скрипт, чтобы запрограммировать любое нужное количество устройств.

Цикл разработки скрипта для SAFP. Для того, чтобы воспользоваться функционалом SAFP, требуется выполнить следующие типовые шаги.

1. Если нет в наличии готового драйвера Flash Programmer, описанного выше, то сначала необходимо его создать для используемого устройства flash. Этот шаг необходим, чтобы можно было осуществлять не только стандартные действия в окне утилиты Flash Programmer, но и функционирование скрипта SAFP. Систем процессор/память flash, построенных традиционным образом, скорее всего писать драйвер не понадобится, можно взять готовый, предназначенный для одной из плат EZ-KIT Lite. Свой драйвер можно написать на основе примеров, поставляемых вместе со средой VisualDSP++ (см. выше описание процесса разработки такого драйвера).

2. Требуется наличие файла, который будет записываться в программируемую микросхему flash. Чаще всего это загрузочный образ программы (файл *.ldr) [2], или это может быть файл исполняемого кода, работающего из памяти flash (либо часть программы, так называемый файл splitter [2], или вся программа целиком).

3. Требуется создать файл скрипта на одном из языков программирования (C/C++, VBScript, JScript или Python). Чаще всего удобнее использовать скрипт VBasic, запускаемый в среде операционных систем Windows (файл с расширением *.vbs). В результате получится интерфейс автоматизации, упрощающий процедуру программирования. Сборщику остается только подключить к системе интерфейс JTAG (ICE-100B [6] или другой подобный), подать на программируемую систему питание, запустить скрипт двойным щелчком на файле запуска/ярлыке, и потом просто наблюдать за сообщениями программирования в ожидании завершения процесса (запускать среду разработки VisualDSP не требуется). Таким образом, разработчик может создать скрипт, проверить его, подогнав его под максимальное упрощение и удобство использования сборщиком.

Пример такого скрипта автоматизации на VBscript (*.vbs):

' Принудительно будет использоваться Stand-Alone Flash Programmer:

Const SAFP = 1

Const CONFIG_FILE = "путь до каталога установки VisualDSP\BF537_SAFP_config.ini"

Const DRIVER_FILE = "путь до каталога установки VisualDSP\Blackfin\Examples\"
                  + "ADSP-BF537 EZ-Kit Lite\Flash Programmer\\BF537EzFlashDriver.dxe"

Const LDR_FILE    = "путь до каталога установки VisualDSP\Blackfin\Examples\"
                  + "ADSP-BF537 EZ-Kit Lite\Power_On_Self_Test\"
                  + "1000320_AA0188-2004_M29W320DB_U24.ldr"

Dim FileFormat

Dim VerifyWhileWriting

Dim EraseOption

Dim StartAddress 

FileFormat = 0          ' Формат Intel HEX. Для двоичного формата укажите 1
VerifyWhileWriting = 1  ' Проверка после записи.
EraseOption = 0         ' Стирать только записываемые секторы (erase affected)
StartAddress = 0        ' Для формата Intel HEX этот параметр игнорируется.
                        ' Для двоичного формата тут должно быть указано смещение
                        ' до целевого адреса записи относительно начала (адреса 0).

if SAFP Then
   ' Программирование на основе Stand-Alone Flash Programmer.
   ' В этом случае лицензия VisualDSP++ не нужна.
   Set pFlash = CreateObject("VisualDSP.ADspSAFP") 

   ' Установка файла конфигурации:
   wscript.Echo "Setting config file..."
   pFlash.ConfigFile = CONFIG_FILE

Else 
   ' Примечание: у меня этот вариант не заработал (выводилось сообщение
   ' "ошибка сервера").
    Set app = CreateObject("VisualDSP.ADspApplication")
    Set plugin = app.PluginList.Item("Flash Programmer")
    Set pFlash = plugin.Open()

End If

' Загрузка драйвера:
wscript.Echo "Loading driver..."
pFlash.LoadDriver DRIVER_FILE

' Стирание блока:
wscript.Echo "Erasing Block 0..."
pFlash.EraseBlock 0

' Загрузка ldr-файла:
wscript.Echo "Load the LDR file..."
pFlash.LoadFile LDR_FILE, FileFormat, VerifyWhileWriting, EraseOption, StartAddress

if SAFP = 0 Then
    plugin.Close pFlash

End If 

wscript.Echo "Done."

Интерфейс автоматизации SAFP на основе скрипта работает по тому же самому принципу, что используется утилитой Flash Programmer в среде VisualDSP++. Однако несмотря на это, есть 3 главных отличия функционала окна утилиты Flash Programmer и скрипта SAFP:

• У SAFP имеется дополнительное свойство, называемое ConfigFile (см. ниже шаг 4), что должно быть установлено для вызова любых методов, показанных в примере VBScript.
• Использование кода SAFP в сравнении с плагином Flash Programmer незначительно отличается (зависит от предварительной установки значения переменной SAFP).
• Плагин Flash Programmer должен быть закрыт по окончании работы скрипта. Ничего не нужно закрывать при написании скрипта SAFP, поскольку он заботится об этом самостоятельно.

4. Последний шаг для SAFP - создание специального конфигурационного файла *.INI (ConfigFile). В нем предоставляется дополнительная информация, необходимая для идентификации устройства flash и интерфейса JTAG. Эта информация используется при работе SAFP.

Разработчик может создать файл конфигурации с помощью утилиты VisualDSP++ Configurator (см. врезку ниже) на своем компьютере разработки или на компьютере, где будет запускаться скрипт SAFP. Как только файл конфигурации был создан, оба файла - и скрипт SAFP, и файл конфигурации должны быть перенесены на компьютер, где будет работать скрипт при запуске его сборщиком (организация рабочего процесса программирования). После этого пользователь/сборщик может просто запускать скрипт SAFP, чтобы программировать устройства flash.

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

Описание процесса создания конфигурационного файла см. во врезке "ConfigFile. Описание создания конфигурационного файла (*.INI)".

Основные функции SAFP. Stand-Alone Flash Programmer может почти все, что Flash Programmer GUI в среде VisualDSP++ (к сожалению, нельзя получать информацию об устройстве памяти, и довольно плохо описаны свойства объектов API). Ниже во врезках описаны методы, поддерживаемые SAFP.

Общие замечания по методам. Описанные во врезках ниже методы относятся к объектам ADspFlashProgrammer и ADspSAFP.

Если object относится к ADspFlashProgrammer, то в прикладной среде разработки должна быть ссылка на DLL-файл WmFlashProgrammer.dll, который находится в директории System каталога инсталляции VisualDSP++. Таким образом, если Вы используете среду разработки, требующую наличия библиотеки типов (например C++ или .NET), то должны указать на файл WmFlashProgrammer.dll вместо файла Idde.exe. Также имейте в виду, что ссылка на объект должна быть получена из свойства PluginList объекта ADspApplication как это показано в примерах врезки "Демонстрация методов LoadDriver, EraseAll, LoadFile, EraseBlock, FillFlash, CompareFlashWithFile и SendCustom".

Если object относится к ADspSAFP, то он реализован во внешнем DLL-файле WmSAFP.dll, который также в директории System каталога инсталляции VisualDSP++, и соответственно в средах разработки наподобие C++ или .NET, нужно давать ссылку на файл WmSAFP.dll вместо ссылки на Idde.exe.

Примеры использования объектов ADspFlashProgrammer и ADspSAFP и их методов см. во врезке "Демонстрация методов LoadDriver, EraseAll, LoadFile, EraseBlock, FillFlash, CompareFlashWithFile и SendCustom".

object.LoadDriver( DriverPath )

object.LoadFile( FilePath, FileFormat, VerifyWhileWriting, EraseOption, Offset )

object.SaveFile( FilePath, FileFormat, Offset, Count )

// test.cpp : определяет точку входа в консольное приложение.

//

// USAGE: передается начальный адрес для записываемого дампа и количество байт,

//        указанные в формате HEX без префикса 0x

//

#include "stdafx.h"

#define _SAFP_

#ifdef _SAFP_

 #import "C:\Program Files\Analog Devices\VisualDSP 5.0\System\WmSAFP.dll" \

              named_guids no_namespace

#else

 #import "C:\Program Files\Analog Devices\VisualDSP 5.0\System\DeviceProgrammer.dll" \

              named_guids no_namespace

#endif

#define Driver _T("C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\Blackfin\\Examples \

                  \\ADSP-BF537 EZ-Kit Lite\\Flash Programmer\\BF537EzFlashDriver.dxe")

#define Ldr    _T("C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\Blackfin\\Examples \

                  \\ADSP-BF537 EZ-Kit Lite\\Power_On_Self_Test\\Sector_0.ldr")

#define Config _T("C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\BF537_SAFP_config.ini")

int _tmain(int argc, _TCHAR* argv[])

{
   // Инициализация библиотек COM:
   CoInitialize( NULL );
   USES_CONVERSION;
   _bstr_t bstrDriverPath = Driver;
   _bstr_t bstrLdrFile = Ldr;
   _bstr_t bstrConfigFile = Config;
   long lCount = 0x2000;

#ifdef _SAFP_
   IADspSAFPPtr pFlashProg("VisualDSP.ADspSAFP");
   // Установка файла конфигурации:
   pFlashProg->put_ConfigFile(bstrConfigFile);

#else
   IADspApplicationPtr pApp("VisualDSP.ADspApplication");
   IADspPluginPtr pFlashPlugin = pApp->PluginList->GetItem("Flash Programmer");
   IADspFlashProgrammerPtr pFlashProg = pFlashPlugin->Open();

#endif
   // Загрузка драйвера:
   printf("Start: Loading the flash programmer driver...\n");
   HRESULT hr = pFlashProg->LoadDriver(bstrDriverPath.GetBSTR());
   if( hr != S_OK )
   {
      printf("Failed Loading Driver");
      return 1;
   }
   printf("Done: Loading the flash programmer driver...\n\n");
   // Сохранение файла в формате Intel Hex:
   printf("Start: Saving ldr file...\n");
   hr = pFlashProg->SaveFile(bstrLdrFile.GetBSTR(), formatIntelHex, 0x0, lCount );
   if( hr != S_OK )
   {
      printf("Failed Saving Ldr file.");
      return 1;
   }
   printf("Done: Saving Sector 0 to ldr file...\n\n");

#ifndef _SAFP_
   pFlashPlugin->Close(pFlashProg);

#endif
   printf("Done.\n");
   return 0;
}

'//////////////////////////////////////////////////////////////////////////////

'//   Основное приложение

'//////////////////////////////////////////////////////////////////////////////

Const SAFP = 1

Const CONFIG_FILE = "C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\BF537_SAFP_config.ini"

Const DRIVER_FILE = "C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\Blackfin"
                  + "\\Examples\\ADSP-BF537 EZ-Kit Lite\\Flash Programmer\\BF537EzFlashDriver.dxe"

Const LDR_FILE    = "C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\Blackfin\\Examples"
                  + "\\ADSP-BF537 EZ-Kit Lite\\Power_On_Self_Test\\Sector_0.ldr"

Dim FileFormat

Dim StartAddress

Dim Count

FileFormat = 0    ' Формат Intel HEX
StartAddress = 0  '
Count = 8192      '

if SAFP Then
   Set pFlash = CreateObject("VisualDSP.ADspSAFP")
   ' Установка файла конфигурации:
   wscript.Echo "Setting config file..."
   pFlash.ConfigFile = CONFIG_FILE

Else
   Set app = CreateObject("VisualDSP.ADspApplication")
   Set plugin = app.PluginList.Item("Flash Programmer")
   Set pFlash = plugin.Open()

End If

' Загрузка драйвера
wscript.Echo "Loading driver..."
pFlash.LoadDriver DRIVER_FILE

' Сохранение ldr-файла
wscript.Echo "Save the LDR file..."
pFlash.SaveFile LDR_FILE, FileFormat, StartAddress, Count

if SAFP = 0 Then
   plugin.Close pFlash

End If

wscript.Echo "Done."

//////////////////////////////////////////////////////////////////////////////

// Основное приложение

//////////////////////////////////////////////////////////////////////////////

// Определение переменных:

var SAFP = 1;

// Установка путей до файла конфигурации, файла драйвера и сохраняемого файла

var ConfigFile = "C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\BF537_SAFP_config.ini";

var DriverFile = "C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\Blackfin\\Examples

                 \\ADSP-BF537 EZ-Kit Lite\\Flash Programmer\\BF537EzFlashDriver.dxe";

var LdrFile    = "C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\Blackfin\\Examples

                 \\ADSP-BF537 EZ-Kit Lite\\Power_On_Self_Test\\Sector_0.ldr";

var FileFormat = 0;     // Формат Intel HEX

var StartAddress = 0;   //

var Count = 8192;

if( SAFP )
{
   // Получение объекта SAFP
   var pFlash = new ActiveXObject( "VisualDSP.ADspSAFP" );
   // Установка файла конфигурации:
   WScript.Echo("Setting config file...");
   pFlash.ConfigFile = ConfigFile;
}

else
{
   // Получение объекта VDSP
   var app = new ActiveXObject( "VisualDSP.ADspApplication" );
   var plugin = app.PluginList.Item("Flash Programmer");
   var pFlash = plugin.Open();
}

// Загрузка драйвера:
WScript.Echo("Loading driver...");
pFlash.LoadDriver(DriverFile);

// Сохранение файла LDR:
WScript.Echo("Saving sector 0 to LDR file...");
pFlash.SaveFile(LdrFile, FileFormat, StartAddress, Count);

if( !SAFP )
{
   plugin.Close(pFlash);
}

WScript.Echo("Done.");

import   win32com.client

#/////////////////////////////////////////////////////////////////////////////

#// def main()

#/////////////////////////////////////////////////////////////////////////////

if __name__ == '__main__':

   SAFP = 1
   
   DriverPath = "C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\Blackfin\\Examples"
              + "\\ADSP-BF537 EZ-Kit Lite\\Flash Programmer\\BF537EzFlashDriver.dxe"
   LdrPath = "C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\Blackfin\\Examples"
           + "\\ADSP-BF537 EZ-Kit Lite\\Power_On_Self_Test\\Sector_0.ldr"
   ConfigFile = "C:\\Program Files\\Analog Devices\\VisualDSP 5.0\\BF537_SAFP_config.ini"
   
   # Параметры для файла:
   FileFormat = 0x0
   Count = 8192
   
   if ( SAFP == 1 ):
      pFlash = win32com.client.Dispatch("VisualDSP.ADspSAFP")
      
      ####
      #    Установка файла конфигурации
      ####
      print 'Setting config File.'
      pFlash.ConfigFile = ConfigFile
   else:
      app = win32com.client.Dispatch("VisualDSP.ADspApplication")
      plugin = app.PluginList.Item("Flash Programmer")
      pFlash = plugin.Open()
      
   ####
   #    Загрузка драйвера flash programmer
   ####
   print 'Loading flash driver.'
   pFlash.LoadDriver( DriverPath )
   
   ####
   #    Сохранение flash в файл
   ####
   print 'Saving sector 0 to file'
   pFlash.SaveFile( LdrPath, FileFormat, 0, Count )
   
   if ( SAFP == 0 ):
      plugin.Close( pFlash )
   print 'Done'

object.CompareFlashWithFile( FilePath, FileFormat, Offset )

object.EraseAll()

object.EraseBlock( Block )

object.FillFlash( Offset, Count, Stride, Value )

object.SendCustom ( Command )

object.ConfigFile

[Platform]

Name = ADSP-BF538F (1 processor) via ICE-100B

Platform Type = ICE-100B

Description = ADSP-BF538F (1 processor) via ICE-100B

Device ID = 0JTAG TCLK Frequency = 0

;-- Устройства перечислены в порядке, как они соединены сигналами TDO и TDI --

[Device 0]

Name = Device 0

Device Type = ADSP-BF538

IR Width = 5

[ADspFlashProgrammer и ADspSAFP]

Объекты Windows ADspFlashProgrammer и ADspSAFP устанавливаются вместе с системой программирования VisualDSP++. Объекты реализованы во внешних файлах DLL (ADspFlashProgrammer в WmFlashProgrammer.dll, ADspSAFP в WmSAFP.dll), которые находятся в директории System инсталляции VisualDSP++, и они не относится напрямую к VisualDSP++ (IDDE). Если Вы используете среду разработки, которая требует библиотеку типов (type library, наподобие C++ или .NET), то должны указать на требуемый файл DLL вместо Idde.exe.

ADspFlashProgrammer и ADspSAFP имеют одинаковый набор методов. Основное отличия между этими объектами:

1. ADspSAFP не требует наличие лицензии VisualDSP.
2. ADspSAFP требует создания файла конфигурации для описания свойств системы и отладчика.
3. Ссылка на объект ADspFlashProgrammer должна быть получена из свойства PluginList объекта ADspApplication, как это показано в примерах ниже.

// test.cpp : Здесь определена точка входа в консольное приложение.

//

// USAGE: передайте начальный адрес для дампа и количество байт в формате HEX

//        (без префикса  0x)

//

#include "stdafx.h"

#define _SAFP_

#ifdef _SAFP_

 #import "C:\Program Files\Analog Devices\VisualDSP 4.5\System\

            WmSAFP.dll" named_guids no_namespace#else

#import "C:\Program Files\Analog Devices\Visualdsp 4.5\System\

           WmFlashProgrammer.dll" named_guids no_namespace

#endif

#define Driver _T("C:\\Program Files\\Analog Devices\\VisualDSP 4.5\\Blackfin \

                     \\Examples\\ADSP-BF537 EZ-Kit Lite\\Flash Programmer \

                     \\BF537EzFlashDriver.dxe")

#define Ldr    _T("C:\\Program Files\\Analog Devices\\VisualDSP 4.5\\Blackfin \

                     \\Examples\\ADSP-BF537 EZ-Kit Lite\\Power_On_Self_Test \

                     \\1000320_AA0188-2004_M29W320DB_U24.ldr")

#define Config _T("C:\\Program Files\\Analog Devices\\VisualDSP 4.5 \

                     \\BF537_SAFP_config.ini")

int _tmain(int argc, _TCHAR* argv[])
{
   // Инициализация библиотек COM:
   CoInitialize( NULL );
   USES_CONVERSION;

   _bstr_t bstrDriverPath = Driver;
   _bstr_t bstrLdrFile = Ldr;
   _bstr_t bstrConfigFile = Config;
   int VerifyWhileWriting = 0x1;
   unsigned long ulBlock66Start = 0x3F0000;
   unsigned short sMAC_Address[3];  // Массив для MAC-адреса
   long lCount = 0x1;
   short sStride = 0x1;

   // Назначение MAC-адреса
   sMAC_Address[0] = 0xE000;
   sMAC_Address[1] = 0xFE22;
   sMAC_Address[2] = 0x3412;

#ifdef _SAFP_
   IADspSAFPPtr pFlashProg("VisualDSP.ADspSAFP");
   // Установка файла конфигурации:
   pFlashProg->put_ConfigFile(bstrConfigFile);

#else
   IADspApplicationPtr pApp("VisualDSP.ADspApplication");
   IADspPluginPtr pFlashPlugin = pApp->PluginList->GetItem("Flash Programmer");
   IADspFlashProgrammerPtr pFlashProg = pFlashPlugin->Open();

#endif

   // Загрузка драйвера:
   printf("Start: Loading the flash programmer driver...\n");
   HRESULT hr = pFlashProg->LoadDriver(bstrDriverPath.GetBSTR());
   if( hr != S_OK )
   {
      printf("Failed Loading Driver");
      return 1;
   }
   printf("Done: Loading the flash programmer driver...\n\n");

   // Загрузка файла Intel Hex:
   printf("Start: Loading POST ldr file...\n");
   hr = pFlashProg->LoadFile(bstrLdrFile.GetBSTR(), formatIntelHex,
                             VerifyWhileWriting, eraseAffected, 0x0 );
   if( hr != S_OK )
   {
      printf("Failed Loading Ldr file.");
      return 1;
   }
   printf("Done: Loading POST ldr file...\n\n");

   printf("Start: Comparing POST ldr file to the flash contents...\n");
   hr = pFlashProg->CompareFlashWithFile(bstrLdrFile.GetBSTR(), formatIntelHex, 0x0);
   if( hr != S_OK )
   {
      printf("Ldr file did not match the contents of flash.");
      return 1;
   }
   printf("Done: Comparing POST ldr file to the flash contents...\n\n");

   try
   {
      // Стирание блока с MAC-адресом:
      printf("Start: Erasing block that contains the MAC address...\n");
      hr = pFlashProg->EraseBlock(70);
      if( hr != S_OK )
      {
         printf("Failed erasing sector.");
         return 1;
      }
      printf("End: Erasing block that contains the MAC address...\n\n");
   }
   catch(...)
   {
      printf("Make sure the sector number is correct and not write protected.\n");
      return -1;
   }

   // Запись нашего MAC-адреса:
   printf("Start: Writing MAC address...\n");
   pFlashProg->FillFlash( ulBlock66Start, lCount, sStride, sMAC_Address[0] );
   if( hr != S_OK )
   {
      printf("Failed filling flash.");
      return 1;
   }
   pFlashProg->FillFlash( (ulBlock66Start + 2), lCount, sStride, sMAC_Address[1] );
   if( hr != S_OK )
   {
      printf("Failed filling flash.");
      return 1;
   }
   pFlashProg->FillFlash( (ulBlock66Start + 4), lCount, sStride, sMAC_Address[2] );
   if( hr != S_OK )
   {
      printf("Failed filling flash.");
      return 1;
   }
   printf("End: Writing MAC address...\n");

#ifndef _SAFP_
   pFlashPlugin->Close(pFlashProg);

#endif

   printf("Done.\n");
   return 0;
}

////////////////////////////////////////////////////////////////////////////////

//   Основное приложение

////////////////////////////////////////////////////////////////////////////////

//Определение переменных:

var SAFP = 1;

// Установка путей до файла конфигурации, файла драйвера и ldr-файла:

var ConfigFile = "C:\\Program Files\\Analog Devices\\VisualDSP 4.5\\BF537_SAFP_config.ini";

var DriverFile = "C:\\Program Files\\Analog Devices\\VisualDSP 4.5\\Blackfin\\Examples

                 \\ADSP-BF537 EZ-Kit Lite\\Flash Programmer\\BF537EzFlashDriver.dxe";

var LdrFile = "C:\\Program Files\\Analog Devices\\VisualDSP 4.5\\Blackfin\\Examples

              \\ADSP-BF537 EZ-Kit Lite\\Power_On_Self_Test\\1000320_AA0188-2004_M29W320DB_U24.ldr";

var FileFormat = 0;           // формат Intel HEX

var VerifyWhileWriting = 1;   // делать проверку

var EraseOption = 0;          // erase affected

var StartAddress = 0;         // для формата Intel HEX этот параметр игнорируется

if( SAFP )
{
   // Получение объекта SAFP:
   var pFlash = new ActiveXObject( "VisualDSP.ADspSAFP" );
   // Установка файла конфигурации:
   WScript.Echo("Setting config file...");
   pFlash.ConfigFile = ConfigFile;
}

else
{
   // Получение объекта VDSP:
   var app = new ActiveXObject( "VisualDSP.ADspApplication" );
   var plugin = app.PluginList.Item("Flash Programmer");
   var pFlash = plugin.Open();
}

// Загрузка драйвера:
WScript.Echo("Loading driver...");
pFlash.LoadDriver(DriverFile);

// Стирание первого блока:
WScript.Echo("Erasing sector 0...");
pFlash.EraseBlock(0);

// Загрузка ldr-файла:
WScript.Echo("Loading the LDR file...");
pFlash.LoadFile(LdrFile, FileFormat, VerifyWhileWriting, EraseOption, StartAddress);

if( !SAFP )
{
   plugin.Close(pFlash);
}

WScript.Echo("Done.");

import   win32com.client

#/////////////////////////////////////////////////////////////////////////////

#// def main()

#/////////////////////////////////////////////////////////////////////////////

if __name__ == '__main__':
   SAFP = 1
   MacAddressBlock = 66                      # 66 для устройства DB и 70 для EB
   bEraseAll = 0                             # 0 - стереть сектор, 1 - стереть все
   MAC_Address = [ 0xE000, 0xFE22, 0x3412 ]  # значение MAC-адреса
   DriverPath = "C:\\Program Files\\Analog Devices\\VisualDSP 4.5\\Blackfin\\Examples
                \\ADSP-BF537 EZ-Kit Lite\\Flash Programmer\\BF537EzFlashDriver.dxe"
   LdrPath = "C:\\Program Files\\Analog Devices\\VisualDSP 4.5\\Blackfin\\Examples
             \\ADSP-BF537 EZ-Kit Lite\\Power_On_Self_Test\\1000320_AA0188-2004_M29W320DB_U24.ldr"
   ConfigFile = "C:\\Program Files\\Analog Devices\\VisualDSP 4.5\\BF537_SAFP_config.ini"

   # Параметры для программирования файла:
   EraseOption = 0x0
   FileFormat = 0x0
   VerifyWhileWriting = 0x1

   if ( SAFP == 1 ):
      pFlash = win32com.client.Dispatch("VisualDSP.ADspSAFP")
      ####
      #    Первое, что нужно сделать: установить наш файл конфигурации.
      ####
      print 'Setting config File.'
      pFlash.ConfigFile = ConfigFile
   else:
      app = win32com.client.Dispatch("VisualDSP.ADspApplication")
      plugin = app.PluginList.Item("Flash Programmer")
      pFlash = plugin.Open()

   ####
   #    Загрузка драйвера flash programmer
   ####
   print 'Loading flash driver.'
   pFlash.LoadDriver( DriverPath )
   
   ####
   #    Стирание
   ####
   if ( bEraseAll == 1 ):
      print 'Erase all of flash.'
      pFlash.EraseAll()
   else:
      print 'Erase block 0'
      pFlash.EraseBlock( 0 )

   ####
   #    Загрузка нашего файла в память flash
   ####
   print 'Loading file to flash'
   pFlash.LoadFile( LdrPath, FileFormat, VerifyWhileWriting, EraseOption, 0 )

   ####
   #    Сравнение нашего файла со значениями во flash
   ####
   print 'Comparing file with flash'
   pFlash.CompareFlashWithFile( LdrPath, FileFormat, 0 )

   ####

   #    Теперь запрограммируем MAC-адрес
   ####
   print 'Erase sector containing the MAC Address'
   pFlash.EraseBlock( 66 )
   print 'Write our MAC address to flash'
   pFlash.FillFlash( 0x3F0000, 1, 1, MAC_Address[0] )
   pFlash.FillFlash( 0x3F0002, 1, 1, MAC_Address[1] )
   pFlash.FillFlash( 0x3F0004, 1, 1, MAC_Address[2] )

   ####
   #    В этом месте отправляется команда сброса.
   #    Это делается для демонстрации отправки команд.
   ####
   print 'Send a custom command'
   pFlash.SendCustom( 2 )

   if ( SAFP == 0 ):
      plugin.Close( pFlash )

   print 'Done'

Устранение проблем при использовании SAFP. Ниже показано решение типичных проблем, возникающих при использовании SAFP.

Проблема: не могу запустить скрипт VBasic. Скрипт *.vbs запускается двойным кликом, если используется интерпретатор wscript. Как альтернатива для запуска скрипта через wscript может использоваться командная строка:

wscript имяскрипта.vbs

Если нужно использовать интерфейс консоли, то тогда в качестве интерпретатора нужно взять cscript, командная строка будет аналогичная:

cscript имяскрипта.vbs

Для запуска можно настроить ярлык на рабочий стол с указанием в его свойствах этой командной строки. Я обычно использую командный файл (*.bat или *.cmd) с таким же содержанием, и этот командный файл (или ярлык для него) размещаю на Рабочем Столе (Desktop) операционной системы Windows.

Проблема: скрипт запускается, но ничего не происходит. Если для скрипта используется интерпретатор cscript или wscript, то может истечь таймаут скрипта. Подобная проблема: сообщение "Script execution time was exceeded on script X"

Чтобы исправить проблему: найдите wscript.exe (находится в каталоге \WINDOWS\system32 системы Windows XP), и выполните на нем двойной клик. Убедитесь что не выбрана опция "Stop script after specified number of seconds". Другой способ исправить эту проблему: в командной строке (CMD.EXE) выполните команду:

cscript.exe //T:nn name.ext

или

wscript.exe //T:nn name.ext

Здесь nn задает количество секунд, отведенное на работу скрипта, name это основное имя скрипта до расширения, и ext это расширение файла скрипта (такое как js или vbs).

[Ссылки]

1. Как происходит загрузка ADSP-BF533 Blackfin.
2. Blackfin: утилита elfloader.exe.
3. S29AL008D 8 Mbit (1M x 8-Bit/512 K x 16-Bit), 3V Boot Sector Flash site:cypress.com.
4. Intel HEX: описание формата файла.
5. Blackfin: форматированный вывод в окно терминала через UART.
6. Эмулятор Blackfin ICE-100B.