TOEGANGSCONTROLE KNLTB LEDENPASSEN

Transcriptie

1 TOEGANGSCONTROLE KNLTB LEDENPASSEN H A N D L E I D I N G Januari 2017 Alle rechten betreffende de EUREKA software zijn wettelijk voorbehouden aan Vidya Consultancy - Arnhem

2 Inhoudsopgave Auteursrecht...2 De Hardware...3 De microcomputer...3 Aansluitingen microcontroller & relaisbord...3 Aansluitingen microcontroller & LED indicatoren...4 Shutdown drukknop (Optioneel)...4 De Software...6 De bestanden en hun functie...6 Internetaansluiting geadviseerd...7 Toegangscontrole op afstand beheren...7 IP-adres microcontroller...7 Putty...7 Linux prompt...9 uitlezen IP-adres...9 systeem herstarten...9 systeem afsluiten...9 Filezilla...9 Bijlage(n) Bedradingsschema Softwareversies Patches en updates Onderdelen

3 Auteursrecht Het is echter een misverstand dat open source software niet auteursrechtelijk beschermd zou zijn, of dat de maker ervan zijn auteursrechten heeft prijsgegeven. In tegendeel: het auteursrecht geeft de maker juist de mogelijkheid om een goed werkend open source systeem op te zetten voor zijn software! Software wordt in Europa met name beschermd door het auteursrecht. Bij het ontwikkelen van maatwerksoftware in opdracht van de afnemer, kan de vraag rijzen wie de auteursrechten verkrijgt op deze software. Het antwoord daarop is eenvoudig: de auteursrechten komen in beginsel toe aan de maker van de software. Het feit dat de afnemer gedetailleerde specificaties verstrekt en volledig voor de ontwikkeling betaalt, doet daar niet aan af. Als de afnemer zelf eigenaar wil worden van de auteursrechten op die software, dan moeten die rechten schriftelijk worden overgedragen. Disclaimer De schrijver/bouwer van de EUREKA toegangscontrole software kan op geen enkele wijze verantwoordelijk worden gesteld indien de geleverde omgeving (hard- en opensource software) door derden aangepast of veranderd is. De schrijver/bouwer beroept zich op het auteursrecht dat voor het maatwerk, te noemen EURKA Toegangscontrole software geldt. De software is as is functioneel opgeleverd. Alle rechten betreffende de EUREKA software zijn wettelijk voorbehouden aan Vidya Consultancy - Arnhem

4 De Hardware De microcomputer De microcomputer bevat een 900 MHz quad-core ARM Cortex-A7 CPU en 1 GB RAM. Het besturingssysteem is gebaseerd op Debian (Linux). Het systeembord is voorzien van 40 headerpinnen. Deze bevatten o.a. de voedingen (3,3V & 5V) en de I/O-poorten, ook wel de GPIO (General Purpose Input Output) poorten genoemd. Daarnaast zijn er vier USB-connectoren, een netwerkaansluiting, een HDMI-connectie en een micro-b USB die voor dit project te gebruiken zijn. Aansluitingen microcontroller & relaisbord Het microcontrollerbord is verbonden met een relaisbord waarop twee relais gemonteerd zijn. Ofschoon de relais in staat zijn een spanning van 220V / 10A te schakelen wordt aangeraden de relais als stuurrelais te gebruiken en de gewenste apparatuur via een (galvanisch) gescheiden lastrelais te schakelen. Hieronder is het aansluitschema van het relaisbord weergegeven. Je kunt ook de gekleurde draden in de afbeeldingen volgen. Microcomputer headerpin Functie Relaisbord 4 +5V VCC (+5V) 6 Ground (GND) Ground (GND) 11 GPIO17 IN1 (relais 1 - geldige pas) 13 GPIO27 IN2 (Relais 2 - ongeldige pas) 3.

5 Figuur: aansluitingen microcontroller & relaisbord Aansluitingen microcontroller & LED indicatoren De LED indicatoren geven de statussen power aan, programma in leesstand en de validatie van de ingelezen pas, te weten: geldig of ongeldig. Hieronder is het aansluitschema van de LED indicatoren weergegeven. Microcomputer headerpin Functie LED indicator 2 +5V Power (rood) 34 Ground (GND) Ground (GND) 36 GPIO16 Geldige pas (bi-color groen) 38 GPIO20 Programma status (oranje) 40 GPIO21 Ongeldige pas (bi-color rood) Figuur: aansluitingen microcontroller & LED indicatoren Shutdown drukknop (Optioneel) Om beschadiging van de software te voorkomen dient de software van de toegangscontrole op de juiste wijze gestopt te worden. Dit kan o.a. door met de pc op afstand m.b.v. de terminalfunctie de nodige commando s in te geven. Dit vraagt om programmeerervaring in Linux. 4.

