ESEEK M600 Програматор SDK Ръководство за потребителя на скенера

Име на продукта	Ръководство за потребителя на M600 и SDK за програмист
Ревизия	1X
Номер на документа	XXXXXX-1X
Дата	29 ноември 2022 г
производител	E-Seek Incorporated
Търговска марка	E-Seek и логото на E-Seek са регистрирани търговски марки на E-Seek Инкорпориран.
Webсайт	www.e-seek.com
Адрес	Център за научноизследователска и развойна дейност 9471 Ridgehaven Ct. #E Сан Диего, Калифорния 92123
Телефон	858-495-1900
факс	858-495-1901

Инструкции за употреба на продукта

Прочетете внимателно ръководството за потребителя, за да се запознаете с продукта.

Уверете се, че устройството отговаря на част 15 от правилата на FCC и освободените от лиценз RSS(и) на Industry Canada.
Инсталирайте устройството на минимално разстояние от 20 см между радиатора и тялото ви, за да спазите ограниченията на FCC за излагане на радиация.

Обърнете се към съдържанието за лесна навигация в ръководството.
Следвайте раздела за описание на устройството за надписview на модела M600.

Review спецификациите на продукта, за да разберете техническите подробности.

Авторско право © 2022 E-Seek Incorporated. Всички права запазени.
E-Seek си запазва правото да прави промени във всеки продукт, за да подобри надеждността, функцията или дизайна.
E-Seek не поема никаква отговорност за продукта, произтичаща от или във връзка с приложението или използването на продукта, схемата или приложението, описани тук.
Не се предоставя лиценз, изрично или подразбиращо се, estoppel, или по друг начин съгласно каквото и да е патентно право или патент, покриващ или свързан с каквато и да е комбинация, система, апарат, машина, материален метод или процес, в който продуктите на E-Seek могат да бъдат използвани. Подразбиращ се лиценз съществува само за оборудване, вериги и подсистеми, съдържащи се в продуктите на E-Seek.

E-Seek и логото на E-Seek са регистрирани търговски марки на E-Seek Incorporated. Други имена на продукти, споменати в това Справочно ръководство, може да са търговски марки или регистрирани търговски марки на съответните им компании и се признават с настоящото.
Имайте предвид, че понастоящем декодерите за PDF417, MRZ и QR кодове са документирани, но все още не функционират.
Обърнете внимание, че M600 RFID се свързва с компютъра чрез стандартен CCID USB клас и не е обхванат от този документ.

E-SEEK Inc.
Webсайт: www.e-seek.com

Патентован продукт
Център за научноизследователска и развойна дейност
9471 Ridge haven Ct. #E
Сан Диего, Калифорния 92123
Тел: 858-495-1900
факс: 858-495-1901

Декларация за намеса на Федералната комисия по комуникациите
Това устройство е в съответствие с част 15 от правилата на FCC. Операцията е предмет на следните две условия:

Това устройство може да не причинява вредни смущения и
това устройство трябва да приема всякакви получени смущения, включително смущения, които могат да причинят нежелана работа.

Това оборудване е тествано и е установено, че отговаря на ограниченията за цифрово устройство от клас A, съгласно част 15 от правилата на FCC. Тези ограничения са предназначени да осигурят разумна защита срещу вредни смущения в жилищна инсталация. Това оборудване генерира, използва и може да излъчва радиочестотна енергия и, ако не е инсталирано и използвано в съответствие с инструкциите, може да причини вредни смущения в радиокомуникациите. Въпреки това, няма гаранция, че няма да възникнат смущения при определена инсталация. Ако това оборудване причинява вредни смущения в радио или телевизионното приемане, което може да се определи чрез изключване и включване на оборудването, потребителят се насърчава да опита да коригира смущенията чрез една от следните мерки:

Пренасочете или преместете приемната антена.
Увеличете разстоянието между оборудването и приемника.
Свържете оборудването към контакт във верига, различна от тази, към която е свързан приемникът.
Консултирайте се с търговеца или опитен радио/телевизионен техник за помощ.

FCC Внимание: Всички промени или модификации, които не са изрично одобрени от страната, отговорна за съответствието, могат да анулират правото на потребителя да работи с това оборудване. Този предавател не трябва да се намира заедно или да работи заедно с друга антена или предавател.

Декларация за излагане на радиация:
Това оборудване отговаря на ограниченията на FCC за излагане на радиация, определени за неконтролирана среда. Това оборудване трябва да се инсталира и работи на минимално разстояние от 20 см между радиатора и вашето тяло.

Индустрия Канада
Това устройство съдържа освободени от лиценз предаватели/приемници, които отговарят на освободените от лиценз RSS(и) на Канада за иновации, наука и икономическо развитие. Операцията е предмет на следните две условия:

