Для работы CANfestival нужно следующее:

1. Рабочая станция под управлением Linux, FreeBSD, Cygwin (GNU toolchain).
2. Компилятор GNU C (gcc) или любой другой компилятор языка ANSI-C для Вашей целевой платформы.
3. Xpdf и официальный файл 301_v04000201.pdf для получения контекстной подсказки в GUI.
4. GNU Make.
5. Bash и sed.

Для традиционной платформы win32 понадобится следующее:

1. Visual Studio Express 2005 или более свежая и продвинутая версия.
2. Microsoft platform SDK (требуется Genuine Advantage).
3. Cygwin (только для конфигурации).
4. MinGW/MSYS.

Компиляция и инсталляция. Вызовите ./conigure -help чтобы посмотреть доступные опции времени компиляции. После запуска команды ./conigure с опциями командной строки, относящимися к определенной платформе, просто выполните команду make.

./configure [список необходимых опций]
make
make install

[Узел CANopen для стандартной Linux]

./configure --timers=unix

Чтобы запустить узел CANopen на компьютере под управлением Linux, Вам потребуется:

1. Рабочий дистрибутив Linux.
2. Один или большее количество интерфейсов Peak system PC CAN, и установленный драйвер Peak Linux последней версии.

[Узел CANopen для Real-Time Linux]

Для Linux Xenomai:

./configure --timers=xeno

Для Linux Rtai:

./configure --timers=rtai

Чтобы запустить узел CANopen на компьютере PC под управлением Linux, Вам понадобятся:

1. Рабочий дистрибутив Linux с установленным патчем XENOMAI (2.1 или более новым) или RTAI (3.6).
2. Один или несколько интерфейсов Peak system PC CAN, и установленный драйвер Peak Real Time Linux последней версии.

[Узел CANopen на Linux, работающий на уровне ядра]

Чтобы запустить узел CANopen на компьютере PC под управлением Linux, работающий в kernel space, Вам понадобятся:

1. Рабочий дистрибутив Linux, собранный из 2.6.x.x kernel sources.
2. Драйвер карты CAN, совместимый с CanFestival.

[Устройства CAN]

Настоящий момент поддерживаемые устройства CAN и соответствующая опция скрипта conigure:

Peak systems

./configure --can=peak_linux

Интерфейс PeakSystems CAN автоматически выбирается как интерфейс CAN по умолчанию, если в системе присутствует библиотека libpcan. Загрузите драйвер с сайта http://www.peak-system.com/linux, и следуйте инструкциям по установке драйвера в Вашей системе.