6 Ook is het mogelijk een drukknop met de headerpinnen 30 en 32 te verbinden die na het indrukken de Linux commando s uitvoert die nodig zijn om de toegangscontrole af te stoppen. Vanwege de kwetsbaarheid is de drukknop standaard niet in/op de kast gemonteerd. De drukknop is te bestellen of zelf te maken. Na het kort indrukken van de knop heeft de microcomputer ongeveer 30 seconden nodig om volledig te stoppen. Daarna kan de voedingssteker (220V) veilig uit het contact worden gehaald. Microcomputer headerpin Functie Shutdown drukknop 30 Ground (GND) Contact 1 van de drukknop 32 GPIO12 Contact 2 van de drukknop Figuur: de shutdown drukknop 5.

7 De Software Voor het volgende hoofdstuk wordt ervaring met het Linux bestandssysteem gevraagd. De bestanden en hun functie In de mappenstructuur van de microcomputer staat de map my_eureka. In deze map staan de volgende bestanden. counter.log eureka.py swipes.log ver_nr.txt - Dit is het bestand dat het aantal keer dat een kaart gelezen wordt bijhoudt. Het wordt aangeraden na het initieel installeren van de toegangscontrole het bestand op nul (0) te zetten. Het bestand is in een standaard teksteditor te bewerken. - Dit is het hoofdprogramma EUREKA BASIC+, Toegangscontrole KNLTB Ledenpas. Op moment van schrijven (maart 2016) is de hoogste versie 5a (HD). - Dit is het bestand waarin alle kaarten geregistreerd worden. De volgende informatie wordt hierin vastgelegd: Wanneer het systeem aangezet is; Op welke datum en tijd de pas gelezen is; Het bondsnummer bij een geldige KNLTB pas; Het bondsnummer bij een verlopen KNLTB pas; Het nummer van de tijdelijke KNLTB Ledenpas; Als het geen KNLTB pas betreft. - Dit bestand bevat het verenigingsnummer van de KNLTB waarvan de ledenpassen gelezen dienen te worden. Dit nummer kan: handmatig aangepast worden. Gebruik hiervoor een standaard tekst editor; of aangemaakt worden m.b.v. het programma ver_nr_bestand_maken. ver_nr_bestand_maken - Dit programma maakt het bestand ver_nt.txt aan. Zonder dit bestand start het hoofdprogramma niet op, er zal een melding volgen: IOError: [Errno 2] No such file or directory: /home/pi/my_eureka/ver_nr.txt. Na het opstarten van het programma wordt om een valide KNLTB ledenpas gevraagd. Het programma leest het verenigingsnummer van de pas en slaat deze op in het bestand ver_nr.txt. 6.

8 Internetaansluiting geadviseerd Ofschoon de microcomputer voorzien is van een RTC (real time clock) wordt voor de exacte datum/tijd registratie en de ingestelde vervaldatum (geldigheidsmoment oude ledenpas) geadviseerd de microcomputer van een internetaansluiting te voorzien. De verbinding is eveneens nodig om de unit op afstand te beheren. Toegangscontrole op afstand beheren Om de toegangscontrole op afstand met een pc te kunnen beheren is een internetaansluiting nodig die beide apparaten lokaal via een router of switch verbindt. Op de pc (Windows) zijn de volgende programma s nodig: Een terminal programma, ook wel SSH-client zoals Putty. Bestandsuitwisselingsprogramma, ook wel FTP-client die een SSH verbinding tot stand kan brengen, zoals Filezilla. IP-adres microcontroller Om op afstand verbinding met de toegangscontrole te krijgen is het IP-adres van de microcomputer nodig. Deze kan in de router bij de toegewezen IP-adressen door de DHCP-server worden opgezocht. Ook is het mogelijk een toetsenbord en een HDMI-beeldscherm direct op de microcomputer aan te sluiten en middels het commando ifconfig achter de Linux prompt het IP-adres van de microcontroller te achterhalen. Dit laatste vergt enige kennis van de Linux commando- en bestandsstructuur. Putty PuTTY is een gratis telnet- en SSH-client. Het is software waarmee je een verbinding kan maken met de microcomputer. De verbinding tussen de terminal en de microcomputer verloopt via het SSHprotocol, dat als veiligere opvolger wordt gezien voor het verouderde telnetprotocol. PuTTY heeft geen installatieprogramma en kan overal op de harde schijf neergezet worden. De software is beschikbaar voor o.a. het Windows besturingssysteem. Putty kan als onderstaande afbeelding ingesteld worden. Het enige dat overeen moet komen is het IP-adres van de microcomputer, in dit voorbeeld Figuur: Putty configuratiescherm 7.