Това устройство може да не причинява смущения.
Това устройство трябва да приема всякакви смущения, включително смущения, които могат да причинят нежелана работа на устройството.

ВЪВЕДЕНИЕ

Благодарим ви, че избрахте това устройство.
Това Ръководство на потребителя предоставя описания на работните процедури и API за програмиране за E-seek модел M600. Прочетете внимателно това ръководство за потребителя, преди да използвате това устройство.
Действителните екрани, които се показват, може да са малко по-различни от екранните изображения, използвани в това Ръководство на потребителя. Скенерът модел M600 е наричан по-долу „това устройство“

Ръчна конвенция

Внимание: Това предупреждава за възможност за повреда на това устройство.

Важно: Това показва инструкции, които трябва да се следват, за да се гарантира правилната функционалност и ефективност на това устройство.
Забележка: Това показва предмет от общо значение.
Напомняне: Това показва елемент от относителна важност.
детайл: Това показва елемент от специфична важност.

Ограничения

Неупълномощеното използване или възпроизвеждане на това Ръководство на потребителя, независимо дали изцяло или частично, е строго забранено.

Информацията, съдържаща се в това ръководство на потребителя, подлежи на промяна без предупреждение.

ХАРАКТЕРИСТИКА НА ПРОДУКТА
Това устройство е четец на ID3, ID1 и бордна карта.

ОПИСАНИЕ НА УСТРОЙСТВОТО

ID четецът E-Seek модел M600 въвежда нов стандарт за производителност за четене на лични карти. Може да чете ID3 и ID1 карти без капак, за да рационализира четенето на документи. Баркодовете на бордната карта също могат да бъдат разчетени. Извършва се усъвършенствана обработка на изображения, за да се осигурят висококачествени ID1 изображения без качулка.
Моделът M600 SDK включва също декодери MRZ, QR и PDF417. Свързва се към компютър чрез високоскоростна USB 2.0 връзка.

КРАЙVIEW НА МОДЕЛ М600
Фигури 1 и 2 илюстрират основните модули и компоненти на M600.

СПЕЦИФИКАЦИЯ НА ПРОДУКТА

Предмети	Описание
Изобразяване	Сензор: 2D CMOS Резолюция: RGB/IR 600dpi, UV 300dpi Дълбочина на цвета: RGB/UV: 24 бита/пиксел, IR: 8 бита/пиксел Източници на светлина: видими (бяло), IR (870 nm), UV (365 nm) Изходен формат на изображението: BMP
Смарт карта	Безконтактно: ISO 14443 A/B, NFC,
Предупреждение	Звуков: Звуков сигнал Визуален индикатор: 2 RGB светодиода за състояние
Свързаност	USB 2.0 високоскоростен.
Електрически	Входяща мощност: 5V input voltagд. Консумирана мощност: TBD Захранващ адаптер: AC110-240V, 50/60Hz 0.35A Макс Изход: 5V 2Amps
Физически	Размери: Дължина: 195 мм Ширина: 160 мм Височина: 109 mm/ 102 mm (към стъкло) Тегло: 900 грама (2 lbs) Прозорец за заснемане на изображения: 130 x 95 mm (5.12 x 3.74”) Антирефлексно и устойчиво на надраскване стъкло
Екологични	Температура: Работна: –10°C до 50°C (14°F до 122°F) Съхранение: –20°C до 70°C (–4°F до 158°F) Влажност: Работна: 5-95 % (без кондензация) Прах: IP5x

ТЕХНИЧЕСКИ ДАННИ

RGB 24 бита при 600 dpi
IR 8 бита при 600 dpi
UV 24 бита @ 300 dpi
ID3, ID1 и бордна карта
Декодира MRZ
Декодира QR
Декодира 2D (PDF417) и 1D
USB 2.0 Висока скорост
Работа без капак
RFID
Патентован

РАЗОПАКОВАНЕ НА УСТРОЙСТВО

Пакетът M600 включва:

Устройство M600
USB кабел
Карта за калибриране (???)

USB КАБЕЛ
M600 се доставя с USB интерфейсен кабел. Този кабел позволява на M600 да се свързва със стандартен USB 2.0 високоскоростен порт на вашия компютър.

КАРТА ЗА КАЛИБРИРАНЕ НА БАЛАНС НА БЯЛОТО

Картата за калибриране се използва за калибриране на баланса на бялото. Може да се наложи калибриране след транспортиране или продължителна употреба. За да извършите калибриране на баланса на бялото, просто поставете картата със стрелката напред.
След продължителна употреба или ако картата бъде надраскана, тя трябва да се изхвърли.

ЗАПОЧВАНЕ

Скенерът M600 използва WinUSB драйвери и не е необходима инсталация за Windows8, Windows10 или Windows11.
Свържете захранващия кабел M600 и включете скенера.

