Skener SDK ESEEK M600 Programmer SDK

Informácie o produkte

Názov produktu	Používateľská príručka M600 a SDK programátora
Revízia	1X
Číslo dokumentu	XXXXXX-1X
Dátum	29. novembra 2022
Výrobca	E-Seek Incorporated
ochranná známka	E-Seek a logo E-Seek sú registrované ochranné známky E-Seek Incorporated.
Webstránky	www.e-seek.com
Adresa	Centrum výskumu a vývoja 9471 Ridgehaven Ct. #E San Diego, CA 92123
Telefón	858-495-1900
Fax	858-495-1901

Návod na použitie produktu

1. Pozorne si prečítajte návod na použitie, aby ste sa zoznámili s produktom.
2. Zabezpečte, aby zariadenie vyhovovalo časti 15 pravidiel FCC a licencovaným RSS kanálom Industry Canada.
3. Nainštalujte zariadenie s minimálnou vzdialenosťou 20 cm medzi žiaričom a vaším telom, aby ste splnili limity FCC pre vystavenie žiareniu.
4. Pozrite si obsah pre jednoduchú navigáciu v príručke.
5. Postupujte podľa sekcie s popisom zariadenia pre overenieview z modelu M600.
6. Review špecifikácie produktu, aby ste pochopili technické podrobnosti.

Copyright © 2022 E-Seek Incorporated. Všetky práva vyhradené.
E-Seek si vyhradzuje právo vykonávať zmeny na akomkoľvek produkte s cieľom zlepšiť spoľahlivosť, funkciu alebo dizajn.
E-Seek nepreberá žiadnu zodpovednosť za produkt vyplývajúcu z aplikácie alebo používania produktu, obvodu alebo aplikácie opísanej v tomto dokumente alebo v súvislosti s nimi.
Žiadna licencia nie je udelená, či už výslovne alebo implicitne, prekážka alebo inak, na základe akéhokoľvek patentového práva alebo patentu, ktoré by sa vzťahovali na akúkoľvek kombináciu, systém, prístroj, stroj, metódu materiálu alebo proces, v ktorom by sa produkty E-Seek mohli použiť. Implicitná licencia existuje len pre zariadenia, obvody a podsystémy obsiahnuté v produktoch E-Seek.

E-Seek a logo E-Seek sú registrované ochranné známky spoločnosti E-Seek Incorporated. Ostatné názvy produktov uvedené v tejto referenčnej príručke môžu byť ochrannými známkami alebo registrovanými ochrannými známkami príslušných spoločností a sú týmto uznané.
Upozorňujeme, že v súčasnosti sú dekodéry kódov PDF417, MRZ a QR zdokumentované, ale ešte nefunkčné.
Všimnite si, že M600 RFID sa pripája k počítaču pomocou štandardnej triedy CCID USB a nie je pokrytá týmto dokumentom.

Spoločnosť E-SEEK Inc.
Webmiesto: www.e-seek.com

Patentovaný produkt
Centrum výskumu a vývoja
9471 Ridge Haven Ct. #E
San Diego, CA 92123
Tel: 858-495-1900
Fax: 858-495-1901

Vyhlásenie Federálnej komunikačnej komisie o zasahovaní
Toto zariadenie je v súlade s časťou 15 pravidiel FCC. Prevádzka podlieha týmto dvom podmienkam:

1. Toto zariadenie nesmie spôsobovať škodlivé rušenie a
2. toto zariadenie musí akceptovať akékoľvek prijaté rušenie, vrátane rušenia, ktoré môže spôsobiť nežiaducu činnosť.

Toto zariadenie bolo testované a bolo zistené, že vyhovuje limitom pre digitálne zariadenie triedy A v súlade s časťou 15 pravidiel FCC. Tieto limity sú navrhnuté tak, aby poskytovali primeranú ochranu pred škodlivým rušením pri inštalácii v obytných priestoroch. Toto zariadenie generuje, používa a môže vyžarovať rádiofrekvenčnú energiu a ak nie je nainštalované a používané v súlade s pokynmi, môže spôsobiť škodlivé rušenie rádiovej komunikácie. Neexistuje však žiadna záruka, že pri konkrétnej inštalácii nedôjde k rušeniu. Ak toto zariadenie spôsobuje škodlivé rušenie rádiového alebo televízneho príjmu, čo sa dá zistiť vypnutím a zapnutím zariadenia, používateľovi sa odporúča, aby sa pokúsil napraviť rušenie jedným z nasledujúcich opatrení:

