Interfaccia Open CAN

Accesso diretto al sistema di comunicazione del castello

Le serrature PS Locks comunicano tramite un robusto bus CAN.

L’interfaccia aperta permette agli integratori di sistemi di integrare la comunicazione della serratura nei propri sistemi di controllo e nelle proprie applicazioni.

Basi tecniche

• CAN 2.0A

• Identificatore a 11 bit

• 50 kbit/s

• Topologia lineare

• SocketCAN su Linux

• Interfaccia CAN, per esempio can0

L’interfaccia CAN è particolarmente adatta per quelle applicazioni in cui è necessario far funzionare in modo affidabile più serrature tramite una linea bus comune.

Fino a 126 fermate per linea di autobus

Una linea CAN può essere utilizzata con un gran numero di serrature, in base all’indirizzamento del sistema e alla configurazione della rete.

Con l’implementazione dell’OIP è possibile gestire fino a 126 serrature per ogni linea di autobus.

La piattaforma è quindi adatta sia per piccoli impianti singoli che per sistemi di armadi e armadietti più grandi.

Il numero effettivamente possibile dipende dalla struttura del bus, dal cablaggio, dall’alimentazione, dall’indirizzamento dei dispositivi e dai componenti utilizzati.

Rilevamento automatico dei dispositivi

Messa in funzione con configurazione automatica

L’OIP semplifica la messa in funzione delle nuove serrature.

I dispositivi appena collegati vengono riconosciuti automaticamente sul bus CAN. Successivamente, è possibile assegnare loro un ID logico fisso e una denominazione chiara.

Ad esempio, un indirizzo tecnico di un dispositivo diventa:

Nodo CAN 17 → mandrino 12

oppure:

Nodo CAN 24 → Spogliatoio donne – Scomparto 24

L’assegnazione può essere effettuata tramite la dashboard web o tramite l’API.

Dashboard web

Tutti i blocchi di accesso in un unico posto nel browser

L’OIP mette a disposizione una moderna interfaccia utente basata sul web.

Una volta effettuato l’accesso tramite un browser web standard, le serrature collegate sono disponibili a livello centrale.

Funzioni della dashboard

• Panoramica di tutte le serrature collegate

• Visualizzazione dello stato attuale della serratura

• Visualizzazione dello stato della porta

• Comandi diretti

• Apri

• Ricarica continua

• Blocca

• Identificazione del dispositivo

• Visualizzazione degli eventi

• Visualizzazione degli stati di errore

Le modifiche di stato possono essere trasmesse immediatamente all’interfaccia web tramite Server-Sent Events (SSE).

Non è quindi necessario ricaricare manualmente la pagina.

Nomi personalizzati e configurazione

Gli ID tecnici diventano impianti chiari

A ogni lucchetto si può assegnare un nome personalizzato.

Esempi:

• Armadietto 01

• Armadietto 02

• Armadietto per attrezzi 07

• Spogliatoio uomini 12

• Camera d’albergo 204

• Armadietto per il materiale A-17

La configurazione viene salvata in modo permanente e rimane invariata anche dopo il riavvio del gateway.

Per questo motivo, l’OIP è adatto anche a impianti più grandi con tante serrature identiche.

Registro degli eventi e degli audit

Tracciabilità completa

Per gli impianti professionali, è importante poter tracciare le operazioni di comando e gli eventi.

L’OIP può registrare gli eventi rilevanti con data e ora e salvarli in un registro eventi centrale.

Tra questi possono esserci, ad esempio:

• Letture RFID

• Procedure di apertura

• Chiusure

• operazioni manuali

• Allarmi

• Errore

• Cambiamenti di stato

• Eventi di sistema

Il registro di audit è disponibile sia nell’interfaccia web che tramite l’interfaccia software per ulteriori elaborazioni.

API REST

Integrazione nel tuo software

L’OIP mette a disposizione una moderna API REST basata su HTTP.

In questo modo, le applicazioni esterne possono interrogare e controllare le serrature collegate senza dover comunicare direttamente con il bus CAN.

Possibili integrazioni

• Software per la gestione degli armadietti

• Sistemi di controllo degli accessi

• Software per hotel

• Sistema di gestione degli edifici

• Sistemi di produzione

• Sistemi ERP/MES

• applicazioni web proprie

• app mobili

• Applicazioni cloud

L’API garantisce una netta separazione tra l’applicazione e la comunicazione CAN a livello hardware.

