Anonymous

Door control system: Difference between revisions

From London Hackspace Wiki

Door control system (view source)

Revision as of 13:22, 1 January 2019

200 bytes removed ,  1 January 2019
update it a bit with more doorbots, and re-order paragraphs, the most important stuff for new users at the top.
m (→‎Cards that are known to work well: Added links and info)
(update it a bit with more doorbots, and re-order paragraphs, the most important stuff for new users at the top.)
Line 4: Line 4:
<blockquote>The major difference between a thing that might go wrong and a thing that cannot possibly go wrong is that when a thing that cannot possibly go wrong goes wrong it usually turns out to be impossible to get at or repair.</blockquote> ''- Douglas Adams, 'Mostly Harmless'''
<blockquote>The major difference between a thing that might go wrong and a thing that cannot possibly go wrong is that when a thing that cannot possibly go wrong goes wrong it usually turns out to be impossible to get at or repair.</blockquote> ''- Douglas Adams, 'Mostly Harmless'''


== Hardware ==
=== Front doorbot ===
The front doorbot at 388 High Road is based on a TI Connected Launchpad, and works alongside the building landlord's door entry system. During normal 'office hours', the maglock on the front door between the street and the shared lift lobby will be unlocked by the landlord's system. Only outside of normal hours will the door entry phone (only used by other tenants), and Hackspace's Front Doorbot will be necessary. Exit button is the landlord's door release button.
The Hackspace card reader is a small blue enclosure on the right hand glass. The reader loop is at the top of the enclosure near the logo.
Front doorbot is in a shared enclosure with the Ground floor doorbot, and has a battery backup. In the event of power failure, it will still try to open doors with cached credentials, though some functions will depend on working networking and working acserver.
The front doorbot sends out notifications using MQTT, to the topic base /door/gf-front-external. Any network device can listen in to these messages and set up their own bot/reporting infrastructure, etc.
=== Back Doorbot ===
The back doorbot is the same as the front - with two differences: there's no bell, and the relay is activated by setting the pin state to HIGH.
=== Radio Lab Doorbot ===
The radio room is fitted with the same as the workshop door setup. The reader is a standard reader with a doorbell button, but there is currently no software to pick up on the button and make a noise, should there be a need for it. In the same enclosure as the Electronics Lab doorbot. SLA 12V backup battery. Restricted access. You need to have an amateur radio licence and have a facility induction to gain access. Contact [https://wiki.london.hackspace.org.uk/view/User:Marrold marrold] or [https://wiki.london.hackspace.org.uk/view/User:Tgreer tgreer]. Fitted with a reader with a doorbell button; though that doesn't do much yet.
=== Biohackspace Doorbot ===
This is the same as above. You need to be a member of the [[Biohacking|Biohackers]] to get in. Not currently deployed.
=== 1st Floor Doorbot ===
Maglock, 1st floor entrance from lift lobby. SLA 12V backup battery. ACNode shield v1. Node id 2
Rebuilt to make it more like the ground floor / front doorbot, and to implement a doorbell button on the reader.
==Software==
The source code for the software on the nodes is on [https://github.com/londonhackspace/acnode-cl Github], the server is here [https://github.com/londonhackspace/acserver-django acserver-django]
All the logs go over the network to /var/log/network/ on [[adminstuff]], but it's not configured yet.
The access list is JSON [http://github.com/londonhackspace/hackspace-foundation-sites/blob/master/london.hackspace.org.uk/carddb.php file]. The acserver should download a new version of the carddb file every 5 minutes from [[Turing]] (the machine that runs the website), but it's not working yet.
Notification and status messages go via mqtt to the mqtt server. There's currrently a process that runs on a raspberry pi to take these notification messages and re-generate legacy UDP broadcast messages. Eventually, all the listener clients will subscribe to feeds on the mqtt server instead of listening to UDP broadcast messages.
The door opener broadcasts on the network whenever the door is opened by a member using their card <s>, or if the front doorbell is pushed</s>. The back door broadcasts on 50000, and the front uses 50002, so we can tell the difference between them in the various listeners.  This is a stop-gap until we add the door ID to the messages.
=== Doorbot listener scripts ===
There are [http://github.com/londonhackspace/Doorbot/tree/master/listeners listeners] on [[hamming]] that connect to '''robonaut''' to announce on IRC, and <s>flash the lights using '''Lighted'''</s>. By default, this will include your full real name. If you wish to change this behaviour, you can set up a nickname [https://london.hackspace.org.uk/members/cards.php in the cards section] of the member area.
<s>[[hamming]] also runs listeners for the scrolling led board and the audio announcements.</s>
The announcement listener uses the [http://en.wikipedia.org/wiki/GLaDOS GLaDOS] voice. You can generate and use your own file as a greeting. Update your 'Glados file' with a URL of an audio file, and it will play a maximum 12 seconds of the sample when you enter the 1st floor. File formats supported include mp3, m4a, wav, and non-DRM-protected aac. It will not play 'audio' from a YouTube URL.
The Announcement listener runs on [[Hamming]], announcing the 1st floor door, and on [[Holonyak]], announcing the back door, Workshops door, and cage door.
The code that runs the [[Project:BandwidthMeter|bandwidth meter]] on [[adminstuff]] also listens for doorbell and member entry messages.


== Adding a card==
== Adding a card==
If you're a new or pending member and looking to add a card to enter the space on your own, be sure you have an [https://simple.wikipedia.org/wiki/RFID RFID or Contactless Smart] Card that operates on the 13.56MHz frequency.  You likely have several in your wallet and may not even know it.  Note that our doorbot RFID readers do NOT read the older 125kHz frequency RFID cards frequently used for older 1990s/early 2000s era office/housing access, so not every card works in our system. You are likely in luck and have at least one 13.56MHz card already: the [https://en.wikipedia.org/wiki/Oyster_card#Technology Transport for London Oyster card] is by far the most popular card used by LHS members, but several members have also successfully used various hotel RFID keycards, contactless credit and debit cards, and some compatible government ID cards as well.
If you're a new or pending member and looking to add a card to enter the space on your own, be sure you have an [https://simple.wikipedia.org/wiki/RFID RFID or Contactless Smart] Card that operates on the 13.56MHz frequency.  You likely have several in your wallet and may not even know it.  Note that our doorbot RFID readers do NOT read the older 125kHz frequency RFID cards frequently used for older 1990s/early 2000s era office/housing access, so not every card works in our system. You are likely in luck and have at least one 13.56MHz card already: the [https://en.wikipedia.org/wiki/Oyster_card#Technology Transport for London Oyster card] is by far the most popular card used by LHS members, but several members have also successfully used various hotel RFID keycards, contactless credit and debit cards, some RFID wristbands, and some compatible government ID cards as well.


=== Cards that are known to work well ===
=== Cards that are known to work well ===
Line 103: Line 52:


Many early members enjoyed doorbot audio greetings in the style of [https://en.wikipedia.org/wiki/GLaDOS GLaDOS] - an artificial-intelligence sounding voice used in the Portal series of video games and in the movie Pacific Rim. Want to fit in with the 'classical' spirit of the Hackspace? Generate your own GLaDOS voice file on [http://glados.biringa.com/ this site here].
Many early members enjoyed doorbot audio greetings in the style of [https://en.wikipedia.org/wiki/GLaDOS GLaDOS] - an artificial-intelligence sounding voice used in the Portal series of video games and in the movie Pacific Rim. Want to fit in with the 'classical' spirit of the Hackspace? Generate your own GLaDOS voice file on [http://glados.biringa.com/ this site here].
To avoid annoying people in the hackspace with overly long introduction sounds, the playback is limited to the first 17 seconds.


=== Old GLaDOS Voice Generation Guide ===
=== Old GLaDOS Voice Generation Guide ===
Line 117: Line 68:
*Up the pitch by dragging upwards by 160 or so.
*Up the pitch by dragging upwards by 160 or so.
*Save
*Save
== Hardware ==
=== Front doorbot ===
The front doorbot at 388 High Road is based on a TI Connected Launchpad, and works alongside the building landlord's door entry system. During normal 'office hours', the maglock on the front door between the street and the shared lift lobby will be unlocked by the landlord's system. Only outside of normal hours will the door entry phone (only used by other tenants), and Hackspace's Front Doorbot will be necessary. Exit button is the landlord's door release button.
The Hackspace card reader is a small blue enclosure on the right hand glass. The reader loop is at the top of the enclosure near the logo.
Front doorbot is in a shared enclosure with the Ground floor doorbot, and has a battery backup. In the event of power failure, it will still try to open doors with cached credentials, though some functions will depend on working networking and working acserver.
The front doorbot sends out notifications using MQTT, to the topic base /door/gf-front-external. Any network device can listen in to these messages and set up their own bot/reporting infrastructure, etc.
=== Back Doorbot ===
The back doorbot is the same as the front - with two differences: there's no bell, and the relay is activated by setting the pin state to HIGH.
=== Radio Lab Doorbot ===
The radio room is fitted with the same as the workshop door setup. The reader is a standard reader with a doorbell button, but there is currently no software to pick up on the button and make a noise, should there be a need for it. In the same enclosure as the Electronics Lab doorbot. SLA 12V backup battery. Restricted access. You need to have an amateur radio licence and have a facility induction to gain access. Contact [https://wiki.london.hackspace.org.uk/view/User:Marrold marrold] or [https://wiki.london.hackspace.org.uk/view/User:Tgreer tgreer]. Fitted with a reader with a doorbell button; though that doesn't do much yet.
=== Biohackspace Doorbot ===
This is the same as above. You need to be a member of the [[Biohacking|Biohackers]] to get in. Not currently deployed.
=== 1st Floor Doorbot ===
Dual Maglock, 1st floor entrance from lift lobby. SLA 12V backup battery. ACNode shield v1. Node id 2
Rebuilt to make it more like the ground floor / front doorbot, and to implement a doorbell button on the reader.
=== Back cage gate doorbot ===
Maglock on cage gate. Exit button in shrouded case. ACNode/Doorbot board. Doorbell button fitted in IP55 reader enclosure.
==Software==
The source code for the software on the nodes is on [https://github.com/londonhackspace/acnode-cl Github], the server is here [https://github.com/londonhackspace/acserver-django acserver-django]
All the logs go over the network to /var/log/network/ on [[adminstuff]], but it's not configured yet.
The access list is JSON [http://github.com/londonhackspace/hackspace-foundation-sites/blob/master/london.hackspace.org.uk/carddb.php file].
Notification and status messages go via mqtt to the mqtt server. All the listener clients will subscribe to feeds on the mqtt server, and action notifications accordingly.
The door opener sends an MQTT message whenever the door is opened by a member using their card <s>, or if the front doorbell is pushed</s>.
=== Doorbot listener scripts ===
There are [http://github.com/londonhackspace/Doorbot/tree/master/listeners listeners] on [[hamming]] that connect to '''robonaut''' to announce on IRC, and <s>flash the lights using '''Lighted'''</s>. By default, this will include your full real name. If you wish to change this behaviour, you can set up a nickname [https://london.hackspace.org.uk/members/cards.php in the cards section] of the member area.
<s>[[hamming]] also runs listeners for the scrolling led board and the audio announcements.</s>
The announcement listener uses the [http://en.wikipedia.org/wiki/GLaDOS GLaDOS] voice. You can generate and use your own file as a greeting. Update your 'Glados file' with a URL of an audio file, and it will play a maximum 12 seconds of the sample when you enter the 1st floor. File formats supported include mp3, m4a, wav, and non-DRM-protected aac. It will not play 'audio' from a YouTube URL.
The Announcement listener runs on [[Hamming]], announcing the 1st floor door, and on [[Holonyak]], announcing the back door, Workshops door, and cage door.
The code that runs the [[Project:BandwidthMeter|bandwidth meter]] on [[adminstuff]] also listens for doorbell and member entry messages.


== Managing Doorbots ==
== Managing Doorbots ==
Simon Hewison
538

edits

Retrieved from ‘https://wiki.london.hackspace.org.uk/view/Special:MobileDiff/52349’