• Presmerujte alebo premiestnite prijímaciu anténu.
• Zväčšite vzdialenosť medzi zariadením a prijímačom.
• Zapojte zariadenie do zásuvky v inom okruhu, než ku ktorému je pripojený prijímač.
• Požiadajte o pomoc predajcu alebo skúseného rádio/TV technika.

Upozornenie FCC: Akékoľvek zmeny alebo úpravy, ktoré nie sú výslovne schválené stranou zodpovednou za zhodu, môžu zrušiť oprávnenie používateľa prevádzkovať toto zariadenie. Tento vysielač nesmie byť umiestnený ani prevádzkovaný v spojení s akoukoľvek inou anténou alebo vysielačom.

Vyhlásenie o vystavení žiareniu:
Toto zariadenie vyhovuje limitom FCC pre vystavenie žiareniu stanoveným pre nekontrolované prostredie. Toto zariadenie by malo byť inštalované a prevádzkované s minimálnou vzdialenosťou 20 cm medzi radiátorom a vaším telom.

Industry Canada
Toto zariadenie obsahuje licencované vysielače/prijímače, ktoré sú v súlade s Innovation, Science and Economic Development Canada bez licencie RSS. Prevádzka podlieha týmto dvom podmienkam:

1. Toto zariadenie nesmie spôsobovať rušenie.
2. Toto zariadenie musí akceptovať akékoľvek rušenie, vrátane rušenia, ktoré môže spôsobiť neželanú prevádzku zariadenia.

ÚVOD

Ďakujeme, že ste si vybrali toto zariadenie.
Táto používateľská príručka obsahuje popisy prevádzkových postupov a programovacích rozhraní API pre E-seek Model M600. Pred použitím tohto zariadenia si pozorne prečítajte túto používateľskú príručku.
Skutočné obrazovky, ktoré sa objavia, sa môžu mierne líšiť od obrazov používaných v tejto Používateľskej príručke. Jednotka skenera Model M600 sa ďalej označuje ako „toto zariadenie“

Manuálna konvencia

• Pozor: Toto varuje pred možným poškodením tohto zariadenia.
• Dôležité: Označuje pokyny, ktoré je potrebné dodržiavať, aby sa zabezpečila správna funkčnosť a účinnosť tohto zariadenia.
• Poznámka: Označuje to položku všeobecného významu.
• Pripomienka: Označuje to položku relatívnej dôležitosti.
• Podrobnosti: Označuje to položku špecifickej dôležitosti.

Obmedzenia

• Neoprávnené použitie alebo reprodukcia tejto používateľskej príručky, či už celej alebo jej častí, je prísne zakázaná.
• Informácie obsiahnuté v tejto používateľskej príručke sa môžu zmeniť bez upozornenia.

VLASTNOSTI PRODUKTU
Toto zariadenie je čítačka ID3, ID1 a palubného lístka.

POPIS ZARIADENIA

ID čítačka E-Seek Model M600 predstavuje nový štandard výkonu pre čítanie ID kariet. Dokáže čítať karty ID3 a ID1 bez krytu, aby sa zjednodušilo čítanie dokumentov. Čiarové kódy palubného lístka sa dajú tiež prečítať. Pokročilé spracovanie obrazu sa vykonáva s cieľom poskytnúť vysokokvalitné snímky ID1 bez krytu.
Model M600 SDK obsahuje aj dekodéry MRZ, QR a PDF417. K PC sa pripája pomocou vysokorýchlostného USB 2.0 pripojenia.

KONIECVIEW MODELU M600
Obrázky 1 a 2 znázorňujú hlavné moduly a komponenty M600.

ŠPECIFIKÁCIA PRODUKTU

