3. Funkce
Td_Close_Driver
Prototyp |
Td_Close_Driver(PHandle_ handle) |
Popis |
Zastaví veškerou činnost zařízení a ukončí se zařízením spojení. |
Podpora |
Implementováno pro všechna zařízení. |
Argumenty |
handle |
Handle otevřeného zařízení. |
Td_Config_Ability_Generate_IRQ
Prototyp |
Td_Config_Ability_Generate_IRQ(PHandle_ handle, DWORD global_ability, DWORD irqcfgreg) |
Popis |
Funkce pro aktivaci a deaktivaci přerušení od různých zdrojů.
Důležitá poznámka: Využití funkce je specifické pro zařízení a její použití způsobí obtížnou přenositelnost na jiné zařízení. |
Podpora |
Implementováno pro zařízení s generátorem časových značek. |
Argumenty |
handle |
Handle otevřeného zařízení. |
global_ability |
Povoluje/zakazuje možnost generování přerušení.
0: Globální zakázání přerušení.
1: Globální povolení přerušení. |
irqcfgreg |
Povoluje požadavky přerušení od zdrojů závislých na typu zařízení (viz. Uživatelská příručka zařízení).
Platné hodnoty jsou definovány možnostmi daného zařízení. |
Td_Config_Acquisition
Prototyp |
Td_Config_Acquisition(PHandle_ handle, DWORD parameter0, DWORD parameter1, DWORD index_of_channel, DWORD number_of_channels) |
Popis |
Funkce je určena pro konfiguraci kanálů v měřicí sekvenci; jejím opakovaným voláním je nutné vyplnit kontinuální pole kanálů od 0 do N-1 (N je počet měřených kanálů).
Upozornění: Konfiguraci je nutné provést před každým voláním Td_Start_Acquisition. |
Podpora |
Implementováno pro zařízení s blokovým přenosem dat. |
Argumenty |
handle |
Handle otevřeného zařízení. |
parameter0 |
Tato položka určuje jaká data se budou vracet v měřicí sekvenci na pozici kanálu.
0..255: Kanál zpřístupňuje analogové vstupy a zadaná hodnota definuje nastavení multiplexeru zařízení. Platné hodnoty jsou definovány možnostmi daného zařízení.
256..511: Kanál zpřístupňuje čítače (režim se softwarovým zásobníkem) nebo synchronně scanované čítače (režim s plně hardwarovým zásobníkem). Platné hodnoty jsou definovány možnostmi daného zařízení.
512..767: Kanál zpřístupňuje digitální vstupní porty (režim se softwarovým zásobníkem) nebo synchronně scanované digitální vstupní porty (režim s plně hardwarovým zásobníkem). Platné hodnoty jsou definovány možnostmi daného zařízení.
768: Kanál zpřístupňuje aktuální stav generátoru časových značek. Platné hodnoty jsou definovány možnostmi daného zařízení.
|
parameter1 |
Význam tohoto parametru je závislý na obsahu parameter0; platné hodnoty jsou definovány možnostmi daného zařízení. |
index_of_channel |
Číslo programovaného kanálu, tzn. 0, 1, … , N-1 (číslováno od nuly; ; mezní hodnota je N je number_of_channels). |
number_of_channels |
Počet měřených kanálů, tzn. N (číslováno od jedničky výše; mezní počet kanálů sekvence je omezen vlastnostmi zařízení, viz popis funkce
Td_Get_Info_DeviceType). |
Upřesnění |
 |
