Ce document décrit comment installer et mettre en service des terminaux de pointage avec Planik, pour deux familles de matériel :

  1. Datafox

  2. Dormakaba (Besico / Besicomm Box)

Pour chaque famille, les informations sont organisées par profil :

  • Administration / chefs d’équipe

  • Service informatique (IT)

  • Électricien·ne / installateur·trice


Les détails très techniques (fichiers internes, formats UID des badges, etc.) sont indiqués comme Note technique et peuvent être ignorés si vous n’en avez pas besoin.
Le présent document se concentre sur ce que les clients doivent savoir pour installer et utiliser les terminaux avec Planik.


Table des matières




1. Datafox

1.1 Informations pour l’administration et les chefs d’équipe

1.1.1 Ce que vous recevez


Pour un terminal Datafox utilisé avec Planik (par exemple EVO 3.5 Universal), la livraison contient généralement :

    - un terminal Datafox (EVO 3.5 Universal ou modèle compatible),

    - un cadre de montage en saillie (montage apparent recommandé),

    - un adaptateur PoE (Power over Ethernet), ou la préparation pour une alimentation via un port PoE du switch réseau.


Les terminaux livrés par Planik sont :

    - déjà préconfigurés selon les besoins de votre organisation,

    - préparés pour se connecter à votre organisation dans Planik Hub.


L’adaptateur PoE peut déjà être câblé sur le terminal. Selon le type de blindage du câble Ethernet, la pince de blindage peut être fixée au niveau de l’adaptateur ou au dispositif de décharge de traction.



1.1.2 Vérifications à la réception


À la réception du colis, l’administration / le chef d’équipe peut :

  1. Déballer le terminal.
  2. Sur l’étiquette du terminal, vérifier :
    - le numéro de série (SN),
    - le type de communication (PoE),
    - le type de lecteur de badge : Mifare ou LEGIC.
  3. Conserver cette information (SN, type de badge, etc.) dans la documentation interne.
  4. Demander à l’IT / à l’électricien·ne de raccorder le terminal au câble réseau prévu et de l’allumer.

Après allumage :

  • le terminal doit démarrer,
  • en haut à droite de l’écran, l’icône “TCP IP” apparaît d’abord faiblement, puis doit devenir fortement lumineuse en moins de ~30 secondes.


Si l’icône TCP IP est lumineuse, le terminal est connecté au Planik Hub.



Si la connexion ne fonctionne pas, vérifier que les étapes précédentes ont correctement été effectuées en contactant le service informatique de votre entreprise. Contacter le support Planik si l'icône lumineuse ne s'allume toujours pas, ou si elle clignote (support@planik.ch, +41 31 544 40 60).


1.1.3 Quand le terminal est-il prêt à l’emploi ?


Le terminal est considéré comme prêt à l’emploi lorsque :

  1. L’icône “TCP IP” est allumée fortement → connexion au cloud OK.
  2. En présentant un badge devant le lecteur :
    - soit un pointage est enregistré (badge connu),
    - soit un message d’erreur indique que le badge ne peut pas être attribué.


Ensuite, dans Planik Web :

  1. Si le badge n’est pas encore attribué, l’affecter à un·e collaborateur·rice dans Planik.
  2. Refaire un test de badgage.
  3. Vérifier que le pointage apparaît dans Planik, par exemple via :
    - Mes équipes → Paramètres → Paramètres d’équipe → Saisie du temps, ou
    - Évaluations → Saisie du temps dans l’équipe concernée.


1.1.4 Modes de fonctionnement des terminaux (KG, M, KGM)

Les terminaux Datafox utilisés avec Planik peuvent fonctionner en trois modes :

  • Dual (KG)

    • Le collaborateur choisit explicitement Kommen (Entrée) ou Gehen (Sortie) avant de badger.

    • Avantage : direction de pointage claire.

  • Mono (M)

    • Le collaborateur badge simplement, sans choisir la direction.

    • Planik déduit automatiquement s’il s’agit d’une entrée ou d’une sortie, en fonction du planning.

  • Mixte (KGM)

    • Combinaison des deux modes :

    • certains pointages restent en mono, d’autres nécessitent un choix explicite Entrée / Sortie.

Le mode est défini avec Planik lors de la configuration du projet.


1.1.5 Administration côté client

Il est recommandé qu’une personne joue le rôle d’administrateur·trice des terminaux côté client :

  • connaît la liste des terminaux installés (emplacements, noms, type de lecteur),

  • sait vérifier rapidement si un terminal semble fonctionner (icône TCP IP, test de badge),

  • fait le lien avec l’IT en cas de souci réseau,

  • gère l’attribution des badges dans Planik ou coordonne ce point avec les RH.


1.2 Informations pour le service informatique (IT)

1.2.1 Préparation réseau – Vue générale