OpenAPI e Swagger

Interfaccia intuitiva per gli sviluppatori

L’API REST può essere descritta e testata tramite una documentazione OpenAPI/Swagger.

In questo modo gli sviluppatori possono capire velocemente quali endpoint sono disponibili e creare le proprie integrazioni.

Tra i compiti tipici ci sono, ad esempio:

Cerca un castello

→ Visualizza i dispositivi e le informazioni sullo stato

Aprire la serratura

→ Inviare un comando di apertura a un cassetto specifico

Modifica configurazione

→ Gestisci i parametri operativi e le assegnazioni

Visualizza gli eventi

→ Analizzare gli eventi storici

Ricevi lo stato in tempo reale

→ Gestire le modifiche di stato tramite SSE

Architettura di sistema

Hardware e software ben separati

L’OIP si basa su un’architettura modulare.

Pianura del Castello

Serrature elettroniche per mobili PS Lock

↓

Livello del bus di campo

Bus CAN / CAN 2.0A

↓

Livello gateway

Linux / Raspberry Pi / PC industriale

↓

Livello software

Linux SocketCAN + OIP

↓

Livello di integrazione

API REST + SSE

↓

Livello applicativo

Dashboard web / Software per i clienti / Sistema di terze parti

Questa architettura permette di far funzionare l’hardware di Schloss indipendentemente dall’applicazione effettiva dell’utente.

Tecnologia software

L’OIP si basa su tecnologie open source consolidate.

Stack tecnologico

• Linux

• SocketCAN

• Python

• FastAPI

• API REST

• Server-Sent Events (SSE)

• SQLite

• HTML / JavaScript

• TailwindCSS

In questo modo la piattaforma rimane trasparente e può essere ampliata in modo flessibile da sviluppatori e integratori di sistemi.

Requisiti hardware

Hardware compatto per gateway

Come gateway si può usare, ad esempio, un Raspberry Pi o un altro computer industriale basato su Linux.

Struttura tipica

• Raspberry Pi o IPC Linux

• Interfaccia CAN / CAN-Shield

• Cablaggio del bus CAN

• Ethernet o Wi-Fi

• Serrature elettroniche per mobili PS Lock

La scelta precisa dell’hardware dipende dal numero di serrature, dall’ambiente di installazione, dall’alimentazione e dai requisiti del singolo impianto.

Assistenza per gli sviluppatori

Crea la tua applicazione

L’architettura aperta permette agli sviluppatori di creare le proprie applicazioni e sistemi di controllo basati sulla piattaforma PS Locks.

Nel repository sono disponibili, a seconda dello stato del progetto, tra le altre cose, esempi di software e test.

Interessante per gli integratori

• Esempi in Python

• Comunicazione CAN

• Integrazione API

• Rilevamento dei dispositivi

• Controllo delle serrature

• Monitoraggio dello stato

• Elaborazione degli eventi

• test automatizzati

Open source e integrazione trasparente

Niente scatola nera

Un’interfaccia aperta facilita l’integrazione a lungo termine delle serrature elettroniche nei sistemi personalizzati dei clienti.

Invece di una soluzione completa esclusivamente proprietaria, gli sviluppatori possono comprendere il funzionamento della comunicazione e basare la propria architettura software su di essa.

Questo è particolarmente interessante per gli OEM e gli integratori di sistemi che vogliono avere il pieno controllo del proprio software, dell’interfaccia utente e della logica di business.

Applicazioni tipiche

Una piattaforma – tante possibilità di utilizzo

Fitness e sport

Armadietti per palestre, piscine e impianti sportivi.

Azienda

Armadietti elettronici per i dipendenti, per uffici, stabilimenti di produzione e aree logistiche.

Alberghi

Soluzioni per armadi e contenitori con integrazione nei sistemi software esistenti.

Istituzioni scolastiche

Armadietti per scuole, università e centri di formazione.

Industria

Armadi per attrezzi, armadi per materiali e sistemi di stoccaggio controllati.

Strutture pubbliche

Sistemi di armadietti in uffici pubblici, strutture ricreative e aree accessibili al pubblico.

A chi è rivolta la Open Integration Platform?

Per tutti quelli che vogliono integrare da soli il proprio sistema di armadietti

L’OIP si rivolge in particolare a:

Integratori di sistemi

Integrazione delle serrature nei sistemi esistenti relativi agli edifici, ai controlli di accesso o alla gestione.

