User manual

Funkce ovladače
Níže uvedená tabulka vysvětluje všechny funkce USB TC-08:
Funkce Popis
Nové USB a sériový mód
usb_tc08_open_unit Otevírá jednotku USB TC-8 a dostává platný
odkaz USB.
usb_tc08_open_unit_async Asynchronně otevírá jednotku.
usb_tc08_open_unit_progress Během asynchronní operace zjišťuje postup
výčtu.
usb_tc08_close_unit Zavírá odkaz.
usb_tc08_stop Zastavuje streaming.
usb_tc08_set_mains Nastavení odmítnutí rušení sítě 50 Hz nebo 60Hz
usb_tc08_get_minimum_interval_ms Vrací minimální vzorkovací interval pro současné
nastavení.
usb_tc08_get_unit_info Poskytuje informaci o příslušné jednotce
a podává ji jako strukturu.
usb_tc08_get_formatted_info Poskytuje informaci o příslušné jednotce
a podává ji jako řetězec.
usb_tc08_get_last_error Vrací poslední chybu konkrétní jednotky
nebo volání otevření jednotky.
Pouze nové USB
usb_tc08_set_channel Nastavení kanálu USB-TC-08
usb_tc08_run Spouští streaming USB TC-08
usb_tc08_get_single Na základě požadavku konvertuje údaje
z aktuálně nastaveného kanálu.
usb_tc08_get_temp V režimu streaming podává údaje o teplotě
z určeného kanálu.
usb_tc08_get_temp_deskew V režimu streaming podává údaje o teplotě
z určeného kanálu s uvedením času na ploše.
Pouze mód Legacy
usb_tc08_legacy_run Spouští USB TC-08 v režimu Legacy.
usb_tc08_legacy_set_channel Nastavení kanálu USB-TC-08.
usb_tc08_legacy_get_temp Podává údaje o teplotě z určeného kanálu.
usb_tc08_legacy_get_cold_junction Poskytuje údaje o teplotě ze studeného spoje.
usb_tc08_legacy_get_driver_version Vrací verzi ovladače.
usb_tc08_legacy_get_version Vrací verzi hardwaru USB TC-08
usb_tc08_legacy_get_cycle Vrací počet dosavadních měření.
Mód nového USB a mód legacy
usb_tc08_open_unit
short usb_tc08_open_unit (void)
Tato funkce vrací platný odkaz do USB TC-08, pokud jej ovladač úspěšně otevře. Když operace selže,
viz vysvětlení chybových kódů v části usb_tc08_get_last_error. Pokud chcete používat víc, než jedno
USB TC-08, měl by být tento příkaz vyvolán jednou pro každou jednotku připojenou k počítači.
Když nejsou nalezeny žádné další jednotky, funkce vrací 0. Ovladač je zabezpečen pro používání
subprocesů a nedovoluje přístup k jedné jednotce z vícera aplikací. Když proto funkce
usb_ tc08_open_ unit nenajde jednotku, zkontrolujte, jestli USB TC-08 nevyužívají jiné aplikace.
Do kontroly zahrňte i aplikace pod jiným účtem na stejném PC, na kterém je podporována funkce
rychlého přepnutí uživatelů.
Poznámka: Funkce usb_tc08_open_unit nabízí jednoduchý způsob, jak otevřít jednotku
USB TC-08. Volání funkce však uzamkne proces volání, dokud připojená jednotka USB TC-08
není plně vyčíslena. Pokud jedna zpracovávaná aplikace vyžaduje uskutečnění souběžného procesu,
jako např. zobrazení ukazatele průběhu, měla by se použít funkce usb_tc08_open_unit_async.
Argumenty
None
Vrací
Positive short
- handle pro jednotku
0
- Žádné další jednotky nebyly nalezeny
-1
- Jednotku se nepovedlo otevřít. Volejte
usb_tc08_get_last_error s hodnotou 0 pro získání chybového
kódu.
Příklad
Níže uvedený kód je částí C aplikace a ukazuje, jak otevírat složené aplikace s ovladačem
USB TC-08. Identifikátory pro otevírání jednotek se ukládají v poli pro pozdější použití:
//======================================================
// Otevírání složených jednotek
//======================================================
for (i = 0; (new_handle = usb_tc08_open_unit()) > 0; i++)
{
// ulož identifikátor v poli
handle_array[i] = new_handle;
}
no_of_units = i;
// pokud vznikne nějaká chyba, vypřádejte se s ní,
// když byl nový identifikátor 0, chyba se nevyskytla
// a dostali jsme se k poslední jednotce, která je k dispozici
if (new_handle == -1)
{
error_code = usb_tc08_get_last_error(0);
printf("Unit failed to open\nThe error code is %d", error_code);
// zde bylo možné aplikaci ukončit
}
//
// Začněte používat otevřené jednotky
usb_tc08_open_unit_async
short usb_tc08_open_unit_async (void)
Tato funkce zahájí výčet jednotek USB TC-08 na pozadí a okamžitě vrací výsledek, takže proces
volání může pokračovat v provádění dalšího kódu.
Poznámka: Ovladač je zabezpečen pro používání subprocesů a nedovoluje přístup k jedné jednotce
z vícera aplikací. Když proto funkce usb_tc08_open_unit_async nenajde jednotku,
zkontrolujte, jestli USB TC-08 nevyužívají jiné aplikace. Do kontroly zahrňte i aplikace pod jiným účtem
na stejném PC, na kterém je podporována funkce rychlého přepnutí uživatelů.
Argumenty
None
Vrací
1
Volání bylo úspěšné.
0
Žádné další jednotky nebyly nalezeny.
-1
Vyskytla se chyba, volejte usb_tc08_get_last_error s hodnotou
0 pro získání chybového kódu.