9 Het spreekt voor zich dat er alleen verbinding gemaakt kan worden als de microcomputer opgestart is. Figuur: Putty Security Alert Bij het maken van de verbinding verschijnt de eerste keer bovenstaand melding. Deze mag genegeerd worden. Een volgende keer zal deze (bij hetzelfde IP-adres) niet opnieuw verschijnen. Vervolgens dient er ingelogd te worden. Het wachtwoord hiervoor is bij de bouwer op te vragen. Figuur: Putty terminal - Login Als er verbinding gemaakt is start de terminal op met het EUREKA scherm van de toegangscontrole. Figuur: Putty terminal EUREKA toegangscontrole Indien een KNLTB-pas ingelezen wordt zie je de verwerking van de informatie in het terminalscherm. 8.

10 Linux prompt Om het EUREKA programma te stoppen geef je exit in. Na het ingeven hiervan staat de cursor achter de Linux prompt. Hier kun je o.a. de volgende commando s ingeven: uitlezen IP-adres = ifconfig systeem herstarten = sudo reboot systeem afsluiten = sudo shutdown h now Note van de schrijver Als je geen ervaring in Linux bestandbeheer of de standaard microcontroller omgeving hebt wordt afgeraden beheer op afstand te doen. Filezilla FileZilla is een FTP-client waarmee je op eenvoudige wijze bestanden kunt uploaden en downloaden van je PC naar de folders van de SD-kaart in de microcontroller met behulp van het File Transfer Protocol (FTP). FileZilla is snel en simpel in het gebruik en heeft een overzichtelijke interface waarop je in een oogopslag alles kunt overzien. Filezilla kan als onderstaande afbeelding ingesteld worden. Het enige dat overeen moet komen is het IP-adres van de microcomputer, in dit voorbeeld Ook hier verschijnt bij het maken van de verbinding verschijnt de eerste keer een melding. Deze mag genegeerd worden. Een volgende keer zal (bij hetzelfde IP-adres) deze niet opnieuw verschijnen. 9.

11 Bijlage(n) Bedradingsschema Figuur: Bedradingsschema Toegangscontrole 10.

12 Softwareversies De volgende versies van EUREKA Toegangscontrole Software zijn beschikbaar. Software versie Pastype Validatie item/data Releasedatum Eureka 3a - Basic KNLTB Ledenpas KNLTB pas December 2015 Jaartal Verenigingsnummer Eureka 4a - Basic KNLTB Ledenpas KNLTB pas Januari 2016 Jaartal Verenigingsnummer Eureka 5a Basic+ KNLTB Ledenpas, KNLTB Tijdelijke ledenpas KNLTB pas Jaartal Verenigingsnummer KNLTB Tijdelijke ledenpas (TLP) Maart 2016 Eureka 10f - Premium Eureka 10k4 - Premium Eureka RFID 10 KNLTB Ledenpas, KNLTB Tijdelijke ledenpas KNLTB Ledenpas, KNLTB Tijdelijke ledenpas RFID pas (13.56MHz) Volgnummer TLP KNLTB pas Jaartal Verenigingsnummer Bondsnummer KNLTB Tijdelijke ledenpas (TLP) Volgnummer TLP Autorisatielijst KNLTB pas Jaartal Verenigingsnummer Bondsnummer KNLTB Tijdelijke ledenpas (TLP) Volgnummer TLP Autorisatielijst RFID pas (13.56MHz) Autorisatielijst Maart 2016 Augustus 2016 Januari 2017 Patches en updates Known errors Te grote EMP / EMK vonkslag bij relais Voeding bevat kleine rimpel (<5%) EMP / EMK invloeden op installatie Patches & updates Condensator (470nF) over de contacten van de relais geplaatst. Stuur- & lastrelais (eigen voeding) combinatie ingesteld. Buffercondensator (2200uF/16V) over uitgang van 5V voeding geplaatst. Systeem in metalen kast (host) geplaatst. Netfilter opgenomen voor voeding. Lastrelais in aparte metalen kast geplaatst. Verbinding tussen stuur- en lastrelais is afgeschermd (80% shield). Shield via RC-set (1 MΩ / 4,7nF) op kastmassa aangesloten. 11.

13 Onderdelen Vanwege het open karakter van de toepassing wordt de gebruiker in de gelegenheid gesteld onderdelen zelf bij de verschillende leveranciers te kunnen bestellen. Onderdeel Artikel nr. Leverancier (voorkeur) Eureka Toegangscontrole Software (KNLTB Ledenpas) Zie overzicht vidyaconsultancy.nl softwareversies Microcontroller Raspberry Pi 2 model B, Quad-core 900MHz sossolutions.nl ARM Cortex A7-processor Jumper wires t.b.v. headerverbindingen sossolutions.nl USB Universal Magnetic Stripe Credit/Debit Card Bidirectional dx.com Swipe Reader 5V 2A Regulated Switching Power Supply (110~220V) dx.com Keyes - 2 Channel 5V High Level Trigger Relay dx.com Hammond Electronics - Universele behuizing conrad.nl 12.