Produttori di armadi e armadietti

Sviluppo di sistemi di armadi personalizzati con tecnologia elettronica PS Locks.

OEM

Integrazione dei componenti per serrature nei propri prodotti e sistemi completi.

Sviluppatore di software

Sviluppo di applicazioni proprie basate sulle interfacce REST e CAN.

Automazione degli edifici

Collegamento di impianti di armadi elettronici a sistemi di gestione e di edificio di livello superiore.

Dall’hardware fino all’integrazione completa

Sei tu a decidere l’architettura del sistema

PS Locks fornisce l’hardware per le serrature elettroniche e la piattaforma di comunicazione aperta.

Con l’OIP hai a disposizione anche un gateway che semplifica l’integrazione nelle moderne applicazioni basate su IP.

In questo modo è possibile implementare diverse architetture di sistema:

Integrazione diretta con CAN

Per i tuoi sistemi di controllo e i tuoi sistemi embedded.

OIP Gateway

Per un’integrazione veloce tramite Ethernet e API REST.

Dashboard web

Per la messa in funzione, la diagnostica e il comando manuale.

Sistema di terza parte

Per l’integrazione con i software già in uso per armadietti, edifici o controllo accessi.

Dati tecnici

Repository e risorse per gli sviluppatori

Inizia subito con l’integrazione

Il software e le risorse per gli sviluppatori sono disponibili nel repository:

GitHub:
https://github.com/sigar-nxp/CAN

Lì gli sviluppatori possono consultare i componenti disponibili, gli esempi e i test e prepararsi a integrarli nel proprio ambiente di sistema.

Domande frequenti

Le serrature PS Locks possono essere controllate direttamente tramite CAN?

Sì. Le serrature sono dotate di un’interfaccia di comunicazione basata su CAN, grazie alla quale possono essere integrate in sistemi di controllo e software personalizzati.

Mi serve l’OIP per la comunicazione CAN?

No. L’OIP è un livello aggiuntivo di gateway e software. È possibile anche un’integrazione diretta tramite CAN.

Posso sviluppare un software tutto mio?

Sì. L’interfaccia aperta è particolarmente interessante per integratori, OEM e sviluppatori di software che vogliono creare le proprie applicazioni.

Posso gestire più serrature contemporaneamente?

Sì. Le serrature possono essere collegate centralmente tramite il bus CAN. Il numero massimo dipende dalla struttura specifica del bus e dalla configurazione del sistema. Nella configurazione descritta, l’OIP supporta fino a 126 serrature indirizzabili per linea bus.

Posso verificare lo stato di una serratura?

Sì. A seconda del modello di serratura utilizzato, è possibile leggere, tra le altre cose, le informazioni relative allo stato dei catenacci, della porta e del sistema RFID.

C’è un’interfaccia web?

Sì. L’OIP dispone di un pannello di controllo basato sul web per la messa in servizio, il monitoraggio e il controllo manuale.

C’è un’API REST?

Sì. L’OIP mette a disposizione un’interfaccia REST basata su HTTP per l’integrazione con applicazioni esterne.

Posso integrare le serrature in un sistema di gestione di edifici o armadi già esistente?

Sì. Tramite CAN o l’API REST OIP, le serrature possono essere integrate in sistemi di livello superiore.

Di quale hardware ho bisogno per l’OIP?

Di solito un Raspberry Pi o un PC industriale basato su Linux con interfaccia CAN e una connessione di rete.

Sei pronto per la tua soluzione su misura per gli armadi?

Sviluppa la tua applicazione su una piattaforma aperta.

Che si tratti di un singolo armadietto, di un grande impianto di armadietti o di un sistema di gestione degli armadietti completamente integrato:

Con PS Locks avrai a disposizione serrature elettroniche per mobili dotate di un’interfaccia di comunicazione aperta e di una base flessibile per integrazioni personalizzate.

Scegli l’hardware
Scopri le soluzioni di chiusura PS Locks disponibili.

Documentazione tecnica
Scopri di più sulla comunicazione CAN e sull’integrazione.

Prova OIP
Usa il gateway per un collegamento veloce tra il bus CAN e la rete IP.

Repository degli sviluppatori
https://github.com/sigar-nxp/CAN

PS Locks – Integrazione aperta

Serrature elettroniche. Interfacce aperte. Sistemi propri.

Crea la soluzione di armadio più adatta alla tua applicazione.