M600 трябва да се появи под устройства с универсална серийна шина в диспечера на устройства.

В този момент проверете състоянието на горния светодиод на M600 и се уверете, че зелената светлина свети постоянно.
Ако ЧЕРВЕНАТА светлина мига, това означава, че скенерът е срещнал фатална грешка. Проверете типа грешка, като отворите „M600dll.log“ file.

ПУСКАНЕ НА ДЕМО ПРИЛОЖЕНИЕ
Изтеглете демо приложението M600 от http://e-seek.com/products/m-600/

ОБХВАТ

Компютърният софтуер се състои от приложение exe, C# API модул и C/C++ DLL, който комуникира с M600 през USB. Този документ обхваща M600 C# sample приложение и C# API, което дава на C# разработчика прост интерфейс към M600 DLL. M600 съдържа RFID модул, който използва стандартен Microsoft CCID интерфейс, който не е обхванат от този документ. Операция

Когато се постави карта, фърмуерът на M600 ще:

Автоматично сканиране на документ, ако е активирано
Декодирайте MRZ, ако има такъв
Декодирайте PDF417, ако има такъв
Сканирайте с помощта на белите светодиоди
Сканирайте с помощта на инфрачервените светодиоди
Сканирайте с помощта на UV светодиоди

ИНДИКАТОРНИ светодиоди
Таблицата за състоянието на M600 LED е както следва:

GUI

Фигура 9 показва ID3 документ, а Фигура 10 показва ID1 документ. ID1 изображенията бяха изрязани.
GUI има три малки preview изображения вляво и голямо основно изображение.

МАЛКИ ИЗОБРАЖЕНИЯ PREVIEW ПАНЕЛ

Има три малки панела, които показват сканираната карта с различно осветление.

Първото изображение е заснето с бяла светлина.
Второто изображение е заснето с помощта на инфрачервена светлина.
Последното изображение е заснето с помощта на UV светлина.

АРХИТЕКТУРА

Основната цел на демонстрационното приложение на C# е да предостави exampза това как да напишете приложение, което взаимодейства с M600 с помощта на C# API.

Приложението (M600.exe или потребителско приложение), M600api.dll и M600dll.dllnd трябва да са в една и съща директория. DLL ще създаде регистрационен файл file (M600dll.log) в директорията, в която се изпълнява по подразбиране, но може да бъде деактивиран, ако желаете.
Както бе споменато в обхвата, M600 има RFID модул, който се свързва с компютър като CCID USB клас и не е обхванат от този документ.

M600 ДЕМО ПРИЛОЖЕНИЕ
Проектът C# M600APP съдържа основното приложение и GUI. Той създава изпълнимия файл „M600.exe“.
Модулите в този проект са:

FormM600demo.cs
FormUpdate.cs

FORMM600DEMO.CS
Това е основният формуляр и съдържа кода, който взаимодейства с M600 C# API. Той извиква функцията Init(), която инициализира M600DLL, за да комуникира с M600 и автоматично да прехвърля изображения. Потребителското приложение трябва да замени WndProc() и да извика функцията WndProcMessage() на M600, ако иска да получава събития за USB свързване и прекъсване.

FORMUPDATE.CS
Този модул съдържа подпрограми, които актуализират GUI.

C# API

C# API предоставя прост интерфейс на M600. Разработчикът на C# трябва да може да използва този интерфейс за бърза връзка с M600, без да е необходимо да се свързва директно с неуправляемия DLL код на M600.
Приложението трябва да се регистрира за събития за обратно повикване при инициализация. След това DLL ще извика обратно приложението, когато възникне събитие. След това приложението трябва да синхронизира извикването обратно към своята нишка, като използва метода Invoke във FormM600demo.cs.

Сглобяването на API се инстанцира в приложението като:

публичен статичен CM600api m_M600 = нов CM600api();

API ФУНКЦИИ
void SetLogDir(LOG_DIR) [По избор] Извикайте тази функция преди Init(), за да замените директорията на журнала по подразбиране. По подразбиране, ако тази функция не бъде извикана, M600DLL ще създаде M600DLL.LOG file в същата директория, в която се изпълнява. Предайте на тази функция низа от желаната директория на журнала. За да деактивирате регистрирането, подайте низа „null“.

