Microcode Tillys

Le microcode TILLYS est le langage de programmation propriétaire exécuté par les UTL TILLYS NG et TILLYS CUBE de TIL Technologies (groupe HIRSCH). Il définit le comportement de l’UTL face aux événements remontés par les lecteurs de badges, modules déportés et plages horaires.

Ce guide couvre la syntaxe complète, les 3 sections du programme, tous les registres et événements, ainsi que les fonctions clés (PULSE, SET_RDR_MODE, blocs SI/SINON/FINSI).

Sommaire

1.Qu’est-ce que le microcode TILLYS ? 2.Structure d’un programme microcode 3.Adressage des registres TILLYS 4.Section initialisation 5.Section combinatoire 6.Section événementielle 7.Fonctions clés (PULSE, XPULSE, SET_RDR_MODE…) 8.Couleurs SET_RDR_COLOR (SSCP / OSDP) 9.Exemple complet — porte simple 10.Exemple avancé : MLP2 double lecteur avec contrôle renforcé et détecteurs de porte 11.Pièges courants à éviter 12.Glossaire

1. Qu’est-ce que le microcode TILLYS ?

Le microcode est un langage de programmation spécifique exécuté par chaque UTL TILLYS.

Il utilise des mnémoniques (noms courts) qui correspondent directement aux registres physiques et virtuels de l’automate : entrées de modules déportés, sorties de relais, plages horaires, états de lecteurs.

La combinaison de ces mnémoniques avec des opérateurs logiques, des opérateurs de test et des blocs conditionnels permet de rédiger des programmes allant de quelques lignes (porte simple) à plusieurs centaines de lignes (gestion intrusion + contrôle d’accès complexe).

Source : document officiel TIL Technologies / HIRSCH Secure SAS

2. Structure d’un programme microcode

Un programme microcode TILLYS est composé de 3 sections implicites, exécutées dans un ordre précis.
Elles ne sont pas déclarées explicitement : c’est leur position et leur contenu qui déterminent à quelle section elles appartiennent.

3. Adressage des registres TILLYS

Avec la TILLYS NG/CUBE et les modules déportés 16 entrées, la syntaxe des registres d’entrées (D, G) et de sorties (X) utilise désormais 4 chiffres au lieu de 3.

Décomposition d’une adresse

X  A  01  03
│  │  │   └─ N° de voie / I/O sur le module (01 à 16)
│  │  └───── Adresse du module déporté sur le bus (01 à 16)
│  └──────── Bus de raccordement : A, B ou C
└─────────── Type de registre : D (entrée), G (entrée GTC), X (sortie)

Exemples :
  DA0214  →  Entrée n°14 du module @ adresse 02 sur bus A
  XC1103  →  Sortie n°03 du module @ adresse 11 sur bus C
  XA0101  →  Sortie n°01 du module @ adresse 01 sur bus A

Concrètement, sur une TILLYS NG avec un module MLP branché sur le bus A dont les deep switches sont réglés sur adresse 01, l’écriture XA0101 désigne la voie 01 de ce module qui correspond physiquement au relais 1 (typiquement câblé sur la gâche de la porte).

Types de registres disponibles

Le microcode distingue deux familles : les registres ToR (Tout ou Rien, valeur 0 ou 1) et les registres numériques (entiers 32 bits signés).

Correspondance bus / numérotation des lecteurs

Source de confusion fréquente : la numérotation des lecteurs dans les événements badge (Lyx) et clavier (CLVx) ne suit pas la même logique selon le bus.

Adressage des sorties sur module MLP2

Chaque module déporté (MLP1, MLP2, MLD1, MLD2) expose ses entrées/sorties selon la convention Xxyyzz, avec un mapping fixe des voies selon leur fonction.

Cliquer pour agrandir

Sur un MLP2 (deux têtes de lecture) : le module consomme une seule adresse sur le bus mais expose des voies supplémentaires pour le second lecteur. La LED verte du lecteur 2 se trouve à la voie 06.

