Программное обеспечение
LComp
Руководство программиста
Комплект ПО для разработки приложений (SDK)
Windows 98/Me/2000/XP
L-264/L-305/L-1221/L-1250/L-1450/L-761/L-780/L-783/L-791/E14-440/E14-140/E20-10/E154
![]() |
Москва. Февраль. 2003 Ревизия 1.0 |
ЗАО "Л-КАРД"
Адреса в Интернет:
E-Mail:
Представители в регионах:
Version 6.0r0
Copyright (c) 1998-2008 L-Card Ltd.
Интерфейс и функциональные возможности драйвера и библиотеки могут измениться в последующих версиях.
Учтите это при проектировании своих приложений.
Корректная поддержка плат с помощью это драйвера возможна только при соответствующих прошивках BIOS ADSP. Пока это выполняется для L-305 L-264 L-1250 L-1251 L-1221 L-761 L-780 L-783 L-1450 L-791 E14-440 E14-140 E20-10 E154.
Данный релиз драйвера и библиотеки поддерживает следующие платы:
L032 |
ISA |
2000/XP |
Установите плату как L-1250 и используйте функции ввода/вывода в порты. |
L305 |
ISA |
2000/XP |
|
L264 |
ISA |
2000/XP |
|
L1250 |
ISA |
2000/XP |
|
L1450 |
ISA |
2000/XP |
|
L1620 |
ISA |
2000/XP |
Установите плату как L-1250, при загрузке используйте БИОС от платы L-1620. Далее вызывайте функции L-1250. Разница только в формате данных. |
L1251 |
ISA with fast read |
2000/XP |
|
L1221 |
ISA with fast read |
2000/XP |
|
L761 |
PCI |
2000/XP |
|
L780 |
PCI |
2000/XP |
|
L783 |
PCI |
2000/XP |
|
L791 |
PCI |
2000/XP |
|
E14-440 |
USB |
2000/XP |
|
E14-140 |
USB |
2000/XP |
|
E20-10 |
USB |
2000/XP |
|
E154 |
USB |
2000/XP |
Принцип действия:
Устройство АЦП собирает данные в кольцевой буфер или FIFO, реализованный в ОЗУ сигнального процессора или микросхемы ПЛИС. При заполнении части буфера генерируется прерывание. Драйвер устройства по этим прерываниям вычитывает данные и помещает их в большой кольцевой буфер, реализованный в ОЗУ компьютера. Большой кольцевой буфер драйвера доступен пользовательскому приложению - имеется указатель на начало этого буфера. Кроме этого пользователю доступен счетчик заполнения буфера (тоже посредством указателя). Используя этот счетчик, пользователь может забирать данные из правильной части кольцевого буфера (т.е. из той, в которую драйвер уже записал данные).
Приложение может:
- забирать данные из буфера для сохранения непрерывного потока
данных;
- обрабатывать данные на месте - тогда старые данные
будут замещаться новыми;
Связь драйвера с приложением возможна двумя способами:
- чтение счетчика заполнения буфера (циклическое заполнение
буфера);
- ожидание сообщения о готовности буфера (однократное
заполнение буфера);
Первый способ работает всегда, но требует ресурсов от компьютера при ожидании в цикле. Второй способ удобно использовать при осциллографическом режиме работы.
Использование такого режима работы - по прерываниям - обусловлено тем, что платы PCI L-761/780/L783 построены на микросхеме без поддержки BusMastering и для них такой способ ввода непрерывного потока данных является единственно возможным. При этом загрузка ЦПУ минимальна благодаря высокой скорости чтения на шине PCI. Для ISA плат при таком режиме работы удается достичь наивысшей скорости передачи данных, однако для них загрузка процессора может достигать 50-90% на предельных скоростях, что не очень хорошо, но все же позволяет осуществлять непрерывный сбор данных на диск.
Для ISA плат поддерживающих ввод/вывод данных по DMA введен еще один режим. В этом режиме плата передает данные в компьютер по DMA в режиме автоинициализации. Буфер DMA маленький - до 2048 слов. При заполнении половины этого буфера плата генерирует прерывание, по которому драйвер копирует данные из буфера DMA в большой кольцевой буфер. Кроме этого возможен одновременный вывод на ЦАП платы данных из такого же маленького буфера - по DMA с автоинициализацией. В таком режиме работы скорость ввода данных не превышает 200 кГц, но при этом загрузка машины существенно ниже. Возможна работа двух плат на ввод по DMA.
Для платы L791 режим ввода и принцип сбора немного другие. Эта плата поддерживает режим ввода/вывода BusMaster. При этом основной принцип работы с библиотекой остается прежний – приложение забирает данные из кольцевого буфера в памяти компьютера. Только поступают они туда не по прерывания от платы, а по BusMaster-каналу. Заполнение буфера контролируется также по чтению счетчика, только этот счетчик находится непосредственно в плате. Прерывания от платы тоже могут выступать сигналами готовности данных – пользователь может установить события на них и потом обрабатывать.
Для USB модулей реализован также принцип кольцевого буфера путем циклической перепосылки запросов на ввод данных. Работа с ЦАП в потоковом режиме для этих модулей не поддерживается. Она возможна при использовании библиотек не совместимых с LComp – LUsbApi. При этом используется другой интерфейс драйвера ldevusbu.sys.
Первое правило при установке плат - необходимо убедиться, что компьютер настроен и все драйвера для него установлены. Особенно драйвера для чипсета. Также надо проверить, что в плате L-Card прошита самая свежая конфигурационная ПЗУ (см. каталог UTILS после установки драйверов). Как правило, для установки PCI платы необходимо просто вставить ее в компьютер и установить драйвера. После этого плата готова к использованию. Но возможны ситуации, когда это не так. Новые драйвера - это полноценные WDM драйвера способные работать в Windows c поддержкой ACPI и соответственно shared IRQ. Но возможны ситуации, когда другие устройства некорректно работают с ACPI и при этом разделяют ресурсы с платой L-Card. Тогда возможны зависания системы и частичная или полная неработоспособность платы L-Card или какой-то другой. Для решения этой проблемы, необходимо какими либо средствами исключить разделение ресурсов платой L-Card c другими устройствами компьютера. Разделение ресурсов также может понизить производительность системы и/или платы L-Card и тогда тоже желательно его ликвидировать. Ниже приведены пути отключения ACPI и исключения ситуации Shared IRQ для Windows 98 и 2000 (под Me и XP аналогично).
Общая часть:
В БИОСЕе компьютера надо поискать ключ вида Plug & Play OS Installed и установить его в No. Это заставит именно БИОС производить первоначальную настройку PCI плат и Windows, потом будет использовать именное ее.
В БИОСе компьютера найти, если есть ключ ACPI function и поставить его в Disabled.
В БИОСе компьютера найти, если есть ключи вида PCI Slot(0,1..) use IRQ и поставить там фиксированное свободное прерывание вместо Auto.
Если это все проделать на компьютере до установки ОС, то при установке ОС она установится в варианте без поддержки ACPI. Если ОС уже стоит, то придется отключить ACPI в ОС.
Windows 98:
Загрузиться в Safe Mode.
Зайти в Панель Управления.
Открыть иконку Система.
В ней в Диспетчере устройств выбрать Системные устройства.
Если у Вас там значится Plug & play BIOS и нет нигде слова ACPI, то и ACPI соответственно нет и ничего делать больше не надо.
Иначе надо удалить все системные устройства, а Системная кнопка ACPI заменить на Plug & play BIOS с помощью обновления драйвера(выбрать все устройства).
Перезагрузиться.
Посмотреть в Диспетчер устройств. Там все должно быть в одном экземпляре и без восклицательных знаков. Если это не так, то надо удалять дублеров вместе с оригиналами и перезагружаться пока все не придет в норму. К сожалению, это процесс довольно трудно формализуется(PCI irq holder может быть много - это нормально).
Как результат у Вас должна получиться нормальная система с Plag & play BIOS в системных устройствах.
Windows 2000:
Зайти в Панель Управления.
Открыть иконку Система.
Выбрать закладку Оборудование.
В ней в Диспетчере устройств выбрать Компьютер.
Если у Вас там значится Standart PC,то ACPI соответственно нет и ничего делать больше не надо.
Иначе надо сменить тип компьютера на Standart PC с помощью кнопки обновления драйвера (выбрать все устройства).
Перезагрузиться.
Посмотреть в Диспетчер устройств. Там все должно быть в одном экземпляре и без восклицательных знаков. Если это не так то надо удалять дублеров вместе с оригиналами и перезагружаться пока все не придет в норму. К сожалению, это процесс довольно трудно формализуется.
Как результат у Вас должна получиться нормальная система с типом компьютера Standart PC.
Если ресурсы по прежнему разделяются, то можно попробовать переставить плату L-Card в другой слот PCI т.к. некоторые слоты PCI всегда разделяют прерывания с AGP слотом или дополнительными PCI слотами (если слотов >4).
Первое правило при установке плат - необходимо убедиться, что компьютер настроен и все драйвера для него установлены. Особенно драйвера для чипсета. После установки платы в компьютер и инсталляции драйверов надо вызвать мастер установки новых устройств Windows:
Далее выбрать Добавить устройство.
Подождать пока система поищет в своей базе, и выбрать Добавить новое устройство.
Выбрать Выбор из списка.
Выбрать L-Card ADC/DAC ISA boards.
Выбрать нужную плату - появится диалог настройки ресурсов.
В диалоге выбрать нужную конфигурацию и настроить ресурсы в соответствии с установленными перемычками. Не обязательно выбирать самую сложную конфигурацию. Можно ограничиться просто адресом и прерыванием, если требуется только ввод с АЦП и наоборот вывод на ЦАП будет работать только при конфигурации с ПДП для ЦАП. Некоторые платы требуют для работы АЦП наличие ПДП.
Завершить работу мастера и перезагрузить компьютер - в списке устройств должна появиться установленная плата с выбранными ресурсами.
Напрямую с реестром библиотека и пользователь больше не работают. Информация о системных ресурсах назначенных плате извлекается драйверами при помощи PnP менеджера Windows. Она хоть и хранится в реестре, но в служебном формате. Для PCI плат эта информация видна на вкладке ресурсов для соответствующей платы. Для ISA плат она там устанавливается. Только тип платы и процессора DSP задаются посредством INF файла при установке плат. Получить их можно посредством вызова библиотечной функции GetSlotParam. Изменить соответственно - изменив INF файл.
Если Вы написали свое приложение и хотите оформить его в виде дистрибутива, то включите в него следующие файлы:
ldevisa.sys - WDM драйвер для ISA плат - копировать в WINDOWS\SYSTEM32\DRIVERS;
ldevpcim.sys - WDM драйвер для PCI плат L791 - копировать в WINDOWS\SYSTEM32\DRIVERS;
ldevpci.sys - WDM драйвер для PCI плат - копировать в WINDOWS\SYSTEM32\DRIVERS;
ldevusbu.sys - WDM драйвер для USB модулей - копировать в WINDOWS\SYSTEM32\DRIVERS;
ldevs.sys - поддерживающий драйвер - копировать в WINDOWS\SYSTEM32\DRIVERS;
lcardisa.inf - INF файл для ISA плат - копировать в WINDOWS\INF;
lcardpci.inf - INF файл для PCI плат - копировать в WINDOWS\INF;
ldevpcim.inf - INF файл для PCI плат L791 - копировать в WINDOWS\INF;
ldevusbu.inf - INF файл для USB модулей - копировать в WINDOWS\INF;
lcomp.dll - DLL библиотека для работы с платами - класть лучше всего в один каталог с приложением;
Все это будет работать под операционными системами Windows 2000/XP. Оригинальный скрипт инсталляции написан с помощью бесплатной программы NSIS(www.nullsoft.com) и прилагается.
Драйвер поддерживает некоторый низкоуровневый интерфейс, с помощью которого можно управлять платой без использования промежуточной DLL библиотеки. Все обращения к драйверу выполняются посредством вызова стандартной функции DeviceIoControl с передачей ей соответствующих параметров. Предварительно драйвер должен быть открыт с помощью CreateFile. При завершении работы с драйвером необходимо вызвать CloseHandle.
Еще не написано. См. исходники библиотеки, если есть необходимость.
Библиотека функций создана для того, чтобы упростить связь приложений с драйверами. Ниже приведен полный список функций поддерживаемых библиотекой - фактически это файл ifc_ldev.h. Работа с библиотекой построена на принципах COM-интерфейса, но это не COM в полном смысле этого слова. Для всех плат функции имеют одно и тоже название. Те из них, которые не поддерживаются конкретной платой, возвращают статус L_NOTSUPPOTRED. Трактовка параметров в некоторых функциях различается для конкретных типов плат, о чем написано в описании функции.
struct LUnknown { IFC(HRESULT) QueryInterface(const IID& iid, void** ppv) = 0; IFC(ULONG) AddRef() = 0; IFC(ULONG) Release() = 0; }; struct IDaqLDevice:LUnknown { IFC(ULONG) inbyte ( ULONG offset, PUCHAR data, ULONG len=1, ULONG key=0) = 0; IFC(ULONG) inword ( ULONG offset, PUSHORT data, ULONG len=2, ULONG key=0) = 0; IFC(ULONG) indword( ULONG offset, PULONG data, ULONG len=4, ULONG key=0) = 0; IFC(ULONG) outbyte ( ULONG offset, PUCHAR data, ULONG len=1, ULONG key=0) = 0; IFC(ULONG) outword ( ULONG offset, PUSHORT data, ULONG len=2, ULONG key=0) = 0; IFC(ULONG) outdword( ULONG offset, PULONG data, ULONG len=4, ULONG key=0) = 0; IFC(ULONG) inmbyte ( ULONG offset, PUCHAR data, ULONG len=1, ULONG key=0) = 0; IFC(ULONG) inmword ( ULONG offset, PUSHORT data, ULONG len=2, ULONG key=0) = 0; IFC(ULONG) inmdword( ULONG offset, PULONG data, ULONG len=4, ULONG key=0) = 0; IFC(ULONG) outmbyte ( ULONG offset, PUCHAR data, ULONG len=1, ULONG key=0) = 0; IFC(ULONG) outmword ( ULONG offset, PUSHORT data, ULONG len=2, ULONG key=0) = 0; IFC(ULONG) outmdword( ULONG offset, PULONG data, ULONG len=4, ULONG key=0) = 0; IFC(ULONG) GetWord_DM(USHORT Addr, PUSHORT Data) = 0; IFC(ULONG) PutWord_DM(USHORT Addr, USHORT Data) = 0; IFC(ULONG) PutWord_PM(USHORT Addr, ULONG Data) = 0; IFC(ULONG) GetWord_PM(USHORT Addr, PULONG Data) = 0; IFC(ULONG) GetArray_DM(USHORT Addr, ULONG Count, PUSHORT Data) = 0; IFC(ULONG) PutArray_DM(USHORT Addr, ULONG Count, PUSHORT Data) = 0; IFC(ULONG) PutArray_PM(USHORT Addr, ULONG Count, PULONG Data) = 0; IFC(ULONG) GetArray_PM(USHORT Addr, ULONG Count, PULONG Data) = 0; IFC(ULONG) SendCommand(USHORT Cmd) = 0; IFC(ULONG) PlataTest() = 0; IFC(ULONG) GetSlotParam(PSLOT_PAR slPar) = 0; IFC(HANDLE) OpenLDevice() = 0; IFC(ULONG) CloseLDevice() = 0; IFC(ULONG) SetParametersStream(PDAQ_PAR sp, ULONG *UsedSize, void** Data, void** Sync, ULONG StreamId = L_STREAM_ADC) = 0; IFC(ULONG) RequestBufferStream(ULONG *Size, ULONG StreamId = L_STREAM_ADC) = 0; IFC(ULONG) FillDAQparameters(PDAQ_PAR sp) = 0; IFC(ULONG) InitStartLDevice() = 0; IFC(ULONG) StartLDevice() = 0; IFC(ULONG) StopLDevice() = 0; IFC(ULONG) LoadBios(char *FileName) = 0; IFC(ULONG) IoAsync(PDAQ_PAR sp) =0; IFC(ULONG) ReadPlataDescr(LPVOID pd) = 0; IFC(ULONG) WritePlataDescr(LPVOID pd, USHORT Ena) = 0; IFC(ULONG) ReadFlashWord(USHORT FlashAddress, PUSHORT Data) = 0; IFC(ULONG) WriteFlashWord(USHORT FlashAddress, USHORT FlashWord) = 0; IFC(ULONG) EnableFlashWrite(USHORT Flag) = 0; IFC(ULONG) EnableCorrection(USHORT Ena=1) = 0; IFC(ULONG) GetParameter(ULONG name, PULONG param) = 0; IFC(ULONG) SetParameter(ULONG name, PULONG param) = 0; };
Функция создает объект для конкретного слота. Тип объекта определяется автоматически внутри этой функции.
Описание:
C: LUnknown* CreateInstance(ULONG
Slot);
Pascal: function
CreateInstance(Slot:ULONG): LUnknown;
Параметры:
ULONG Slot - номер слота, для которого создается объект (0,1 ...).
Возвращает:
- указатель на объект типа LUnknown или NULL в случае ошибки.
Реализована:
L7XX L1250 L1221 L305 L264 L1450 E14-440 E14-140 E20-10 E154
Примечание:
Дополнительную информацию о типе ошибки можно получить вызвав
GetLastError. Если она вернула L_ERROR_NOBOARD значит в запрашиваемом
слоте нет платы. L_ERROR_INUSE - плата в этом слоте уже используется
кем-то. L_ERRROR - возвращается когда невозможно создать объект.
L_NOTSUPPORTED - если в слоте установлена плата, которая не
поддерживается этой библиотекой. Пример использования этой функции
при сканировании слотов см. L1221.DSK.
После вызова CreateInstance
надо вызвать QueryInteface для получения указателя на интерфейс с
которым дальше работать.
Общий принцип работы с библиотекой:
Загрузить библиотеку с помощью LoadLibrary.
Создать объект, связанный с конкретным виртуальным слотом при помощи вызова CreateInstance.
Получить указатель на интерфейс вызвав QueryInterface
Далее вызывать функции этого интерфейса.
Виртуальные слоты это собственно порядковые числа в названиях линков драйверов. Начинаются с 0 и так далее по порядку. Разделения на ISA,PCI или USB платы нет. Причем определить, что за плата соответствует конкретному слоту, можно только открыв его и прочитав информацию GetSlotParam и ReadPlataDescr (+ для L1450, E440, E2010 предварительно надо загрузить плату). GetSlotParam даст информацию о типе платы и назначенных ей ресурсах. Далее для PCI плат более подробную информацию даст ReadPlataDescr. Для L-1450, E440, E2010 также можно вызвать ReadPlataDescr, но предварительно в нее надо загрузить БИОС. Вызов ReadPlataDescr обязателен перед началом конфигурирования сбора данных поскольку там содержится информация о частоте кварца необходимая при расчетах временных параметров сбора данных. Также там хранятся калибровочный коэффициенты.
Для одной платы начало работы выглядит примерно так:
Файл create.h
#ifndef __TEST__ #define __TEST__ typedef IDaqLDevice* (*CREATEFUNCPTR)(ULONG Slot); ULONG CallCreateInstance(char* name); extern CREATEFUNCPTR CreateInstance; #endif
Файл create.cpp
#include <windows.h> #include <objbase.h> #include "..\include\ioctl.h" #include "..\include\ifc_ldev.h" #include "..\include\create.h" CREATEFUNCPTR CreateInstance; ULONG CallCreateInstance(char* name) { HINSTANCE hComponent = ::LoadLibrary(name); if(hComponent==NULL) { return 0; } CreateInstance = (CREATEFUNCPTR)::GetProcAddress(hComponent,"CreateInstance"); if(CreateInstance==NULL) { return 0; } return 1; }
Где-то в Вашем проекте (в компьютере одна плата L-783):
ULONG slot = 0; trace("Get IUnknown pointer"); CallCreateInstance("lcomp.dll"); LUnknown* pIUnknown = CreateInstance(slot); if(pIUnknown == NULL) { trace("CallCreateInstance failed"); return 1; } trace("Get IDaqLDevice interface"); IDaqLDevice* pI; HRESULT hr = pIUnknown->QueryInterface(IID_ILDEV,(void**)&pI); if(!SUCCEEDED(hr)) { trace("Get IDaqLDevice failed"); return 1; } trace("IDaqLDevice get success"); trace("Free IUnknown"); pIUnknown->Release(); pI->OpenLDevice(); // начало работы с платой pI->LoadBios("l783"); ... pI->CloseLDevice(); // завершение работы pI->Release();
Подробнее - смотрите примеры.
Общий принцип работы с библиотекой:
Загрузить библиотеку с помощью LoadLibrary.
Создать объект, связанный с конкретным виртуальным слотом при помощи вызова CreateInstance.
Получить указатель на интерфейс, вызвав QueryInterface
Далее вызывать функции этого интерфейса.
Виртуальные слоты это собственно порядковые числа в названиях линков драйверов. Начинаются с 0 и так далее по порядку. Разделения на ISA,PCI или USB платы нет. Причем определить, что за плата соответствует конкретному слоту, можно только открыв его и прочитав информацию GetSlotParam и ReadPlataDescr (+ для L1450, E440, E2010 предварительно надо загрузить плату). GetSlotParam даст информацию о типе платы и назначенных ей ресурсах. Далее для PCI плат более подробную информацию даст ReadPlataDescr. Для L-1450, E440, E2010 также можно вызвать ReadPlataDescr, но предварительно в нее надо загрузить БИОС. Вызов ReadPlataDescr обязателен перед началом конфигурирования сбора данных поскольку там содержится информация о частоте кварца необходимая при расчетах временных параметров сбора данных. Также там хранятся калибровочный коэффициенты..
Для одной платы начало работы выглядит примерно так:
Файл create.pas
unit Create; interface uses Windows, ioctl, ifc_ldev; type TCreateInstance = function(Slot:ULONG): LUnknown; cdecl; var hModule: THandle; CreateInstance: TCreateInstance; function CallCreateInstance(name:PChar):ULONG; implementation function CallCreateInstance(name:PChar):ULONG; begin hModule:=0; hModule:=LoadLibrary(name); if(hModule=0) then begin Result:=0; Exit; end; @CreateInstance:=GetProcAddress(hModule,'CreateInstance'); if(@CreateInstance=nil) then begin Result:=0; Exit; end; Result:=1; end; end.
Где-то в Вашем проекте (в компьютере одна плата L-1450):
var pLDev: IDaqLDevice; pIUnknown:LUnknown; hr:Integer; dev: THandle; ... if(CallCreateInstance('lcomp.dll')=1) then begin {сообщение об успехе загрузки библиотеки} end; pIUnknown:=CreateInstance(0); hr := pIUnknown.QueryInterface(IID_ILDEV,pLDev); if(not Succeeded(hr)) then MessageBox(0,'Get interface failed','Error',MB_OK); pIUnknown.Release; dev:=pLDev.OpenLDevice; ... pLDev.CloseLDevice; pLDev.Release;
Подробнее - смотрите примеры.
Эту функцию необходимо вызвать перед началом работы с платой. Функция открывает соответствующий линк драйвера для платы.
Описание:
C: HANDLE OpenLDevice();
Pascal:
function OpenLDevice:THandle;
Параметры:
Возвращает:
HANDLE - в случае успеха (дескриптор для работы с платой);
INVALID_HANDLE_VALUE - в случае ошибки;
Реализована:
L7XX L1250 L1221 L305 L264 L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
Для каждой платы установленной в компьютер драйвер формирует линк по следующему принципу: LDev## (где ## - номер 1..).Номер в названии линка - это виртуальный слот. Номер виртуального слота, для которого будет выполнена функция OpenLDevice, передается как параметр в функции CreateInstance.
Эта функция вызывается при завершении работы с платой.
Описание:
C: ULONG CloseLDevice();
Pascal:
function CloseLDevice:ULONG;
Параметры:
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L1221 L305 L264 L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
После вызова этой функции значение дескриптора устройства больше недействительно и не может использоваться при вызове функций библиотеки. Для платы L791 еще происходит удаление выделенной в функции RequsetBufferStream памяти для буфера ПДП.
Вызов этой функции настраивает плату АЦП/ЦАП на заданные параметры ввода или вывода данных, устанавливает размера кольцевого буфера на плате, задает интервал генерации прерываний (через столько-то точек), передает приложению адреса большого буфера и переменой синхронизации.
Описание:
C: ULONG
SetParametersStream(PDAQ_PAR sp, ULONG *UsedSize, void** Data,
void** Sync, ULONG StreamId);
Pascal:
function SetParametersStream(var sp:DAQ_PAR; var UsedSize:ULONG;
out Data; out Sync; StreamId:ULONG):ULONG;
Параметры:
PDAQ_PAR sp - структура, которая описывает параметры ввода
или вывода данных ( ADC_PAR,DAC_PAR или другая в зависимости от типа
поля s_Type);
ULONG *UsedSize - переменная, в которой
будет возвращено количество реально используемой памяти (в отсчетах
АЦП);
void** Data - переменная, в которой будет возвращен
адрес начала большого буфера;
void** Sync - переменная, в
которой будет возвращен адрес переменной синхронизации;
ULONG
StreamId - дескриптор потока (L_STREAM_ADC, L_STREAM_DAC или
другой);
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PDAQ_PAR sp - структура, которая описывает
параметры ввода или вывода данных. У этой структуры, если она не
NULL, обновляются поля с учетом возможностей платы.
Реализована:
L7XX L1250 L1221 L305 L264 L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
Принцип быстрого и непрерывного ввода или вывода данных с платы в драйверах всегда одинаков. Различается только направление передачи данных. Поэтому было введено понятие потоков данных. Поток создается 3 функциями - RequestBufferStream FullDAQparameters SetParametersStream. Фактически это большой кольцевой буфер и структура, описывающая параметры сбора данных. Поток может быть с АЦП, на ЦАП, на цифровые линии, с цифровых линий или какой-то нестандартный реализованный в драйвере платы. Интерфейс при этом не меняется. Чтобы различать потоки служит переменная StreamId - это некоторая константа, определенная в заголовочных файлах.
Функция служит для выделения памяти под большой кольцевой буфер.
Описание:
C: ULONG
RequestBufferStream(ULONG *Size, ULONG StreamId);
Pascal:
function RequestBufferStream(var Size:ULONG;
StreamId:ULONG):ULONG;
Параметры:
ULONG *Size - размер большого буфера в USHORT;
ULONG
StreamId - дескриптор потока (L_STREAM_ADC, L_STREAM_DAC или
другой);
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Size - возвращается количество реально выделенной
памяти;
Реализована:
L7XX L1250 L1221 L305 L264 L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
Выделяет память в ОЗУ компьютера под большой кольцевой буфер. Память выделяется с выравниванием размера на 4096 байт. Принцип быстрого и непрерывного ввода или вывода данных с платы в драйверах всегда одинаков. Различается только направление передачи данных. Поэтому было введено понятие потоков данных. Поток создается 3 функциями - RequestBufferStream SetParametersStream FullDAQparameters. Фактически это большой кольцевой буфер и структура, описывающая параметры сбора данных. Поток может быть с АЦП, на ЦАП, на цифровые линии, с цифровых линий или какой-то нестандартный реализованный в драйвере платы. Интерфейс при этом не меняется. Чтобы различать потоки служит переменная StreamId - это некоторая константа, определенная в заголовочных файлах.
Для платы L791 выделяется всегда 512*1024 слов. Это буфер отсчетов ЦАП и АЦП - по 128К 32 битных отсчетов соответственно. Удаляется этот буффер при вызове CloseLDevice .
Функция инициализирует внутренние переменные драйвера перед началом сбора.
Описание:
C: ULONG InitStartLDevice();
Pascal: function
InitStartLDevice:ULONG;
Параметры:
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L1221 L305 L264 L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
Надо вызывать перед вызовом функции StartLDevice.
Функция запускает сбор данных с платы в большой кольцевой буфер.
Описание:
C: ULONG StartLDevice();
Pascal:
function StartLDevice:ULONG;
Параметры:
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L1221 L305 L264 L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
После выполнения функции можно переходить к откачиванию данных из буфера. При этом необходимо следить за синхронизацией поступления данных и их откачки.
Функция останавливает сбор данных с платы в большой кольцевой буфер.
Описание:
C: ULONG StopLDevice();
Pascal:
function StopLDevice:ULONG;
Параметры:
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L1221 L305 L264 L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
После остановки данные в буфере соответствуют последним данным, полученным от платы. Их можно обрабатывать любым способом. Необходимо только учитывать, что остановка могла произойти в любом месте этого буфера и гарантировать целостность можно только той части буфера, на готовность которой указывала переменная синхронизации.
Для L791 не следует пытаться разрешить режим BusMaster после выполнения команды StopLDevice. При старте буфер данных блокируется в ОЗУ компьютера, формируется таблица адресов и передается в плату. При остановке блокировка снимается и разрешение на передачу данных вызовет повреждение операционной системы.
Загрузка BIOS в плату.
Описание:
C: ULONG LoadBios(char
*FileName);
Pascal: function
LoadBios(FileName:PChar):ULONG;
Параметры:
char *FileName - имя файла прошивки БИОС без расширения (lbios009);
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L1221 L305 L264 L1450 E14-440 E20-10
Примечание:
В модуль E20-10 загружается прошивка ПЛИС e2010.pld, указывать ее нужно также без расширения. У L791 нет загружаемого БИОСа. E140 также не требует загрузки БИОС.
Читает слово из памяти данных DSP.
Описание:
C: ULONG GetWord_DM(USHORT Addr,
PUSHORT Data);
Pascal: function
GetWord_DM(Addr:USHORT; var Data:USHORT):ULONG;
Параметры:
USHORT Addr - адрес переменной;
PUSHORT Data -
возвращаемые данные;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PUSHORT Data - возвращаемые данные;
Реализована:
L7XX L1250 L305 L264 L1450 L1221 E14-440 E14-140 E154
Примечание:
Записывает слово в память данных DSP.
Описание:
C: ULONG PutWord_DM(USHORT Addr,
USHORT Data);
Pascal: function
PutWord_DM(Addr:USHORT; Data:USHORT):ULONG;
Параметры:
USHORT Addr - адрес переменной;
USHORT Data -
записываемые данные;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L305 L264 L1450 L1221 E14-440 E14-140 E154
Примечание:
Читает слово из памяти программ DSP.
Описание:
C: ULONG GetWord_PM(USHORT Addr,
PULONG Data);
Pascal: function
GetWord_PM(Addr:USHORT; var Data:ULONG):ULONG;
Параметры:
USHORT Addr - адрес переменной;
PULONG Data -
возвращаемые данные;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PULONG Data - возвращаемые данные;
Реализована:
L7XX L1450 L1221 E14-440 E14-140 E154
Примечание:
Читает слово из памяти программ DSP.
Описание:
C: ULONG PutWord_PM(USHORT Addr,
ULONG Data);
Pascal: function
PutWord_PM(Addr:USHORT; Data:ULONG):ULONG;
Параметры:
USHORT Addr - адрес переменной;
ULONG Data -
записываемые данные;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1450 L1221 E14-440 E14-140 E154
Примечание:
Читает массив слов из памяти данных DSP.
Описание:
C: ULONG GetArray_DM(USHORT Addr,
ULONG Count, PUSHORT Data);
Pascal:
function GetArray_DM(Addr:USHORT; Count:ULONG; var
Data:USHORT):ULONG;
Параметры:
USHORT Addr - адрес переменной;
ULONG Count -
размер массива в словах;
PUSHORT Data - возвращаемые
данные;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PUSHORT Data - возвращаемые данные;
Реализована:
L7XX L1450 L1221 E14-440 E14-140 E154
Примечание:
Записывает массив слов в память данных DSP.
Описание:
C: ULONG PutWord_DM(USHORT Addr,
ULONG Count, USHORT Data);
Pascal:
function PutWord_DM(Addr:USHORT; Count:ULONG; Data:USHORT):ULONG;
Параметры:
USHORT Addr - адрес переменной;
ULONG Count -
размер массива в словах;
USHORT Data - записываемые
данные;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1450 L1221 E14-440 E14-140 E154
Примечание:
Читает массив слов из памяти программ DSP.
Описание:
C: ULONG GetArray_PM(USHORT Addr,
ULONG Count, PULONG Data);
Pascal:
function GetArray_PM(Addr:USHORT; Count:ULONG; var
Data:ULONG):ULONG;
Параметры:
USHORT Addr - адрес переменной;
ULONG count -
размер массива в двойных словах;
PULONG Data -
возвращаемые данные;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PULONG Data - возвращаемые данные;
Реализована:
L7XX L1450 L1221 E14-440
Примечание:
Записывает массив слов в память программ DSP.
Описание:
C: ULONG PutArray_PM(USHORT Addr,
ULONG Count, ULONG Data);
Pascal:
function PutArray_PM(Addr:USHORT; Count:ULONG; Data:ULONG):ULONG;
Параметры:
USHORT Addr - адрес переменной;
ULONG Count -
размер массива в двойных словах;
ULONG Data -
записываемые данные;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1450 L1221 E14-440
Примечание:
Посылает выбранную команду DSP.
Описание:
C: ULONG SendCommand(USHORT Cmd)
;
Pascal: function
SendCommand(Cmd:USHORT):ULONG;
Параметры:
USHORT Cmd - код команды;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L264 L305 L1450 L1221 E14-440 E14-140 E154
Примечание:
Тест на наличие платы и успешную загрузку.
Описание:
C: ULONG PlataTest();
Pascal:
function PlataTest:ULONG;
Параметры:
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L1221 L305 L264 L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
Для L791, E14-140 E154и E20-10 это просто заглушка всегда возвращающая успех.
Функция для асинхронных операций ввода/вывода (чтение данных с АЦП, вывод данных на ЦАП, работа с цифровыми линиями).
Описание:
C: ULONG IoAsync(PDAQ_PAR sp);
Pascal: function IoAsync(var
sp:DAQ_PAR):ULONG;
Параметры:
PDAQ_PAR sp - структура с параметрами запроса;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PDAQ_PAR sp - структура с результатами запроса
(если была операция ввода данных);
Реализована:
L7XX L1250 L1221 L305 L264 L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
Эта функция реализует все асинхронные операции ввода/вывода (типа одиночного ввода данных).
Плата L-1450
Для ввода одного отсчета с АЦП надо заполнить структуру ASYNC_PAR так:
s_Type -L_ASYNC_ADC_INP
Chn[0]
- логический номер канала;
Результат в Data[0].
Для вывода одного отсчета на TTL линии:
s_Type
-L_ASYNC_TTL_OUT
Data[0] - данные для вывода;
Для ввода одного отсчета с TTL линий:
s_Type
-L_ASYNC_TTL_INP
Data[0] - введенные данные;
Разрешить/запретить цифровые линии:
s_Type -L_ASYNC_TTL_CFG
Mode
- (0/1);
Для вывода одного отсчета на ЦАП:
s_Type -L_ASYNC_DAC_OUT
Mode
- (0/1) номер ЦАП;
Data[0] - данные для ЦАП;
Платы L-1250/L-264/L-305/L-1620
Для ввода одного отсчета с АЦП надо заполнить структуру ASYNC_PAR так:
s_Type -L_ASYNC_ADC_INP
Chn[0]
- логический номер канала;
Результат в Data[0].
Для вывода одного отсчета на TTL линии:
s_Type
-L_ASYNC_TTL_OUT
Data[0] - данные для вывода;
Mode
- (0 - for multiplexer ttl(SETCHANNEL in fact))/( 1- dsp out)
Для ввода одного отсчета с TTL линий:
s_Type -L_ASYNC_TTL_INP
Mode
- (0 - прямые линии)/(1 - линии через DSP)
Data[0] -
введенные данные;
Для вывода одного отсчета на ЦАП:
s_Type -L_ASYNC_DAC_OUT
Mode
- (0 - синхронный/1 - асинхронный) вывод на ЦАП;
Data[0]
- данные для ЦАП;
Для установки номера ЦАП и режима вывода:
s_Type -L_ASYNC_DAC_CFG
Mode
- (0 - выкл режим одновременного вывода )(1 - вкл режим
одновременного вывода на ЦАП со вводом с АЦП);
Chn[0] -
номер ЦАП(0/1);
Плата L-1221
Для ввода одного отсчета с АЦП надо заполнить структуру ASYNC_PAR так:
s_Type -L_ASYNC_ADC_INP
Chn[0]
- логический номер канала;
Результат в Data[0].
Для вывода одного отсчета на TTL линии:
s_Type
-L_ASYNC_TTL_OUT
Data[0] - данные для вывода;
Для ввода одного отсчета с TTL линий:
s_Type
-L_ASYNC_TTL_INP
Data[0] - введенные данные;
Для настройки цифровых линий:
s_Type -L_ASYNC_TTL_CFG
Mode
- маска направлений (0XXX 0000)
Платы L-761/L-780/L-783
Для ввода одного отсчета с АЦП надо заполнить структуру ASYNC_PAR так:
s_Type -L_ASYNC_ADC_INP
Chn[0]
- логический номер канала;
Результат в Data[0].
Для вывода одного отсчета на TTL линии:
s_Type
-L_ASYNC_TTL_OUT
Data[0] - данные для вывода;
Для ввода одного отсчета с TTL линий:
s_Type
-L_ASYNC_TTL_INP
Data[0] - введенные данные;
Для вывода одного отсчета на ЦАП:
s_Type -L_ASYNC_DAC_OUT
Mode
- номер ЦАП (0/1);
Data[0] - данные для ЦАП;
Разрешить/запретить цифровые линии: (только L780C)
s_Type -L_ASYNC_TTL_CFG
Mode
- (0/1);
Платы L-791
Для ввода одного отсчета с АЦП надо заполнить структуру ASYNC_PAR так:
s_Type -L_ASYNC_ADC_INP
Chn[0]
- логический номер канала;
Результат в Data[0].
Для вывода отсчета на ЦАП надо заполнить структуру ASYNC_PAR так:
s_Type -L_ASYNC_DAC_OUT
Chn[0] -(0/1) выводить на 0 канал
Chn[1] -(0/1) выводить на 1 канал
Data[0] — данные для 0 канала
Data[1] — данные для 1 канала
Для вывода одного отсчета на TTL линии:
s_Type
-L_ASYNC_TTL_OUT
Data[0] - данные для вывода;
Для ввода одного отсчета с TTL линий:
s_Type
-L_ASYNC_TTL_INP
Data[0] - введенные данные;
Разрешить/запретить цифровые линии:
s_Type -L_ASYNC_TTL_CFG
Mode
– (0/1) разрешить/запретить цифровые линии;
Модуль E440
Для ввода одного отсчета с АЦП надо заполнить структуру ASYNC_PAR так:
s_Type -L_ASYNC_ADC_INP
Chn[0]
- логический номер канала;
Результат в Data[0].
Для вывода одного отсчета на TTL линии:
s_Type
-L_ASYNC_TTL_OUT
Data[0] - данные для вывода;
Для ввода одного отсчета с TTL линий:
s_Type
-L_ASYNC_TTL_INP
Data[0] - введенные данные;
Для вывода одного отсчета на ЦАП:
s_Type -L_ASYNC_DAC_OUT
Mode
- номер ЦАП (0/1);
Data[0] - данные для ЦАП;
Разрешить/запретить цифровые линии:
s_Type
-L_ASYNC_TTL_CFG
Mode - (0/1);
Модуль E140
Для ввода одного отсчета с АЦП надо заполнить структуру ASYNC_PAR так:
s_Type -L_ASYNC_ADC_INP
Chn[0]
- логический номер канала;
Результат в Data[0].
Для вывода одного отсчета на TTL линии:
s_Type
-L_ASYNC_TTL_OUT
Data[0] - данные для вывода;
Для ввода одного отсчета с TTL линий:
s_Type
-L_ASYNC_TTL_INP
Data[0] - введенные данные;
Для вывода одного отсчета на ЦАП:
s_Type -L_ASYNC_DAC_OUT
Mode
- номер ЦАП (0/1);
Data[0] - данные для ЦАП;
Разрешить/запретить цифровые линии:
s_Type
-L_ASYNC_TTL_CFG
Mode - (0/1);
Модуль E2010
Для вывода одного отсчета на TTL линии:
s_Type
-L_ASYNC_TTL_OUT
Data[0] - данные для вывода;
Для ввода одного отсчета с TTL линий:
s_Type
-L_ASYNC_TTL_INP
Data[0] - введенные данные;
Для вывода одного отсчета на ЦАП:
s_Type -L_ASYNC_DAC_OUT
Mode
- номер ЦАП (0/1);
Data[0] - данные для ЦАП;
Разрешить/запретить цифровые линии:
s_Type
-L_ASYNC_TTL_CFG
Mode - (0/1);
Модуль E154
Для ввода одного отсчета с АЦП надо заполнить структуру ASYNC_PAR так:
s_Type -L_ASYNC_ADC_INP
Chn[0]
- логический номер канала;
Результат в Data[0].
Для вывода одного отсчета на TTL линии:
s_Type
-L_ASYNC_TTL_OUT
Data[0] - данные для вывода;
Для ввода одного отсчета с TTL линий:
s_Type
-L_ASYNC_TTL_INP
Data[0] - введенные данные;
Для вывода одного отсчета на ЦАП:
s_Type
-L_ASYNC_DAC_OUT
Data[0] - данные для ЦАП;
Разрешить/запретить цифровые линии:
s_Type
-L_ASYNC_TTL_CFG
Mode - (0/1);
Включает/выключает режим коррекции. Сама загружает коэффициенты в плату.
Описание:
C: ULONG EnableCorrection(USHORT
Ena=1);
Pascal: function
EnableCorrection(Ena:USHORT):ULONG;
Параметры:
USHORT Ena - новое значение переменной разрешения/запрещения коррекции (1/0);
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1450 L1221 E14-440
Примечание:
Заполняет внутреннюю структуру параметров сбора данных значениями из структуры ADC_PAR,DAC_PAR или другой в зависимости от типа поля s_Type.
Описание:
C: ULONG
FillDAQparameters(PDAQ_PAR sp);
Pascal:
function FillDAQparameters(var sp:DAQ_PAR):ULONG;
Параметры:
PDAQ_PAR sp - структура с параметрами сбора данных;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PDAQ_PAR sp - в структуре обновлены поля
Rate,Kadr,NCh с учетом возможностей платы.
Реализована:
L7XX L1250 L305 L264 L1450 L1221 L791 E14-440 E14-140 E20-10 E154
Примечание:
Чтение пользовательского Flash.
Описание:
C: ReadPlataDescr(LPVOID pd);
Pascal: function
ReadPlataDescr(var pd):ULONG;
Параметры:
LPVOID pd - указатель на структуру PLATA_DESCR_U;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
LPVOID pd - указатель на заполненную структуру
PLATA_DESCR_U;
Реализована:
L7XX L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
Для каждой платы определены свои частные структуры флеша и для удобства они сгруппированы в union PLATA_DESCR_U/U2. U2 появился из-за модуля E2010 у которого флеш больше. Внутри библиотеки все хранится в union PLATA_DESCR_U2.
Запись пользовательского Flash.
Описание:
C: ULONG WritePlataDescr(LPVOID
pd, USHORT Ena);
Pascal:
function WritePlataDescr(var pd; Ena:USHORT):ULONG;
Параметры:
LPVOID pd - указатель на структуру PLATA_DESCR_U;
USHORT
Ena - разрешение(1) / запрещение(0) записи служебной части
пользовательского Flash;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
Чтение слова из пользовательского Flash.
Описание:
C: ULONG ReadFlashWord(USHORT
FlashAddress, PUSHORT Data);
Pascal:
function ReadFlashWord(FlashAddress:USHORT; var
Data:USHORT):ULONG;
Параметры:
USHORT FlashAddress - адрес, с которого читать;
PUSHORT
Data - прочитанное слово;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PUSHORT Data - прочитанное слово;
Реализована:
L7XX L1450 L1221 L791 E14-440 E14-140
Примечание:
Для L1221 и L791 читает байт. Старший байт слова не используется.
Запись слова в пользовательский Flash.
Описание:
C: ULONG WriteFlashWord(USHORT
FlashAddress, USHORT Data);
Pascal:
function WriteFlashWord(FlashAddress:USHORT; Data:USHORT):ULONG;
Параметры:
USHORT FlashAddress - адрес, по которому писать;
USHORT
Data - записываемое слово;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1450 L1221 L791 E14-440 E14-140
Примечание:
Для L1221 записывает младший байт из слова. Для L791 записывает младший байт из слова в буфер микросхемы. Реальная запись происходит по команде EnableFlashWrite в указанную страницу.
Разрешение записи в пользовательский Flash.
Описание:
C: ULONG EnableFlashWrite(USHORT
Flag);
Pascal: function
EnableFlashWrite(Flag:USHORT):ULONG;
Параметры:
USHORT Flag - разрешение (1) / запрещение (0) записи во Flash;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
Для платы L791 Flag это номер страницы в которую будут записаны данные из буфера микросхемы. 0 - это страница со структурой PLATA_DESCR.
Функция служит для считывания разнообразных параметров с платы. Замещает некоторые простые функции из старых API.
Описание:
C: ULONG GetParameter(ULONG name,
PULONG param);
Pascal: function
GetParameter(name:ULONG; var param:ULONG):ULONG;
Параметры:
ULONG name - условное название параметра (см примечание);
PULONG param - значение параметра;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PULONG param - значение параметра;
Реализована:
L1221 L1250 L264 L305
Примечание:
Для 1221 есть следующие параметры:
L1221_EXT_COUNTER - считать значение внешнего счетчика (ячейки 0x3D5C 0x3D5B);
L1221_OVERFLOW - считать значение ячейки переполнения (0x3D4E);
L1221_BIT_RES - считать ячейку с разрядностью АЦП (0x3D58);
Для 1250/264/305:
L1251_MEM_STATE - возвращает размер установленной внешней памяти данных: 0 - нет; 1 - 8К; 2 - 32К; 3 - 128К;
L1251_MEM_PM_STATE - тестирует наличие внешней памяти программ на плате: 0 - нет; 1 - есть;
Функция служит для записи разнообразных параметров в плату. Замещает некоторые простые функции из старых API.
Описание:
C: ULONG SetParameter(ULONG name,
PULONG param);
Pascal: function
SetParameter(name:ULONG; var param:ULONG):ULONG;
Параметры:
ULONG name - условное название параметра (см примечание);
PULONG param - значение параметра;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PULONG param - значение параметра;
Реализована:
L1221
Примечание:
Для 1221 есть следующие параметры:
L1221_BIT_RES - считать ячейку с разрядностью АЦП (0x3D58);
Функция служит для установки события в драйвере. Работа события облегчает ожидание готовности данных от платы при однократном заполнении буфера. Также позволяет более удобно получать информацию о других процессах в плате.
Описание:
C: ULONG SetLDeviceEvent(HANDLE
hEvent, ULONG EventId=L_EVENT_ADC);
Pascal:
function SetParameter(hEvent:THandle; EventId:ULONG):ULONG;
Параметры:
ULONG hEvent - условное название параметра (см
примечание);
ULONG EventId – идентификатор события
на который установлен event;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L1221 L305 L264 L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
Для EventId есть следующие значения:
L_EVENT_ADC_BUF 1 – событие по заполнении буфера АЦП:
L_EVENT_DAC_BUF 2 - событие при работе с буфером ЦАП (L1450, L780M):
L_EVENT_ADC_OVF 3 - L791 -см описание по генерации прерываний от платы;
L_EVENT_ADC_FIFO 4 - L791 -см описание по генерации прерываний от платы;
L_EVENT_DAC_USER 5 - L791 -см описание по генерации прерываний от платы;
L_EVENT_DAC_UNF 6 - L791 -см описание по генерации прерываний от платы;
L_EVENT_PWR_OVR 7 - L791 -см описание по генерации прерываний от платы;
Функция возвращает информацию для указанного виртуального слота.
Описание:
C: ULONG GetSlotParam(PSLOT_PAR
slPar);
Pascal: function
GetSlotParam(var slPar:SLOT_PAR):ULONG;
Параметры:
PSLOT_PAR slPar - переменная, в которой будут возвращены параметры;
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PSLOT_PAR slPar - параметры установленные для
данного слота;
Реализована:
L7XX L1250 L1221 L305 L264 L1450 L791 E14-440 E14-140 E20-10 E154
Примечание:
Ввод байта из I/O порта.
Описание:
C: ULONG inbyte ( ULONG offset,
PUCHAR data, ULONG len=1, ULONG key=0);
Pascal:
function inbyte (offset:ULONG; var data:UCHAR; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PUCHAR data - массив, в который будут занесены
прочитанные данные;
ULONG len - размер массива в байтах;
ULONG key - номер региона ( фактически выбирает базовый
адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PUCHAR data - прочитанные данные;
Реализована:
L7XX L1221 L1250 L264 L305 L1450
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Ввод слова из I/O порта.
Описание:
C: ULONG inword ( ULONG offset,
PUSHORT data, ULONG len=2, ULONG key=0);
Pascal:
function inword (offset:ULONG; var data:USHORT; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PUSHORT data - массив, в который будут занесены
прочитанные данные;
ULONG len - размер массива в байтах;
ULONG key - номер региона ( фактически выбирает базовый
адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PUSHORT data - прочитанные данные;
Реализована:
L7XX L1221 L1250 L264 L305 L1450
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например, при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Ввод двойного слова из I/O порта.
Описание:
C: ULONG indword ( ULONG offset,
PULONG data, ULONG len=4, ULONG key=0);
Pascal:
function indword (offset:ULONG; var data:ULONG; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PULONG data - массив, в который будут занесены
прочитанные данные;
ULONG len - размер массива в байтах;
ULONG key - номер региона ( фактически выбирает базовый
адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PULONG data - прочитанные данные;
Реализована:
L7XX L1221 L1250 L264 L305 L1450
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например, при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Вывод байта в I/O порт.
Описание:
C: ULONG outbyte ( ULONG offset,
PUCHAR data, ULONG len=1, ULONG key=0);
Pascal:
function outbyte (offset:ULONG; var data:UCHAR; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PUCHAR data - массив данных;
ULONG len -
размер массива в байтах;
ULONG key - номер региона (
фактически выбирает базовый адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L1221 L305 L264 L1450
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например, при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Вывод слова в I/O порт.
Описание:
C: ULONG outword ( ULONG offset,
PUSHORT data, ULONG len=1, ULONG key=0);
Pascal:
function outword (offset:ULONG; var data:USHORT; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PUSHORT data - массив данных;
ULONG len -
размер массива в байтах;
ULONG key - номер региона (
фактически выбирает базовый адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L1221 L305 L264 L1450
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например, при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Вывод двойного слова в I/O порт.
Описание:
C: ULONG outdword ( ULONG offset,
PULONG data, ULONG len=1, ULONG key=0);
Pascal:
function outdword (offset:ULONG; var data:ULONG; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PULONG data - массив данных;
ULONG len -
размер массива в байтах;
ULONG key - номер региона (
фактически выбирает базовый адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L1250 L1221 L305 L264 L1450
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например, при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Ввод байта из памяти.
Описание:
C: ULONG inmbyte ( ULONG offset,
PUCHAR data, ULONG len=1, ULONG key=0);
Pascal:
function inmbyte (offset:ULONG; var data:UCHAR; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PUCHAR data - массив, в который будут занесены
прочитанные данные;
ULONG len - размер массива в байтах;
ULONG key - номер региона ( фактически выбирает базовый
адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PUCHAR data - прочитанные данные;
Реализована:
L7XX L791
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например, при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Ввод слова из памяти.
Описание:
C: ULONG inmword ( ULONG offset,
PUSHORT data, ULONG len=1, ULONG key=0);
Pascal:
function inmword (offset:ULONG; var data:USHORT; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PUSHORT data - массив, в который будут занесены
прочитанные данные;
ULONG len - размер массива в байтах;
ULONG key - номер региона ( фактически выбирает базовый
адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PUSHORT data - прочитанные данные;
Реализована:
L7XX L791
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например, при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Ввод двойного слова из памяти.
Описание:
C: ULONG inmdword ( ULONG offset,
PULONG data, ULONG len=1, ULONG key=0);
Pascal:
function inmdword (offset:ULONG; var data:ULONG; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PULONG data - массив, в который будут занесены
прочитанные данные;
ULONG len - размер массива в байтах;
ULONG key - номер региона ( фактически выбирает базовый
адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
PULONG data - прочитанные данные;
Реализована:
L7XX L791
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например, при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Вывод байта в память.
Описание:
C: ULONG outmbyte ( ULONG offset,
PUCHAR data, ULONG len=1, ULONG key=0);
Pascal:
function outmbyte (offset:ULONG; var data:UCHAR; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PUCHAR data - массив данных;
ULONG len -
размер массива в байтах;
ULONG key - номер региона (
фактически выбирает базовый адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L791
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например, при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Вывод слова в память.
Описание:
C: ULONG outmword ( ULONG offset,
PUSHORT data, ULONG len=1, ULONG key=0);
Pascal:
function outmword (offset:ULONG; var data:USHORT; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PUSHORT data - массив данных;
ULONG len -
размер массива в байтах;
ULONG key - номер региона (
фактически выбирает базовый адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
-
Реализована:
L7XX L791
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например, при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Вывод двойного слова в память.
Описание:
C: ULONG outmdword ( ULONG
offset, PULONG data, ULONG len=1, ULONG key=0);
Pascal:
function outmdword (offset:ULONG; var data:ULONG; len:ULONG;
key:ULONG ):ULONG;
Параметры:
ULONG offset - смещение порта относительно базового
адреса;
PULONG data - массив данных;
ULONG len -
размер массива в байтах;
ULONG key - номер региона (
фактически выбирает базовый адрес из списка возможных );
Возвращает:
L_SUCCESS - в случае успеха;
L_ERROR - в случае
ошибки;
Реализована:
L7XX L791
Примечание:
В данной реализации нет проверки выхода смещения за разрешенную границу. Про key. У некоторых плат есть несколько регионов портов ввода/вывода. Для переключения между ними и служит этот параметр. Например, при key=0 для L7XX будет осуществляться доступ к служебным регистрам PLX, а при key=1 к DSP(те работа через порты, а не память). В стандартных драйверах этот параметр не задействован и должен быть всегда равен 0.
Это обобщенная структура для удобства работы со структурами задачи параметров сбора данных разных плат.
Описание:
C:
typedef union _ADC_PARAM_U_ : {
ADC_PAR_0 t1; ADC_PAR_1 t2;
} ADC_PAR, *PADC_PAR;
Параметры:
Примечание:
Структура служит для передачи параметров сбора данных в плату. Заполняется пользователем и передается в драйвер где и хранится.
Описание:
C:
typedef struct _ADC_PARAM_U_0 : public DAQ_PAR { // ULONG s_Type; // ULONG FIFO; // ULONG IrqStep; // ULONG Pages; ULONG AutoInit; double dRate; double dKadr; double dScale; * ULONG Rate; * ULONG Kadr; * ULONG Scale; * ULONG FPDelay ULONG SynchroType; ULONG SynchroSensitivity; ULONG SynchroMode; ULONG AdChannel; ULONG AdPorog; ULONG NCh; ULONG Chn[128]; ULONG IrqEna; ULONG AdcEna; } ADC_PAR_0, *PADC_PAR_0;
Параметры:
ULONG s_Type - тип структуры (должен быть L_ADC_PARAM);
ULONG AutoInit - флаг указывающий на тип сбора данных 0 -
однократный 1 - циклический;
double dRate - частота
опроса каналов в кадре (кГц);
double dKadr - интервал
между кадрами (мс);
double dScale - масштаб работы
таймера для 1250 или делителя для 1221;
ULONG Rate -
частота опроса каналов в кадре (в кодах для процессора, вычисляется
библиотекой);
ULONG Kadr - интервал между кадрами (в
кодах для процессора, вычисляется библиотекой);
ULONG Scale -
масштаб работы таймера для 1250 или делителя для 1221 (в кодах для
процессора, вычисляется библиотекой);
ULONG FPDelay -
служебная величина задержки выдачи первого отсчета (вычисляется
библиотекой);
ULONG SynchroType - тип синхронизации;
ULONG SynchroSensitivity - вид синхронизации;
ULONG
SynchroMode - режим синхронизации;
ULONG AdChannel -
канал, по которому выполняется синхронизация;
ULONG AdPorog -
уровень синхронизации;
ULONG NCh - количество
опрашиваемых каналов ;
ULONG Chn[128] - массив с номерами
каналов и усилением на них; описывает порядок опроса каналов;
ULONG
FIFO - размер половины аппаратного буфера FIFO на плате;
ULONG
IrqStep - шаг генерации прерываний;
ULONG Pages -
размер кольцевого буфера в шагах прерываний;
ULONG IrqEna -
разрешение генерации прерывания от платы (1/0);
ULONG AdcEna
- разрешение работы АЦП (1/0);
Примечание:
Структура ADC_PAR используется совместно с вызовом FillDAQparameters для настройки параметров ввода данных с платы АЦП. Поля отмеченные комментарием (//) наследуются из структуры DAQ_PAR. Пользователь должен заполнять все поля кроме тех, которые помечены (*). Особенности трактовки полей этой структуры для различных плат:
L-761/780/783
s_Type - должен быть L_ADC_PARAM;
AutoInit - (0 - однократное заполнение большого буфера и если установлено событие в функции SetLDeviceEvent, то произойдет генерация события)/( 1 циклическое заполнение буфера);
dRate - частота опроса каналов в кадре в килогерцах;
dKadr - интервал между кадрами в миллисекундах, фактически определяет скорость сбора данных;
SynchroType
0 - цифровая синхронизация старта, остальные параметры синхронизации не используются;
1 – по-кадровая синхронизация, остальные параметры синхронизации не используются;
2 – аналоговая синхронизация старта по выбранному каналу АЦП;
3 – нет синхронизации;
SynchroSensitivity
0 – аналоговая синхронизация по уровню;
1 – аналоговая синхронизация по переходу;
SynchroMode
0 – по уровню «выше» или переходу «снизу-вверх»;
1 - по уровню «ниже» или переходу «сверху-вниз»;
AdChannel - канала, выбранный для аналоговой синхронизации;
AdPorog - пороговое значение для аналоговой синхронизации в коде АЦП;
Nch – количество опрашиваемых в кадре каналов;
Chn – массив с логическими номерами каналов, слово вида 00000000 XXXXXXXX;
№ бита |
Обозначение |
Назначение |
0 |
MA0 |
0 бит номера |
1 |
MA1 |
1 бит номера |
2 |
MA2 |
2 бит номера |
3 |
MA3 |
3 бит номера |
4 |
MA4 |
«0»/ 4 бит |
5 |
MA5 |
16 диф/32 общ |
6 |
GS0 |
0 бит усил. |
7 |
GS1 |
1 бит усил. |
MA5=MA4=0, MA3-MA0 – номер диф. канала.
MA5=0 MA4=1 – калибровка нуля.
MA5=1 MA4-MA0 – номер входа с общей землей.
GS0 GS1= {00, 01, 10, 11} - усиление {1, 4, 16, 64} для 780/761 и {1, 2, 4, 8} для 783.
L-1450
s_Type - должен быть L_ADC_PARAM;
AutoInit - (0 - однократное заполнение большого буфера и если установлено событие в функции SetLDeviceEvent, то произойдет генерация события)/( 1 циклическое заполнение буфера);
dRate - частота опроса каналов в кадре в килогерцах;
dKadr - интервал между кадрами в миллисекундах, фактически определяет скорость сбора данных;
SynchroType
0 - цифровая синхронизация старта, остальные параметры синхронизации не используются;
1 – по-кадровая синхронизация, остальные параметры синхронизации не используются;
2 – аналоговая синхронизация старта по выбранному каналу АЦП;
3 – нет синхронизации;
SynchroSensitivity
0 – аналоговая синхронизация по уровню;
1 – аналоговая синхронизация по переходу;
SynchroMode
0 – по уровню «выше» или переходу «снизу-вверх»;
1 - по уровню «ниже» или переходу «сверху-вниз»;
AdChannel - канала, выбранный для аналоговой синхронизации;
AdPorog - пороговое значение для аналоговой синхронизации в коде АЦП;
Nch – количество опрашиваемых в кадре каналов;
Chn – массив с логическими номерами каналов, слово вида 00000000 XXXXXXXX;
№ бита |
Обозначение |
Назначение |
0 |
MA0 |
0 бит номера |
1 |
MA1 |
1 бит номера |
2 |
MA2 |
2 бит номера |
3 |
MA3 |
3 бит номера |
4 |
MA4 |
«0»/ 4 бит |
5 |
MA5 |
16 диф/32 общ |
6 |
GS0 |
0 бит усил. |
7 |
GS1 |
1 бит усил. |
MA5=MA4=0, MA3-MA0 – номер диф. канала.
MA5=0 MA4=1 – калибровка нуля.
MA5=1 MA4-MA0 – номер входа с общей землей.
GS0 GS1= {00, 01, 10, 11} - усиление {1, 4, 16, 64}.
E14-440/E14-140/E154
s_Type - должен быть L_ADC_PARAM;
AutoInit - (0 - однократное заполнение большого буфера и если установлено событие в функции SetLDeviceEvent, то произойдет генерация события)/( 1 циклическое заполнение буфера);
dRate - частота опроса каналов в кадре в килогерцах;
dKadr - интервал между кадрами в миллисекундах, фактически определяет скорость сбора данных;
SynchroType
0 – нет синхронизации;
1 - цифровая синхронизация старта, остальные параметры синхронизации не используются;
2 – по-кадровая синхронизация, остальные параметры синхронизации не используются;
3 – аналоговая синхронизация старта по выбранному каналу АЦП;
для E140 сюда еще можно добавить биты 6 и 7, 6 бит включает внешний clock, 7 бит разрешает трансляцию clock на внешний разъем
SynchroSensitivity
0 – аналоговая синхронизация по уровню;
1 – аналоговая синхронизация по переходу;
SynchroMode
0 – по уровню «выше» или переходу «снизу-вверх»;
1 - по уровню «ниже» или переходу «сверху-вниз»;
AdChannel - канала, выбранный для аналоговой синхронизации;
AdPorog - пороговое значение для аналоговой синхронизации в коде АЦП;
Nch – количество опрашиваемых в кадре каналов;(для E154 макс. 16)
Chn – массив с логическими номерами каналов, слово вида 00000000 XXXXXXXX;
№ бита |
Обозначение |
Назначение |
0 |
MA0 |
0 бит номера |
1 |
MA1 |
1 бит номера |
2 |
MA2 |
2 бит номера |
3 |
MA3 |
3 бит номера |
4 |
MA4 |
«0»/ 4 бит |
5 |
MA5 |
16 диф/32 общ |
6 |
GS0 |
0 бит усил. |
7 |
GS1 |
1 бит усил. |
MA5=MA4=0, MA3-MA0 – номер диф. канала.
MA5=0 MA4=1 – калибровка нуля.
MA5=1 MA4-MA0 – номер входа с общей землей.
GS0 GS1= {00, 01, 10, 11} - усиление {1, 4, 16, 64} .
L-1250/51/L-1450C/L-305/L-264:
NCh - количество каналов (максимум 32);
IrqStep - должен быть равен FIFO т.к. плата может работать только по половинкам фифо буфера;
SynchroType - тип синхронизации (SMode по описанию DOS);
SynchroMode - режим синхронизации (TtlMask по описанию DOS);
L-1221:
dRate - частота опроса на каждом канале.
NCh - битовая маска активных каналов (10101010 for example);
Chn[32] - первые 8 членов задают усиление на соответствующих каналах;
Структура служит для передачи параметров сбора данных в плату. Заполняется пользователем и передается в драйвер где и хранится.
Описание:
C:
typedef struct _ADC_PARAM_U_1 : public DAQ_PAR { // ULONG s_Type; // ULONG FIFO; // ULONG IrqStep; // ULONG Pages; ULONG AutoInit; double dRate; double dKadr; ULONG Reserved1; ULONG DM_Ena; * ULONG Rate; * ULONG Kadr; ULONG StartCnt; ULONG StopCnt; ULONG SynchroType; ULONG SynchroMode; ULONG AdPorog; ULONG SynchroSrc; ULONG AdcIMask; ULONG NCh; ULONG Chn[128]; ULONG IrqEna; ULONG AdcEna; } ADC_PAR_1, *PADC_PAR_1;
Параметры:
ULONG s_Type - тип структуры (должен быть L_ADC_PARAM);
ULONG AutoInit - флаг указывающий на тип сбора данных 0 -
однократный 1 - циклический;
double dRate - частота
опроса каналов в кадре (кГц);
double dKadr - интервал
между кадрами (мс);
ULONG Reserved1 –
зарезервировано;
ULONG DM_Ena - разрешение/запрещение маркировки данных
ULONG Rate - частота опроса каналов в кадре (в кодах для
цифрового автомата);
ULONG Kadr - интервал между кадрами
(в кодах для цифрового автомата);
ULONG StartCnt –
задержка старта в кадрах;
ULONG StopCnt — сколько
кадров собирать после старта;
ULONG SynchroType - тип
синхронизации;
ULONG SynchroMode – режим
синхронизации и номер канала;
ULONG AdPorog — порог
синхронизации;
ULONG SynchroSrc – источник внешней
синхронизации;
ULONG AdcIMask – задает режим ввода
по каналам у модуля E2010;
ULONG NCh - количество
опрашиваемых каналов ;
ULONG Chn[128] - массив с номерами
каналов и усилением на них; описывает порядок опроса каналов;
ULONG
FIFO - размер половины аппаратного буфера FIFO на плате;
ULONG
IrqStep;
ULONG Pages – произведение этих двух
параметров IrqStep*Pages задает количество отсчетов которое соберет
плата при однократном сборе, но не больше чем 128К отсчетов. При
циклическом сборе они игнорируются – буфер всегда 128К.
ULONG
IrqEna - разрешение генерации прерывания от платы (mask/0), при
этом mask - это младшие 16 бит в слове разрешающем прерывания от
платы (блок АЦП);
ULONG AdcEna - разрешение работы АЦП
(1/0);
Примечание:
Структура ADC_PAR _1 используется совместно с вызовом FillDAQparameters для настройки параметров ввода данных с платы АЦП. Поля отмеченные комментарием (//) наследуются из структуры DAQ_PAR. Пользователь должен заполнять все поля кроме тех, которые помечены (*). Особенности трактовки полей этой структуры для различных плат:
SynchroType - тип синхронизации;
задается константами, определенными в файле e2010cmd.h
AdcIMask – задает режим ввода по каналам у модуля E2010, сигнал или земля + входной диапазон;
задается константами, определенными в файле e2010cmd.h через (+)
для 0 канала
SIG_0 0x0400 – вход подключен к сигналу;
для остальных каналов аналогично с префиксами _1 _2 _3;
IrqStep – размер запроса циклической посылки данных к USB, не более 1М отсчтетов;
AdPorog - порог срабатывания при аналоговой синхронизации;
Это обобщенная структура для удобства работы со структурами задачи параметров сбора данных разных плат.
Описание:
C:
typedef union _DAC_PARAM_U_ : {
DAC_PAR_0 t1; DAC_PAR_1 t2;
} DAC_PAR, *PDAC_PAR;
Параметры:
Примечание:
Структура служит для передачи параметров вывода данных в плату. Заполняется пользователем и передается в драйвер где хранится в похожей структуре, но в удобном для платы представлении.
Описание:
C:
typedef struct _DAC_PARAM_U_0: public DAQ_PAR { // ULONG s_Type; // ULONG FIFO; // ULONG IrqStep; // ULONG Pages; ULONG AutoInit; double dRate; * ULONG Rate; ULONG IrqEna; ULONG DacEna; ULONG DacNumber; } DAC_PAR_0, *PDAC_PAR_0;
Параметры:
ULONG s_Type -; тип структуры (должен быть L_DAC_PARAM);
ULONG AutoInit - флаг указывающий на тип сбора данных 0 -
однократный 1 - циклический; (пока не используется)
double
dRate - частота вывода данных на ЦАП (кГц);
ULONG Rate -
частота вывода данных на ЦАП (в кодах для процессора);
ULONG
FIFO - размер половины аппаратного буфера FIFO на плате;
ULONG
IrqStep - шаг генерации прерываний;
ULONG Pages -
размер кольцевого буфера в шагах прерываний;
ULONG IrqEna -
разрешение генерации прерывания от платы (1/0);
ULONG DacEna
- разрешение работы ЦAП (1/0);
ULONG DacNumber -
номер канала ЦАП на который выводить данные;
Примечание:
Структура DAC_PAR_0 используется совместно с вызовом FillDAQparameters для настройки параметров вывода данных с ЦАП платы. Поля отмеченные комментарием (//) наследуются из структуры DAQ_PAR. Пользователь должен заполнять все поля кроме тех, которые помечены (*). Особенности трактовки полей этой структуры для различных плат:
L-761/780/783/L-1450 - полностью так, как описано кроме:
DacNumber - не задействован (номер ЦАП задается в самих данных);
IrqEna,Pages- прерывания и реальный кольцевой буфер работают только в L-1450 и L780C, для остальных плат Pages всегда надо задавать 2;
IrqStep - должен быть равен FIFO;
L-1250/51/L-305/L-264:
IrqEna,Pages - прерывания и реальный кольцевой буфер работают только в L-1450 и L780C, для остальных плат Pages всегда надо задавать 2;
IrqStep - должен быть равен FIFO т.к. плата может работать только по половинкам фифо буфера;
dRate - надо ставить такой же как и для АЦП т.к. ЦАП на этих платах как бы синхронен с АЦП - на ввод одного кадра с АЦП происходит один вывод на ЦАП;
Структура служит для передачи параметров вывода данных в плату. Заполняется пользователем и передается в драйвер где хранится в похожей структуре, но в удобном для платы представлении.
Описание:
C:
typedef struct _DAC_PARAM_U_1: public DAQ_PAR { // ULONG s_Type; // ULONG FIFO; // ULONG IrqStep; // ULONG Pages; ULONG AutoInit; double dRate; * ULONG Rate; ULONG IrqEna; ULONG DacEna; ULONG Reserved1; } DAC_PAR_1, *PDAC_PAR_1;
Параметры:
ULONG s_Type -; тип структуры (должен быть L_DAC_PARAM);
ULONG AutoInit - флаг указывающий на тип сбора данных 0 -
однократный 1 - циклический; (пока не используется)
double
dRate - частота вывода данных на ЦАП (кГц);
ULONG Rate -
частота вывода данных на ЦАП (в кодах для процессора);
ULONG
FIFO - размер половины аппаратного буфера FIFO на плате;
ULONG
IrqStep - шаг генерации прерываний;
ULONG Pages -
размер кольцевого буфера в шагах прерываний;
ULONG IrqEna -
разрешение генерации прерывания от платы (1/0);
ULONG DacEna
- разрешение работы ЦAП (1/0);
Примечание:
Структура DAC_PAR_1 используется совместно с вызовом FillDAQparameters для настройки параметров вывода данных с ЦАП платы. Поля отмеченные комментарием (//) наследуются из структуры DAQ_PAR. Пользователь должен заполнять все поля кроме тех, которые помечены (*). Особенности трактовки полей этой структуры для различных плат:
L-791 - полностью так, как описано кроме:
AutoInit – не используется;
IrqStep – не используется;
Pages- не используется, буфер всегда 128К отсчетов;
FIFO,IrqStep – не используется, буфер всегда 128К отсчетов; прерывания генерируются по флагам в данных ЦАП
Структура служит для передачи в плату параметров асинхронного ввода/вывода данных. Используется совместно IoAsync.
Описание:
C:
typedef struct _ASYNC_PARAM_ : public DAQ_PAR { // USHORT s_Type; // USHORT FIFO; // USHORT IrqStep; // USHORT Pages; double dRate; * USHORT Rate; USHORT NCh; USHORT Chn[128]; USHORT Data[128]; ULONG Mode; } ADC_PAR, *PADC_PAR;
Параметры:
USHORT s_Type - указывает для какой опреации ввода/вывода
содержатся данные в структуре (L_ASYNC_ADC_CFG,
L_ASYNC_TTL_CFG,L_ASYNC_DAC_CFG, L_ASYNC_ADC_INP, L_ASYNC_TTL_INP,
L_ASYNC_TTL_OUT, L_ASYNC_DAC_OUT);
USHORT Data[128] -
массив для данных;
double dRate - частота опроса каналов
в кадре (кГц);
USHORT Rate - частота опроса каналов в
кадре (в кодах для процессора);
USHORT NCh - количество
опрашиваемых каналов ;
USHORT Chn[128] - массив с
номерами каналов и усилением на них; описывает порядок опроса
каналов;
USHORT FIFO - размер половины аппаратного буфера
FIFO на плате;
USHORT IrqStep - шаг генерации прерываний;
USHORT Pages - размер кольцевого буфера в шагах
прерываний;
USHORT Mode - задает различные режимы при
конфигурации.
Примечание:
Структура ASYNC_PAR используется совместно с вызовом IoAsync. Поля отмеченные комментарием (//) наследуются из структуры DAQ_PAR. Пользователь должен заполнять все поля кроме тех, которые помечены (*). Как заполнять или что читать из этой структуры см. описание функции IoAsync.
Структура описывает FLASH на PCI платах L-761/L-780/L-783.
Описание:
C:
typedef struct __PLATA_DESCR { char SerNum[9]; char BrdName[5]; char Rev; char DspType[5]; long Quartz; USHORT IsDacPresent; USHORT Reserv1[7]; USHORT KoefADC[8]; USHORT KoefDAC[4]; USHORT Custom[32]; } PLATA_DESCR , *PPLATA_DESCR;
Параметры:
char SerNum[9] - серийный номер платы;
char
BrdName[5] - название платы;
char Rev - ревизия
платы;
char DspType[5] - тип DSP;
long Quartz -
частота кварца;
USHORT IsDacPresent - наличие ЦАПа;
USHORT Reserv1[7] - зарезервировано;
USHORT
KoefADC[8] - калибровочные коэффициенты АЦП;
USHORT
KoefDAC[4] - калибровочные коэффициенты ЦАП;
USHORT
Custom[32] - пользовательское место;
Примечание:
Структура описывает FLASH на ISA плате L-1450.
Описание:
C:
typedef struct __PLATA_DESCR_1450 { char SerNum[9]; char BrdName[7]; char Rev; char DspType[5]; char IsDacPresent; char IsExtMemPresent; long Quartz; USHORT Reserv1[6]; USHORT KoefADC[8]; USHORT KoefDAC[4]; USHORT Custom[32]; } PLATA_DESCR_1450 , *PPLATA_DESCR_1450;
Параметры:
char SerNum[9] - серийный номер платы;
char
BrdName[7] - название платы;
char Rev - ревизия
платы;
char DspType[5] - тип DSP;
char
IsDacPresent - наличие ЦАПа;
char IsExtMemPresent -
наличие внешней памяти данных;
long Quartz - частота
кварца;
USHORT Reserv1[6] - зарезервировано;
USHORT
KoefADC[8] - калибровочные коэффициенты АЦП;
USHORT
KoefDAC[4] - калибровочные коэффициенты ЦАП;
USHORT
Custom[32] - пользовательское место;
Примечание:
Структура описывает FLASH на PCI плате L-791.
Описание:
C:
typedef struct __PLATA_DESCR_L791 { USHORT crc; char SerNum[16]; char BrdName[16]; char Rev; char DspType[5]; long Quartz; USHORT IsDacPresent; float KoefADC[16]; float KoefDAC[4]; USHORT Custom; } PLATA_DESCR_L791 , *PPLATA_DESCR_L791;
Параметры:
char SerNum[16] - серийный номер платы;
char
BrdName[16] - название платы;
char Rev - ревизия
платы;
char DspType[5] - тип DSP;
USHORT
IsDacPresent - наличие ЦАПа;
long Quartz - частота
кварца;
float KoefADC[16] - калибровочные коэффициенты
АЦП;
float KoefDAC[4] - калибровочные коэффициенты
ЦАП;
USHORT Custom - пользовательское место;
Примечание:
Данная структура используется в интерфейсных функциях, которые работают со служебной областью пользовательского ППЗУ: ReadPlataDescr и WritePlataDescr.
Название поля |
Назначение и допустимые значения поля |
---|---|
crc |
Контрольная сумма, расчитанная по всем полям структуры. |
SerNum |
Серийный номер модуля (строка символов максимальной с длиной 16) |
BrdName |
Название модуля (строка символов максимальной с длиной 16) |
Rev |
Ревизия модуля (ascii символ) |
DspType |
Тип используемого в модуле процессора (строка символов с максимальной длиной 16) |
Quartz |
Частота задающего кварца (32-х разрядное целое) |
IsDacPresented |
Флаг наличия ЦАП в модуле (логическая величина) |
KoefAdc[0] |
Коэффициент коррекции смещения нуля АЦП. Усилении ‘x1’. (число с плавающей точкой одинарной точности) |
KoefAdc[1] |
Коэффициент коррекции смещения нуля АЦП. Усилении ‘x2’.(число с плавающей точкой двойной точности) |
KoefAdc[2] |
Коэффициент коррекции смещения нуля АЦП. Усилении ‘x4’.(число с плавающей точкой двойной точности) |
KoefAdc[3] |
Коэффициент коррекции смещения нуля АЦП. Усилении ‘x8’.(число с плавающей точкой двойной точности) |
KoefAdc[4] |
Коэффициент коррекции смещения нуля АЦП. Усилении ‘x16’.(число с плавающей точкой двойной точности) |
KoefAdc[5] |
Коэффициент коррекции смещения нуля АЦП. Усилении ‘x32’.(число с плавающей точкой двойной точности) |
KoefAdc[6] |
Коэффициент коррекции смещения нуля АЦП. Усилении ‘x64’.(число с плавающей точкой двойной точности) |
KoefAdc[7] |
Коэффициент коррекции смещения нуля АЦП. Усилении ‘x128’.(число с плавающей точкой двойной точности) |
KoefAdc[8] |
Коэффициент коррекции масштаба АЦП. Усилении ‘x1’. (число с плавающей точкой двойной точности) |
KoefAdc[9] |
Коэффициент коррекции масштаба АЦП. Усилении ‘x2’. (число с плавающей точкой двойной точности) |
KoefAdc[10] |
Коэффициент коррекции масштаба АЦП. Усилении ‘x4’. (число с плавающей точкой двойной точности) |
KoefAdc[11] |
Коэффициент коррекции масштаба АЦП. Усилении ‘x5’. (число с плавающей точкой двойной точности) |
KoefAdc[12] |
Коэффициент коррекции масштаба АЦП. Усилении ‘x16’.(число с плавающей точкой двойной точности) |
KoefAdc[13] |
Коэффициент коррекции масштаба АЦП. Усилении ‘x32’. (число с плавающей точкой двойной точности) |
KoefAdc[14] |
Коэффициент коррекции масштаба АЦП. Усилении ‘x64’.(число с плавающей точкой двойной точности) |
KoefAdc[15] |
Коэффициент коррекции масштаба АЦП. Усилении ‘x128’. (число с плавающей точкой двойной точности) |
KoefDac[0] |
Коэффициент коррекции смещения нуля ЦАП. Канал ‘0’. (число с плавающей точкой двойной точности) |
KoefDac[1] |
Коэффициент коррекции смещения нуля ЦАП. Канал ‘1’. (число с плавающей точкой двойной точности) |
KoefDac[2] |
Коэффициент коррекции масштаба ЦАП. Канал ‘0’. (число с плавающей точкой двойной точности) |
KoefDac[3] |
Коэффициент коррекции масштаба ЦАП. Канал ‘1’.(число с плавающей точкой двойной точности) |
Корректировка данных АЦП/ЦАП.
Схемотехника и использованные компоненты обеспечивают линейность передаточной характеристики АЦП/ЦАП модуля. Однако, в виду отсутствия автоматической коррекции как внутри модуля так и в штатной dll-библиотеки, показания АЦП/ЦАП могут иметь некоторое смешение нуля и неточность в передаче масштаба. Работа по коррекции показаний возлагается на пользовательское приложение.
Для корректировки показаний АЦП/ЦАП можно воспользоваться собственными калибровочными коэффициентами и формулами или штатными коэффициентами.
Штатные коэффициенты вычисляются при наладке модуля на производстве и хранятся в системном ППЗУ модуля. Для того чтобы ими воспользоваться, необходимо:
-считать системное ППЗУ модуля при помощи функции ReadPlataDescr()
-из считанной системной информации выбрать коэффициенты масштаба и смещения нуля соответствующие диапазону измерения АЦП или номеру канала ЦАП (см. описание структуры PLATA_DESCR_L791)
-воспользоваться приведенной ниже формулой:
Корректировка данных АЦП:
Y = (X+B)*A, где:
X – некорректированные данные АЦП [в отсчетах АЦП]
Y – скорректированные данные АЦП [в отсчетах АЦП]
A – коэффициент масштаба [безразмерный]
B – коэффициент смещение нуля [в отсчетах АЦП]
Примечание: Коэффициенты A и B одни и те же для всех каналов АЦП, но различные для разных диапазонов измерения.
Корректировка данных ЦАП:
Y = (X+B)*A , где:
X – некорректированные данные ЦАП [в отсчетах ЦАП]
Y – корректированные данные ЦАП [в отсчетах ЦАП]
A – коэффициент масштаба [безразмерный]
B – коэффициент смещение нуля [в отсчетах ЦАП]
Пример 1:
С АЦП, настроенного на диапазон ±2.5В (усиление х4), получены следующие данные:
X1=1000, X2=-1000, X3=0
тогда, если положить что pd – структура типа PLATA_DESCR_L791 предварительно участвовавшая в вызове функции ReadPlataDescr(), то коэффициенты коррекции и скорректированные данные можно получить так:
A=pd. KoefAdc[10], B=pd. KoefADC [2]
Y1=(B+1000)*A, Y2=(B-1000)*A, Y3=B*A
Пример 2:
На втором канале ЦАП необходимо выставить напряжение, соответствующее следующим кодам:
X1=1000, X2=-1000, X3=0
тогда, если положить что pd – структура типа PLATA_DESCR_L791 предварительно участвовавшая в вызове функции ReadPlataDescr(), то коэффициенты коррекции и данные, которые необходимо записать во второй канал ЦАП, можно получить так:
A=pd. KoefDac[3], B=pd. KoefDac[1]
Y1=(B+1000)*A, Y2=(B-1000)*A, Y3=B*A
Структура описывает FLASH на USB модуле E14-440.
Описание:
C:
typedef struct __PLATA_DESCR_440 { char SerNum[9]; char BrdName[7]; char Rev; char DspType[5]; char IsDacPresent; long Quartz; char Reserv2[13]; USHORT KoefADC[8]; USHORT KoefDAC[4]; USHORT Custom[32]; } PLATA_DESCR_E440 , *PPLATA_DESCR_E440;
Параметры:
char SerNum[9] - серийный номер платы;
char
BrdName[7] - название платы;
char Rev - ревизия
платы;
char DspType[5] - тип DSP;
long Quartz -
частота кварца;
char IsDacPresent - наличие ЦАПа;
char
Reserv2[13] - зарезервировано;
USHORT KoefADC[8] -
калибровочные коэффициенты АЦП;
USHORT KoefDAC[4] -
калибровочные коэффициенты ЦАП;
USHORT Custom[32] -
пользовательское место;
Примечание:
Структура описывает FLASH на USB модуле E14-140.
Описание:
C:
typedef struct __PLATA_DESCR_E140 { char SerNum[9]; char BrdName[11]; char Rev; char DspType[11]; char IsDacPresent; long Quartz; char Reserv2[3]; float KoefADC[8]; float KoefDAC[4]; USHORT Custom[20]; } PLATA_DESCR_E140 , *PPLATA_DESCR_E140;
Параметры:
char SerNum[9] - серийный номер платы;
char
BrdName[11] - название платы;
char Rev - ревизия
платы;
char DspType[11] - тип DSP;
long Quartz -
частота кварца;
char IsDacPresent - наличие ЦАПа;
char
Reserv2[3] - зарезервировано;
float KoefADC[8] -
калибровочные коэффициенты АЦП;
float KoefDAC[4] -
калибровочные коэффициенты ЦАП;
USHORT Custom[20] -
пользовательское место;
Примечание:
Внутри модуля это все храниться в ужасном формате PACKED_PLATA_DESCR_E140 котрый определен в файле ioctl.h. Но от пользователя это все скрыто и знать об этом не обязательно...
Структура описывает FLASH на USB модуле E154.
Описание:
C:
typedef struct __PLATA_DESCR_E154 { char SerNum[9]; char BrdName[11]; char Rev; char DspType[11]; char IsDacPresent; long Quartz; char Reserv2[3]; float KoefADC[8]; float KoefDAC[4]; USHORT Custom[20]; } PLATA_DESCR_E154 , *PPLATA_DESCR_E154;
Параметры:
char SerNum[9] - серийный номер платы;
char
BrdName[11] - название платы;
char Rev - ревизия
платы;
char DspType[11] - тип DSP;
long Quartz -
частота кварца;
char IsDacPresent - наличие ЦАПа;
char
Reserv2[3] - зарезервировано;
float KoefADC[8] -
калибровочные коэффициенты АЦП;
float KoefDAC[4] -
калибровочные коэффициенты ЦАП;
USHORT Custom[20] -
пользовательское место;
Примечание:
Внутри модуля это все храниться в ужасном формате PACKED_PLATA_DESCR_E154 котрый определен в файле ioctl.h. Но от пользователя это все скрыто и знать об этом не обязательно...
Структура описывает FLASH на USB модуле E20-10.
Описание:
C:
typedef struct __PLATA_DESCR_E2010 { char BrdName[16]; char SerNum[16]; char DspType[16]; long Quartz; char Rev; char IsDacPresent; float KoefADC[24]; float KoefDAC[4]; USHORT Custom[45]; } PLATA_DESCR_E2010 , *PPLATA_DESCR_E2010;
Параметры:
char SerNum[16] - серийный номер платы;
char
BrdName[16] - название платы;
char Rev - ревизия
платы;
char DspType[16] - тип DSP;
long Quartz -
частота кварца;
char IsDacPresent - наличие ЦАПа;
float
KoefADC[24] - калибровочные коэффициенты АЦП;
float
KoefDAC[4] - калибровочные коэффициенты ЦАП;
USHORT
Custom[45] - пользовательское место;
Примечание:
Это обобщенная структура для удобства работы с флешами разных плат.
Описание:
C:
typedef union __PLATA_DESCR_U { PLATA_DESCR t1; PLATA_DESCR_1450 t2; PLATA_DESCR_L791 t3; WORD_IMAGE wi; BYTE-IMAGE bi; } PLATA_DESCR_U, *PPLATA_DESCR_U; typedef union __PLATA_DESCR_U2 { PLATA_DESCR t1; PLATA_DESCR_1450 t2; PLATA_DESCR_L791 t3; PLATA_DESCR_E440 t4; PLATA_DESCR_E140 t5; PACKED_PLATA_DESCR_E140 pt5; PLATA_DESCR_E2010 t6; WORD_IMAGE wi; BYTE_IMAGE bi; WORD_IMAGE_256 wi256; BYTE_IMAGE_256 bi256; } PLATA_DESCR_U2, *PPLATA_DESCR_U2;
Примечание:
Структура PLATA_DESCR_U2 дополнена новыми типами данных для новых модулей и расширена до 256 байт против 128. Библиотека внутри хранит все уже в структуре U2.
Представление структуры флеша в виде массива слов.
Описание:
C:
typedef struct __WORD_IMAGE { WORD data[64]; } WORD_IMAGE, *PWORD_IMAGE;
Примечание:
Структура описывает параметры виртуального слота.
Описание:
C:
typedef struct __SLOT_PARAM { ULONG Base; ULONG BaseL; ULONG Base1; ULONG BaseL1; ULONG Mem; ULONG MemL; ULONG Mem1; ULONG MemL1; ULONG Irq; ULONG BoardType; ULONG DSPType; ULONG Dma; ULONG DmaDac; ULONG DTA_REG; ULONG IDMA_REG; ULONG CMD_REG; ULONG IRQ_RST; ULONG DTA_ARRAY; ULONG RDY_REG; ULONG CFG_REG; } SLOT_PAR, *PSLOT_PAR;
Параметры:
ULONG Base - базовый адрес первого региона портов;
ULONG
BaseL - протяженность первого региона портов в байтах;
ULONG
Base1 - базовый адрес второго региона портов;
ULONG
BaseL1 - протяженность второго региона портов в байтах;
ULONG
Mem - адрес первого региона памяти;
ULONG MemL -
протяженность первого региона памяти в байтах;
ULONG Mem1 -
адрес второго региона памяти;
ULONG MemL1 - протяженность
второго региона памяти в байтах;
ULONG Irq - используемое
драйвером аппаратное прерывание;
ULONG BoardType - тип
платы;
ULONG DSPType - тип установленного на плате DSP;
ULONG Dma - используемый для ввода данных канал ПДП: 0 -
не использовать,5,6;
ULONG DmaDac - используемый для
вывода данных канал ПДП: 0 - не использовать,6;
ULONG
DTA_REG;
ULONG IDMA_REG;
ULONG CMD_REG;
ULONG
IRQ_RST;
ULONG DTA_ARRAY;
ULONG RDY_REG;
ULONG CFG_REG; -
адреса регистров платы относительного базового адреса;
Примечание:
Структура SLOT_PAR используется совместно с вызовом GetSlotParam для получения параметров виртуальных слотов.
Для платы L791 занчение имеют только поля Mem, MemL, Irq, BoardType. Все остальные ничего не значат.
Пока определены следующие коды ошибок:
L_SUCCESS 0 - функция выполнена успешно;
L_NOTSUPPORTED 1 - функция не поддерживается этой платой;
L_ERROR 2 - ошибка при выполнении функции;
L_ERROR_NOBOARD 3 - нет платы в запрашиваемом слоте;
L_ERROR_INUSE 4 – плата в запрашиваемом слоте уже используется;
В заголовочных файлах определены следующие типы плат поддерживаемые библиотекой:
NONE 0 - нет платы;
L1250 1 - плата L1250;
N1250 2 - плата N1250 (работоспособность не проверялась);
L1251 3 - плата L1251;
L1221 4 - плата L1221;
PCIA 5 - плата серии L7XX rev. A;
PCIB 6 - плата серии L7XX rev. B;
L264 8 - плата L264;
L305 9 - плата L305;
L1450C 10 - плата L1450 с совместимым биосом L1250;
L1450 11 - плата L1450;
L032 12 - плата L032;
HI8 13 - плата HI8;
PCIC 14 - плата серии L7XX rev. С (L780M);
L791 19 - плата серии L79X (L791);
E440 30 - модуль E14-440;
E140 31 - модуль E14-140;
E2010 32 – модуль E20-10;
E154 38 – модуль E154;
E2010B 39 — модуль E20-10 ревизии В
В заголовочных файлах определены следующие константы:
L_ADC_PARAM 1 - трактовать DAQ_PAR как ADC_PAR при передаче в FillDAQparameters;
L_DAC_PARAM 2 - трактовать DAQ_PAR как DAC_PAR при передаче в FillDAQparameters;
L_ASYNC_ADC_CFG 3 - ASYNC_PAR содержит запрос на конфигурирование АЦП;
L_ASYNC_TTL_CFG 4 - ASYNC_PAR содержит запрос на конфигурирование цифровых линий;
L_ASYNC_DAC_CFG 5 - ASYNC_PAR содержит запрос на конфигурирование ЦАП;
L_ASYNC_ADC_INP 6 - ASYNC_PAR содержит запрос на ввод данных с АЦП;
L_ASYNC_TTL_INP 7 - ASYNC_PAR содержит запрос на ввод данных с цифровых линий;
L_ASYNC_TTL_OUT 8 - ASYNC_PAR содержит запрос на вывод данных на цифровые линии;
L_ASYNC_DAC_OUT 9 - ASYNC_PAR содержит запрос на вывод данных на ЦАП;
L_STREAM_ADC 1 - тип потока - поток данных с АЦП;
L_STREAM_DAC 2 - тип потока - поток данных с ЦАП;
L_EVENT_ADC_BUF 1
L_EVENT_DAC_BUF 2
L_EVENT_ADC_OVF 3
L_EVENT_ADC_FIFO 4
L_EVENT_DAC_USER 5
L_EVENT_DAC_UNF 6
L_EVENT_PWR_OVR 7 – макросы для различных событий устанавливаемых в функции SetLDeviceEvent для платы L791.
Адресное пространство L-1250/L-264/L-305
Адрес |
Чтение |
Запись |
Base+0x0 |
Данные от платы. До тех пор, пока процессор ADSP ничего не записал в порт данных, соответствующий бит готовности равен нулю. После записи слова в порт данных процессором ADSP автоматически устанавливается в единичное значение бит готовности, который переключится в ноль после того, как компьютер считает переданное слово. |
Данные для передачи в плату. После записи слова в порт данных автоматически устанавливается в нулевое значение бит готовности, который переключится в единицу автоматически после того, как процессор ADSP считает переданное слово. |
Base+0x8 |
Сброс прерывания от платы в PC. В том случае если используется прерывание IRQ10/11, то обработчик прерывания обязан произвести одно чтение из этого порта для сброса запроса прерывания. В противном случае линия прерываний окажется заблокированной. |
При записи команды в этот порт автоматически генерируется прерывание в процессоре ADSP IRQ2. Драйвер LBIOS использует это порт для передачи команд, при этом обработчик прерывания в процессоре в ответ на IRQ2 считывает переданный код через порт данных и вызывает функцию, соответствующую переданному коду. |
Base+0xC |
Порт битов готовности и двух ТТЛ цифровых линий ( 34 и 35 на внешнем разъеме ) |
Порт конфигурации. При помощи порта конфигурации можно: - загрузить в процессор управляющую программу; - отключить линию прерывания IRQ10/11; - перевести порт данных в режим работы по каналам ПДП; |
Список команд поддерживаемых биос L-1250/L-264/L-305
Номер |
Обозначение |
Описание |
0 |
cmSTOP_1251 |
перевод платы в "тихое" состояние |
1 |
cmADC_CHAN_1251 |
ввод с АЦП с переустановкой каналов |
2 |
cmOUT_DAC_1251 |
вывод на ЦАП |
3 |
cmSTREAM_1251 |
одноканальный ввод с синхронизацией от внутреннего таймера |
4 |
cmSOFT_1251 |
многоканальный ввод с синхронизацией от внутреннего таймера |
5 |
cmSAMPLE_1251 |
ввод с АЦП без переустановки каналов |
6 |
cmTTL_IN_1251 |
ввод цифровых портов |
7 |
cmTTL_OUT_1251 |
вывод в цифровые порты |
8 |
cmIRQ_SIMPLE_1251 |
генерирование прерываний от внутреннего таймера |
9 |
cmIRQ_ADC_CHAN_1251 |
генерирование прерываний от внутреннего таймера с одноканальным вводом с АЦП |
10 |
cmIRQ_KADR_1251 |
генерирование прерываний от внутреннего таймера с многоканальным вводом с АЦП |
11 |
cmCALIBR_1251 |
зарезервирована |
12 |
cmTEST_1251 |
тестирование наличия платы |
13 |
cmDAC_STREAM_1251 |
вывод на ЦАП массива |
14 |
cmMEMORY_STATE_1251 |
тестирование памяти |
15 |
cmFILTER_1251 |
зарезервирована |
16 |
cmFLT_NO_LOAD_1251 |
зарезервирована |
17 |
cmSET_MULTI_1251 |
зарезервирована |
18 |
cmSET_SCALE_1251 |
установка коэффициента масштабирования таймера |
19 |
cmSET_UVX_1251 |
зарезервирована |
20 |
cmSET_DSP_SPEED_1251 |
установка типа скорости процессора |
21 |
cmSET_WAITSTATE_1251 |
установка задержки на память |
22 |
cmSET_DELAY_1251 |
установка межканальной задержки |
23 |
cmSYNCHRO_MODE_1251 |
установка типа синхронизации |
24 |
cmDAC_CONFIG_1251 |
установка номера ЦАПа |
25 |
cmFIFO_CONFIG_1251 |
режим FIFO буфера |
26 |
cmSOFT_MEMORY_1251 |
ввод во внутреннюю память |
28 |
cmPROGRAM_1251 |
программирование модулей в крейте |
29 |
cmWRITE_TO_MEM_1251 |
ввод в память массива |
30 |
cmREAD_FROM_MEM_1251 |
чтение массива из памяти |
31 |
cmGET_LSM_NAME_1251 |
чтение кода модуля |
32 |
cmSET_2FIFO_TYPE_1251 |
установка двойного FIFO |
33 |
cmSET_LM_DAC_1251 |
установка ЦАПа LM модуля |
34 |
cmGET_LM_TTL_1251 |
чтение цифрового модуля |
35 |
cmCOMPARATPR_1251 |
частотомер |
36 |
cmTEST_PM_1251 |
проверка наличия памяти программ |
37 |
cmLOW_POWER_1251 |
cmLOW_POWER_1251 |
39 |
cmLM404_1251 |
работа с модулем LM-404 |
Существует две ревизии PCI плат - А и В. Они различаются адресацией портов. Ревизия А очень редкая. Наиболее распространенная ревизия – В. Base - один из трех возможных вариантов базового адреса:порты ввода/вывода,память ниже 1Мб,память выше 1Мб.Значения Base можно увидеть под Windows в Панели Управления/Система в ресурсах соответствующих PCI плат. Под Windows всегда используется доступ к плате через память выше 1Мб.
Адресное пространство L-761/L-780/L-783 (Rev A).
Адрес |
Чтение |
Запись |
Base+0 |
Порт для чтения данных с платы по IDMA как при одиночных операция, так и при блочных. |
Порт для записи данных в плату по IDMA как при одиночных операция, так и при блочных. |
Base+4096 |
- |
Порт для установки адреса IDMA. |
Base+8192 |
- |
Порт генерации IRQ2 DSP. |
Base+12288 |
- |
Порт сброса прерываний. |
Адресное пространство L-761/L-780/L-783 (Rev B).
Адрес |
Чтение |
Запись |
Base+0 |
Порт для чтения данных с платы по IDMA при одиночных операция. |
Порт для записи данных в плату по IDMA при одиночных операция. |
Base+2 |
- |
Порт для установки адреса IDMA. |
Base+4 |
- |
Порт генерации IRQ2 DSP. |
Base+6 |
- |
Порт сброса прерываний. |
Base+4096 |
Порт для чтения данных с платы по IDMA при блочных операциях. |
Порт для записи данных в плату по IDMA при блочных операциях. |
Список команд поддерживаемых биос L-761/L-780/L-783
Номер |
Обозначение |
Описание |
Использует |
0 |
cmTEST_PLX |
Проверка загрузки платы и ее работоспособности; |
L_TEST_LOAD_PLX |
1 |
cmLOAD_CONTROL_TABLE_PLX |
Загрузка управляющей таблицы в память DSP; |
L_CONTROL_TABLE_PLX, L_CONTROL_TABLE_LENGTH_PLX |
2 |
cmADC_ENABLE_PLX |
Разрешение/Запрещение работы АЦП; |
L_ADC_ENABLE_PLX |
3 |
cmADC_FIFO_CONFIG_PLX |
Конфигурирование параметров кольцевого буфера АЦП; |
L_ADC_FIFO_BASE_ADDRESS_PLX, L_ADC_FIFO_BASE_ADDRESS_INDEX_PLX, L_ADC_FIFO_LENGTH_PLX, L_ADC_NEW_FIFO_LENGTH_PLX |
4 |
cmSET_ADC_KADR_PLX |
Установка временных параметров работы АЦП; |
L_ADC_RATE_PLX, L_INTER_CADR_DELAY_PLX |
5 |
cmENABLE_DAC_STREAM_PLX |
Разрешение/запрещение выдачи данных из буфера ЦАП. |
L_DAC_ENABLE_STREAM_PLX |
6 |
cmDAC_FIFO_CONFIG_PLX |
Конфигурирование параметров буфера ЦАП; |
L_DAC_FIFO_BASE_ADDRESS_PLX, L_DAC_FIFO_LENGTH_PLX, L_DAC_NEW_FIFO_LENGTH_PLX |
7 |
cmSET_DAC_RATE_PLX |
Установка частоты вывода данных на ЦАП; |
L_DAC_RATE_PLX |
8 |
cmADC_SAMPLE_PLX |
Однократный ввод c АЦП; |
L_ADC_SAMPLE_PLX, L_ADC_CHANNEL_PLX |
9 |
cmTTL_IN_PLX |
Чтение данных с цифровых линий; |
L_TTL_IN_PLX |
10 |
cmTTL_OUT_PLX |
Вывод данных на цифровые линии; |
L_TTL_OUT_PLX |
11 |
cmSYNCHRO_CONFIG_PLX |
Управление синхронизацией; |
L_SYNCHRO_TYPE_PLX, L_SYNCHRO_AD_CHANNEL_PLX, L_SYNCHRO_AD_POROG_PLX, L_SYNCHRO_AD_MODE_PLX, L_SYNCHRO_AD_SENSITIVITY_PLX |
12 |
cmENABLE_IRQ_PLX |
Разрешение/запрещение работы с прерываниями; |
L_ENABLE_IRQ_PLX, L_ENABLE_IRQ_VALUE_PLX, L_IRQ_STEP_PLX |
13 |
cmIRQ_TEST_PLX |
Тестовая команда генерирует прерывания 10 раз в сек; |
L_ENABLE_IRQ_PLX |
14 |
cmSET_DSP_TYPE_PLX |
Передает в драйвер тип установленного на плате DSP и соответствующим образом модифицирует код драйвера; |
L_DSP_TYPE_PLX |
Список внутренних переменных биос L-761/L-780/L-783 (8 - признак того, что это DM)
Адрес |
Обозначение |
Описание |
0x8A00 |
L_CONTROL_TABLE_PLX |
Управляющая таблица содержащая логические номера каналов (до 96). В соответствии с ней DSP производит последовательный циклический сбор данных с АЦП. Размер этой таблицы задается переменной L_CONTROL_TABLE_LENGTH_PLX. По умолчанию { 0, 1, 2, 3, 4, 5, 6, 7 } |
0x8D00 |
L_SCALE_PLX |
Массив с 4 калибровочными коэффициентами используемый при корректировке масштаба данных с АЦП. По умолчанию {7FFF, 0x7FFF, 0x7FFF, 0x7FFF } |
0x8D04 |
L_ZERO_PLX |
Массив с 4 калибровочными коэффициентами используемый при корректировке смещения нуля данных с АЦП. По умолчанию { 0x0, 0x0, 0x0, 0x0 } |
0x8D08 |
L_CONTROL_TABLE_LENGHT_PLX |
Размер управляющей таблицы. По умолчанию 8. |
0x8D40 |
L_READY_PLX |
Флажок готовности платы к дальнейшей работе. После загрузки управляющей программы в DSP необходимо дождаться установления данного флажка в 1. |
0x8D41 |
L_TMODE1_PLX |
Тестовая переменная. После загрузки управляющей программы по этому адресу должно читаться число 0x5555. |
0x8D42 |
L_TMODE2_PLX |
Тестовая переменная. После загрузки управляющей программы по этому адресу должно читаться число 0xAAAA. |
0x8D48 |
L_DSP_TYPE_PLX |
Переменная, передающая драйверу тип установленного на модуле DSP. 0 - ADSP2184; 1 - ADSP2185; 2 - ADSP2186; По умолчанию 0. |
0x8D49 |
L_COMMAND_PLX |
Переменная, при помощи которой драйверу передается номер команды. |
0x8D4C |
L_TTL_OUT_PLX |
Переменная, в которой хранятся значения 16-ти выходных цифровых линий. |
0x8D4D |
L_TTL_IN_PLX |
Переменная, в которой хранятся значения 16-ти входных цифровых линий. |
0x8D50 |
L_FIFO_PTR_PLX |
Переменная, в которой хранится текущий адрес заполнения кольцевого буфера. Данная переменная по мере ввода данных меняет свое значение от L_ADC_FIFO_BASE_ADDRESS_PLX до L_ADC_FIFO_ADDRESS_PLX + L_ADC_FIFO_LENGTH_PLX. |
0x8D52 |
L_TEST_LOAD_PLX |
Тестовая переменная. |
0x8D53 |
L_ADC_RATE_PLX |
Переменная, задающая частоту работы АЦП. |
0x8D54 |
L_INTER_KADR_DELAY_PLX |
Переменная, задающая межкадровую задержку при вводе данных с АЦП. |
0x8D55 |
L_DAC_RATE_PLX |
Переменная, задающая частоту вывода данных с ЦАП-ов. |
0x8D56 |
L_DAC_VALUE_PLX |
Величина, которую требуется установить на выходе ЦАП-а. |
0x8D57 |
L_ENABLE_IRQ_PLX |
Запрещение(0)/разрешение(1) генерации прерывания в PC при соответствующем заполнении кольцевого буфера АЦП. По умолчанию - 0. |
0x8D58 |
L_IRQ_STEP_PLX |
Переменная, задающая число отсчетов при заполнении кольцевого буфера АЦП, каждый раз при превышении которого генерируется прерывание в PC |
0x8D5A |
L_IRQ_FIFO_ADDRESS_PLX |
Если произошло прерывание в PC, то начиная с этого адреса можно считать L_IRQ_STEP_PLX отсчетов из кольцевого буфера АЦП. |
0x8D5B |
L_ENABLE_IRQ_VALUE_PLX |
Переменная, значение которой при выполнении соответствующей команды передается в переменную L_ENABLE_IRQ_PLX. |
0x8D5C |
L_ADC_SAMPLE_PLX |
Данная переменная используется при однократном вводе с АЦП, храня считанное значение. |
0x8D5D |
L_ADC_CHANNEL_PLX |
Данная переменная используется при однократном вводе с АЦП, задавая логический номер канала. |
0x8D5E |
L_DAC_SCLK_DIV_PLX |
- |
0x8D60 |
L_CORRECTION_ENABLE_PLX |
Разрешение(1)/запрещение(0) корректировки данных аналоговых каналов при помощи калибровочных коэффициентов. По умолчанию - 0. |
0x8D62 |
L_ADC_ENABLE_PLX |
Запрещение(0)/разрешение(1) работы АЦП. |
0x8D63 |
L_ADC_FIFO_BASE_ADDRESS_PLX |
Текущий базовый адрес кольцевого буфера АЦП. По умолчанию - 0x2000. |
0x8D64 |
L_ADC_FIFO_BASE_ADDRESS_INDEX_PLX |
Переменная, задающая базовый адрес кольцевого буфера АЦП. Может принимать три значения:0 - (0x0000 для ADSP-2185),1 - (0x2000 для ADSP-2185 -2186), 2 - (0x3000 для ADSP-2185 -2186; 0x2000 для ADSP-2184). |
0x8D65 |
L_ADC_FIFO_LENGTH_PLX |
Текущая длина кольцевого буфера АЦП. По умолчанию 0x800. |
0x8D66 |
L_ADC_NEW_FIFO_LENGTH_PLX |
Переменная, задающая длину кольцевого буфера АЦП. |
0x8D67 |
L_DAC_ENABLE_STREAM_PLX |
Запрещение(0)/разрешение(1) вывода данных из буфера ЦАП на ЦАП. |
0x8D68 |
L_DAC_FIFO_BASE_ADDRESS_PLX |
Текущий базовый адрес буфера ЦАП. Данный буфер расположен в памяти программ DSP. По умолчанию 0xC00. |
0x8D69 |
L_DAC_FIFO_LENGTH_PLX |
Текущая длина буфера ЦАП. По умолчанию 0x400. |
0x8D6A |
L_DAC_NEW_FIFO_LENGTH_PLX |
Переменная, задающая длину буфера ЦАП. |
0x8D70 |
L_SYNCHRO_TYPE_PLX |
Переменная, задающая тип синхронизации. |
0x8D73 |
L_SYNCHRO_AD_CHANNEL_PLX |
При аналоговой синхронизации задает логический номер канала, по которому происходит синхронизация. |
0x8D74 |
L_SYNCHRO_AD_POROG_PLX |
Порог аналоговой синхронизации. |
0x8D75 |
L_SYNCHRO_AD_MODE_PLX |
Переменная, задающая режим синхронизации по переходу "снизу - вверх"(0) или "сверху - вниз"(1) |
0x8D76 |
L_SYNCHRO_AD_SENSITIVITY_PLX |
Переменная, задающая тип синхронизации по уровню(0) или по переходу(1). |
Адресное пространство L-1221.
Адрес |
Чтение |
Запись |
Base+0 |
16-битные данные передаваемые по каналу IDMA. |
16-битные данные передаваемые по каналу IDMA. |
Base+2 |
Вызывает генерацию прерывания IRQ1 в сигнальном процессоре. Служит для генерации команды. |
Устанавливает начальный адрес IDMA . Данные передаваемые/считываемые в/из DSP будут размещаться/считываться начиная с этого адреса. |
Список команд поддерживаемых биос L-1221
Номер |
Обозначение |
Описание |
Использует |
0 |
cmTEST_1221 |
Проверка загрузки платы и ее работоспособности; |
L_TEST_LOAD_1221 |
1 |
cmFLASH_WRITE_1221 |
Запись байта в ППЗУ. {зарезервирована} |
- |
2 |
cmFLASH_READ_1221 |
Чтение байта из ППЗУ. |
L_FLASH_ADDRESS_1221, L_FLASH_BYTE_1221 |
3 |
cmSET_TTL_1221 |
Установка цифровых линий. |
L_TTL_CONFIG_1221, L_TTL_OUT_1221 |
4 |
cmGET_TTL_1221 |
Чтение цифровых линий. |
L_TTL_CONFIG_1221, L_TTL_IN_1221 |
5 |
cmENABLE_IRQ_1221 |
Разрешение/запрещение прерываний. |
L_ENABLE_IRQ_1221 |
6 |
cmRESET_AD_1221 |
Переинициализация аналогового тракта. |
L_CHANNEL_MASK_1221, L_RATE_SCALE_1221, L_READY_1221 |
7 |
cmSET_GAIN_1221 |
Установка входного диапазона. |
L_GAIN_CHANNEL_1221, L_GAIN_1221 |
8 |
cmSET_RATE_1221 |
Установка частоты ввода. |
L_GAIN_1221 |
9 |
cmCONFIG_FIFO_1221 |
Установка параметров буфера. |
L_FIFO_START_ADDRESS_1221, L_FIFO_LENGTH_1221 |
Список внутренних переменных биос L-1221
Адрес |
Обозначение |
Описание |
0x2000 |
L_BUFFER_1221 |
По умолчанию базовый адрес буфера в плате L-1221, размером 4096 слов. Данный адрес используется при чтении данных, поступающих с аналоговых каналов. Если были сделаны переустановки параметров буфера с помощью команды cmCONFIG_FIFO_1221, то надо пользоваться переменными L_FIFO_START_ADDRESS_1221 и L_FIFO_LENGTH. |
0x3C80 |
L_SCALE_1221 |
Массив с 64 калибровочными коэффициентами масштаба аналоговых каналов. |
0x3CC0 |
L_ZERO_1221 |
Массив с 64 калибровочными коэффициентами смещения нуля в режиме измерения постоянного напряжения. |
0x3D00 |
L_ZERO_FLT_1221 |
Массив с 64 калибровочными коэффициентами смещения нуля в режиме фильтрации постоянной составляющей. |
0x3D40 |
L_KADR_1221 |
Массив из 8 чисел с последними данными со всех восьми аналоговых каналов платы. Независимо от переменной L_CHANNEL_MASK_1221 в массив L_KADR_1221 постоянно подгружаются данные со всех аналоговых каналов. При этом по адресу L_KADR_1221 будет считываться код с первого канала АЦП, а по адресу L_KADR_1221+7 - с восьмого канала. |
0x3D48 |
L_TMODE_1221 |
Тестовая переменная, после загрузки управляющей программы по этому адресу должно читаться число 5. |
0x3D49 |
L_COMMAND_1221 |
Переменная, при помощи которой задается номер команды. |
0x3D4A |
L_FLASH_ADDRESS_1221 |
Адрес байта в ППЗУ. ППЗУ - энергонезависимая память на плате, в которой хранятся калибровочные коэффициенты. |
0x3D4B |
L_FLASH_BYTE_1221 |
Байт данных записываемый/считываемый в/из ППЗУ. |
0x3D4C |
L_TTL_OUT_1221 |
Слово, в котором хранятся значения 3 выходных цифровых линий. Формат - 00000000 0ХХХ000Y.Y - управляет режимом отсечки. |
0x3D4D |
L_TTL_IN_1221 |
Слово, в котором хранятся значения 3 входных цифровых линий. Формат - 00000000 0ХХХ0000. |
0x3D4E |
L_OVERFLOW_1221 |
Слово, в котором запоминаются биты, фиксирующие переполнение на аналоговых каналах. 1 - переполнение. Младший бит соответствует 0 каналу, старший - 7. Формат - 00000000 ХХХХХХХХ |
0x3D4F |
L_ENABLE_IRQ_1221 |
Слово, разрешающее(1)/запрещающее(0) генерирование прерываний от платы к компьютеру. |
0x3D50 |
L_FIFO_PTR_1221 |
Переменная , в которой хранится текущий адрес заполнения буфера. Данная переменная по мере ввода данных меняет свое значение от L_FIFO_START_ADDRESS_1221 до L_FIFO_START_ADDRESS_1221 + L_FIFO_LENGTH_1221-1. |
0x3D51 |
L_CHANNEL_MASK_1221 |
Битовая маска, при помощи которой задаются активные каналы, т.е. те каналы АЦП, данные с которых надо помещать в буфер. Формат - 00000000 ХХХХХХХХ. |
0x3D52 |
L_TEST_LOAD_1221 |
Тестовая переменная. 0xAA55. |
0x3D53 |
L_RATE_1221 |
Переменная устанавливающая частоту ввода данных. Целое число от 0 до 14 :0-6.99 kHz,1-7.46 kHz,2-7.99 kHz,3-8.6 kHz,4-9.32 kHz,5-10.17 kHz,6-11.19 kHz,7-12.43 kHz,8-13.98 kHz,9-15.98 kHz,10-18.64 kHz,11-22.37 kHz,12-27.97 kHz,13-37.29 kHz,14-55.93 kHz. |
0x3D54 |
L_RATE_SCALE_1221 |
Масштаб частоты ввода. Уменьшает частоту ввода : 0-1,1-16,2-256,3-4096. |
0x3D55 |
L_GAIN_CHANNEL_1221 |
Номер канала на котором изменяется входной диапазон. |
0x3D56 |
L_GAIN_1221 |
Устанавливаемый входной диапазон : 0-6.3 В,1-3.15 В,2-1.5 В,3-0.75 В,4-0.375 В,5-0.18 В,6-0.08 В,7-0.04 В. |
0x3D57 |
L_IRQ_STEP_1221 |
Шаг, с которым генерируется прерывание по мере заполнения буфера. |
0x3D58 |
L_N_BIT_1221 |
Разрядность АЦП. Фактически сдвиг данных в право. 16 бит - (0) 15 бит - (-1) ... |
0x3D59 |
L_FIFO_N_LOW_1221 |
Младшее слово числа введенных частей буфера. |
0x3D5A |
L_FIFO_N_HIGH_1221 |
Старшее слово числа введенных частей буфера. |
0x3D5B |
L_IRQ0_N_LOW_1221 |
Младшее слово счетчика внешних импульсов. |
0x3D5C |
L_IRQ0_N_HIGH_1221 |
Старшее слово счетчика внешних импульсов. |
0x3D5D |
L_TTL_CONFIG_1221 |
Конфигурация TTL линий. 1 - выход 0 – вход. Формат - 00000000 0ХХХ0000 |
0x3D63 |
L_CORRECTION_ENABLE_1221 |
Переменная запрещающая(0)/разрешающая(1) коррекцию вводимых данных. По умолчанию - 0; |
0x3D64 |
L_FIFO_START_ADDRESS_1221 |
Переменная, задающая начальный адрес буфера. Если она равна нулю, то адрес равен 0х0000. Если не равна нулю - адрес равен 0х2000. По умолчанию - 0х2000. |
0x3D65 |
L_FIFO_LENGTH_1221 |
Определяет длину буфера. По умолчанию 0х1000. |
0x3D69 |
L_READY_1221 |
0 - do calibration 1 – ready. Переменная сигнализирующая о готовности платы. |
0x3D70 |
L_IRQ_ADDRESS_1221 |
Переменная указывающая на каком адресе в буфере произошло прерывание. |
0x3F6C |
L_TEMPERATURE_1221 |
Температура платы. |
0x3D5E |
L_SYNCHRO_TYPE_1221 |
Переменная, задающая тип синхронизации. |
0x3D5F |
L_SYNCHRO_AD_CHANNEL_1221 |
При аналоговой синхронизации задает номер канала, по которому происходит синхронизация. |
0x3D60 |
L_SYNCHRO_AD_POROG_1221 |
Порог аналоговой синхронизации. |
0x3D61 |
L_SYNCHRO_AD_MODE_1221 |
Переменная, задающая режим синхронизации по переходу "снизу - вверх"(0) или "сверху - вниз"(1) |
0x3D62 |
L_SYNCHRO_AD_SENSITIVITY_1221 |
Переменная, задающая тип синхронизации по уровню(0) или по переходу(1). |
Адресное пространство L-1450.
Адрес |
Чтение |
Запись |
Base+0x0 |
Порт данных. Чтение 16-битного слова из порта данных. Все 16 считываемых бит являются значимыми. До тех пор, пока процессор DSP ничего не записал в порт данных, соответствующий бит готовности равен нулю. После записи 16-битного слова в порт данных сигнальным процессором автоматически устанавливается в единичное значение бит готовности RDYR, который переключится в ноль после того, как компьютер считает переданное слово. |
Порт данных. Запись 16-битного слова в порт данных. Все 16 записываемых бит являются значимыми. После записи слова в порт данных автоматически устанавливается в нулевое значение бит готовности RDYW, который переключится в единицу автоматически после того, как процессор ADSP считает переданное слово. |
Base+0x4 |
Порт дополнительных данных. Имеют значение только два младших бита в принимаемых данных, которые используются в штатном LBIOS при работе с платой по прерываниям. |
Порт EIORDY. Разрешения использования сигнала I/O CH RDY магистрали ISA. |
Base+0x8 |
Порт сброса запроса прерывания. В том случае если используется прерывание IRQ 10/11/12/15, то обработчик данного прерывания в РС обязан произвести одно чтение из описываемого порта для сброса запроса прерывания. В противном случае линия прерываний окажется заблокированной. |
Порт команд. При записи номера команды в данный порт автоматически генерируется прерывание IRQ2 в сигнальном процессоре и, одновременно с этим, записывает передаваемое число в порт данных. При этом обработчик прерывания драйвера LBIOS в ответ на запрос IRQ2 считывает переданный номер команды и вызывает процедуру, соответствующую переданному номеру команд. |
Base+0xC |
Порт статуса. Порт битов готовности записи RDYW и чтения RDYR. |
Порт управления. При помощи порта конфигурации можно:загрузить в процессор управляющую программу,отключить линию прерывания IRQ 10/11/12/15,перевести плату в режим работы по каналам Прямого Доступа к Памяти (ПДП). |
Список команд поддерживаемых биос L-1450
Номер |
Обозначение |
Описание |
Использует |
0 |
cmTEST_L1450 |
Проверка загрузки платы и ее работоспособности. |
L_TEST_LOAD_L1450 |
1 |
cmGET_DM_WORD_L1450 |
Чтение слова из памяти данных DSP |
- |
2 |
cmPUT_DM_WORD_L1450 |
Запись слова в память данных DSP |
- |
3 |
cmGET_PM_WORD_L1450 |
Чтение слова из памяти программ DSP |
- |
4 |
cmPUT_PM_WORD_L1450 |
Запись слова в память программ DSP |
- |
5 |
cmGET_DM_ARRAY_L1450 |
Чтение массива слов из памяти данных DSP |
- |
6 |
cmPUT_DM_ARRAY_L1450 |
Запись массива слов в память данных DSP |
- |
7 |
cmGET_PM_ARRAY_L1450 |
Чтение массива слов из памяти программ DSP |
- |
8 |
cmPUT_PM_ARRAY_L1450 |
Запись массива слов в память программ DSP |
- |
9 |
cmENABLE_FLASH_WRITE_L1450 |
Разрешение процедуры записи в пользовательское ППЗУ |
L_FLASH_ENABLE_L1450 |
10 |
cmREAD_FLASH_WORD_L1450 |
Чтение слова из ППЗУ |
L_FLASH_ADDRESS_L1450, L_FLASH_DATA_L1450 |
11 |
cmWRITE_FLASH_WORD_L1450 |
Запись слова в ППЗУ |
L_FLASH_ADDRESS_L1450, L_FLASH_DATA_L1450 |
12 |
cmSTART_L1450 |
Разрешение работы АЦП и/или ЦАП |
L_ADC_ENABLE_L1450, L_ENA_ADC_IRQ_L1450, L_ADC_DATA_STEP_L1450, L_DAC_ENABLE_L1450, L_ENA_DAC_IRQ_L1450, L_DAC_DATA_STEP_L1450 |
13 |
cmSET_ADC_PARS_L1450 |
Установка параметров работы АЦП |
L_CONTROL_TABLE_L1450, L_CONTROL_TABLE_LENGHT_L1450, L_ADC_RATE_L1450, L_INTER_KADR_SCALE_L1450, L_INTER_KADR_PERIOD_L1450 |
14 |
cmADC_FIFO_CONFIG_L1450 |
Конфигурирование параметров FIFO буфера АЦП. |
L_ADC_FIFO_BASE_ADDRESS_L1450, L_ADC_FIFO_BASE_ADDRESS_INDEX_ L1450, L_ADC_FIFO_LENGTH_L1450, L_ADC_NEW_FIFO_LENGTH_L1450 |
15 |
cmADC_SAMPLE_L1450 |
Однократный ввод отсчета АЦП с заданного канала |
L_ADC_SAMPLE_L1450, L_ADC_CHANNEL_L1450 |
16 |
cmSYNCHRO_CONFIG_L1450 |
Управление синхронизацией начала ввода данных с АЦП. |
L_SYNCHRO_TYPE_L1450, L_SYNCHRO_AD_CHANNEL_L1450, L_SYNCHRO_AD_POROG_L1450, L_SYNCHRO_AD_MODE_L1450, L_SYNCHRO_AD_SENSITIVITY_L1450 |
17 |
cmDAC_FIFO_CONFIG_L1450 |
Конфигурирование пара-метров FIFO буфера ЦАП. |
L_DAC_FIFO_BASE_ADDRESS_L1450, L_DAC_FIFO_LENGTH_L1450, L_DAC_NEW_FIFO_LENGTH_L1450 |
18 |
cmSET_DAC_RATE_L1450 |
Установка частоты вывода данных из FIFO буфера ЦАП |
L_DAC_RATE_L1450 |
19 |
cmENABLE_TTL_OUT_L1450 |
Разрешение выходных цифровых линий |
L_ENABLE_TTL_OUT_L1450 |
20 |
cmTTL_IN_L1450 |
Считывание состояния 16ти внешних цифровых линий. |
L_TTL_IN_L1450 |
21 |
cmTTL_OUT_L1450 |
Управление 16тью внешними цифровыми линиями. |
L_TTL_OUT_L1450 |
22 |
cmIRQ_TEST_L1450 |
Тестовая функция для генерирования прерываний в РС с частотой примерно 300 Гц. |
L_ENABLE_IRQ_L1450 |
23 |
cmSET_PAGE_MEMORY_L1450 |
Установка номера страницы внешней памяти |
L_PAGE_MEMORY_L1450 |
24 |
cmSET_DSP_TYPE_L1450 |
Передает в драйвер LBIOS тип установленного на плате DSP и соответствующим образом модифицирует код драйвера. |
L_DSP_TYPE_L1450 |
Список внутренних переменных биос L-1450 (8 - признак того, что это DM)
Адрес |
Обозначение |
Описание |
0x8A00 |
L_CONTROL_TABLE_L1450 |
Управляющая таблица, содержащая последовательность логических номеров каналов (максимум 128 элементов). В соответствии с ней DSP производит последовательный циклический сбор данных с АЦП. Размер этой таблицы задается переменной L_CONTROL_TABLE_LENGHT_ L1450 (см. ниже). По умолчанию - { 0, 1, 2, 3, 4, 5, 6, 7} |
0x8D00 |
L_SCALE_L1450 |
Массив с 4 калибровочными коэффициентами, используемый при корректировки масштаба данных с АЦП. По умолчанию - { 0x7FFF, 0x7FFF, 0x7FFF, 0x7FFF} |
0x8D04 |
L_ZERO_L1450 |
Массив с 4 калибровочными коэффициентами, используемый при корректировки смещения нуля данных с АЦП. По умолчанию - { 0x0, 0x0, 0x0, 0x0} |
0x8D08 |
L_CONTROL_TABLE_LENGHT_PLX |
Размер управляющей таблицы (максимум 128 логических каналов). По умолчанию - 8. |
0x8D0A |
L_IS_EXT_MEM_EXIST_L1450 |
Флажок наличия внешней памяти данных |
0x8D0B |
L_PAGE_MEMORY_L1450 |
Текущий номер используемой страницы внешней памяти (только для плат Rev.'A') |
0x8D41 |
L_TMODE1_L1450 |
Тестовая переменная. После загрузки драйвера (LBIOS) по этому адресу должно читаться число 0x5555. |
0x8D42 |
L_TMODE2_L1450 |
Тестовая переменная. После загрузки драйвера (LBIOS) по этому адресу должно читаться число 0xAAAA. |
0x8D43 |
L_ENA-DAC_IRQ_L1450 |
Данная переменная разрешает (0х1) либо запрещает (0х0) генерирование прерываний в PC по мере необходимости новых данных для FIFO буфера ЦАП. По умолчанию - 0х0. |
0x8D48 |
L_DSP_TYPE_L1450 |
Переменная, передающая драйверу (LBIOS) тип установленного на модуле DSP. Если она равна 0, то на плате установлен ADSP-2184 (4 КСлов памяти программ и 4 КСлов памяти данных). Если она равна 1, то - ADSP-2185 (16 кСлов памяти программ и 16 КСлов памяти данных). Если она равна 2, то - ADSP-2186 (8 КСлов памяти программ и 8 КСлов памяти данных). По умолчанию L_DSP_TYPE_L1450=0. |
0x8D4B |
L_DAC_DATA_STEP_L1450 |
Переменная, задающая шаг (число отсчетов) при генерировании прерываний в РС по мере необходимости в получении новых данных для FIFO буфера ЦАП. При помощи этой перемен-ной можно сделать так, что прерывания в РС будут генерироваться, например, после каждых 20 отсчетов выведенных на ЦАП. По умолчанию - 0х200. |
0x8D4C |
L_TTL_OUT_L1450 |
Слово (16 бит) , в котором по-битово хранятся значения 16ти выходных цифровых линий для их выставления по команде C_TTL_OUT_L1450. |
0x8D4D |
L_TTL_IN_L1450 |
Слово (16 бит), в котором после выполнения команды C_TTL_IN_L1450 по-битово хранятся значения 16ти входных цифровых линий. |
0x8D4E |
L_ENABLE_TTL_OUT_L1450 |
Данная переменная разрешает (0х1) либо запрещает (0х0) использование выходных цифровых линий (перевод их в третье состояние) |
0x8D53 |
L_ADC_RATE_L1450 |
Переменная, задающая частоту работы АЦП. |
0x8D54 |
L_INTER_KADR_SCALE_L1450 |
Переменная, совместно с L_INTER_KADR_ PERIOD_L1450 задающая межкадровую задержку при вводе данных с АЦП. |
0x8D55 |
L_DAC_RATE_L1450 |
Переменная, задающая частоту вывода данных с ЦАП-ов. |
0x8D57 |
L_ENA_ADC_IRQ_L1450 |
Данная переменная разрешает (0х1) либо запрещает (0х0) генерирование прерываний в PC по мере заполнения FIFO буфера АЦП. По умолчанию - 0х0. |
0x8D58 |
L_ADC_DATA_STEP_L1450 |
Переменная, задающая шаг (число отсчетов) при генерировании прерываний в РС по мере заполнения FIFO буфера АЦП. При помощи этой переменной можно сделать так, что прерывания в РС будут генерироваться, например, через каждые 20 отсчетов. По умолчанию - 0х400. |
0x8D5A |
L_INTER_KADR_PERIOD_L1450 |
Переменная, совместно с L_INTER_KADR_SCALE_L1450 задающая межкадровую задержку при вводе данных с АЦП. |
0x8D5C |
L_ADC_SAMPLE_L1450 |
Данная переменная используется при однократном вводе с АЦП, храня считанное значение. |
0x8D5D |
L_ADC_CHANNEL_L1450 |
Данная переменная используется при однократном вводе с АЦП, задавая логический номер канала. |
0x8D60 |
L_CORRECTION_ENABLE_L1450 |
Переменная запрещающая (0)/ разрешающая (1) корректировку данных аналоговых каналов при помощи калибровочных коэффициентов. По умолчанию L_CORRECTION_ENABLE=0х0. |
0x8D62 |
L_ADC_ENABLE_L1450 |
Переменная запрещающая(0)/разрешающая (1) работу АЦП. |
0x8D63 |
L_ADC_FIFO_BASE_ADDRESS_L1450 |
Текущий базовый адрес FIFO буфера АЦП. По умолчанию L_ADC_FIFO_BASE_ADDRESS_ L1450 = 0x2000. |
0x8D64 |
L_ADC_FIFO_BASE_ADDRESS_INDEX_L1450 |
Переменная, задающая требуемый базовый адрес FIFO буфера АЦП. Может принимать три значения:0 - базовый адрес начинается с адреса 0х0 только для ADSP-2185,1 - базовый адрес начинается с адреса 0х2000 только для ADSP-2185 и ADSP-2186,2 - базовый адрес начинается с адреса 0х3000 для ADSP-2185 и ADSP-2186 и с адреса 0х2000 для ADSP-2184. |
0x8D65 |
L_ADC_FIFO_LENGTH_L1450 |
Текущая длина FIFO буфера АЦП. По умолчанию L_ADC_FIFO_LENGTH_L1450 = 0x800. |
0x8D66 |
L_ADC_NEW_FIFO_LENGTH_L1450 |
Переменная, задающая требуемую длину FIFO буфера АЦП. |
0x8D67 |
L_DAC_ENABLE_L1450 |
Переменная запрещающая (0)/разрешающая (1) вывод данных из FIFO буфера ЦАП на сам ЦАП. |
0x8D68 |
L_DAC_FIFO_BASE_ADDRESS_L1450 |
Текущий базовый адрес FIFO буфера ЦАП. Данный буфер расположен в памяти программ DSP. По умолчанию L_DAC_FIFO_BASE_ ADDRESS_L1450 = 0xС00. |
0x8D69 |
L_DAC_FIFO_LENGTH_L1450 |
Текущая длина FIFO буфера ЦАП. По умолчанию L_DAC_FIFO_LENGTH_L1450 = 0x400. |
0x8D6A |
L_DAC_NEW_FIFO_LENGTH_L1450 |
Переменная, задающая требуемую длину FIFO буфера ЦАП. |
0x8D70 |
L_SYNCHRO_TYPE_L1450 |
Переменная, задающая тип синхронизации. |
0x8D73 |
L_SYNCHRO_AD_CHANNEL_L1450 |
При аналоговой синхронизации задает логический номер канала, по которому происходит синхронизация. |
0x8D74 |
L_SYNCHRO_AD_POROG_L1450 |
Порог аналоговой синхронизации. |
0x8D75 |
L_SYNCHRO_AD_MODE_L1450 |
Переменная, задающая режим синхронизации по переходу "снизу - вверх"(0) или "сверху - вниз"(1) |
0x8D76 |
L_SYNCHRO_AD_SENSITIVITY_L1450 |
Переменная, задающая тип синхронизации по уровню(0) или по переходу(1). |
Пояснения по работе с платой L791.
Это плата без сигнального процессора на борту - просто цифровой автомат. Передачу данных осуществляет по BusMaster каналу PCI.
Временные параметры сбора задаются таймерами.
Библиотека для работы с платой имеет интерфейс аналогичный интерфейсу других плат. Но есть некоторые особенности и ограничения:
циклические буфера в компьютере всегда имеют одно и тоже значение 128К отсчетов (32 разрядных) для АЦП и 128К отсчетов для ЦАП;
переменная -указатель sync служит не только для чтения счетчиков ПДП каналов, но и для прямого доступа к 32-х битным регистрам платы;
при этом указатель sync от потока ЦАП и от потока АЦП это одно и тоже;
прерывания от платы доходят к пользователю через события. При этом они разрешаются битами в параметре IrqEna в структуре описывающей сбор данных АЦП (младшие 16 бит ) и ЦАП (старшие 16 бит).
с платой можно работать и напрямую по регистрам управляя сбором данных, но только после команды StartLDevice надо дождаться появления бита ADC_En в регистре управления, после чего запретить сбор. Дальше можно делать что хочется. В плату уже прописаны адреса памяти для BusMaster каналов и установлен обработчик прерывания. Все что хочется можно делать до команды StopLDevice.
про регистры платы читайте печатную книжку;
про логические номера каналов читайте печатную книжку;
размер половины фифо буфера АЦП 1,2,4,8,16,32,64,128 отсчетов;
при работе следует иметь ввиду что настройки параметров сбора сохраняются внутри драйвера и при старт/стоп режиме если запрограммировали ЦАП и АЦП то они и будут работать, а если ЦАП стал не нужен, то надо сделать новую установку параметров где ЦАП отключить.
Пояснения по работе с модулем E14-140/E154.
Библиотека для работы с платой имеет интерфейс аналогичный интерфейсу других плат. Но есть некоторые особенности и ограничения:
у модуля не настраивается FIFO.
работа в библиотеке имитирует работу по прерываниям путем перепосылки запросов размером IrqStep к модулю и укладывания их в большой буфер.
максимальный размер IrqStep ограничен 64 кОтсчетов.
Коррекция данных выполняется пользователем.
Пояснения по работе с модулем E20-10.
Библиотека для работы с платой имеет интерфейс аналогичный интерфейсу других плат. Но есть некоторые особенности и ограничения:
у модуля не настраивается FIFO.
работа в библиотеке имитирует работу по прерываниям путем перепосылки запросов размером IrqStep к модулю и укладывания их в большой буфер.
максимальный размер IrqStep ограничен 1M Отсчетов.
Коррекция данных выполняется пользователем.
Пояснения по работе с платой L780M (rev C ).
Эта плата поддерживает потоковый вывод данных на ЦАП. Но есть особенности в формате данных для ЦАП.
Если вывод программируется как для обычной 780 платы, то формат данных в буфере USHORT, а если для потокового вывода 780M, то данные ULONG.
Пример кода:
USHORT data1;
for(int i=0;i<1024;i+=2) data1[i]=((USHORT)(1024.0*sin((2.0*(3.1415*i)/1024.0)))&0xFFF)|0x0000;
for(int i=1;i<1024;i+=2) data1[i]=((USHORT)(1024.0*sin((2.0*(3.1415*i)/1024.0)))&0xFFF)|0x1000;
// задается два синуса по двум каналам и из памяти DSP
или
ULONG data1;
for(int i=0;i<2048;i++) data1[i]=((USHORT)(512*sin((2.0*(3.1415*i)/1024.0)))&0xFFF)|0x0000;
// по 0 каналу синус и из буфера PC
Такая корявость получилась из-за сохранения совместимости для старых драйверов.