Socket-Can (http://socketcan.berlios.de)

./configure --can=socket

Serial

./configure --can=serial

Драйвер CAN serial реализует последовательное соединение 1:1 между 2 устройствами CAN. Например, Вы можете соединить 2 приложения CANFestival через кабель NULL modem.

Также с этим драйвером поставляется программный хаб, с помощью которого можно соединить друг с другом до 16 приложений CANFestival, работающих на одном компьютере PC, с опциональным соединением с другим драйвером CAN. Имейте в виду, что настоящий момент поддерживается только драйвер serial. Этот хаб использует ptys (pseudo ttys), доступный на системах *nix.

LinCan

./configure --can=lincan

Виртуальные интерфейсы CAN (для теста/отладки)

./configure --can=virtual

или, для работы в kernel space:

./configure --can=kernel_virtual

Виртуальный интерфейс CAN использует каналы Unix (pipes) для эмуляции виртуальной сети CAN. Каждое сообщение, выданное из узла, повторяется для всех других узлов. Сейчас это функционирует только с узлами, работающими в одном процессе, и не поддерживается работа в системах Xenomai или RTAI.

VScom

./configure --can=vscom

После выдачи этой команды архив VSCAN API будет автоматически загружен и распакован (требуется unzip). Список доступных поддерживаемых адаптеров см. на сайте www.vscom.de.

[Службы LSS]

Canfestival опционально поддерживает службы LSS, но они должны быть разрешены на этапе конфигурирования, с последующей компиляцией.

./configure --enable-lss

Дополнительно может быть разрешена служба FastScan LSS.

./configure --enable-lss --enable-lss-fs

[Код, работающий в пространстве пользователя (User space)]

Установленный пакет CanFestival предоставляет пример /example/TestMasterSlave.

TestMasterSlave. Библиотекой драйвера CAN является libcanfestival_can_virtual.so., которая будет просто передавать сообщения CAN через каналы Unix между узлами Master и Slave.

Вы также можете указать другой интерфейс CAN и определить некоторые порты CAN. Другой пример использует интерфейс Peak dual PCMCIA (конфигурируется и устанавливается с опцией --can=peak):

TestMasterSlave -l libcanfestival_can_peak.so -s 40 -m 41

Если службы LSS разрешены, то также будет установлен пример в /example/TestMasterSlaveLSS. Это работает так же, как и TestMasterSlave, кроме факта, что здесь 2 узла без допустимых идентификаторов nodeID, чтобы взаимодействие узлов могло быть настроено службами LSS. Если опционально разрешена служба FastScan, то этот пример будет использовать её.

[Код, работающий в режиме ядра (Kernel space)]

example/kerneltest. Этот пример базируется на TestMasterSlave, и имеет тот же функционал. Здесь также по умолчанию используется виртуальный драйвер CAN. После успешной инсталляции Вы можете вставить модуль, если введете команду:

modprobe canf_ktest

Управление модулем осуществляется через простую консоль 'canf_ktest_console' которая используется для запуска/остановки отправки данных.

Cygwin должен быть установлен со следующими пакетами:

1. gcc
2. unzip
3. wget
4. make

В настоящий момент поддерживаются только устройства CAN компании PeakSystems с драйвером и библиотекой PcanLight. Поэтому кроме установленной системы Cygwin потребуется драйвер для устройства Peak CAN. Загрузите драйвер с сайта http://www.peak-system.com/themen/download_gb.html и следуйте инструкциям по установке на Вашей системе.

[Конфигурирование и компиляция Cygwin]

Откройте терминал Cygwin и выполните следующие действия:

a) Один узел с PcanLight  и адаптером Peak CAN-USB adapter. Загрузите zip-файл PCAN-Light для Вашего оборудования:

wget http://www.peak-system.com/files/usb.zip

Распакуйте содержимое этого загруженного архива в домашний каталог (cygwin home), это создаст директорию Disk:

unzip usb.zip

Сконфигурируйте CanFestival3, предоставив путь на желаемую реализацию PcanLight:

cd CanFestival -3
export PCAN_INCLUDE=~/Disk/PCAN-Light/Api/
export PCAN_HEADER=Pcan_usb.h
export PCAN_LIB=~/Disk/PCAN-Light/Lib/Visual\ C++/Pcan_usb.lib
./configure --can=peak_win32
make

Чтобы провести тест, у Вас должен быть другой узел CanFestival, подключенный кабелем CAN.

cp ~/Disk/PCAN-Light/Pcan_usb.dll .
./examples/TestMasterSlave/TestMasterSlave \
-l drivers/can\_peak\_win32/cygcan\_peak\_win32.dll \
-S 500K -M none

Затем на другом узле выполните команду:

./TestMasterSlave -l my_driver.so -S none -M 500K

После этого между узлами master и slave произойдет обмен сообщениями.

b) Два узла с PcanLight и адаптером Peak dual PCMCIA-CAN. Загрузите zip-файл PCAN-Light для Вашего оборудования:

wget http://www.peak-system.com/files/pccard.zip

Распакуйте содержимое этого загруженного архива в домашний каталог (cygwin home), это создаст директорию Disk:

unzip pccard.zip

Сконфигурируйте CanFestival3 с предоставлением пути до желаемой реализации PcanLight:

export PCAN_INCLUDE=~/Disk/PCAN-Light/Api/
export PCAN_HEADER=Pcan_pcc.h
export PCAN_LIB=~/Disk/PCAN-Light/Lib/Visual\ C++/Pcan_pcc.lib
export PCAN2_HEADER=Pcan_2pcc.h
export PCAN2_LIB=~/Disk/PCAN-Light/Lib/Visual\ C++/Pcan_2pcc.lib

Чтобы провести тест, соедините друг с другом оба порта CAN карты PCMCIA. Не забудьте подключить терминирующий резистор 120 Ом.

cp ~/Disk/PCAN-Light/Pcan_pcc.dll .
cp ~/Disk/PCAN-Light/Pcan_2pcc.dll .
./examples/TestMasterSlave/TestMasterSlave \
-l drivers/can_peak_win32/cygcan_peak_win32.dll