Entrées physiques (D) : les bornes I1, I2, I3…

Les entrées physiques du MLP, sérigraphiées I1, I2, I3… (ou In1, In2… selon les versions) sur le bornier, correspondent aux registres D. C’est sur ces entrées que sont câblés les contacts de porte, boutons de sortie (REX), contacts d’arrachement et autres détecteurs en boucle EOL.

Sorties (X) : pas seulement les relais

Les sorties X regroupent toutes les commandes de sortie du module — pas uniquement les relais :

• Les voies 01 et 02 sont des relais secs (R1 et R2), accessibles physiquement sur le bornier du MLP. C’est là qu’on câble la gâche, l’électro-aimant ou un asservissement.
• Les voies 03, 04 et 05 sont des commandes logiques transmises au lecteur via le bus SSCP/RS485 qui le relie au MLP. Elles ne correspondent à aucune borne visible sur le MLP : l’ordre est transmis dans le câble du lecteur, et c’est le lecteur Evolution lui-même qui allume sa LED ou actionne son buzzer.

4. Section initialisation

La section initialisation est exécutée une seule fois, à la fin du téléchargement du microcode dans l’UTL. Elle ne se ré-exécute pas lors d’un téléchargement de badges, de plages horaires ou de jours fériés.

TEMPO() — Temporisation d’un registre ToR

Filtre les rebonds ou déclenchements intempestifs sur un registre ToR. Maximum 128 fonctions TEMPO par programme.

TEMPO(Registre_ToR)=n0,n1
; n0 : tempo sur front descendant (1/10e sec)
; n1 : tempo sur front montant (1/10e sec) — si omis, n1 = n0

;--- Exemples ---
TEMPO(DA0101)=10,20    ; 1s en descente, 2s en montée
TEMPO(DA0102)=10       ; 1s dans les deux sens

#DEFINE — Définition de constantes nommées

Permet de nommer une valeur ou un registre pour améliorer la lisibilité du code.

#DEFINE LED_VERTE 30           ; constante valant 30
#DEFINE $LEC_PORTE1 LA1        ; alias du lecteur 1 bus A
#DEFINE $CMD_PORTE1 XA0101     ; alias de la sortie gâche

;--- Utilisation ---
EV(LA1==AUTORISE)
  XA0101=PULSE(LED_VERTE)      ; impulsion de 3 sec

SET_RDR_COLOR() — Personnalisation des couleurs LED lecteur

Définit les couleurs des LED des lecteurs transparents. Compatible firmware ≥ 1.9.0 (TILLYS NG/CUBE) et ≥ 1.8.0 (modules MLD/MLP). À placer uniquement en section initialisation.

SET_RDR_COLOR(l, c1, c2, c3, c4)
; l  : numéro de lecteur (1 à 24)
; c1 : couleur au repos (LED1=0, LED2=0)
; c2 : couleur quand LED1=1, LED2=0
; c3 : couleur quand LED1=0, LED2=1
; c4 : couleur quand LED1=1, LED2=1

;--- Exemple ---
SET_RDR_COLOR(1,cyan,lime,gold,magenta)

5. Section combinatoire

Boucle principale exécutée en permanence par l’UTL. Chaque ligne est une formule de la forme registre_sortie = expression. Les formules peuvent utiliser des parenthèses (profondeur max 8) et sont limitées à 75 caractères.

Opérateurs logiques (registres ToR)

Opérateurs de test

6. Section événementielle

La section événementielle contient des blocs EV(condition) suivis d’instructions. Ces instructions ne s’exécutent que lorsque l’événement se produit.

Événements badges lecteurs (TILLYS NG / CUBE)

Syntaxe : EV(Lyx==ÉTAT) où x est l’adresse lecteur (1 à 8) et y est le bus (A, B ou C).

Événements système et plages horaires