Objectif : permettre au terminal Datafox de communiquer avec Planik Hub.

L’IT doit :

  • connecter les terminaux à des ports PoE d’un switch adapté,

  • autoriser les connexions sortantes suivantes :

    • vers Planik Hub :

      • URL : https://hub.planik.ch

      • Port : 443 (HTTPS)

    • pour la communication Datafox → Planik Hub :

      • Port 8000 (sortant)

  • définir pour chaque terminal :

    • une adresse IP (via DHCP ou fixe),

    • un masque de sous-réseau,

    • une gateway,

    • un ou plusieurs serveurs DNS.


Sur les réseaux segmentés, il peut être judicieux d’utiliser un VLAN spécifique pour les terminaux de pointage (pour isoler le trafic et simplifier le diagnostic).


1.2.2 Fichiers de configuration réseau (INI, DF0)

En interne, la configuration réseau des terminaux Datafox se fait avec le logiciel Studio V, via deux fichiers principaux :

  • Fichier INI (réseau)

    • définit le réseau cible dans lequel le terminal va fonctionner chez le client :

      • protocole,

      • ports utilisés,

      • gateway,

      • adresse / host du Hub.

  • Fichier DF0

    • définit les propriétés spécifiques au terminal :

      • DHCP ou IP fixe,

      • adresse IP du terminal,

      • masque de sous-réseau,

      • gateway locale.



- Dans Studio V, le menu “Systemvariablen für die Gerätekonfiguration” fixe le réseau (INI).
- Le menu “LAN/wLAN-Konfiguration (*.df0)” fixe les paramètres du terminal (DF0).
- Il peut être utile de reproduire un sous-réseau de test similaire à celui du client pour valider la configuration avant la mise en production.


1.2.3 Programme du terminal & listes (AES, TXT)

Les terminaux Datafox exécutent un programme interne défini dans un fichier AES.

  • Le fichier AES est :

    • spécifique au client,

    • spécifique au type de terminal (EVO 3.5, EVO 4.3, etc.),

    • spécifique à la langue et au type de transpondeur (Mifare, LEGIC).

Certains programmes utilisent aussi des listes TXT, par exemple pour des raisons de départ (“Gehengründe”).



- Dans Studio V, le menu Communication permet de charger la Programmdatei (AES) et les listes TXT associées.
- Quand un fichier AES est ouvert, les listes qui lui sont associées apparaissent en bas à gauche.
- Les conversions AES entre différents modèles de la série EVO (EVO 3.5 ↔ EVO 4.3) ont déjà été préparées par Planik ; elles ne doivent pas être modifiées côté client sans coordination.


1.2.4 Affichage & langue (INI Display, DFL)

Affichage (touches, écran)

  • L’affichage (touches Kommen/Gehen/Mono/Info/Manuell/ESC, présentation de l’écran) est défini dans un fichier INI d’affichage, modifiable via le Display Designer.

  • La configuration standard Planik utilise 6 touches principales.

Langue système (DFL)

  • La langue de l’interface terminal (FR / DE) est définie via un fichier DFL.

  • Lors du chargement, une .bin est générée, qui doit être compatible avec la version de firmware du terminal.


- Exemples de fichiers : user-deutsch.dfl, user-french.dfl.
- Après mise à jour de la firmware, il faut vérifier la compatibilité avec les DFL utilisés.



1.2.5 Certificat HTTPS (CERT) et firmware (DFZ)

Certificat HTTPS (CERT)

  • Les terminaux utilisent un certificat pour établir une connexion HTTPS vers hub.planik.ch.

  • Ce certificat est chargé sur le terminal via le menu approprié dans Studio V.

  • Le certificat a une date de validité ; il doit être mis à jour avant expiration sur tous les terminaux.

Firmware (DFZ)

  • La firmware du terminal est mise à jour à l’aide d’un fichier DFZ.

  • Une version de base (“baseline”) est définie pour chaque génération de terminaux.

  • Studio V doit être maintenu à jour pour gérer les firmware récentes.



- Un terminal doit contenir uniquement des certificats valides.
- Lors d’une mise à jour firmware, toujours vérifier :
    - la langue (DFL)
    - la communication HTTPS avec Planik Hub (443, certificat)


1.3 Informations pour l’électricien·ne / installateur·trice

1.3.1 Travaux attendus

  • Poser le câble Ethernet entre le local technique (switch PoE) et le terminal.

  • Réaliser les perçages nécessaires.

  • Fixer le terminal sur le mur, en général avec le cadre de montage en saillie (recommandé).


(pdf des plans en annexe)


Le montage encastré de l’EVO 3.5 Universal n’est en général pas recommandé en raison :
- de la rigidité du câble PoE,
- de l’espace limité dans les boîtes d’encastrement.