Произойдет обмен сообщениями между узлами master и slave, оба внутри процесса TestMasterSlave.

Во время конфигурации требуется минимальная инсталляция Cygwin, чтобы создать специфические файлы заголовков (config.h и cancfg.h). Как только эти файлы созданы, больше cygwin не нужен.

Файлы проекта и решения (solution) были созданы и протестированы в среде Visual Studio Express 2005. Убедитесь, что у Вас установлен Microsoft Platform SDK, как это рекомендуется после завершения установки Visual Studio.

Конфигурация с помощью cygwin. Следуйте инструкциям "Конфигурирование и компиляция Cygwin" из врезки "Среда CYGWIN", но не вызывайте make и не делайте тесты, просто выполните шаги конфигурирования. Эти шаги создадут заголовочные файлы в соответствии с Вашими параметрами конфигурации для необходимой аппаратуры CAN.

Компиляция в Visual Studio. Вы можете либо загрузить отдельный файл проекта "*.vcproj", либо загрузить предоставленный проект решения CanFestival-3.vc9.sln (для Visual Studio 2009) или CanFestival-3.vc10.sln (для Visual Studio 2010). Сначала выполните сборку проекта CanFestival-3.

1>------ Перестроение всех файлов начато: проект: CanFestival-3, Конфигурация: Debug Win32 ------
1>Сборка начата 31.05.2017 15:16:01.
1>_PrepareForClean:
1>  Файл "Debug\CanFestival-3.lastbuildstate" удаляется.
1>InitializeBuildStatus:
1>  Создание "Debug\CanFestival-3.unsuccessfulbuild", так как было задано "AlwaysCreate".
1>ClCompile:
1>  win32.c
1>  timers_win32.c
1>  timer.c
1>  sync.c
1>  states.c
1>  sdo.c
1>  pdo.c
1>  objacces.c
1>  nmtSlave.c
1>  nmtMaster.c
1>  lss.c
1>  lifegrd.c
1>c:\asm\canfestival-3-8bfe0ac00cdb\src\lifegrd.c(231): warning C4550: вычисление выражения
 дает функцию, в которой отсутствует список аргументов
1>  emcy.c
1>  dcf.c
1>c:\asm\canfestival-3-8bfe0ac00cdb\src\dcf.c(106): warning C4101: node: неиспользованная
 локальная переменная
1>  Создание кода...
1>Link:
1>     Создается библиотека Debug\CanFestival-3.lib и объект Debug\CanFestival-3.exp
1>  CanFestival-3.vc10.vcxproj -> C:\asm\CanFestival-3-8bfe0ac00cdb\Debug\CanFestival-3.dll
1>FinalizeBuildStatus:
1>  Файл "Debug\CanFestival-3.unsuccessfulbuild" удаляется.
1>  Обращение к "Debug\CanFestival-3.lastbuildstate".
1>
1>Построение успешно завершено.
1>
1>Затраченное время: 00:00:04.54
========== Перестроение всех: успешно: 1, с ошибками: 0, пропущено: 0 ==========

a) PcanLight и проект can_peak_win32 project. Выбранные файлы библиотек Pcan_xxx.lib и иногда Pcan_2xxx.lib должны быть добавлены в проект can_peak_win32 перед сборкой DLL.

Тестирование: скопируйте иногда необходимые библиотеки (например Pcan_Nxxx.lib) в директорию Release или Debug, и запустите программу теста:

TestMasterSlave.exe -l can_peak_win32.dll

Загрузите MSYS по ссылке from : http://sourceforge.net/project/showfiles.php?group_id=2435:

1. MSYS-1.0.10.exe.
2. MinGW-5.1.3.exe.
3. mingwPORT (в котором содержится wget-1.9.1).

Загрузите драйвер по ссылке http://www.peak-system.com/themen/download_gb.html и следуйте инструкциям для установки драйвера в Вашей системе. Требуется установка MSYS, MingW и драйвера для Вашего устройства Peak CAN. Откройте терминал MSYS, и выполните следующие действия:

• Распакуйте wget-1.9.1-mingwPORT.tar.bz2.
• Скопируйте wget.exe в c:\msys\1.0\bin\.
• Запустите MSYS, и проверьте, что файл /etc/fstab содержит строку c:/MinGW /mingw.