7. Fonctions clés de la section événementielle

PULSE() — Impulsion temporisée sur sortie ToR

Génère une impulsion à 0 ou à 1 sur un registre de sortie ou un registre virtuel ToR. Maximum 128 fonctions PULSE par programme, 48 en simultané par même événement.

Registre_sortie = PULSE(t, niveau)
; t      : durée en 1/10e sec (constante ou registre VN/RN/MN)
; niveau : 1=impulsion haute (défaut), 0=impulsion basse

Détail des exemples avec leur adressage décomposé :

SET_RDR_MODE() — Modification dynamique du mode lecteur

Modifie en cours de fonctionnement le comportement d’un lecteur : marche/arrêt, contrôle renforcé, passage contrôlé, escorte.

SET_RDR_MODE(l, a, v)
; l : numéro de lecteur (1 à 24)
; a : action — 0=marche/arrêt, 1=contrôle renforcé, 2=passage contrôlé
; v : mode (dépend de a)

;--- Verrouillage automatique hors plage horaire ---
EV(P1==0)
  SET_RDR_MODE(1,0,0)    ; arrêt du lecteur 1
  SET_RDR_MODE(2,1,3)    ; lecteur 2 en contrôle renforcé personnalisé

SI / SINON / FINSI — Blocs conditionnels

SI(expression_logique)
  (instructions si vrai)
SINON
  (instructions si faux)    ; SINON est facultatif
FINSI

;--- Exemple ---
EV(LA1==AUTORISE)
  XA0101=PULSE(30)
  SI(DA0101==1)
    V5=1
  SINON
    V5=0
  FINSI

EXIT — Abandon du traitement en cours

EV(LA1==AUTORISE)
  SI(P1==0)            ; si hors plage horaire
    EXIT               ; ne pas continuer le traitement
  FINSI
  XA0101=PULSE(30)     ; exécuté uniquement si P1 actif

8. Couleurs disponibles pour SET_RDR_COLOR()

Protocole SSCP — lecteurs Evolution

Disponible sur lecteurs Evolution ST, KB et TL (firmware ≥ Z01), Evolution XS (≥ Z02) et Evolution IN (≥ Z14).

Protocole OSDP — lecteurs HID

9. Exemple complet : microcode contrôle d’une porte simple

Microcode pour une porte équipée d’un lecteur sur le bus A à l’adresse 1 (MLP2), avec gâche, LED de feedback, bouton de sortie et passage libre par plage horaire.

;==================================================
; SECTION INITIALISATION
;==================================================
#DEFINE TEMPO_GACHE 30    ; durée gâche : 3 secondes
#DEFINE TEMPO_LED   30    ; durée LED   : 3 secondes

SET_RDR_COLOR(1,blue,green,red,orange)
; au repos : bleu | badge OK : vert | badge KO : rouge

;==================================================
; SECTION COMBINATOIRE
;==================================================
; Maintien gâche ouverte si V1 actif (passage libre)
XA0101=V1

;==================================================
; SECTION ÉVÉNEMENTIELLE
;==================================================

; --- Initialisation au démarrage ---
EV(INIT)
  XA0103=0    ; LED1 éteinte
  XA0104=0    ; LED2 éteinte

; --- Badge autorisé ---
EV(LA1==AUTORISE)
  XA0101=PULSE(TEMPO_GACHE)   ; impulsion gâche 3 sec
  XA0103=PULSE(TEMPO_LED)     ; LED verte 3 sec

; --- Badge interdit ---
EV(LA1==INTERDIT)
  XA0104=PULSE(TEMPO_LED)     ; LED rouge 3 sec

; --- Bouton de sortie (entrée DA0102) ---
EV(DA0102==1)
  XA0101=PULSE(TEMPO_GACHE)   ; déverrouillage côté sortie
  XA0103=PULSE(TEMPO_LED)     ; LED verte

