Connector

De Tillor Connector is een lokale service die Tillor verbindt met fysieke apparaten in je park - zoals printers, toegangscontrollers en betaalterminals. De connector draait op een computer in je netwerk en communiceert via MQTT met de Tillor-cloud.

Hoe werkt de connector?

Tillor Cloud ←→ MQTT ←→ Connector (lokaal) ←→ Printers / Toegangscontrollers / Terminals

De connector fungeert als brug: Tillor stuurt opdrachten via het internet naar de connector, die deze vervolgens uitvoert op de aangesloten apparaten in je lokale netwerk.

Connector instellen

Vereisten

• Een computer of server in het lokale netwerk van het park (bijv. een Raspberry Pi of Windows-pc)
• Stabiele internetverbinding
• De Tillor Connector-software (download via Instellingen, bij de Connector-app)

Installatie

1. Ga naar Instellingen en open de Connector-app
2. Download de connector-software voor jouw besturingssysteem
3. Installeer de software op de lokale computer
4. Voer tijdens de installatie de connector-sleutel in (te vinden in Instellingen, bij de Connector-app)
5. De connector meldt zich automatisch aan bij Tillor

Verbinding controleren

Na installatie zie je in Instellingen bij de Connector-app de verbindingsstatus:

• Verbonden (groen) - de connector is actief en bereikbaar
• Verbroken (rood) - er is geen verbinding; controleer de lokale computer en internetverbinding

Docker deployment

Je kunt de connector ook draaien met Docker Compose. Dit is handig op een NAS (zoals Synology), een Linux-server of een Raspberry Pi.

Vereisten: Docker en Docker Compose

Eenvoudige setup (één connector)

Maak een map aan, plaats daarin een .env-bestand met je connector-gegevens en gebruik dit bestand:

# docker-compose.simple.yaml
version: "3.9"

services:
  connector:
    image: registry.tillor.dev/tillor-public/connector:latest
    container_name: tillor-connector
    restart: always
    volumes:
      - ./shared:/shared
    ports:
      - 3000:3000
      - 9234:9234
      - 9235:9235
    env_file:
      - .env
    security_opt:
      - no-new-privileges:true

Start met: docker compose -f docker-compose.simple.yaml up -d

Automatische updates met Watchtower

Om de connector automatisch bij te werken (elke 15 seconden controleren op nieuwe images):

# docker-compose.watchtower.yml
services:
  watchtower:
    image: nickfedor/watchtower:latest
    container_name: watchtower
    environment:
      - TZ=Europe/Brussels
      - WATCHTOWER_CLEANUP=true
      - WATCHTOWER_INCLUDE_STOPPED=true
      - WATCHTOWER_REVIVE_STOPPED=false
      - WATCHTOWER_ROLLING_RESTART=true
      - WATCHTOWER_POLL_INTERVAL=15
      - DOCKER_API_VERSION=1.43
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped

Start naast je connector: docker compose -f docker-compose.watchtower.yml up -d

Environment variabelen

Maak een .env-bestand in dezelfde map als je Compose-bestanden:

# Verplicht
TILLOR_ORG_ID=jouw-organisatie-id
TILLOR_API_URL=https://api.tillor.dev
TILLOR_API_TOKEN=jouw-connector-token

# Optioneel
HEALTH_CHECK_PORT=3000
ACCESS_CONTROL_SECRET=geheim-voor-toegangscontrollers
JSON_LOGGING=true

De connector-sleutel en API-URL vind je in Instellingen bij de Connector-app.

Gekoppelde apparaten

Via de connector kun je de volgende apparaten aansturen:

Printers

Zie de printer-documentatie voor het instellen en gebruiken van printers via de connector.

Toegangscontrollers

Slagbomen, poorten en andere toegangspunten worden gesynchroniseerd via de connector. Wijzigingen in toegangsregels in Tillor worden automatisch doorgezet naar de controllers.

Zie de controllers-documentatie voor meer informatie.

Betaalterminals

Betalingen via een gekoppelde betaalterminal verlopen ook via de connector. Tillor stuurt de betaalaanvraag naar de connector, die hem doorstuurt naar de terminal.

Problemen oplossen

Connector niet verbonden

1. Controleer of de lokale computer aanstaat
2. Controleer de internetverbinding op de lokale computer
3. Herstart de connector-service via het systeemvak of de taakbeheerder
4. Controleer of de connector-sleutel correct is ingesteld

Opdrachten worden niet uitgevoerd

1. Controleer de verbindingsstatus in Tillor
2. Bekijk de logbestanden van de connector op de lokale computer
3. Controleer of het betreffende apparaat bereikbaar is in het lokale netwerk