Конфигурирование и компиляция MSYS. Инструкции для компиляции почти те же самые, как были для CYGWIN.

a) Один узел с PcanLight и адаптером Peak CAN-USB. Загрузите zip-файл PCAN-Light для Вашей аппаратуры:

wget http://www.peak-system.com/files/usb.zip

Распакуйте его содержимое в домашний каталог (MSYS home), это создаст директорию Disk:

unzip usb.zip

Сконфигурируйте CanFestival3, предоставив путь до нужной реализации PcanLight:

cd CanFestival-3
export PCAN_INCLUDE=~/Disk/PCAN-Light/Api/
export PCAN_HEADER=Pcan_usb.h
export PCAN_LIB=~/Disk/PCAN-Light/Lib/Visual\ C++/Pcan_usb.lib
./configure --can=peak_win32
make

Для проверки у Вас должен быть другой узел CanFestival, подключенный кабелем CAN.

cp ~/Disk/PCAN-Light/Pcan_usb.dll .
./examples/TestMasterSlave/TestMasterSlave \
-l drivers/can_peak_win32/cygcan_peak_win32.dll \
-S 500K -M none

Затем на другом узле выполните:

./TestMasterSlave -l my_driver.so -S none -M 500K -m 0

После этого между узлами master и slave произойдет обмен сообщениями.

b) Два узла с PcanLight и адаптером Peak dual PCMCIA-CAN. Загрузите zip-файл PCAN-Light для Вашего оборудования:

wget http://www.peak-system.com/files/pccard.zip

Распакуйте содержимое этого загруженного архива в домашний каталог (MSYS home), это создаст директорию Disk:

unzip pccard.zip

Сконфигурируйте CanFestival3 с предоставлением пути до нужной реализации PcanLight:

export PCAN_INCLUDE=~/Disk/PCAN-Light/Api/
export PCAN_HEADER=Pcan_pcc.h
export PCAN_LIB=~/Disk/PCAN-Light/Lib/Visual\ C++/Pcan_pcc.lib
export PCAN2_HEADER=Pcan_2pcc.h
export PCAN2_LIB=~/Disk/PCAN-Light/Lib/Visual\ C++/Pcan_2pcc.lib

Чтобы провести тест, соедините друг с другом оба порта CAN карты PCMCIA. Не забудьте подключить терминирующий резистор 120 Ом.

cp ~/Disk/PCAN-Light/Pcan_pcc.dll ~.
cp ~/Disk/PCAN-Light/Pcan_2pcc.dll ~.
./examples/TestMasterSlave/TestMasterSlave \
-l drivers/can\_peak\_win32/cygcan\_peak\_win32.dll -m 0 -s 1

Произойдет обмен сообщениями между узлами master и slave, оба внутри процесса TestMasterSlave.

Эти примеры тестировались на микроконтроллере MC9S12DG255, смонтированном на плате Elektronikladen HCS12 T-board.

Имейте в виду, что есть несколько различий в модуле MSCAN микроконтроллеров 68HC12 и HCS12. Для HC12 Вы должны адаптировать драйвер, который разработчики предоставили для HCS12. Описание различий MSCAN HC12/HCS12 см. апноут AN2011/D от Motorola.

Опция configure:

--target=hcs12

Чтобы запустить узел CANopen на микроконтроллере Motorola MC9S12DP256, Вам нужно: 

1. Компилятор GNU gcc для HC11, HC12, HCS12: m6811 -elf. Загрузите релиз 3.1 по ссылке http://m68hc11.serveftp.org/m68hc11_pkg_rpm.php.
2. Плата, на которой установлен этот чип. Разработчики использовали T-board от Electronikladen.
3. Как минимум 40 килобайт памяти программ.
4. Инструментарий для прошивки памяти (разработчики использовали дорогой отладчик Lauterbach). 

Запуск узла HCS12. Скомпилируйте Canfestival: 

./configure --target=hcs12

Войдите в папку примера HCS12 и запустите команду:

make all

Прошивка памяти. Используйте для этого то, что Вам больше подходит, например загрузчик. Если у Вас есть debugger Lauterbach, то можете загрузить файл bash: trace32_flash_programmer.cmm. Он непосредственно загрузит elf-файл. 

