Granus-OCR-Driver

Základní informace

Služba slouží pro připojení štěrbinových scannerů a umožnuje jejich integraci do dalších systémů.

Podporované funkce scanneru

• Čtení MRZ zóny dokladů
• Čtení magnetického proužku

Podporované operační systémy

• Microsoft Windows 10 (x86_32, x86_64)
• Microsoft WIndows 11 (x86_32, x86_64)
• GNU Linux Ubuntu, Debian, RedHat, SUSE, ... (x86_64, ARM64)

Stažení instalačního balíku

Instalační balík Granus-OCR-Driver lze stahnout z následující adresy:
https://support.digitaldata.cz/download/drivers/

Pro případ potřeby jsou v archivu jsou k dispozici i všechny starší verze.

Instalační balík je archiv ve formátu ZIP chráněný heslem - pokud heslo neznáte kontaktujte zákaznickou podporu.

Postup instalace na MS Windows

Rozbalte ZIP archiv a zvolte soubor "Granus-OCR-Driver.exe" z adresáře "win-x86_32" nebo "win-x86_64" - podle architektury kterou potřebujete.

Soubor umistěte do vhodné složky (může být integrováno s Vaší aplikací), zde pro názornost použijeme "C:\Program Files\Granus". Následně zaregistrujeme jako službu

"C:\Program Files\Granus\Granus-OCR-Driver.exe" -service install -config "C:\ProgramData\Granus\Granus-OCR-Driver.json"

Tím došlo k zaregistrování služby včetně zaregistrování cesty ke konfiguračnímu souboru. V případě potřeby změny doporučujeme službu odregistrovat a zaregistrovat s novou konfigurací. Odregistraci služby je možná udělat následujícím příkazem:

"C:\Program Files\Granus\Granus-OCR-Driver.exe" -service uninstall"

Ukázka konfiguračního souboru

{
    "mrz": {
        "file": {
            "path": "C:\\Windows\\Temp\\mrz.txt",
            "append": false,
            "run": {
                "command": "notepad.exe",
                "args": ["C:\\Windows\\Temp\\mrz.txt" ]
            }
        }
    },
    "ms": {
        "file": {
            "path": "C:\\Windows\\Temp\\ms.txt",
            "append": false,
            "run": {
                "command": "notepad.exe",
                "args": ["C:\\Windows\\Temp\\ms.txt" ]
            }
        }
    }  
}

Pro test je možné spustit ovladač přímo z terminálu kde budou vypsány i všechny informace z logu.

Pozor - v ukázce je použit notepad.exe který zobrazí vytvořený soubor s daty, to funguje pouze při spuštění z terminálu. Při spuštění ze služby není možné spouštěť GUI aplikace a spuštění externího programu/scriptu je určeno pro Vaše integrační nástroje které data předají dále ke zpracování nebo zajistí notofikaci Vaší aplikace.

Postup instalace na GNU Linux

Rozbalte ZIP archiv a zvolte soubor "Granus-OCR-Driver" z adresáře "linux-x86_64" nebo "linux-arm64" - podle architektury kterou potřebujete. Verze pro OS Linux je staticky linkována proti libusb (soubor Granus-OCR-Driver) nebo hidraw (soubor Granus-OCR-Driver-hidraw). Ve většině případů doporučujeme používat verzi libusb. Verze hidraw je určena hlavně pro případy kdy je USB scanner sdílen s jinou aplikací která používá také hidraw - při sdílení zařízení musí být dané USB zařízení v obou aplikacích otevřeno ve stejném režimu.

Soubor umistěte do vhodné složky (může být integrováno s Vaší aplikací), zde pro názornost použijeme "/opt/granus". Následně zaregistrujeme jako službu

sudo /opt/granus/Granus-OCR-Driver -service install -config "/opt/granus/Granus-OCR-Driver.json"

Tím došlo k zaregistrování služby včetně zaregistrování cesty ke konfiguračnímu souboru. V případě potřeby změny doporučujeme službu odregistrovat a zaregistrovat s novou konfigurací. Odregistraci služby je možná udělat následujícím příkazem:

sudo /opt/granus/Granus-OCR-Driver -service uninstall

Ukázka konfiguračního souboru ve formátu JSON

{
    "mrz": {
        "file": {
            "path": "/tmp/mrz.txt",
            "append": false,
            "run": {
                "command": "gedit",
                "args": ["/tmp/mrz.txt" ]
            }
        }
    },  
    "ms": {
        "file": {
            "path": "/tmp/ms.txt",
            "append": false,
            "run": {
                "command": "gedit",
                "args": ["/tmp/ms.txt" ]
            }
        }
    }  
}

Ukázka konfiguračního souboru ve formátu YAML

mrz:
  file:
    path: "/tmp/mrz.txt"
    append: false
    run: 
      command: "gedit"
      args:
      - "/tmp/mrz.txt"
ms:
  file:
    path: "/tmp/ms.txt"
    append: false
    run:
      command: "gedit"
      args:
      - "/tmp/ms.txt"

Pro test je možné spustit ovladač přímo z terminálu kde budou vypsány i všechny informace z logu. Ovladač musí být spuštěn s právy root (např. pomocí sudo).

Pozor - v ukázce je použit gedit který zobrazí vytvořený soubor s daty, to funguje pouze při spuštění z terminálu. Při spuštění ze služby není možné spouštěť GUI aplikace a spuštění externího programu/scriptu je určeno pro Vaše integrační nástroje které data předají dále ke zpracování nebo zajistí notofikaci Vaší aplikace.

Konfigurační soubor

Konfigurace může být uložena ve formátu JSON (přípona souboru .json), YAML (přípona souboru .yaml nebo .yml) nebo XML podlě potřeby Vaší aplikace.

Skupina mrz obsahuje konfiguraci pro zpracování MRZ zóny dokladu ze scanneru.

Skupina file obsahuje definici výstupu do souboru:
path - Cesta k souboru, doporucujeme používat absolutní cestu. Jinak je použita relativni cesta od pracovní složky služby.
append - Režim otevření souboru (připojování na konec nebo přepis). Hodnoty true/false.
run / command - Příkaz která bude spuštěn po úspěšném načtení dokladu.
run / args - Další volitelné parametry příkazové řádky.