User manual

usb_tc08_get_minimum_interval_ms
long usb_tc08_get_minimum_interval_ms (short handle)
Tato funkce vrací minimální vzorkovací interval (nebo nejrychlejší interval), který může jednotka
dosáhnout při současném nastavení. Konfigurace se definuje voláním usb_tc08_set_channel().
Argumenty
handle
- Specifikuje jednotku USB TC-08
Vrací
0
- Použijte usb_tc08_get_last_error.
Minimum
interval
- Minimální vzorkovací interval při současném nastavení
(v milisekundách).
usb_tc08_get_unit_info
short get_unit_info( short handle,
USBTC08_INFO * info)
Tato funkce vyvolá informace o jednotce a kopíruje je do struktury USBTC08_INFO ve složce headeru
usbtc08.h… Pokud se vloží do funkce 0 jako handle, bude platný pouze člen verze ovladače, ale
funkce vrátí 1 (úspěch).
Argumenty
handle
- Specifikuje jednotku USB TC-08
info
- Ukazatel na strukturu obsahující informace o jednotce.
Vrací
0
- Použijte usb_tc08_get_last_error.
1
- Volání bylo úspěšné.
usb_tc08_get_formatted_info
short usb_get_formatted_info ( short handle,
char * unit_info,
short string_length)
Tato funkce je podobná volání usb_get_unit_info, ale informace se z jednotky vrací ve formě
formátovaného řetězce znaků. Řetězec je rozdělený na následující prvky, z kterých každý se
zobrazuje v jiném řádku: verze ovladače, verze hardwaru, variantní informace, sériové číslo a datum
kalibrace.
Argumenty
handle
- Specifikuje jednotku USB TC-08
unit_info
- Řetězec, do kterého se má vložit informace o jednotce
String_length
- Délka řetězce, který se má kopírovat. Její délka by měla
obsahovat aspoň 256 znaků (USBTC08_MAX_INFO_CHARS)
Vrací
0
- Příliš mnoho bytů na kopírování, zkopíruje max. možný počet
plných řádků.
1
- Volání bylo úspěšné.
usb_tc08_get_last_error
short usb_tc08_get_last_error (short handle)
Tato funkce vrací poslední chybu určenou handlem. Pokud se namísto handle vloží nula, funkce vrátí
chybu spojenou s posledním voláním usb_tc08_open_unit nebo usb_tc08_open_unit_async.
Poznámka: Pokud se do funkce vloží neplatný handle, funkce selže. Chybový kód však nemůže být
přidružený k jednotce, a tak usb_tc08_get_last_error nezachytí v tomto případě chybový kód.
usb_tc08_get_last_error také selže, pokud se do něj vloží neplatný handle.
Chybové kódy, které lze najít rovněž v hlavičkovém souboru (header file) jsou následující:
Chybové kódy uživatele / vývojáře:
Chybový
kód
Chyba Další informace
0 USBTC08_ERROR_OK Žádná chyba se neobjevila.
1 USBTC08_ERROR_OS_NOT_SUPPORTED Potřeba použití Windows 98 SE,
(nebo novější), nebo Windows
2000 (nebo novější).
2 USBTC08_ERROR_NO_CHANNELS_SET Vyžaduje se volání na
usb_tc08_set_channel
3 USBTC08_ERROR_INVALID_PARAMETER Jeden, nebo vícero argumentů
funkce bylo nesprávných.
4 USBTC08_ERROR_VARIANT_NOT_SUPPORTED Verze hardwaru není
podporována.
5 USBTC08_ERROR_INCORRECT_MODE V streaming módu byla volána
nekompatibilní směs funkcí
legacy a non-legacy (nebo
usb_tc08_get_single).
6 USBTC08_ERROR_ENUMERATION_INCOMPLETE Během výčtu na pozadí byla opět
volána funkce
usb_tc08_open_unit_async
Poznámka: Pro více informací o chybových kódech viz níže část "Řešení problémů".
Chybové kódy rezervované pro Pico
Chybový
kód
Chyba Další informace
7 USBTC08_ERROR_NOT_RESPONDING Nelze získat odpověď z jednotky
USB TC-08.
8 USBTC08_ERROR_FW_ Nelze stáhnout firmware.
9 USBTC08_ERROR_CONFIG_FAIL Chybějící, nebo porušený EEPROM.
10 USBTC08_ERROR_NOT_FOUND Nelze najít vyjmenovávající zařízení.
11 USBTC08_ERROR_THREAD_FAIL Selhala funkce řetězení.
12 USBTC08_ERROR_PIPE_INFO_FAIL Nelze získat informaci o USB propojení.
13 USBTC08_ERROR_NOT_CALIBRATED Nenalezeno datum kalibrace.
14 USBTC08_ERROR_PICOPP_TOO_OLD V systému byl nalezen starý ovladač
picop.sys
Poznámka: Hodnoty těchto rezervovaných chybových kódů mají význam pouze pro personál
technické podpory Pico, ale uvádíme je, abychom umožnili vývojářům zobrazit v aplikacích varování.
Pro více informací o chybových kódech viz níže část "Řešení problémů".
Argumenty
handle
- Specifikuje jednotku USB TC-08
Vrací
-1
- Neplatný handle
Error code
- Pro bližší pochopení viz informaci o chybových kódech
uvedenou výše