La maggior parte dei terminali viene letta direttamente in rete e non richiede altro. Alcuni tipi di connessione usano invece il software Windows del produttore (un "SDK") sul PC del connettore. Oggi si tratta solo dell'SDK ZKTeco. Questa pagina spiega quando serve, come installarlo passo dopo passo, che cosa significano i controlli e quali sono le regole di licenza.
Anteprima e nota di trasparenza. Il percorso SDK è stato realizzato e verificato solo con simulazioni software. Non è stato provato con un'installazione SDK reale su un PC Windows, né su terminali reali di ogni modello. Dettagli che su un PC reale potrebbero differire: la struttura del registro di sistema, il comportamento di
regsvr32, le risposte esatte dell'SDK ad alcune chiamate. Prova prima con un solo dispositivo. Se non funziona, la connessione diretta integrata è sempre disponibile.
#Ti serve davvero?
Probabilmente no. Per la maggior parte dei terminali ZKTeco scegli ZKTeco (diretto): legge timbrature e utenti, imposta l'orologio, riavvia il dispositivo e modifica gli utenti, ed è stato verificato su un iFace702 reale. Usa il tipo SDK solo se ti serve ciò che la connessione diretta non può fare:
| Funzionalità | ZKTeco diretto | SDK ZKTeco |
|---|---|---|
| Lettura di timbrature, utenti e orologio del dispositivo | Sì | Sì |
| Modifica, aggiunta, eliminazione di utenti; impostazione dell'orologio; riavvio | Sì | Sì |
| Attivare / disattivare un utente sul dispositivo | No ("non supportato qui") | Sì |
| Copiare volti e impronte tra due dispositivi | No | Sì |
| Foto degli utenti, foto istantanee alle timbrature | No | Sì |
| Eventi di timbratura in tempo reale | No (polling) | Sì, solo testato via software (meglio con l'SDK a 64 bit) |
| Richiede software sul PC | No | Sì: l'SDK ZKTeco, registrato |
| Verificato su un dispositivo reale | Sì (iFace702, funzioni di sola lettura) | No (solo simulato) |
Le modifiche ai dispositivi devono essere consentite anche nella pagina del connettore (vedi Installazione) e quelle avanzate richiedono il titolare.
#Passo dopo passo: l'SDK a 64 bit (consigliato)
Il PC del connettore deve essere Windows (64 bit) e servono i diritti di amministratore.
- Scarica tu stesso lo ZKTeco Standalone SDK da ZKTeco. SolaHR non lo include né lo ridistribuisce mai. Accetti i termini di licenza di ZKTeco quando lo scarichi. Usa la versione 6.3.1.37 o successiva: contiene una cartella chiamata
64bitcon un verozkemkeeper.dlla 64 bit, compatibile con il connettore a 64 bit. Vedi la nota qui sotto su dove ottenerlo. - Decomprimi il pacchetto in una cartella del PC (ad esempio nella cartella Download).
- Apri la cartella
64bit, fai clic con il pulsante destro su Register_SDK_x64.bat e scegli Esegui come amministratore. Copia i file dell'SDK nella cartella di sistema di Windows e registrazkemkeeper.dllal posto tuo. - In SolaHR (pagina del dispositivo, Configura il software necessario) o nella pagina del connettore, premi Verifica installazione.
- Leggi i controlli. Quando tutti sono Pronto, la scheda del dispositivo esce da Configurazione necessaria e Test connessione funziona.
Dove trovare l'SDK. ZKTeco pubblica materiale SDK nel proprio Download Center (categoria SDK) e mantiene un repository Standalone-SDK sul proprio account GitHub. Al momento della stesura abbiamo potuto verificare che il repository contiene un pacchetto più vecchio a 32 bit (Communication Protocol SDK 6.2.4.11) e che l'elenco SDK del Download Center mostra altri SDK (moduli per impronte e luce visibile); non abbiamo potuto confermare un link pubblico alla 6.3.1.37. Alcuni download di ZKTeco richiedono un accesso gratuito come membro. Se non lo trovi, chiedi a ZKTeco o al tuo distributore ZKTeco lo "Standalone SDK 6.3.1.37 o successivo, a 64 bit". Anche il link mostrato in SolaHR non è verificato in modo indipendente.
#Cosa significano i controlli di idoneità
| Verifica | Significato | Se indica Mancante |
|---|---|---|
| Windows | Il PC esegue Windows. | Un tipo SDK non può funzionare su un altro sistema ("Questo tipo di connessione non può funzionare su quel PC"). |
| Componente Python COM | Il connettore può comunicare con i componenti di Windows (pywin32). | Fa parte del connettore. Reinstalla o aggiorna il connettore. |
| SDK registrato | Windows conosce l'SDK (zkemkeeper). |
Esegui Register_SDK_x64.bat come amministratore. |
| File DLL | Il zkemkeeper.dll registrato esiste sul disco. |
Registra di nuovo; poi non spostare né eliminare i file. |
| Architettura | L'SDK è a 32 o a 64 bit e il connettore è a 64 bit. | Un SDK solo a 32 bit non è compatibile direttamente: usa l'SDK a 64 bit oppure l'alternativa qui sotto. |
La verifica di idoneità viene eseguita prima di ogni test di connessione e di ogni lettura. Un SDK mancante è uno stato, "Configurazione necessaria": SolaHR non ritenta in ciclo e non dichiara il dispositivo irraggiungibile.
#Alternativa: un SDK più vecchio, solo a 32 bit
I pacchetti più vecchi hanno solo un componente a 32 bit, che il connettore a 64 bit non può caricare direttamente. In tal caso la pagina del connettore offre Scegli DLL / Registra (diritti di amministratore; Windows ti chiederà conferma). Fa esattamente questo e nient'altro:
- verifica che il file scelto sia un file locale con il nome esatto
zkemkeeper.dlle una vera DLL di Windows; - registra quel solo file in Windows (
regsvr32); - se il file è a 32 bit, fa in modo che Windows lo esegua in un processo ausiliario separato a 32 bit.
Non scarica mai nulla, non esegue mai altri file e non modifica mai un dispositivo. Per sicurezza, quando il connettore gira come servizio registra una DLL solo sotto Program Files o Windows; per una DLL in altre posizioni un amministratore esegue solahr-dc sdk-setup --dll <path> da un prompt dei comandi con privilegi elevati. solahr-dc readiness stampa il rapporto attuale e solahr-dc sdk-setup --candidates elenca le copie della DLL che riesce a trovare. Gli eventi in tempo reale possono essere inaffidabili con questo percorso; per quelli usa l'SDK a 64 bit. Per annullare: regsvr32 /u <path to dll>. La disinstallazione di Device Connect non tocca la registrazione del tuo SDK.
#Se l'SDK non funziona: usa la connessione integrata
Nel pannello Configura il software necessario premi Usa invece la connessione integrata. Dopo la tua conferma, SolaHR cambia il tipo di connessione in quello diretto, mantiene indirizzo IP e porta, elimina le impostazioni dell'SDK e prova di nuovo il dispositivo. Timbrature e abbinamenti dei dipendenti vengono conservati. Nulla viene modificato senza la tua conferma.
#Restrizioni di licenza dei produttori e altri produttori
| SDK del produttore | Stato in Device Connect | Restrizioni da conoscere |
|---|---|---|
ZKTeco Standalone SDK (zkemkeeper) |
Implementato, solo testato via software | Concesso in licenza da ZKTeco. Non incluso e non ridistribuibile da noi: lo scarichi da ZKTeco e ne accetti i termini (il repository GitHub che abbiamo controllato non riporta alcun testo di licenza, quindi leggi i termini allegati al tuo download). Solo Windows. La registrazione vale per l'intero computer e richiede i diritti di amministratore. |
| Suprema G-SDK | Pianificato, non implementato | Il repository G-SDK di Suprema indica che i download passano al Suprema Download Center (dal 2 marzo 2026) e non vi è indicata alcuna licenza; i download potrebbero richiedere un accesso come partner. Oggi i dispositivi Suprema vengono letti tramite un server BioStar 2. |
| Device Network SDK di Hikvision | Non pianificato | Non necessario: i terminali Hikvision vengono letti tramite ISAPI (protocollo web). Le pagine SDK di Hikvision esistono per i tuoi progetti; le sue guide per sviluppatori ISAPI sul portale TPP richiedono un accordo firmato e i dati del partner. |
| Anviz CrossChex SDK | Non pianificato | Non necessario: Anviz viene letto tramite il suo protocollo di rete o CrossChex Cloud. Anviz ha una pagina di download dell'SDK per i tuoi progetti. |
Nulla di quanto qui scritto è una consulenza legale: leggi sempre la licenza allegata al download del produttore.