1.3.2 Gabarits et cadre de montage

  • Pour un montage en saillie : un cadre spécifique est fourni, avec une notice de montage.

  • Pour un montage encastré (si tout de même choisi), il existe un gabarit de perçage spécifique.


Les documents se trouvent en pdf en fin de tutoriel ou en image ci-dessous:




1.3.3 Connexion et test

  • Brancher le câble Ethernet sur un port PoE du switch.

  • Vérifier que le terminal s’allume.

  • Informer l’IT qu’un test réseau peut être effectué (icône TCP IP, test de badge).


Si le câble tire sur les petits fils du connecteur vert, pensez à utiliser la décharge de traction et à fixer la pince de blindage à l’emplacement prévu pour éviter qu’ils ne soient endommagés.




1.4. Terminaux mobiles Datafox

1.4.1. Livraison des terminaux

Le terminal est préconfiguré par Planik (selon les exigences du client) et la livraison comprend 3 éléments :

  • Terminal (avec module de téléphonie mobile / antenne / carte SIM)
  • Cadre de montage en saillie
  • Alimentation 220/230 V avec connecteur système


Notre récommandation à la réception du terminal:

  • Déballez le terminal et vérifiez sur l’étiquette le numéro de série (SN), le type de communication (dans ce cas : PoE) ainsi que le type de lecteur de transpondeur (Mifare ou Legic).
  • Alimentez le terminal. Pour le modèle EVO 3.5 Universal, le bloc d’alimentation doit être branché, comme indiqué dans la documentation fournie, à l’aide du connecteur système dans l’emplacement système libre. Pour un test, il peut être simplement raccordé sans fixation définitive.
  • Si le terminal réagit correctement comme attendu, l’installation est probablement conforme. Il démarre alors, affiche le logo Planik dans sa configuration, puis, après quelques minutes, indique un état opérationnel acceptable.



2. Dormakaba (Besico / Besicomm Box)

2.1 Informations pour l’administration et les chefs d’équipe

2.1.1 Architecture générale

Une installation Dormakaba associée à Planik comprend généralement :

  • une Besicomm Box (boîtier de communication),

  • un ou plusieurs terminaux Dormakaba,

  • une connexion réseau vers le Planik Hub.

Fonctionnement :

  • la Box récupère les données de base (collaborateurs, badges, etc.) depuis Planik,

  • les terminaux envoient leurs badges à la Box,

  • la Box traite ces badgages et transmet les résultats à Planik (en flux ou par paquets).

Planik permet également un fonctionnement mixte (Datafox + Dormakaba) dans une même organisation, à condition d’utiliser la même technologie de badge.



2.1.2 Informations à préparer côté client

Avant la mise en service, l’administration / le chef d’équipe doit clarifier :

  • Installation :

    • emplacements des terminaux et de la Box (entrée, vestiaires, etc.),

  • Activation réseau :

    • coordonnées du réseau (gateway, DNS, DHCP / IP fixes, ports),

  • Nom des terminaux :

    • noms souhaités tels qu’ils apparaîtront dans Planik,

  • Badges :

    • type (Mifare, LEGIC, etc.),

    • plage de numéros,

    • règles d’attribution aux collaborateurs,

  • Responsable technique :

    • personne en charge des questions “terminaux” chez le client.

Ces informations sont rassemblées dans un formulaire de configuration client, utilisé pour préparer la Box et les terminaux. 

Ce formulaire au format Excel est envoyé par Planik. Le client doit remplir les champs de la colonne "Valeur à la livraison" dont la valeur est actuellement "???" avant de renvoyer le fichier à leur contact chez Planik.



2.1.3 Modes de fonctionnement

Comme pour Datafox, les terminaux Dormakaba peuvent fonctionner en :

  • Dual (KG) – choix explicite Entrée / Sortie,

  • Mono (M) – un simple badgage, interprétation automatique via Planik / Box,

  • Mixte (KGM) – combinaison des deux.

Le mode est défini avec Planik lors de la configuration du projet.


2.2 Informations pour le service informatique (IT)

2.2.1 Préparation réseau

L’IT doit assurer la connectivité :

  • de la Besicomm Box au réseau interne puis à Internet,

  • des terminaux Dormakaba au réseau (souvent via PoE).

Les connexions sortantes suivantes doivent être autorisées :

  1. Vers le Planik Hub :

    • URL : https://hub.planik.ch

    • Port : 443 (HTTPS)

  2. Pour la maintenance à distance de la Box :

    • SSH : port 18722

    • NTP : port 123 (synchronisation de l’heure)

  3. Pour la communication interne Box ↔ terminaux :

    • Port 30465 sur le réseau interne.

Paramètres réseau :

  • gateway, DNS, masque de sous-réseau,

  • DHCP ou IP fixe pour la Box et les terminaux,

  • éventuellement VLAN dédié.