Položky	Popis
Zobrazovanie	Senzor: 2D CMOS   Rozlíšenie: RGB/IR 600dpi, UV 300dpi   Farebná hĺbka: RGB/UV: 24 bitov / pixel, IR: 8 bitov / pixel Svetelné zdroje: viditeľné (biele), IR (870 nm), UV (365 nm) Výstupný obrazový formát: BMP
Smart Card	Bezkontaktné: ISO 14443 A/B, NFC,
Upozornenie	Počuteľné: Pípnutie   Vizuálny indikátor: 2 RGB stavové LED diódy
Konektivita	Vysokorýchlostné USB 2.0.
Elektrické	Vstupné napájanie: 5V vstupné objtage. Spotreba energie: TBD Napájací adaptér: AC110-240V, 50/60Hz 0.35A Max Výstup: 5V 2Amps
Fyzické	Rozmery: Dĺžka: 195 mm Šírka: 160 mm Výška: 109 mm/ 102 mm (do skla) Hmotnosť: 900 gramov (2 libier) Okno na snímanie obrazu: 130 x 95 mm (5.12 x 3.74”) Antireflexné sklo odolné proti poškriabaniu
Environmentálne	Teplota: Prevádzková teplota: –10 °C až 50 °C (14 °F až 122 °F) Skladovanie: –20 °C až 70 °C (-4 °F až 158 °F) Vlhkosť: Prevádzková: 5-95 % (bez kondenzácie) Prach: IP5x

TECHNICKÉ PODROBNOSTI

• RGB 24 bit @ 600 dpi
• IR 8 bit @ 600 dpi
• UV 24 bit @ 300 dpi
• ID3, ID1 a palubný lístok
• Dekóduje MRZ
• Dekóduje QR
• Dekóduje 2D (PDF417) a 1D
• Vysokorýchlostné USB 2.0
• Prevádzka bez kapucne
• RFID
• Patentovaný

ROZBALENIE ZARIADENIA

Balík M600 obsahuje:

• Zariadenie M600
• USB kábel
• Kalibračná karta (???)

USB KÁBEL
M600 sa dodáva s káblom rozhrania USB. Tento kábel umožňuje M600 pripojiť sa k štandardnému vysokorýchlostnému portu USB 2.0 na vašom počítači.

KALIBRAČNÁ KARTA ZVÁŽENIA BIELEJ

Kalibračná karta sa používa na kalibráciu vyváženia bielej. Po preprave alebo dlhšom používaní môže byť potrebná kalibrácia. Ak chcete vykonať kalibráciu vyváženia bielej, jednoducho vložte kartu stranou so šípkou napred.
Po dlhšom používaní alebo ak sa karta poškriabe, mala by sa zlikvidovať.

ZAČÍNAME

1. Skener M600 používa ovládače WinUSB a pre Windows8, Windows10 alebo Windows11 nie je potrebná žiadna inštalácia.
   Pripojte napájací kábel M600 a zapnite skener.

M600 by sa mal objaviť v Správcovi zariadení v časti Zariadenia s univerzálnou sériovou zbernicou.

V tomto bode skontrolujte stav hornej LED diódy M600 a uistite sa, že zelená kontrolka neprerušovane svieti.
Ak ČERVENÉ svetlo bliká, znamená to, že skener zaznamenal fatálnu chybu. Skontrolujte typ chyby otvorením súboru „M600dll.log“ file.

SPUSTENÁ DEMO APLIKÁCIA
Stiahnite si Demo aplikáciu M600 z http://e-seek.com/products/m-600/

ROZSAH PÔSOBNOSTI

PC softvér pozostáva z aplikačného exe, zostavy C# API a C/C++ DLL, ktorá komunikuje s M600 cez USB. Tento dokument pokrýva M600 C# sample a C# API, ktoré poskytuje vývojárom C# jednoduché rozhranie k M600 DLL. M600 obsahuje modul RFID, ktorý používa štandardné rozhranie Microsoft CCID, na ktoré sa tento dokument nevzťahuje. Prevádzka

Po vložení karty firmvér M600:

• Automaticky skenovať dokument, ak je povolené
• Dekódujte MRZ, ak je prítomný
• Dekódujte súbor PDF417, ak je prítomný
• Skenujte pomocou bielych LED diód
• Skenujte pomocou IR LED
• Skenujte pomocou UV LED diód

INDIKAČNÉ LED
Tabuľka stavu LED M600 je nasledovná:

GUI

Obrázok 9 zobrazuje dokument ID3 a obrázok 10 dokument ID1. Obrázky ID1 boli orezané.
GUI má tri malé predview obrázky vľavo a veľký hlavný obrázok.