Подключение к консоли RS232. Подключите portS(TxD0) HCS12 к консоли, сконфигурированной на 19200 бод, 8N1, через чип MAX232, чтобы привести в соответствие электрические уровни сигналов. На Linux можно использовать утилиту minicom. Подключение консоли полезно для чтения сообщений, но это не требуется. 

Подключение к сети CAN. Подключите порт CAN0 (выводы PM0, PM1) к сети через контроллер CAN. На плате разработчиков в качестве контроллера CAN использовался чип PCA82C250. Для запуска узла нажмите кнопку сброса на Вашей плате HCS12. 

Этот пример предоставляет узел, который может выполнять некоторые команды пользователя, введенные через stdin. С этим примером Вы можете: 

1. Просканировать сеть (сбросить все узлы, и отобразить сообщение bootup узла).
2. Запустить (start) / остановить (stop) / сбросить (reset) дальний узел сети.
3. Получить информацию по дальнему узлу сети.
4. Прочитать / записать определенный элемент дальнего узла сети. 

Узел может быть запущен как master или как slave. Отличие только в том, что когда запуск осуществлен как master, все узлы сети сбрасываются. 

Первой командой должна быть команда "load". Для подсказки по командам выполните команду help, отобразится следующий экран:

****************************************************************************
* CANOpenShell                                                             *
*                                                                          *
* ОБЯЗАТЕЛЬНАЯ КОМАНДА (должна быть первой)                                *
* load#CanLibraryPath,channel,baudrate,nodeid,type (0:slave, 1:master)     *
*                                                                          *
* СЕТЬ: (если nodeid=0x00, то broadcast)                                   *
* ssta#nodeid : запуск узла                                                *
* ssto#nodeid : остановка узла                                             *
* srst#nodeid : сброс узла                                                 *
* scan : сброс всех узлов и печать сообщения, когда произошел bootup узла  *
* wait#seconds : заснуть на n секунд                                       *
*                                                                          *
* SDO: (размер в байтах)                                                   *
* info#nodeid                                                              *
* rsdo#nodeid,index,subindex : прочитать sdo                               *
* ex : rsdo#42,1018,01                                                     *
* wsdo#nodeid,index,subindex,size,data : записать sdo                      *
* ex : wsdo#42,6200,01,01,FF                                               *
*                                                                          *
* Примечание: все числа указываются в hex                                  *
*                                                                          *
* help : будет отображен этот экран                                        *
* quit : выход из приложения                                               *
****************************************************************************

Пример минимальной команды запуска (запуск узла как slave c номером узла nodeid 8, скорость 125K на канале 32): 

./CANOpenShell load#libcanfestival_can_peak_linux.so,32,125K,8,0

Пример продвинутой команды:

./CANOpenShell load#libcanfestival_can_peak_linux.so,32,125K,8,1 \
help \
wait#5 \
wsdo#42,6200,01,01,FF

Эта команда запустит узел в режиме master с номером узла 8 на скорости 125K канала 32, отобразит меню подсказки, подождет 5 секунд для NMT bootup узла, и запишет значение FF по индексу 6200, субиндексу 01 в дальний узел сети с идентификатором 42.

Это простой пример для запуска на компьютере PC. Реализует 2 узла CANopen в одном и том же процессе, master и slave. Оба узла осуществляют взаимодействие друг с другом, периодически обмениваясь сообщениями NMT, SYNC, SDO и PDO. Master конфигурирует генератор сердцебиений (heartbeat producer) с интервалом 1000 мс для slave node-id 0x02 с помощью краткого DCF.

**************************************************************
* TestMasterSlave                                            *
*                                                            *
* A simple example for PC. It does implement 2 CanOpen       *
* nodes in the same process. A master and a slave. Both      *
* communicate together, exchanging periodically NMT, SYNC,   *
* SDO and PDO. Master configure heartbeat producer time      *
* at 1000 ms for slave node-id 0x02 by concise DCF.          *
*                                                            *
* Usage:                                                     *
* ./TestMasterSlave [OPTIONS]                                *
*                                                            *
* OPTIONS:                                                   *
* -l : Can library ["libcanfestival_can_virtual.so"]         *
*                                                            *
* Slave:                                                     *
* -s : bus name ["0"]                                        *
* -S : 1M,500K,250K,125K,100K,50K,20K,10K,none(disable)      *
*                                                            *
* Master:                                                    *
* -m : bus name ["1"]                                        *
* -M : 1M,500K,250K,125K,100K,50K,20K,10K,none(disable)      *
*                                                            *
**************************************************************