2.2.2 Processus de configuration

  • Les informations fournies par le client dans le formulaire sont utilisées pour :

    • configurer la Box (IP, ports, communication avec Planik Hub),

    • configurer les terminaux (type de badge, mode de fonction, etc.).

  • La Box et les terminaux sont livrés préconfigurés pour se connecter à l’organisation Planik du client.

Une fois installés et allumés :

  1. L’IT vérifie que la Box obtient une IP et peut joindre hub.planik.ch.

  2. Vérifie que les terminaux sont alimentés et communiquent avec la Box.

  3. Planik peut ensuite valider qu’un badge test produit bien un enregistrement de temps. 


2.2.3 Badges et encodage – vue générale

Les badges peuvent être de différents standards (Mifare DESFire, LEGIC, etc.) :

  • chaque badge a un numéro unique,

  • ce numéro est généralement réduit à 4 ou 6 chiffres significatifs pour l’utilisation dans Planik,

  • la structure exacte (offset, longueur, format BCD / HEX) est définie dans le formulaire de configuration.

Les détails internes sur les formats UID (Mifare DESFire EV1/EV2/EV3, LEGIC prime / advant, badges mobiles, etc.) sont gérés par Planik et/ou le fournisseur. Se référer à la documentation technique si nécessaire.


2.3 Informations pour l’électricien·ne / installateur·trice

2.3.1 Travaux attendus

  • Poser les câbles Ethernet :

    • entre le switch / routeur et la Besicomm Box,

    • entre le switch (PoE) et les terminaux Dormakaba.

  • Prévoir un emplacement pour la Box (local technique, rack, etc.).

  • Fixer les terminaux aux emplacements prévus (sas, entrée principale, vestiaires…).

2.3.2 PoE et tests de base

  • Utiliser des ports PoE adaptés pour les terminaux si ceux-ci sont alimentés en PoE.

  • Étiqueter les câbles pour faciliter le travail de l’IT.

  • Après installation, vérifier que :

    • la Box est alimentée,

    • les terminaux s’allument bien.

Ensuite, l’IT peut finaliser les tests de communication et les tests de badge.


Annexe – Aide-mémoire rapide par rôle (Datafox & Dormakaba)


A. Administration / Chefs d’équipe

À faire pour Datafox & Dormakaba :

  • À la réception :

    • vérifier le contenu : terminal(s), cadre(s), adaptateur(s) PoE, Box (Dormakaba),

    • noter les numéros de série (SN) et le type de lecteur (Mifare / LEGIC).

  • Avant installation :

    • décider où seront installés les terminaux (portes, vestiaires, etc.),

    • décider comment nommer les terminaux dans Planik (ex. “Entrée principale”, “Vestiaire étage 1”).

  • Badges :

    • définir qui reçoit un badge,

    • veiller à ce que les badges soient attribués aux collaborateur·rice·s dans Planik,

    • tester quelques badges après installation.

  • Validation :

    • vérifier que les icônes réseau (TCP IP) sont allumées sur les terminaux,

    • vérifier que les pointages apparaissent dans Planik (Évaluations / Saisie du temps).

B. Service informatique (IT)

Datafox :

  • Réseau :

    • connecter les terminaux sur des ports PoE,

    • autoriser les connexions sortantes vers https://hub.planik.ch (port 443) et port 8000,

    • configurer IP / DHCP, gateway, DNS, masque.

  • Tests :

    • vérifier que le terminal démarre,

    • vérifier que l’icône TCP IP devient lumineuse,

    • faire un test de ping / résolution DNS si besoin.

Dormakaba :

  • Réseau Box + terminaux :

    • Box : accès à https://hub.planik.ch (port 443),

    • autoriser ports 18722 (SSH) et 123 (NTP) pour la Box,

    • autoriser port 30465 entre Box et terminaux,

    • configurer IP / DHCP, gateway, DNS, masque.

  • Tests :

    • vérifier que la Box obtient une IP et sort sur Internet,

    • vérifier que les terminaux s’allument et communiquent avec la Box,

    • valider avec Planik qu’un badge test produit un pointage.

C. Électricien·ne / Installateur·trice

Points communs :

  • Câblage :

    • poser les câbles Ethernet vers chaque terminal,

    • utiliser des ports PoE pour alimenter les terminaux,

    • poser un câble réseau dédié pour la Box (Dormakaba).

  • Montage :

    • Datafox : favoriser le montage en saillie avec le cadre fourni,

    • Dormakaba : fixer les terminaux aux emplacements convenus, installer la Box dans un local technique.

  • Vérifications de base :

    • vérifier que chaque terminal s’allume une fois branché,

    • informer l’IT que l’installation physique est terminée pour qu’ils puissent terminer la configuration.