Příklad konfigurace podle obrázku výše byl vytvořen voláním funkce s parametry:
Td_Config_Acquisition(handle, 2, 3, 0, 4)
Td_Config_Acquisition(handle, 5, 1, 1, 4)
Td_Config_Acquisition(handle, 7, 0, 2, 4)
Td_Config_Acquisition(handle, 256, 123, 3, 4)
Na pořadí uvedených 4 volání funkce nazáleží, musí však být vyplněny všechny prvky a poslední volání musí obsahovat správný počet měřených kanálů.
Při využití některé z PCI karet řady PCA-7000A konfigurace zajistí měření … - analogového vstupu AIN2 s rozsahem 3 (tzn. ±1.25V)
- analogového vstupu AIN5 s rozsahem 1 (tzn. ±5V)
- analogového vstupu AIN7 s rozsahem 0 (tzn. ±10V)
- a čítače CNT0 při počáteční hodnotě 123.
|
Td_Config_Generating
Prototyp |
Td_Config_Generating(PHandle_ handle, DWORD parameter0, DWORD parameter1, DWORD index_of_channel, DWORD number_of_channels) |
Popis |
Funkce je určena pro konfiguraci výstupních kanálů v sekvencích pro generování; jejím opakovaným voláním je nutné vyplnit kontinuální pole kanálů od 0 do N-1 (N je počet kanálů v sekvenci).
Užití funkce je analogické funkci
Td_Config_Acquisition. |
Podpora |
Implementováno pro zařízení se synchronním generováním. |
Argumenty |
handle |
Handle otevřeného zařízení. |
parameter0 |
Tato položka určuje význam kanálů ukládaných v sekvencích připravovaných pro generování.
0..255: Kanál zpřístupňuje analogové výstupy, zadaná hodnota definuje číslo analogového výstupu (režim se softwarovým zásobníkem) nebo automaticky generovaného výstupu (režim s plně hardwarovým zásobníkem). Platné hodnoty jsou definovány možnostmi daného zařízení.
512..767: Kanál zpřístupňuje digitální výstupní porty (režim se softwarovým zásobníkem) nebo synchronně generované digitální výstupní porty (režim s plně hardwarovým zásobníkem). Platné hodnoty jsou definovány možnostmi daného zařízení.
|
parameter1 |
Význam tohoto parametru je závislý na obsahu parameter0; platné hodnoty jsou definovány možnostmi daného zařízení. |
index_of_channel |
Číslo programovaného kanálu, tzn. 0, 1, … , N-1 (číslováno od nuly; mezní hodnota je N je number_of_channels). |
number_of_channels |
Počet výstupních kanálů, tzn. N (číslováno od jedničky výše; mezní počet kanálů sekvence je omezen vlastnostmi zařízení, viz popis funkce
Td_Get_Info_DeviceType). |
Td_Config_Generating_Mode
Prototyp |
Td_Config_Generating_Mode(PHandle_ handle, DWORD p_mode, DWORD d_mode, DWORD wait_for_acquisition) |
Popis |
Funkce nastavuje režim a spouštění generování, dále se touto funkcí nastavuje režim potvrzování start/stop generovacího procesu. |
Podpora |
Implementováno pro zařízení se synchronním generováním. |
Argumenty |
handle |
Handle otevřeného zařízení. |
p_mode |
Režim, ve kterém zařízení bude pracovat:
0: všechny kanály přecházejí do režimu softwarového řízení, tzn. jsou ovládány funkcemi Td_Set_AO nebo Td_Set_DO
1: rezervováno
2: kanály konfigurované voláním funkce Td_Config_Generating jsou přepnuty do režimu automatického generování se spouštěním časovačem; ostatní kanály zůstávají v základním softwarovém řízení
3: kanály konfigurované voláním funkce Td_Config_Generating jsou přepnuty do režimu automatického generování se spouštěním externím signálem; ostatní kanály zůstávají v základním softwarovém řízení |
d_mode |
Nastavení zdroje dat pro generování:
0: datový stream; na výstup zařízení se při spuštěném generování přenášejí kontinuálně doplňovaná data
1: cyklický režim; na výstup zařízení se při spuštěném generování cyklicky přenáší přednastavená posloupnost dat
|
wait_for_acquisition |
Určuje synchronizaci startu/zastavení generování se startem/zastavením měření.
0: Generování je odstartováno běžně funkcí Td_Start_Generating a zastaveno Td_Stop_Generating.
1: Pro start/stop generování jsou použity funkce Td_Start_Acquisition a Td_Stop_Acquisition; použití funkcí Td_Start_Generating a Td_Stop_Generating je nepovinné.
Tak je zaručeno, že začátek i konec měření i generování proběhne současně. |
Td_Config_IRQTimer
Prototyp |
Td_Config_IRQTimer(PHandle_ handle, double* frequency, double* period) |
Popis |
Funkce pro nastavení frekvence generátoru časových značek.
Důležitá poznámka: Využití funkce je specifické pro zařízení a její použití způsobí obtížnou přenositelnost na jiné zařízení. |
Podpora |
Implementováno pro zařízení s generátorem časových značek. |
Argumenty |
handle |
Handle otevřeného zařízení. |
frequency |
Ukazatel na oblast paměti, do které je uložena hodnota "frekvence časových značek" [Hz]. |
period |
Ukazatel na oblast paměti, do které je uložena hodnota "čas mezi časovými značkami" [s] |
poznámka |
Z parametrů frequency a period musí být jeden 0 a druhý větší než 0. Vzájemný vztah parametrů je definován jako:
period = 1/frequency
Voláním funkce je do obou parametrů uložena skutečně nastavená hodnota (nejbližší možná požadované hodnotě).
Platné hodnoty jsou definovány možnostmi daného zařízení. |
Td_Config_ScanCounter
Prototyp |
Td_Config_ScanCounter(PHandle_ handle, DWORD parameter0, DWORD index_of_scancounter) |
Popis |
Funkce nastaví synchronně scanovaný čítač do požadovaného režimu. |
Podpora |
Implementováno pro multifunkční PCI karty PCA-7xx8AL/AS/EL. |
Argumenty |
handle |
Handle otevřeného zařízení. |
parameter0 |
0: Čítač je blokován a nezpracovává vstupní signál (tzn. nečítá vstupní impulsy).
1: Čítač zpracovává vstupní signál (aktivní sestupná hrana) nezávisle na stavu signálu Gate.
2: Čítač zpracovává vstupní signál (aktivní sestupná hrana) a čítání je hradlováno je signálem Gate (čítač čítá, je-li signál Gate v logické úrovni H).
3: Čítač zpracovává vstupní signál (aktivní sestupná hrana) a čítání je hradlováno je negovaným signálem Gate (čítač čítá, je-li signál Gate v logické úrovni L). |
index_of_scancounter |
číslo nastavovaného čítače (0 nebo 1) |
Td_Config_Timing_Acquisition
Prototyp |
Td_Config_Timing_Acquisition(PHandle_ handle, double* frequency, double* period) |
Popis |
1) Při blokovém měření spouštěným časovačem nastaví frekvenci měřicích sekvencí. 2) Při blokovém měření spouštěným externím vstupem nastaví optimální parametry zařízení podle nejvyšší předpokládané frekvence. 3) Při blokovém měření spouštěným generátorem časových značek nastavuje frekvenci generování pulsů a povoluje přerušení od generátoru časových značek. Tento režim interně využívá kombinace funkcí Td_Config_Ability_Generate_IRQ a Td_Config_IRQTimer a nelze jej proto kombinovat s uživatelskou obsluhou obvodů přerušení.
Hodnota je předána prostřednictvím frekvence nebo časovým úsekem mezi sekvencemi. |
Podpora |
Implementováno pro zařízení s blokovým přenosem dat. |
Argumenty |
handle |
Handle otevřeného zařízení. |
frequency |
Ukazatel na oblast paměti, do které je uložena hodnota "frekvence měřicích sekvencí" [Hz]. |
period |
Ukazatel na oblast paměti, do které je uložena hodnota "časového úseku mezi starty měřicích sekvencí" [s]. |
poznámka |
Z parametrů frequency a period musí být jeden 0 a druhý větší než 0. Vzájemný vztah parametrů je definován jako:
period = 1/frequency
Voláním funkce je do obou parametrů uložena skutečně nastavená hodnota (nejbližší možná požadované hodnotě).
Platné hodnoty jsou definovány možnostmi daného zařízení. |
Td_Config_Timing_Generating
Prototyp |
Td_Config_Timing_Generating(PHandle_ handle, double* frequency, double* period) |
Popis |
1) Při blokovém generování spouštěném časovačem nastaví frekvenci generovacích sekvencí.
2) Při blokovém generování spouštěném externím vstupem nastaví optimální parametry podle nejvyšší předpokládané frekvence spouštění externím vstupem.
Hodnota je předána prostřednictvím frekvence nebo časovým úsekem mezi sekvencemi. |
Podpora |
Implementováno pro zařízení se synchronním generováním. |
Argumenty |
handle |
Handle otevřeného zařízení. |
frequency |
Ukazatel na oblast paměti, do které je uložena hodnota "frekvence generovacích sekvencí" [Hz]. |
period |
Ukazatel na oblast paměti, do které je uložena hodnota "časového úseku mezi starty generovacích sekvencí" [s]. |
poznámka |
Z parametrů frequency a period musí být jeden 0 a druhý větší než 0. Vzájemný vztah parametrů je definován jako:
period = 1/frequency
Voláním funkce je do obou parametrů uložena skutečně nastavená hodnota (nejbližší možná požadované hodnotě).
Platné hodnoty jsou definovány možnostmi daného zařízení. |
Td_Driver_Version
Prototyp |
Td_Driver_Version(DWORD *Pversion_hi, DWORD *Pversion_low, DWORD select) |
Popis |
Vrací verzi nízkoúrovňové knihovny a knihovny TEDIA_DAQ01. |
Podpora |
Implementováno pro všechna zařízení. |
Argumenty |
Pversion_hi |
Ukazatel na oblast v paměti, do které funkce vyplní verzi knihovny TEDIA_DAQ01. Hlavní číslo verze (navyšuje se pouze při změnách zásadního charakteru) lze získat celočíselným vydělením 100, zbytek po vydělení určuje vedlejší číslo verze (číslo navyšované při každé zveřejněné kompilaci).
Verze "2.10" je tedy představována hodnotou "210". |
Pversion_low |
Ukazatel na oblast v paměti, do které funkce vyplní verzi nízkoúrovňové knihovny buď PCI nebo USB sběrnice v závislosti na parametru select.
Hlavní číslo verze lze získat celočíselným vydělením 100, zbytek po vydělení určuje vedlejší číslo verze.
Verze "1.8" je tedy představována hodnotou "180". |
select |
Volí nízkoúrovňovou knihovnu, pro kterou funkce poskytuje verzi.
0: Na adresu Pversion_low je uložena verze systémové knihovny pro obsluhu PCI karet (tedia_ox9162.dll).
1: Na adresu Pversion_low je uložena verze systémové knihovny pro USB moduly (ftd2xx.dll).
2: Na adresu Pversion_low je uložena verze systémové knihovny pro obsluhu PCI karet (tedia_ox952.dll). |
Td_Get_Buffer_Data
Prototyp |
Td_Get_Buffer_Data(PHandle_ handle, DWORD* buffer, DWORD size_of_buffer, DWORD* recorded_row) |
Popis |
Přečte maximální možný počet měřicích sekvencí z bufferu odměřených dat. |
Podpora |
Implementováno pro zařízení s blokovým přenosem dat. |
Argumenty |
handle |
Handle otevřeného zařízení. |
buffer |
Ukazatel na oblast paměti, do které funkce uloží naměřené kanály z jedné či více měřicích sekvencí (aplikace musí předat ukazatel na místo v paměti velké minimálně size_of_buffer*sizeof(DWORD)). |
size_of_buffer |
Počet kanálů, které se do bufferu mohou uložit. |
recorded_row |
Ukazatel na oblast paměti, do které funkce uloží informace o počtu zaznamenaných vstupních kanálů (jedna sekvence jich obsahuje několik). |
Td_Get_Buffer_Status
Prototyp |
Td_Get_Buffer_Status(PHandle_ handle, DWORD* count_new_row) |
Popis |
Vrací počet změřených kanálů (tvořících určitý počet měřicích sekvencí) právě uložených v bufferu při blokovém přenosu. |
Podpora |
Implementováno pro zařízení s blokovým přenosem dat. |
Argumenty |
handle |
Handle otevřeného zařízení. |
count_new_row |
Ukazatel na oblast paměti, do které funkce uloží počet odměřených kanálů. |
Td_Get_Counter
Prototyp |
Td_Get_Counter(PHandle_ handle, DWORD index_of_counter, DWORD* buffer, DWORD number_of_counters, DWORD source) |
Popis |
Přečte hodnoty souvislé skupiny čítačů zachycené funkcí Td_Load_Counter, první čítač je specifikován indexem. |
Podpora |
Implementováno pro zařízení se standardními čítači. |
Argumenty |
handle |
Handle otevřeného zařízení. |
index_of_counter |
Číslo čítače, od kterého čtení začíná. |
buffer |
Ukazatel na oblast paměti, do které funkce uloží hodnoty (aplikace musí předat ukazatel na místo v paměti velké minimálně number_of_counters*sizeof(DWORD)). |
number_of_counters |
Celkový počet čtených čítačů. |
source |
Identifikace zdroje hodnot ukládaných do bufferu.
0: Čtena zachycená aktuální hodnota čítačů.
1: Čtena hodnota čítačů zachycená externím signálem.
Podrobnosti viz popis funkce Td_Load_Counter . |
poznámka |
Podrobně viz obrázek s vazbami funkcí. |
Td_Get_Counter_Status
Prototyp |
Td_Get_Counter_Status(PHandle_ handle, DWORD index_of_counter, DWORD parameter, DWORD* value) |
Popis |
Funkce je určena pro zjištění stavových registrů čítačů zachycených funkcí Td_Load_Counter_Status, první čítač je specifikován indexem. |
Podpora |
Implementováno specificky pro zařízení se standardními čítači. |
Argumenty |
handle |
Handle otevřeného zařízení. |
index_of_counter |
Číslo čítače, jehož stavové registry získáváme. |
parameter |
Číslo specifického parametru. |
value |
Ukazatel na oblast paměti, do které funkce uloží hodnotu parametru. |
poznámka |
Podrobně viz obrázek s vazbami funkcí. |
Td_Get_DeviceName
Prototyp |
Td_Get_DeviceName(char* name, DWORD index_of_device) |
Popis |
Funkce poskytne jméno zařízení specifikované indexem v rozsahu 0, 1, … , N-1 (číslováno od nuly; mezní hodnotu N definující počet jmen lze zjistit funkcí Td_Get_Number_Of_Devices ze seznamu jmen v administračním programu. |
Podpora |
Funkce nezávislá na zařízení. |
Argumenty |
name |
Ukazatel na uživatelem alokované místo v paměti (alokovat je třeba pole minimálně 100 znaků), do kterého funkce vyplní jméno zařízení specifikovaného indexem. |
index_of_device |
Index do pole jmen. |
Td_Get_DeviceType
Prototyp |
Td_Get_DeviceType(char* name, DWORD index_of_type) |
Popis |
Funkce poskytne typ zařízení specifikované indexem v rozsahu 0, 1, … , N-1 (číslováno od nuly; mezní hodnotu N definující počet jmen lze zjistit funkcí Td_Get_Number_Of_Devices ze seznamu jmen v administračním programu. |
Podpora |
Funkce nezávislá na zařízení. |
Argumenty |
name |
Ukazatel na uživatelem alokované místo v paměti (alokovat je třeba pole minimálně 100 znaků), do kterého funkce vyplní jméno typu specifikovaného indexem. |
index_of_type |
Index do pole typů. |
Td_Get_DI
Prototyp |
Td_Get_DI(PHandle_ handle, DWORD index_of_input, DWORD* buffer, DWORD number_of_inputs) |
Popis |
Přečte souvislou skupinu vstupních digitálních portů, první specifikován indexem. |
Podpora |
Implementováno pro zařízení se vstupními digitálními porty. |
Argumenty |
handle |
Handle otevřeného zařízení. |
index_of_input |
Číslo digitálního portu, od kterého čtení začíná. |
buffer |
Ukazatel na oblast paměti, do které jsou uloženy aktuální hodnoty (aplikace musí předat ukazatel na místo v paměti velké minimálně number_of_inputs*sizeof(DWORD)). |
number_of_inputs |
Celkový počet čtených digitálních portů. |
Td_Get_ErrorMessage
Prototyp |
Td_Get_ErrorMessage(DWORD error, char* name_of_function, char* name_of_error) |
Popis |
Funkce získá textový popis chyby a název funkce, která chybu oznámila. |
Podpora |
Implementováno pro všechna zařízení. |
Argumenty |
error |
Číslo chyby získané z kterékoliv funkce Td_XXX jako návratová hodnota. |
name_of_function |
Ukazatel na místo v paměti alokované uživatelem na minimálně 100 znaků, do kterého je uložen název funkce, která chybu vrátila. |
name_of_error |
Ukazatel na místo v paměti alokované uživatelem na minimálně 100 znaků, do kterého je uložen textový popis chyby. |
Td_Get_Generating_Status
Prototyp |
Td_Get_Generating_Status(PHandle_ handle, DWORD name_of_parameter, DWORD* result) |
Popis |
Funkce zjistí hodnotu parametru bufferu souvisejícího s generováním. |
Podpora |
Implementováno pro zařízení se synchronním generováním. |
Argumenty |
handle |
Handle otevřeného zařízení. |
name_of_parameter |
Číslo parametru vybraného z následujících konstant:
0: Aktuální zaplnění zásobníku knihovny TEDIA_DAQ01 (tzn. počet vzorků aktuálně uložených v zásobníku knihovny, ze kterého data jsou data přenášena do zásobníku zařízení a následně na výstup zařízení). Data se do tohoto zásobníku doplňují funkcí Td_Set_Buffer_Data.
1: Volná kapacita bufferu knihovny TEDIA_DAQ01 (tzn. počet vzorků, které lze zapsat).
2: Zaplnění bufferu zařízení (tzn. počet vzorků aktuálně uložených v bufferu zařízení); má význam pro počáteční přenos dat před zahájením generování. |
Td_Get_Info_DeviceName
Prototyp |
Td_Get_Info_DeviceName(char* name, DWORD parameter, double* numerical_result, char* alphanumeric_result, DWORD* type_of_result) |
Popis |
Funkce poskytující informace o zařízení zadaném jeho jménem. |
Podpora |
Funkce nezávislá na zařízení.
Poznámka: Není-li parametr pro dané zařízení definován, vrací funkce v type_of_result nulu. |
Argumenty |
name |
Jméno zařízení zadané v administračním programu. |
parameter |
1: název typu zařízení
2: stav zařízení: 0 => Zařízení je známé, ale není dostupné v systému.
1 => Zařízení je připravené k měření.
2 => Zařízení není přístupné.
3 => Zařízení nelze obsluhovat knihovnou TEDIA_DAQ01.
4 => Neznámé jméno zařízení.
3: identifikační číslo zařízení (pro každé fyzické zařízení v systému odlišné)
4: sériové číslo zařízení (pouze pro zařízení na sběrnici USB)
V případě zadání více jmen (tzv. aliasů) pro jedno zařízení v administračním programu bude číslo získané pro tato jména stejné.
|
numerical_result |
Ukazatel na oblast paměti, do které je uložena hodnota parametru v případě, že hodnota je celočíselná. |
alphanumeric_result |
Ukazatel na oblast paměti, do které je uložena hodnota parametru v případě, že hodnota je řetězec. Alokuje uživatel na velikost minimálně 256 znaků. |
type_of_result |
Ukazatel na oblast paměti, do které je uložen typ vraceného parametru.
0: Funkce nezná název parametru předaný číslem v parameter, žádnou hodnotu v numerical_result ani v alphanumeric_result nevrací.
1: Vrácený typ je číselný (platná návratová hodnota je pouze v numerical_result).
2: Vrácený typ je řetězec (platná návratová hodnota je pouze v alphanumeric_result).
3: Vrácený typ je řetězec i číslo (platná návratová hodnota je v numerical_result i v alphanumeric_result).
|
Td_Get_Info_DeviceType
Prototyp |
Td_Get_Info_DeviceType(char* name_of_type, DWORD parameter, double* numerical_result, char* alphanumeric_result, DWORD* type_of_result) |
Popis |
Funkce poskytující informace o požadovaném zařízení zadaném názvem jeho typu.
Název jeho typu lze k zařízení známého jména zjistit pomocí funkce Td_Get_Info_DeviceName. |
Podpora |
Funkce nezávislá na zařízení.
Poznámka: Není-li parametr pro dané zařízení definován (např. počet analogových vstupů u PCI karty digitálních portů), vrací funkce v type_of_result nulu. |
Argumenty |
name_of_type |
Název typu zařízení (např. PCA-7428AL) pro které se zjišťují vlastnosti. |
parameter |
1001: IRQTimer - max. frekvence
1002: IRQTimer - min. frekvence
1201: CNT - počet čítačů
1202: CNT - počet datových bitů
1203: CNT - počet platných bitů
1204: CNT - typ čítačů
0 => standardní
1 => obousměrný
2 => s časovačem
1301: DI - počet portů
1302: DI - počet datových bitů
1303: DI - počet platných bitů
1304: DI - typ portů
0 => standardní
1 => obousměrný
1501: AO - počet výstupů
1502: AO - počet datových bitů
1503: AO - počet platných bitů
1504: AO - typ výstupů
0 => napěťový
1 => proudový
1510: AO - počet rozsahů
1511: AO - minimum rozsahu 0
1512: AO - maximum rozsahu 0
1513: AO - minimum rozsahu 1
1514: AO - maximum rozsahu 1
1515: AO - minimum rozsahu 2
1516: AO - maximum rozsahu 2
1517: AO - minimum rozsahu 3
1518: AO - maximum rozsahu 3
1701: DO - počet portů
1702: DO - počet datových bitů
1703: DO - počet platných bitů
1704: DO - typ portů
0 => standardní
1 => obousměrný
2001: ScanBuffer - max. frekvence
2002: ScanBuffer - min. frekvence
2010: ScanBuffer - max. počet kanálů sekvence
2101: ScanAI - počet vstupů
2102: ScanAI - počet datových bitů
2103: ScanAI - počet platných bitů
2104: ScanAI - typ vstupů
0 => napěťový
1 => proudový
2110: ScanAI - počet rozsahů
2111: ScanAI - minimum rozsahu 0
2112: ScanAI - maximum rozsahu 0
2113: ScanAI - minimum rozsahu 1
2114: ScanAI - maximum rozsahu 1
2115: ScanAI - minimum rozsahu 2
2116: ScanAI - maximum rozsahu 2
2117: ScanAI - minimum rozsahu 3
2118: ScanAI - maximum rozsahu 3
2119: ScanAI - minimum rozsahu 4
2120: ScanAI - maximum rozsahu 4
2121: ScanAI - minimum rozsahu 5
2122: ScanAI - maximum rozsahu 5
2123: ScanAI - minimum rozsahu 6
2124: ScanAI - maximum rozsahu 6
2201: ScanCNT - počet čítačů
2202: ScanCNT - počet datových bitů
2203: ScanCNT - počet platných bitů
2204: ScanCNT - typ čítačů
0 => standardní
1 => obousměrný
2 => s časovačem
2301: ScanDI - počet portů
2302: ScanDI - počet datových bitů
2303: ScanDI - počet platných bitů
2304: ScanDI - typ portů
0 => standardní
1 => obousměrný
2501: GenerBuffer - max. frekvence v režimu stream
2502: GenerBuffer - min. frekvence v režimu stream
2503: GenerBuffer - max. frekvence v cyklickém režimu
2504: GenerBuffer - min. frekvence v cyklickém režimu
2505: GenerBuffer - velikost bufferu v cyklickém režimu
2506: GenerBuffer - podpora cyklického režimu (1 = ano)
2510: GenerBuffer - max. počet kanálů sekvence
2601: GenerAO - počet bufferovaných výstupů
2602: GenerAO - počet datových bitů
2603: GenerAO - počet platných bitů
2604: GenerAO - typ výstupů
0 => napěťový
2605: GenerAO - počet rozsahů
2606: GenerAO - minimum rozsahu 0
2607: GenerAO - maximum rozsahu 0
2608: GenerAO - minimum rozsahu 1
2609: GenerAO - maximum rozsahu 1
2610: GenerAO - minimum rozsahu 2
2611: GenerAO - maximum rozsahu 2
2612: GenerAO - minimum rozsahu 3
2613: GenerAO - maximum rozsahu 3
2614: GenerAO - minimum rozsahu 4
2615: GenerAO - maximum rozsahu 4
2616: GenerAO - minimum rozsahu 5
2617: GenerAO - maximum rozsahu 5
|
numerical_result |
Ukazatel na oblast paměti, do které je uložena hodnota parametru v případě, že hodnota je celočíselná. |
alphanumeric_result |
Ukazatel na oblast paměti, do které je uložena hodnota parametru v případě, že hodnota je řetězec. Alokuje uživatel na velikost minimálně 256 znaků. |
type_of_result |
Ukazatel na oblast paměti, do které je uložen typ vraceného parametru.
0: Funkce nezná název parametru předaný číslem v parameter, žádnou hodnotu v numerical_result ani v alphanumeric_result nevrací.
1: Vrácený typ je číselný (platná návratová hodnota je pouze v numerical_result).
2: Vrácený typ je řetězec (platná návratová hodnota je pouze v alphanumeric_result).
3: Vrácený typ je řetězec i číslo (platná návratová hodnota je v numerical_result i v alphanumeric_result).
|
Td_Get_Number_Of_Devices
Prototyp |
Td_Get_Number_Of_Devices(DWORD* number_of_devices) |
Popis |
Funkce vrací počet jmen zařízení zadaných v administračním programu. |
Podpora |
Funkce nezávislá na zařízení. |
Argumenty |
number_of_devices |
Ukazatel na oblast paměti, do které je uložen počet jmen. |
Td_Get_Number_Of_Types
Prototyp |
Td_Get_Number_Of_Types(DWORD* number_of_types) |
Popis |
Funkce vrací počet podporovaných zařízení. |
Podpora |
Funkce nezávislá na zařízení. |
Argumenty |
number_of_types |
Ukazatel na oblast paměti, do které je uložen počet podporovaných zařízení. |
Td_Get_Parameters
Prototyp |
Td_Get_Parameters(PHandle_ handle, DWORD parameter, double* numerical_result, char* alphanumeric_result, DWORD* result_type) |
Popis |
Zjistí hodnoty parametrů aktuálního zařízení. Každý parametr reprezentuje vnitřní proměnnou TEDIA_DAQ01. Pracuje ve dvou režimech: Typ 1: Nastavení parametrů pro zařízení, handle musí být platné
Typ 2: Nastavení parametrů celé knihovny - handle není použit, může obsahovat libovolnou hodnotu.
Pro Typ 1 platí: nemusí se vždy shodovat s hodnotou skutečně nastavenou v zařízení. Například u parametrů zpoždění po odměření analogových kanálů (parameter=1-7) může být hodnota v zařízení odlišná z těchto důvodů:
1) Není zadáno, že se hodnoty mají ukládát (parameter=0).
2) Hodnoty se ukládají do zařízení až po zavolání funkce Td_Start_Acquisition.
Důležitá poznámka: Parametry jsou specifické jednotlivým zařízením a použití této funkce způsobí obtížnou přenositelnost na jiné zařízení.
Konfigurační dialog vizuálně zobrazující parametry lze z aplikace otevřít funkcí Td_Visual_Parameters. |
Podpora |
Implementováno pro vybraná zařízení. |
Argumenty |
handle |
Handle otevřeného zařízení. |
parameter |
Pro Typ 1: Číslo specifického parametru nadefinované možnostmi daného zařízení.
Parametry Typ 2:
350: Jazyk kterým knihovna komunikuje s uživatelem value = 0: čeština, value = 1: angličtina, 2..9: další jazyky kontinuálně následují, jsou-li definovány
400: Počet jazyků, ve kterých knihovna dokáže komunikovat, type_of_result = 0.
401-410: Název jazyku který je na indexu 0. 1. 2. - 9. (401 pro čestina, 402 pro angličtina), type_of_result = 1.
|
numerical_result |
Ukazatel na oblast paměti, do které je uložena hodnota parametru v případě, že hodnota je celočíselná. |
alphanumeric_result |
Ukazatel na oblast paměti, do které je uložena hodnota parametru v případě, že hodnota je řetězec. Alokuje uživatel na velikost minimálně 1024 znaků. |
type_of_result |
Ukazatel na oblast paměti, do které je uložen typ vraceného parametru.
0: Vrácený typ je číselný (platná návratová hodnota je pouze v numerical_result).
1: Vrácený typ je řetězec (platná návratová hodnota je pouze v alphanumeric_result).
|
poznámka |
Dáno možnostmi daného zařízení. |
Td_Get_SingleAcquisition
Prototyp |
Td_Get_SingleAcquisition(PHandle_ handle, DWORD* buffer, DWORD size_of_buffer) |
Popis |
V režimu jednorázového spouštění odměří jednu měřicí sekvenci a uloží ji do uživatelského bufferu. |
Podpora |
Implementováno pro vybraná zařízení (zpravidla s analogovými vstupy). |
Argumenty |
handle |
Handle otevřeného zařízení. |
buffer |
Ukazatel na oblast paměti, do které funkce uloží data vytvořená odměřením jedné sekvence kanálů (alokuje uživatel minimálně na velikost size_of_buffer*sizeof(DWORD)). |
size_of_buffer |
Maximální počet kanálů, který se může do pole uložit. |
Td_Get_State_Buffer_Data_Input
Prototyp |
Td_Get_State_Buffer_Data_Input(PHandle_ handle, DWORD* state) |
Popis |
Vrací stav hlavního vlákna zapisujícího data do vyrovnávacího bufferu příslušného zařízení při časovačem nebo externě spouštěném měření (odstartováno funkcí Td_Start_Acquisition). Pokud se zastaví měření v důsledku přeplnění bufferu, detekuje tento stav právě tato funkce. |
Podpora |
Implementováno pro zařízení s blokovým přenosem dat. |
Argumenty |
handle |
Handle otevřeného zařízení. |
state |
Ukazatel na oblast paměti, do které je uložen stav vlákna.
0: Vlákno je připraveno k příjmu dat.
1: Buffer měřicího zařízení se zaplnil, vlákno se zastavilo, protože další data mohou být neplatná.
2: Buffer knihovny TEDIA_DAQ01 se zaplnil, vlákno se zastavilo, protože další data mohou být neplatná.
Je-li návratová hodnota 1 nebo 2, je nutné měření zastavit a po novém nakonfigurování zařízení znovu odstartovat. |
Td_Init_Driver
Prototyp |
Td_Init_Driver(PHandle_* handle, char* name) |
Popis |
Zpřístupní zařízení zadané jménem (jméno je možné získat funkcí Td_Get_DeviceName, nebo administračním programem). |
Podpora |
Implementováno pro všechna zařízení. |
Argumenty |
handle |
Handle otevřeného zařízení. |
name |
Jméno zařízení uložené v poli ukončeném znakem \0 (C++) nebo Chr(0) (Pascal). Pole může být maximálně 19 znaků dlouhé a formát dat nesmí být Unicode. |
Td_Load_Counter
Prototyp |
Td_Load_Counter(PHandle_ handle, DWORD source) |
Popis |
Funkce načte aktuální hodnoty čítačů nebo hodnoty zachycené externím pulsem do registrů knihovny pro následné použití funkcí Td_Get_Counter.
Poznámka: Funkce načte hodnoty všech čítačů zařízení. |
Podpora |
Implementováno pro zařízení se standardními čítači. |
Argumenty |
handle |
Handle otevřeného zařízení. |
source |
Volba zdroje načítaných hodnot.
0: Načtena aktuální hodnota čítačů.
1: Načtena hodnota zachycená v okamžiku externího pulsu; obvody pro zachycení hodnoty čítače jsou současně zaktivovány pro detekci dalšího pulsu. Pro tuto volbu je potřeba aktivovat funkci zachycení, viz. Td_Set_Counter_Parameters - parameter=14 |
poznámka |
Podrobně viz obrázek s vazbami funkcí. |
Td_Load_Counter_Status
Td_Read_DevEE
Prototyp |
Td_Read_DevEE(PHandle_ handle, DWORD index_of_page, DWORD* buffer) |
Popis |
Načte požadovaná data z paměti EEPROM vybraného zařízení (paměť uchovávající obsah i při vypnutém napájení).
Pokyny pro práci s pamětí:
Paměť je uspořádaná do stránek velikosti 256 byte číslovaných od nuly.
Skutečnou velikost volné paměti lze zjistitit funkcí Td_Size_DevEE. |
Podpora |
Funkce nezávislá na zařízení. |
Argumenty |
handle |
Handle otevřeného zařízení. |
index_of_page |
Index stránky paměti ze které se čte. |
buffer |
Paměťová oblast pro data načtená z paměti EEPROM organizovaná jako pole prvků DWORDů; data typu byte jsou přenášena na nejnižších 8 bitech.
Z paměti EEPROM je načteno pouze tolik prvků, kolik jich zvolená stránka skutečně obsahuje a zbývající prostor paměťové oblasti je ponechán beze změny (pro každou stránku kromě poslední je načteno vždy 256 prvků). |
poznámka |
Dáno možnostmi daného zařízení. |
Td_Save_Counter
Td_Save_Counter_Parameters
Td_Save_StartStop_Counter
Td_Set_AO
Prototyp |
Td_Set_AO(PHandle_ handle, DWORD index_of_output, DWORD* buffer, DWORD number_of_outputs) |
Popis |
Nastaví souvislou skupinu analogových výstupů, první specifikujeme indexem. |
Podpora |
Implementováno pro zařízení s analogovými výstupy. |
Argumenty |
handle |
Handle otevřeného zařízení. |
index_of_output |
Číslo výstupu, od kterého začíná zápis. |
buffer |
Ukazatel na pole hodnot. |
number_of_outputs |
Počet výstupů, které se nastavují. |
Td_Set_Buffer_Data
Prototyp |
Td_Set_Buffer_Data(PHandle_ handle, DWORD* buffer, DWORD size_buffer, DWORD* number_of_set) |
Popis |
Zapíše maximální možný počet sekvencí do bufferu dat připravených pro generování. |
Podpora |
Implementováno pro zařízení se synchronním generováním. |
Argumenty |
handle |
Handle otevřeného zařízení. |
buffer |
Ukazatel na oblast paměti, ze které funkce načte hodnoty kanálů definujících jednu, či více sekvencí pro generování. |
size_of_buffer |
Počet výstupních kanálů, které jsou v bufferu. |
number_of_set |
Ukazatel na oblast paměti, do které funkce uloží informace o skutečném počtu vyzvednutých výstupních kanálů z uživatelova bufferu. Poznámka: Funkce nemusí převzít všechna data (z důvodu plného vnitřního bufferu knihovny), proto je třeba příznak number_of_set testovat! |
Td_Set_Counter
Prototyp |
Td_Set_Counter(PHandle_ handle, DWORD index_of_counter, DWORD* buffer, DWORD number_of_counters) |
Popis |
Funkce slouží pro nastavení předvolby vybraných čítačů.
Funkce uloží hodnoty do registrů knihovny a do zařízení se následně přenesou funkcí Td_Save_Counter. |
Podpora |
Implementováno pro zařízení se standardními čítači. |
Argumenty |
handle |
Handle otevřeného zařízení. |
index_of_counter |
Index prvního čítače kterým se začíná zápis. |
buffer |
Ukazatel na oblast paměti obsahující pole zapisovaných hodnot.
Podporuje-li zařízení pouze nulování, platná hodnota je v takovém případě pouze "0". |
number_of_counters |
Počet zapisovaných předvoleb. |
poznámka |
Podrobně viz obrázek s vazbami funkcí. |
Td_Set_Counter_Parameters
Prototyp |
Td_Set_Counter_Parameters(PHandle_ handle, DWORD index_of_counter, DWORD parameter, DWORD value) |
Popis |
Funkce slouží pro nastavení parametrů zařízení obsahujícího čítače.
Funkce uloží hodnoty do registrů knihovny a do zařízení se následně přenesou funkcí Td_Save_Counter_Parameters. |
Podpora |
Implementováno pro zařízení se standardními čítači. |
Argumenty |
handle |
Handle otevřeného zařízení. |
index_of_counter |
Index nastavovaného čítače. |
parameter |
Číslo specifického parametru. |
value |
Požadovaná hodnota parametru. |
poznámka |
Podrobně viz obrázek s vazbami funkcí. |
Td_Set_DO
Prototyp |
Td_Set_DO(PHandle_ handle, DWORD index_of_output, DWORD* buffer, DWORD number_of_outputs) |
Popis |
Nastaví souvislou skupinu digitálních výstupních portů, první je specifikován indexem. |
Podpora |
Implementováno pro zařízení s digitálními výstupními porty. |
Argumenty |
handle |
Handle otevřeného zařízení. |
index_of_output |
Číslo digitálního portu, od kterého začíná zápis. |
buffer |
Ukazatel na oblast paměti obsahující pole hodnot. |
number_of_outputs |
Počet digitálních portů. |
Td_Set_Parameters
Prototyp |
Td_Set_Parameters(PHandle_ handle, DWORD parameter, double numerical_input, char* alphanumeric_input, DWORD type_of_input, DWORD permanency) |
Popis |
Nastaví aktuální nebo aktuální a implicitní parametry knihovny, popř. zařízení (např. hodnoty pro modifikaci časových poměrů uvnitř sekvence, rozhodovací hodnoty frekvencí a některé další parametry).
Pracuje ve dvou režimech: Typ 1: Nastavení parametrů pro zařízení, handle musí být platné
Typ 2: Nastavení parametrů celé knihovny - handle není použit, může obsahovat libovolnou hodnotu.
Důležitá poznámka: Všechna nastavení lze provést z administračního programu; parametry jsou specifické jednotlivým zařízením a použití této funkce způsobí obtížnou přenositelnost na jiné zařízení.
Konfigurační dialog lze z aplikace otevřít funkcí Td_Visual_Parameters.
|
Podpora |
Implementováno pro vybraná zařízení. |
Argumenty |
handle |
Pro Typ 1: Handle otevřeného zařízení.
Pro Typ 2: Bez významu. |
parameter |
Pro Typ 1: Číslo specifického parametru je nadefinované možnostmi daného zařízení.
Parametry Typ 2:
350: Jazyk kterým knihovna komunikuje s uživatelem; numerical_input = 0: čeština, numerical_input = 1: angličtina
|
numerical_input |
Hodnota nastavovaného parametru (v případě, že hodnota je celočíselná). |
alphanumeric_input |
Ukazatel na oblast paměti, do které je uložena hodnota nastavovaného parametru v případě, že hodnota je řetězec. Alokuje uživatel na velikost minimálně 1024 znaků. |
type_of_input |
typ nastavovaného parametru.
0: typ je číselný (bere se v potaz pouze hodnota v numerical_input).
1: typ je řetězec (bere se v potaz pouze hodnota v alphanumeric_input).
|
permanency |
Určuje trvalé či dočasné nastavení vybrané hodnoty.
0: hodnoty nastaveny pro aktuální spojení se zařízením
1: hodnoty nastaveny trvale (uloženy v registru) |
Td_Size_DevEE
Prototyp |
Td_Size_DevEE(PHandle_ handle, DWORD* size) |
Popis |
Vrací velikost volné paměti EEPROM, přístupné pomocí funkcí Td_Write_DevEE a Td_Read_DevEE. |
Podpora |
Funkce nezávislá na zařízení. |
Argumenty |
handle |
Handle otevřeného zařízení. |
size |
Ukazatel na proměnnou, do které je uložena velikost volné paměti v bytech.
Paměť je organizovaná do stránek velikosti 256 byte indexovaných od nuly. Není-li volná paměť celistvým násobkem 256, pak skutečná kapacita poslední stránky je omezena na zbytek po celočíselném dělení 256
Předaná hodnota size po vydělení 256 a zaokrouhlení nahoru představuje počet stránek.
Zbytek po celočíselném dělení 256 představuje skutečnou kapacitu poslední stránky. |
Td_Start_Acquisition
Prototyp |
Td_Start_Acquisition(PHandle_ handle, DWORD mode) |
Popis |
Odstartuje blokové měření podle zadaných parametrů. Při spouštění časovačem následují funkce pro odebírání dat, při softwarovém spouštění pak funkce Td_Get_SingleAcquisition. |
Podpora |
Implementováno pro zařízení s blokovým přenosem dat. |
Argumenty |
handle |
Handle otevřeného zařízení. |
mode |
Režim, ve kterém zařízení bude pracovat:
1: zařízení pracuje se softwarovým spouštěním
2: zařízení pracuje se spouštěním časovačem
3: zařízení pracuje se spouštěním externím signálem |
poznámka |
Dáno možnostmi daného zařízení. |
Td_Start_Buffer_Data_Request
Prototyp |
Td_Start_Buffer_Data_Request(PHandle_ handle, TProc_buffer proc, DWORD request_row, DWORD call_proc_every, void* Pmy_body) |
Popis |
V režimu spouštění časovačem nebo externím vstupem spustí vlákno, které příjímá naměřené sekvence a vytváří z nich kolekce.
Je-li kolekce kompletní (skládá se z call_proc_every sekvencí), je vyvolána uživatelem definovaná funkce typu TProc_buffer provádějící zpracování podle požadavků. Funkce Td_Start_Buffer_Data_Request funguje pouze jako požadavek spouštějící vlákno, tzn. nečeká a ukončí se bezprostředně po volání a vlákno pracuje samostatně.
Upozornění:
Uživatelem definovaná funkce typu TProc_buffer nesmí obsahovat akce, které musí být spuštěny synchronized (diskové operace výstup na obrazovku, atd..)!
Je-li třeba provést v uživatelské funkci akce synchronized, je potřeba užít funkci Td_Start_Buffer_Data_Request_Sync.
Poznámka: Tuto funkci nelze využít v prostředí Visual Basicu. |
Podpora |
Implementováno pro zařízení s blokovým přenosem dat. |
Argumenty |
handle |
Handle otevřeného zařízení. |
proc |
Ukazatel na uživatelem definovanou funkci, která bude provádět zpracování kolekce sekvencí. |
request_row |
Počet sekvencí, které jsou celkem požadovány.
Předáním záporné hodnoty je spuštěno nepřetržité měření ukončitelné pouze funkcemi Td_Close_Driver, nebo Td_Stop_Buffer_Data_Request. |
call_proc_every |
Počet sekvencí v kolekci. Požadovaný počet přijatých sekvencí vedoucích k volání proc. |
Pmy_body |
Ukazatel předaný uživatelské funkci pro interní potřebu uživatele (uživatelská funkce nesmí být metodou žádného objektu, je třeba zaručit aby mohla nějak předat data uživateli). Do tohoto parametru může uživatel uložit například adresu svého objektu a v uživatelské funkci k atributům svého objektu přes tento ukazatel přistupovat. |
Td_Start_Buffer_Data_Request_Sync
Prototyp |
Td_Start_Buffer_Data_Request_Sync(PHandle_ handle, TProc_buffer proc, DWORD request_row, DWORD call_proc_every, void* Pmy_body) |
Popis |
V režimu spouštění časovačem nebo externím vstupem spustí vlákno, které příjímá naměřené sekvence a vytváří z nich kolekce.
Je-li kolekce kompletní (skládá se z call_proc_every sekvencí), je vyvolána uživatelem definovaná funkce typu TProc_buffer provádějící zpracování podle požadavků. Funkce Td_Start_Buffer_Data_Request_Sync funguje pouze jako požadavek spouštějící vlákno, tzn. nečeká a ukončí se bezprostředně po volání a vlákno pracuje samostatně.
V uživatelské funkci dovoluje užít synchronized akce, nejsou-li ale synchronized operace třeba v uživatelské obsluze, pak je vhodné užít raději funkci Td_Start_Buffer_Data_Request, která bude pracovat výrazně optimálněji.
Poznámka: Tuto funkci nelze využít v prostředí Visual Basicu. |
Podpora |
Implementováno pro zařízení s blokovým přenosem dat. |
Argumenty |
handle |
Handle otevřeného zařízení. |
proc |
Ukazatel na uživatelem definovanou funkci, která bude provádět zpracování kolekce sekvencí. |
request_row |
Počet sekvencí, které jsou celkem požadovány.
Předáním záporné hodnoty je spuštěno nepřetržité měření ukončitelné pouze funkcemi Td_Close_Driver, nebo Td_Stop_Buffer_Data_Request. |
call_proc_every |
Počet sekvencí v kolekci. Požadovaný počet přijatých sekvencí vedoucích k volání proc. |
Pmy_body |
Ukazatel předaný uživatelské funkci pro interní potřebu uživatele (uživatelská funkce nesmí být metodou žádného objektu, je třeba zaručit aby mohla nějak předat data uživateli). Do tohoto parametru může uživatel uložit například adresu svého objektu a v uživatelské funkci k atributům svého objektu přes tento ukazatel přistupovat. |
Td_Start_Counter
Prototyp |
Td_Start_Counter(PHandle_ handle, DWORD index_of_counter) |
Popis |
Funkce uloží informaci o startu příslušného čítače do registrů knihovny. Skutečné spuštění se provede funkcí Td_Save_StartStop_Counter. |
Podpora |
Implementováno pro zařízení se standardními čítači. |
Argumenty |
handle |
Handle otevřeného zařízení. |
index_of_counter |
Index čítače, který má být odstartován. |
poznámka |
Podrobně viz obrázek s vazbami funkcí. |
Td_Start_Generating
Prototyp |
Td_Start_Generating(PHandle_ handle) |
Popis |
Odstartuje blokové generování podle dosud zadaných parametrů.
Je-li nastaven parametr wait_for_acquisition ve funkci Td_Config_Generating_Mode na hodnotu 1, pak je třeba start potvrdit funkcí Td_Start_Acquisition. |
Podpora |
Implementováno pro zařízení se synchronním generováním. |
Argumenty |
handle |
Handle otevřeného zařízení. |
Td_Stop_Acquisition
Prototyp |
Td_Stop_Acquisition(PHandle_ handle) |
Popis |
Ukončí měření spuštěné Td_Start_Acquisition. |
Podpora |
Implementováno pro zařízení s blokovým přenosem dat. |
Argumenty |
handle |
Handle otevřeného zařízení. |
Td_Stop_Buffer_Data_Request
Prototyp |
Td_Stop_Buffer_Data_Request(PHandle_ handle) |
Popis |
Ukončí činnost zahájenou funkcí Td_Start_Buffer_Data_Request. |
Podpora |
Implementováno pro zařízení s blokovým přenosem dat. |
Argumenty |
handle |
Handle otevřeného zařízení. |
Td_Stop_Counter
Prototyp |
Td_Stop_Counter(PHandle_ handle, DWORD index_of_counter) |
Popis |
Funkce uloží informaci o zastavení příslušného čítače do registrů knihovny. Skutečné zastavení se provede funkcí Td_Save_StartStop_Counter. |
Podpora |
Implementováno pro zařízení se standardními čítači. |
Argumenty |
handle |
Handle otevřeného zařízení. |
index_of_counter |
Index čítače, který má být zastaven. |
poznámka |
Podrobně viz obrázek s vazbami funkcí. |
Td_Stop_Generating
Prototyp |
Td_Stop_Generating(PHandle_ handle) |
Popis |
Zastaví blokové generování.
Je-li nastaven parametr wait_for_acquisition ve funkci Td_Config_Generating_Mode na hodnotu 1, pak je třeba stop potvrdit funkcí Td_Stop_Acquisition. |
Podpora |
Implementováno pro zařízení se synchronním generováním. |
Argumenty |
handle |
Handle otevřeného zařízení. |
Td_Visual_Administrate
Prototyp |
Td_Visual_Administrate( ) |
Popis |
Funkce spustí administrační program. |
Podpora |
Funkce nezávislá na zařízení. |
Td_Visual_Parameters
Prototyp |
Td_Visual_Parameters(PHandle_ handle) |
Popis |
Funkce otevře modální dialog pro nastavení rozšířených parametrů otevřeného zařízení. |
Podpora |
Implementováno pro všechna zařízení s rozšířenými parametry
(viz Td_Set_Parameters). |
Argumenty |
handle |
Handle otevřeného zařízení. |
Td_Wait_For_IRQ
Prototyp |
Td_Wait_For_IRQ(PHandle_ handle, DWORD timeout, DWORD* status, DWORD* result_IRQ) |
Popis |
Funkce slouží pro obsluhu přerušení generovaných měřicím zařízením.
Funkce při volání uspí vlákno volající aplikace, dokud nedojde k přerušení nebo nevyprší timeout.
Důležitá poznámka: Využití funkce je specifické pro zařízení a její použití způsobí obtížnou přenositelnost na jiné zařízení. |
Podpora |
Implementováno pro zařízení s generátorem časových značek. |
Argumenty |
handle |
Handle otevřeného zařízení. |
timeout |
Délka časového intervalu [ms], po kterou funkce čeká na vyvolání přerušení zařízením. |
status |
Ukazatel na číslo DWORD, do kterého jsou uloženy stavové informace z registrů příslušeného zařízení. |
result_IRQ |
Ukazatel na číslo DWORD, do kterého je uložen příznak o průběhu funkce.
0: bylo detekováno přerušení
1: funkce byla ukončena timeoutem |
poznámka |
Dáno možnostmi daného zařízení. |
Td_Write_DevEE
Prototyp |
Td_Write_DevEE(PHandle_ handle, DWORD index_of_page, DWORD* buffer) |
Popis |
Uloží požadovaná data do paměti EEPROM vybraného zařízení.
Pokyny pro práci s pamětí:
Paměť je uspořádaná do stránek velikosti 256 byte číslovaných od nuly.
Skutečnou velikost volné paměti lze zjistitit funkcí Td_Size_DevEE. |
Podpora |
Funkce nezávislá na zařízení. |
Argumenty |
handle |
Handle otevřeného zařízení. |
index_of_page |
Index stránky paměti do které se zapisuje. |
buffer |
Paměťová oblast s daty pro uložení do paměti EEPROM organizovaná jako pole prvků DWORDů; data typu byte jsou přenášena na nejnižších 8 bitech.
Z této oblasti se do EEPROM uloží pouze tolik prvků, kolik se jich může technicky uložit pro zvolenou stránku a zbývající jsou ignorovány (pro každou stránku kromě poslední se uloží vždy 256 prvků). |
poznámka |
Dáno možnostmi daného zařízení. |
TProc_buffer
Prototyp |
TProc_buffer(PHandle_ handle, void* Pmy_body, DWORD* buffer, DWORD size_of_buffer) |
Popis |
Typ funkce definované uživatelem pro obsluhu dat získaných měřením. Tato funkce bude volána pouze v případě spuštění měření funkcí Td_Start_Buffer_Data_Request.
Upozornění: Tělo této funkce se musí nacházet v uživatelském programu (tzn. není v TEDIA_DAQ01).
Poznámka: Tuto funkci nelze využít v prostředí Visual Basicu. |
Podpora |
Implementováno pro zařízení s blokovým přenosem dat. |
Argumenty |
handle |
Handle otevřeného zařízení. |
Pmy_body |
Ukazatel předaný funkci Td_Start_Buffer_Data_Request, čistě v uživatelské režii. |
buffer |
Ukazatel na oblast paměti, do které je uložena kolekce měřicích sekvencí. |
size_of_buffer |
Počet naměřených hodnot (počet sekvencí v kolekci * počet prvků v sekvenci viz. Td_Config_Acquisition). |
|