Замечания по поводу использования сокращенного DCF: в этом примере master конфигурирует время 1000 мс heartbeat producer для подчиненного узла с идентификатором 0x02 по сокращенному DCF в соответствии с профилем DS-302. Индекс 0x1F22, sub-индекс 0x00 master OD соответствует количеству элементов. Оно равно максимальному возможному nodeId (127). Sub-индекс указывает на Node-ID устройства, которому принадлежит конфигурация.

Для добавления большего количества параметров конфигураций slave, значение sub-индекса 0x02 должно быть двоичным потоком данных (little-endian) со следующей структурой:

(UNS32) количество записей
(UNS16) индекс параметра 1
(UNS8) sub-индекс параметра 1
(UNS32) размер данных параметра 1
(DOMAIN) данные параметра 1
(UNS16) индекс параметра 2
(UNS8) sub-индекс параметра 2
(UNS32) размер данных параметра 2
(DOMAIN) данные параметра 2
....
(UNS16) индекс параметра n
(UNS8) sub-индекс параметра n
(UNS32) размер данных параметра n
(DOMAIN) данные параметра n

Таким образом, этот двоичный поток данных для конфигурирования времени heartbeat producer должен быть следующим:

0100000017100002000000e803

Узел slave конфигурируется сразу перед входом Master в состояние Pre_operational.

Это простой пример узла CANopen, который только циклически отправляет сообщение SYNC. Здесь демонстрируется реализация на основе платы HCS12.

Пример основан на TestMasterSlave, который был незначительно модифицирован для удовлетворения требований по работе на уровне ядра. Все работает так же, как и TestMasterSlave, но сообщения отправляются на уровне ядра (например, они отображаются командой dmesg). Пример разработан как внешний модуль ядра, реализованный как символьное устройство. Имеется shell-скрипт insert.sh, который вставляет модуль и создает новый файл устройства /dev/canf_ktest (используется для отправки команд в модуль). Для реальной отправки команд Вы можете использовать простую консоль с именем 'canf_ktest_console'. Этот модуль зависит от другого отдельного модуля canfestival.ko, где реализован стек CanOpen с требуемыми экспортируемыми функциями. Модуль canfestival.ko зависит от модуля драйвера карты CAN, по умолчанию будет загружен виртуальный драйвер CAN. После установки модулей (командой make install) все зависимости автоматически разрешаются ядром. Для запуска примера введите команду:

sh run.sh

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

**************************************************************
* TestMasterSlaveLSS                                         *
*                                                            *
* Пример LSS для PC. Реализует 3 узла CanOpen в одном        *
* процессе, master и 2 slave. Все узлы взаимодействуют       *
* друг с другом, периодически обмениваясь сообщениями NMT,   *
* SYNC, SDO и PDO. Master конфигурирует время heartbeat      *
* producer на 1000 мс для slave-устройств с помощью          *
* сокращенного DCF.                                          *
*                                                            *
* Использование:                                             *
* ./TestMasterSlaveLSS [ОПЦИИ]                               *
*                                                            *
* ОПЦИИ:                                                     *
* -l : библиотека CAN ["libcanfestival_can_virtual.so"]      *
*                                                            *
* SlaveA:                                                    *
* -a : имя шины ["0"]                                        *
* -A : 1M,500K,250K,125K,100K,50K,20K,10K,none(disable)      *
*                                                            *
* SlaveB:                                                    *
* -b : имя шины ["1"]                                        *
* -B : 1M,500K,250K,125K,100K,50K,20K,10K,none(disable)      *
*                                                            *
* Master:                                                    *
* -m : имя шины ["2"]                                        *
* -M : 1M,500K,250K,125K,100K,50K,20K,10K,none(disable)      *
*                                                            *
**************************************************************

Для запроса служб LSS используется функция configNetworkNode. Она работает подобно writeNetworkDict и имеет следующий прототип:

UNS8 configNetworkNode (CO_Data* d,
                        UNS8 command,
                        void *dat1,
                        void* dat2,
                        LSSCallback_t Callback);

