Annexe - Documentation technique

Type:

Documentation technique

Organisateur:

ABI

Auteur:

CDS

Objectif:

Documenter le fonctionnement logiciel des matériels de contrôle d’accès

Ce document présente l’installation et le fonctionnement des drivers et contrôleurs de matériels de contrôle d’accès pour un point de passage

  1. DRIVERS DES MATERIELS DE CONTROLE D’ACCES

  2. Les matériels de contrôle d’accès sont fournis par Z-Park avec des drivers dont l’API est composée des opérations essentielles suivantes

  3. Borne à ticket

  4. – imprimerTicket(qr entier, z chaîne, dh dateheure). Imprime et sort un ticket de parking de qrCode correspondant au nombre qr, indiquant une entrée dans la zone z à l’heure et la date courante dh.

  5. – imprimerTicketSortie(p entier, dh dateheure). Imprime sur le ticket entré (et le sort) son prix p et l’heure et la date de sortie dh.

  6. – imprimerTicketForfaitaire(qr entier). Imprime et sort un ticket de parking forfaitaire de qrCode correspondant au nombre qr.

  7. – imprimerReçuCB(m entier, d date/heure, noCB entier). Imprime et sort un reçu de carte bancaire de m euros à la date/heure d pour la carte bancaire noCB.

  8. – affichertexte(m message). Affiche le message textuel sur l’afficheur.

  9. – diffuserAudio(m message). Diffuse le message audio m sur les haut-parleurs.

  10. – ouvrirMicro(). Ouvre le micro.

  11. Barrière

  12. – lever() : chaîne. Lève la barrière. Renvoie KO en cas d’échec (impossible de lever la barrière), OK sinon.

  13. – baisser() : chaîne. Baisse la barrière. Renvoie KO en cas d’échec (impossible de baisser la barrière), OK sinon

  14. Capteur de passage

  15. – détecter(t temps) : chaîne. Détecte le passage d’un véhicule entre le lancement de l’opération et le temps t (en secondes). Renvoie KO si aucun véhicule n’a été détecté dans l’intervalle de temps; OK dès qu’un véhicule est présent.

  16. – détecterAbsence(t temps) : chaîne. Détecte l’absence de véhicule entre le lancement de l’opération et le temps t (en secondes). Renvoie KO si un véhicule est détecté au bout de l’intervalle de temps; OK dès qu’un véhicule est absent.

  17. Caméra de surveillance

  18. – lancer() : chaîne. Lance la diffusion de la caméra. Renvoie un lien vers le flux vidéo si la caméra fonctionne, KO sinon.

  20. Tous les matériels

  21. – DriverMatériel(port entier, refContrôleur Contrôleur). Crée et lance une instance du driver avec

  22. - port : le numéro du port de connexion au panneau de brassage du matériel

  23. - refContrôleur : la référence (un oid) du contrôleur de matériel qui va le commander

  24. Ce constructeur générique a des sous-opérations pour chacun des types de matériels, par exemple DriverBarrière(port entier, refContrôleur Contrôleur) pour les barrières.

  26. ARCHITECTURE ET PRINCIPE DE FONCTIONNEMENT

  27. Le système suit le patron ECB (Entity-Control-Boundary, Métier-Contrôle-IHM en français)

  28. Selon ce patron, l’objet d’IHM et l’objet de contrôle se connaissent mutuellement, l’objet domaine et l’objet de contrôle se connaissent mutuellement, mais l’objet d’IHM et l’objet métier ne se connaissent pas et ne communiquent pas entre eux.

  29. Ainsi pour un point de passage (entrée ou sortie) le système utilise trois objets : un objet métier (Entity), un objet de contrôle (Control) et un objet d’IHM (Boundary).

  30. l’objet métier appartient à la classe PointEntree ou PointSortie selon le cas. Il est persistant sur le serveur applicatif.

  31. L’objet de contrôle est un contrôleur de passage, de classe ControleurEntree ou ControleurSortie, selon le cas.

  32. Il n’y pas dans ce cas un objet d’IHM mais plusieurs, car le point de passage n’a pas d’existence propre mais est composé de matériels d’accès (barrière(s), borne à tickets, …). C’est l’ensemble des drivers de ces matériels d’accès qui constituent l’objet d’IHM, comme présenté dans le diagramme de classes de la figure 1 pour le cas de points de sortie payants.

../_images/classesDrivers.jpg

Fig. 1 : Diagramme de classe des drivers de matériels et des points de passage

  1. INSTALLATION DES MATERIELS POUR UN POINT DE PASSAGE

  2. L’installation d’un point de passage crée une instance de point de passage (dans la classe PointEntree ou PointSortie selon le cas) et une instance de contrôleur de point de passage en les liant entre elles (voir diagramme de classe).

  3. Ensuite, pour chaque matériel du point de passage

  4. – le matériel est connecté physiquement au panneau de brassage du serveur de contrôle

  5. – le code du driver de matériel est installé sur le serveur de contrôle

  6. – une instance du driver de matériel est créée sur le serveur de contrôle, en lui donnant en paramètre le numéro du port de connexion au panneau de brassage et l’oid du contrôleur de point de passage qui va le commander par la suite.

  7. – la liaison inverse est créée (du contrôleur de point de passage au matériel)

  8. – Pour finir selon les cas

  9. - le driver d’une borne à tickets d’un point d’entrée ou de sortie du personnel se met en attente d’un appel audio

  10. - le driver d’une borne à tickets d’entrée payante se met en attente d’une demande de ticket ou d’un appel audio

  11. - le driver d’une borne à tickets de sortie payante se met en attente d’une introduction de ticket ou d’un appel audio

  12. - le driver des lecteurs de plaques lance la détection de plaque

  14. FONCTIONNEMENT EN CONTINU

  15. Lecteur de plaque

  16. A la lecture d’une plaque, le driver de lecteur de plaque appelle l’opération controlerEntrée(numero chaîne) (ou controlerSortie selon le cas) de son contrôleur de point d’entrée (ou de sortie selon le cas) où numero est le numéro d’immatriculation lu. Cette opération gère l’entrée (ou la sortie selon le cas) par ce point de passage.

  17. Borne à tickets d’entrée payante

  18. A la demande de ticket, le driver de borne à tickets appelle l’opération controlerEntrée() de son contrôleur de point d’entrée qui va gérer l’entrée par ce point d’accès.

  19. Borne à tickets de sortie payante

  20. A la lecture d’un ticket, le driver de borne à tickets appelle l’opération controlerSortie(qr entier) (où qr est le QR code du ticket) de son contrôleur de point de sortie qui va gérer la sortie par ce point d’accès.

  21. Toutes les borne à tickets

  22. A l’appui sur le bouton d’appel audio, le driver de borne appelle l’opération appelAudio() de son contrôleur de passage qui va gérer l’appel audio depuis ce point de passage.

  23. Borne à tickets d’entrée ou de sortie par badge

  24. A la lecture d’un badge, le driver d’une borne à tickets appelle l’opération controlerEntrée(code entier) (ou controlerSortie selon le cas) de son contrôleur d’entrée (ou de sortie selon le cas) où code est le numéro du badge lu. Cette opération gère l’entrée (ou la sortie selon le cas) par ce point de passage.