MALÉ OBRÁZKY PREVIEW PANE

Existujú tri malé panely, ktoré zobrazujú naskenovanú kartu s rôznym osvetlením.

• Prvý obrázok bol zachytený pomocou bieleho svetla.
• Druhý obrázok bol zachytený pomocou IR svetla.
• Posledný obrázok bol zachytený pomocou UV svetla.

ARCHITEKTÚRA

Hlavným účelom demo aplikácie C# je poskytnúť exampo tom, ako napísať aplikáciu, ktorá je prepojená s M600 pomocou C# API.

Aplikácia (M600.exe alebo používateľská aplikácia), M600api.dll a M600dll.dllnd musia byť v rovnakom adresári. DLL vytvorí protokol file (M600dll.log) v adresári, v ktorom je štandardne spustený, ale v prípade potreby ho možno deaktivovať.
Ako je uvedené v rozsahu, M600 má modul RFID, ktorý sa pripája k počítaču ako trieda CCID USB a tento dokument sa naň nevzťahuje.

DEMO APLIKÁCIA M600
Projekt C# M600APP obsahuje hlavnú aplikáciu a GUI. Vytvorí spustiteľný súbor „M600.exe“.
Moduly v tomto projekte sú:

• FormM600demo.cs
• FormUpdate.cs

FORMM600DEMO.CS
Toto je hlavný formulár a obsahuje kód, ktorý je prepojený s M600 C# API. Volá funkciu Init(), ktorá inicializuje M600DLL na komunikáciu s M600 a automatický prenos obrázkov. Používateľská aplikácia by mala prepísať WndProc() a zavolať funkciu WndProcMessage() na M600, ak chce prijímať udalosti pripojenia a odpojenia USB.

FORMUPDATE.CS
Tento modul obsahuje podprogramy, ktoré aktualizujú GUI.

C# API

C# API poskytuje jednoduché rozhranie pre M600. Vývojár C# by mal byť schopný použiť toto rozhranie na rýchle prepojenie s M600 bez potreby priameho prepojenia s nespravovaným kódom M600 DLL.
Aplikácia by sa mala zaregistrovať pre udalosti spätného volania pri inicializácii. DLL potom zavolá späť aplikáciu, keď nastane udalosť. Aplikácia by potom mala synchronizovať volanie späť do svojho vlákna pomocou metódy Invoke v FormM600demo.cs.

Zostava API sa vytvorí v aplikácii ako:

verejné statické CM600api m_M600 = nové CM600api();

FUNKCIE API
void SetLogDir(LOG_DIR) [Voliteľné] Zavolajte túto funkciu pred Init(), aby ste prepísali predvolený adresár protokolu. Štandardne, ak sa táto funkcia nenazýva, M600DLL vytvorí M600DLL.LOG file v tom istom adresári, v ktorom beží. Odovzdajte tejto funkcii reťazec požadovaného adresára protokolu. Ak chcete zakázať protokolovanie, zadajte reťazec „null“.

• void Init()
  Zavolajte túto funkciu pri inicializácii, napríklad počas načítania formulára.
• void RegCB(OnNewEvent)
  Zaregistrujte spätné volanie udalosti.
• void Close()
  Túto funkciu zavolajte pred zatvorením aplikácie, napríklad počas zatvorenia formulára.
• bool Prihlásenie(bool bLogin)
  Keď je pravda, jednotka bude skenovať po vložení karty (normálna prevádzka).
  Ak je nastavená hodnota false, jednotka nebude skenovať, keď je vložená karta.
• void UserBeep(E_BEEP eBeep)
  Vytvára pípnutie. Enumerácia E_BEEP má tri hodnoty:
  BEEP_1,
• void GetVer (out M600_VER ver)
  Získa sériové číslo E-Seek (EsSerNum), Silicon sériové číslo (DsSerNum), verziu DLL, verziu dekodéra čiarového kódu, verziu firmvéru a verziu hardvéru, ako je definované štruktúrou M600_VER.
  Členovia štruktúry M600_VER, ktorí môžu byť predmetom záujmu vývojára, sú:
  ulong EsSerNum; // Sériové číslo E-Seek
  //
  byte DllMajor; // Číslo verzie DLL
  byte DllMinor;
  byte DllBuild;
  byte FwMajor; // Číslo verzie firmvéru
  byte FwMinor;
  byte FwBuild; // Vždy nula