FastScan это специальная служба LSS, которая позволяет динамически идентифицировать slave-узлы, даже если у них нет допустимых nodeID. Эта идентификация основана на адресе LSS, составленном по идентификатору производителя (vendor ID), коду изделия (product code), номеру ревизии (revision number) и серийному номеру (serial number). Для дополнительной информации см. документ DS305.

Адрес LSS может быть известен частично либо полностью неизвестен. Чтобы представить этот факт в Canfestival, разработчики использовали структуру lss_fs_transfer_t. Параметр FS_LSS_ID это массив из 4 элементов, где представлены эти 4 составляющих адреса LSS. Другой параметр FS_BitChecked это также массив, и он представляет информацию о том, как много бит в каждом элементе адреса LSS не известны (UNKNOWN). Следующий пример взят из TestMasterSlaveLSS, где не известны только последние 2 цифры (8 бит) vendor ID и product code, и полностью не известны revision number и serial number.

lss_fs_transfer_t lss_fs;

/* VendorID и ProductCode частично неизвестны,

   кроме последних 2 цифр (8 бит). */
lss_fs.FS_LSS_ID[0]=Vendor_ID;
lss_fs.FS_BitChecked[0]=8;
lss_fs.FS_LSS_ID[1]=Product_Code;
lss_fs.FS_BitChecked[1]=8;

/* serialNumber и RevisionNumber неизвестны,

   например неизвестны 8 цифр (32 бита). */
lss_fs.FS_BitChecked[2]=32;
lss_fs.FS_BitChecked[3]=32;
res=configNetworkNode(&d,LSS_IDENT_FASTSCAN,&lss_fs,0,CheckLSSAndContinue);

Сначала Вам нужно загрузить и установить модули Gnosis XML. Эта процедура автоматизирована правилом из Makefile.

cd objdictgen
make

Теперь Вы можете запустить редактор:

python objdictedit.py [файл (или файлы) *.od]

Установите среду Python (как минимум версии 2.4, я устанавливал Python 2.7) и библиотеку wxPython (как минимум версии 2.6.3.2, я устанавливал wxPython3). Пользователи Cygwin могут установить утилиты Gnosis XML таким же способом, как и в Linux. Просто вызовите make.

cd objdictgen
make

Другим пользователям потребуется загрузить и установить Gnosis XML вручную. Загрузите последнюю версию по ссылкам:

http://freshmeat.net/projects/gnosisxml/
http://www.gnosis.cx/download/

Примечание: я скачал по первой ссылке архив gnosisXML.zip, и распаковал оттуда папку gnosis в каталог C:\Python27\Lib\. Установка Gnosis XML на этом завершена.

Загрузите архив CanFestival и распакуйте его. Используйте Проводник (Windows File Explorer), чтобы перейти в каталог CanFestival3\objdicgten, и выполните двойной клик на objdictedit.py. Откроется графический интерфейс, где Вы можете создавать новые и редактировать готовые словари OD. Файлы словарей хранятся в файлах с расширением *.od, также их можно экспортировать в файлы *.eds.

[Проблемы запуска Object Dictionary editor GUI]

К сожалению, мне не удалось запустить редактор (скрипт objdictedit.py) с последней на момент написания статьи версией Python (python-3.6.1) и библиотеки wxPhyton (wxPython-4.0.0a1-cp36) - из-за значительных изменений в синтаксисе языка. Для Phyton это обычное дело... Пришлось подбирать версии, и удалось запустить скрипт редактора на Phyton 2.7.13 (python-2.7.amd64.msi) и wxPhyton 3.0 (wxPython3.0-win64-3.0.2.0-py27.exe), см. архив [4].

1. Ошибка "ImportError: No module named 'wx'" - не установлена библиотека wxPython. Решение: установите библиотеку wxPython.

2. Ошибка "ImportError: No module named '__version__'" - проблема с несоответсвиями версий Python и библиотеки wxPython. Решение: установите Phyton 2.7 и wxPhyton 3.0, правильно настройте пути запуска в переменной окружения %Path%. Определите переменные окружения PYTHONHOME и PYTHONPATH, настроенные на корневой каталог Python и папку Lib, например вот так:

PYTHONHOME C:\Python27
PYTHONPATH C:\Python27\Lib

3. Ошибка "ImportError: No module named gnosis.xml.pickle" - не установлена библиотека Gnosis XML. Решение - установите эту библиотеку для Phyton. Я устанавливал из пакета gnosisXML.zip (см. архив [4]).