; --- Passage libre activé par plage horaire P1 ---
EV(P1==1)
  V1=1                        ; maintien gâche ouverte

EV(P1==0)
  V1=0                        ; fermeture gâche

10. Exemple avancé : MLP2 double lecteur avec contrôle renforcé et détecteurs de porte

Cet exemple couvre une configuration réelle avec deux portes sur un même MLP2 : un lecteur badge (LA3) et un lecteur à code en contrôle renforcé (LA1), chacun conditionné par son propre détecteur d’ouverture de porte.

;---------------------------------------
; SECTION INITIALISATION
;---------------------------------------
 
SET_TACTILLYS_LOGIN_MODE(1,1)
PCLV1=3,4,10
 
; Couleurs LED pour tous les lecteurs
; repos=bleu | accès OK=vert | refus=rouge | attente code=orange
SET_RDR_COLOR(1,blue,green,red,orange)
SET_RDR_COLOR(2,blue,green,red,orange)
; ... (idem pour lecteurs 3 à 16)
SET_RDR_COLOR(16,blue,green,red,orange)
 
;---------------------------------------
; SECTION COMBINATOIRE
;---------------------------------------
XA0302=V2   ; R2 (gâche unique) suit V2 en permanence
 
;---------------------------------------
; SECTION ÉVÉNEMENTIELLE
;---------------------------------------
 
; --- LECTEUR BADGE (LA3) ---
; Si DA0301==0 (porte 1 ouverte) → refus immédiat, LED rouge
EV(LA3==AUTORISE)
    SI(DA0301==1)           ; porte 1 fermée → on autorise
        XA0303=PULSE(30)    ; LED verte LA3 — 3 sec
        V2=PULSE(30)        ; gâche ouverte 3 sec
    SINON                   ; porte déjà ouverte → refus
        XA0304=PULSE(30)    ; LED rouge LA3 — 3 sec
    FINSI
 
EV(LA3==INTERDIT)
    XA0304=PULSE(30)        ; LED rouge LA3 — 3 sec
 
; --- LECTEUR À CODE (LA1) : badge lu ---
; Vérification immédiate du contact de porte
; Si porte fermée → orange pendant l'attente du code (10 sec)
; Si porte ouverte → rouge immédiat, pas d'attente du code
EV(LA1==AUTORISE)
    SI(DA0302==1)           ; porte fermée → attente code → orange
        XA0103=PULSE(100)   ; LED1=1 pendant 10 sec
        XA0104=PULSE(100)   ; LED2=1 pendant 10 sec → LED1+LED2 = orange
    SINON                   ; porte ouverte → refus immédiat
        XA0104=PULSE(30)    ; LED rouge — 3 sec
    FINSI
 
; --- LECTEUR À CODE (LA1) : bon code saisi ---
; Double vérification : la porte peut s'être ouverte entre le badge et le code
EV(LA1==CR_OK)
    SI(DA0302==1)           ; porte toujours fermée → on ouvre
        XA0103=PULSE(30)    ; LED verte — 3 sec
        XA0104=0            ; extinction LED rouge / orange
        V2=PULSE(30)        ; gâche ouverte 3 sec
    SINON                   ; porte ouverte entre-temps → refus
        XA0104=PULSE(30)    ; LED rouge — 3 sec
    FINSI
 
; --- LECTEUR À CODE (LA1) : mauvais code ou timeout ---
EV(LA1==CR_KO)
    XA0104=PULSE(30)        ; LED rouge — 3 sec
 
; --- BOUTON POUSSOIR DE SORTIE (DA0306 = I6) ---
; Sortie libre, pas de condition sur le contact de porte
EV(DA0306==1)
    V2=PULSE(30)            ; gâche ouverte 3 sec
    XA0303=PULSE(30)        ; LED verte LA3 — feedback visuel

11. Pièges courants à éviter

12. Glossaire

Définitions des sigles et termes techniques utilisés dans ce guide et dans la documentation TIL Technologies.