KaVo Device
Guida tecnica per installatori: protocollo broker, percorsi e ogni errore possibile con la relativa soluzione. Classi di riferimento: KaVoSetupService, KaVoBrokerDeviceReader.
CmosDentalCamera.CameraApi (probe dicc.dll). Quel meccanismo è obsoleto ed è stato rimosso dal codice. Oggi Rceasy rileva i dispositivi KaVo/DEXIS solo tramite il broker NCI descritto sotto. Se trovi documentazione o colleghi che parlano ancora di dicc.dll, è superata.
1. Prerequisiti
Software DEXIS/KaVo installato
Rceasy controlla 8 percorsi candidati sotto {Program Files|Program Files (x86)}\PaloDEx Group\IAM\: DTXStudioDriverDashboard.exe, KaVoDriverDashboard.exe, nci_broker.exe, nci_hl.exe (in entrambe le varianti di cartella).
Broker NCI raggiungibile
Rceasy legge l'indirizzo del broker da C:\ProgramData\PaloDEx Group\NCI.xml (elemento <broker_ip>); se assente, usa il valore predefinito 127.0.0.1:11177, con timeout di connessione 3 secondi.
Dispositivo riconosciuto
Il broker deve restituire almeno un dispositivo con numero di serie non vuoto e che corrisponda a un tipo/produttore/nome KaVo noto (KaVoDeviceClassifier).
2. Flusso di controllo
CheckInstallationAsync
Verifica l'esistenza di uno degli 8 percorsi candidati sopra elencati.
CheckConnectedDeviceAsync
Apre una connessione TCP/XML al broker (127.0.0.1:11177 di default), invia login_request poi device_find_request, filtra la risposta con KaVoDeviceClassifier.IsKnownKaVoDevice e formatta l'elenco con KaVoDeviceMarketingNameResolver.
3. Protocollo del broker
| Parametro | Valore |
|---|---|
| File di configurazione | C:\ProgramData\PaloDEx Group\NCI.xml |
| Indirizzo predefinito | 127.0.0.1:11177 |
| Timeout di connessione | 3 secondi |
| Protocollo | XML su TCP: login_request → device_find_request |
| Filtro dispositivi | KaVoDeviceClassifier.IsKnownKaVoDevice (richiede numero di serie) |
4. Comportamenti da conoscere
KaVoDeviceClassifier riconosce come KaVo. Un dispositivo generico o con firmware non standard può risultare "non rilevato" anche se il broker funziona.
5. Errori comuni e soluzioni
Software DEXIS non trovato
Messaggio: "DEXIS software not found. Paths checked: {elenco}." Nessuno degli 8 percorsi candidati esiste.
Soluzione: verificare che il software DEXIS/KaVo sia installato correttamente sulla postazione.
Servizio dispositivi DEXIS non raggiungibile
La connessione al broker fallisce con IOException, SocketException, TimeoutException, InvalidDataException o XmlException (es. porta 11177 chiusa, broker non avviato, risposta XML vuota/malformata).
Soluzione: riavviare il computer e verificare che il software DEXIS sia installato e il servizio broker in esecuzione, poi riprovare.
Nessun dispositivo KaVo rilevato
Il broker risponde correttamente ma nessun dispositivo supera il filtro KaVoDeviceClassifier (0 dispositivi dopo il filtro).
Soluzione: controllare collegamenti, alimentazione e che il dispositivo sia un modello KaVo/DEXIS riconosciuto prima di rilanciare il controllo.
Indirizzo broker non valido in NCI.xml
Eccezione: "Invalid broker address: {indirizzo}". Il valore <broker_ip> in NCI.xml non è nel formato host:porta valido.
Soluzione: controllare/correggere C:\ProgramData\PaloDEx Group\NCI.xml, oppure eliminarlo per tornare al valore predefinito 127.0.0.1:11177.