• bool WrUserData (byte[] aryData)
  Zapíše bajtové pole užívateľských dát na flash (limit 128 bajtov).
  Flash by sa nemal používať na uchovávanie často sa meniacich údajov, pretože je obmedzený na 10,000 XNUMX spoľahlivých zápisov.
• bool RdUserData(byte[] aryData)
  Číta bajtové pole užívateľských dát z flash (limit 128 bajtov).
  Všimnite si, že na prijímanie USB pripojenia a odpojenia musí používateľská aplikácia prepísať WndProc() a zavolať WndProcMessage M600 api.
• chránené prepísanie void WndProc(ref Message m)
  {
  m_M600.WndProcMessage(ref m); // skontroluje pripojenie a odpojenie USB
  báza.WndProc(ref m);

OBJEKTY API

Trieda C# API M600_IMG má bitmapu pre každý z troch svetelných zdrojov:
Bitová mapa bmBmRgb;
Bitová mapa bmBmIr;
Bitová mapa bmBmUv;

Prvý obrázok je RGB.
Druhý obrázok je IR.
Tretí obrázok je UV.
Ak sa zistí dokument ID1, bitmapy budú orezané.

Štruktúra C# API M600_BC obsahuje 2D dátovú štruktúru.

byte[] aryMRZ; // Bajtové pole pre MRZ*
byte[] aryQR; // Bajtové pole pre QR*
byte[] aryP417; // Bajtové pole pre PDF417*
int iBcOrient;
Ak sa nájde čiarový kód PDF417, prvok iBcOrient má štyri vymenované hodnoty orientácie karty a nulu pre neznáme.

• 0 = neznáma orientácia
• 1 = Normálna orientácia (predná strana karty je vpravo).
• 2 = Vpredu vpravo, ale obrátene.
• 3 = Predná časť je vľavo.
• 4 = Predná strana je vľavo a obrátená.

Poznámka že pre toto vydanie ešte nie je implementované dekódovanie MRZ, QR a PDF417.

UDALOSTI:
Používateľská aplikácia by mala odovzdať delegáta pri inicializácii do M600dll, aby DLL mohla zavolať delegáta s celočíselnou hodnotou udalosti.

M600 DLL odošle spätné volanie udalosti do aplikácie vo vlákne, ktoré M600 DLL vytvorí.

• EVENT_DISCOVERY
• EVENT_SCANING Firmvér skenuje dokument
• IR snímka EVENT_IR je pripravená
• EVENT_RGB RGB obrázok pripravený
• EVENT_UV UV obraz pripravený
• EVENT_REMOVE Dokument je možné odstrániť
• EVENT_BARCODE*
• EVENT_MRZ*
• EVENT_DONE Skenovanie je dokončené
• EVENT_USB_CON USB je pripojené
• EVENT_USB_DIS USB je odpojené

nie: Funkcie MRZ a bardode nie sú v súčasnosti implementované

PSEUDO KÓD EXAMPLE

CM600api m_M600 = nové CM600api(); // Objekt C# API
m_M600.Init(M600_Callback); // spätné volanie pre udalosti
// Spätné volanie udalosti
//
public void M600_Callback(int iEvent)
{
prepínač (iEvent)
{
case EVENT_IR: // IR obraz pripravený
prestávka;
case EVENT_RGB: // RGB obraz pripravený
prestávka;
case EVENT_UV: // UV obraz pripravený
prestávka;
case EVENT_DONE: // Skenovanie je dokončené
prestávka;
…
}
}
…
m_M600.Close()

ÚDRŽBA

Na údržbu M600 sú tri časti:
Čistenie (krok 3-5)
Kalibrácia (krok 6-7)

Krok 1: Vložte kalibračnú kartu

MECHANICKÉ VÝKRESY

Dokumenty / zdroje

Skener SDK ESEEK M600 Programmer SDK [pdfPoužívateľská príručka 2A9IZ-M600, 2A9IZM600, m600, M600 Programátor SDK Scanner Unit, Programmer SDK Scanner Unit, SDK Scanner Unit, Scanner Unit

Referencie

• Používateľská príručka