void Init()
Извикайте тази функция при инициализация, например по време на зареждане на формуляр.
void RegCB(OnNewEvent)
Регистрирайте събитие обратно обаждане.
void Close()
Извикайте тази функция, преди да затворите приложението, например по време на затворен формуляр.
bool Вход (bool bLogin)
Когато е вярно, устройството ще сканира, когато е поставена карта (нормална работа).
Когато е невярно, устройството няма да сканира, когато е поставена карта.
void UserBeep(E_BEEP eBeep)
Създава звуков сигнал. Изброяването E_BEEP има три стойности:
BEEP_1,
анулира GetVer (извън M600_VER версия)
Получава серийния номер на E-Seek (EsSerNum), серийния номер на Silicon (DsSerNum), версията на DLL, версията на баркод декодера, версията на фърмуера и версията на хардуера, както е дефинирано от структурата M600_VER.
Членовете на структурата M600_VER, които могат да представляват интерес за разработчика, са:
ulong EsSerNum; // Сериен номер на E-Seek
//
байт DllMajor; // Номер на версията на DLL
байт DllMinor;
байт DllBuild;
байт FwMajor; // Номер на версията на фърмуера
байт FwMinor;
байт FwBuild; // Винаги нула
bool WrUserData (байт [] aryData)
Записва масив от байтове на потребителски данни за флаш (лимит от 128 байта).
Flash не трябва да се използва за съхранение на често променящи се данни, тъй като е ограничен до 10,000 XNUMX надеждни записа.
bool RdUserData(байт[] aryData)
Чете масив от байтове на потребителски данни от флаш (лимит от 128 байта).
Имайте предвид, че за да получи USB свързване и прекъсване на връзката, потребителското приложение трябва да замени WndProc() и да извика WndProcMessage на M600 api.
защитена отмяна void WndProc (реф. съобщение m)
{
m_M600.WndProcMessage(реф. m); // проверява за USB свързване и прекъсване на връзката
base.WndProc(ref m);

API ОБЕКТИ

Класът C# API M600_IMG има растерно изображение за всеки от трите източника на светлина:
Bitmap bmBmRgb;
Bitmap bmBmIr;
Bitmap bmBmUv;

Първото изображение е RGB.
Второто изображение е IR.
Третото изображение е UV.
Растерните изображения ще бъдат изрязани, ако бъде открит ID1 документ.

Структурата C# API M600_BC съдържа 2D структура от данни.

байт [] aryMRZ; // Байтов масив за MRZ*
байт [] aryQR; // Байтов масив за QR*
байт [] aryP417; // Байтов масив за PDF417*
int iBcOrient;
Ако бъде намерен баркод PDF417, елементът iBcOrient има четири изброени стойности на ориентацията на картата и нула за неизвестно.

0 = Неизвестна ориентация
1 = нормална ориентация (лицето на картата е отдясно).
2 = Отпред отдясно, но с главата надолу.
3 = Предната част е отляво.
4 = Предната част е отляво и с главата надолу.

Забележка че за тази версия декодирането MRZ, QR и PDF417 все още не е внедрено.

СЪБИТИЯ:
Потребителското приложение трябва да предаде делегат при инициализация към M600dll, така че DLL да може да извика делегата с целочислената стойност на събитието.

M600 DLL изпраща обратно извикване на събитие към приложението по нишка, създадена от M600 DLL.

СЪБИТИЕ_ОТКРИВАНЕ
EVENT_SCANING Фърмуерът сканира документ
EVENT_IR IR изображението е готово
Готово EVENT_RGB RGB изображение
Готово UV изображение за EVENT_UV
EVENT_REMOVE Документът може да бъде премахнат
EVENT_BARCODE*
EVENT_MRZ*
EVENT_DONE Сканирането завърши
EVENT_USB_CON USB свързан
EVENT_USB_DIS USB връзката е прекъсната

Не: Функциите MRZ и bardode в момента не са внедрени

ПСЕВДО КОД ПРИМAMPLE

CM600api m_M600 = нов CM600api(); // C# API обект
m_M600.Init(M600_Обратно повикване); // обратно извикване за събития
// Обратно извикване на събитие
//
public void M600_Callback(int iEvent)
{
превключвател (iEvent)
{
case EVENT_IR: // IR изображението е готово
прекъсване;
case EVENT_RGB: // Готово RGB изображение
прекъсване;
case EVENT_UV: // Готово UV изображение
прекъсване;
case EVENT_DONE: // Сканирането е завършено
прекъсване;
…
}
}
…
m_M600.Close()

ПОДДРЪЖКА

Има три части за поддръжка на M600:
Почистване (Стъпка 3-5)
Калибриране (стъпка 6-7)

Стъпка 1: Поставете картата за калибриране

МЕХАНИЧНИ ЧЕРТЕЖИ

Документи / Ресурси

ESEEK M600 програматор SDK скенер [pdf] Ръководство за потребителя
2A9IZ-M600, 2A9IZM600, m600, M600 Програматор SDK скенер модул, програматор SDK скенер модул, SDK скенер модул, скенер модул

Референции

Ръководство за потребителя

ESEEK M600 програматор SDK скенер