Differences

This shows you the differences between two versions of the page.

--- door_access_controllers [2019-02-24 00:20] – created tim
+++ door_access_controllers [2019-04-29 17:50] – tim
@@ Line 2: / Line 2: @@
 ===== Overview =====
+The Hacklab door controllers are based on an ESP8266 wifi microcontroller and a PN532 NFC reader module. One controller is installed for each door, and each controller can operate a single 12V channel for an electric door release or magnetic lock. Inputs can be connected for door open/closed reed switch, exit request and local lock/unlock "snib" function.
 ===== PCB =====
@@ Line 31: / Line 33: @@
 Errata: a generic through-hole flyback diode should be fitted between GND and 12V_OUT, on the underside of the screw terminal.
+==== Lessons Learned ====
+Future PCB revisions are likely to be based on a Wemos D1 Mini module to reduce component count and allow easier debugging. The onboard DC-DC converter will be replaced with an off-the-shelf "LDO replacement" DC-DC converter module.
 ===== Controller Unit =====
@@ Line 77: / Line 82: @@
   * [[http://uk.farnell.com/multicomp/mcabt-456-rc/audio-element-piezo-9-5khz-12mm/dp/2433032|12mm piezo disc]]
   * [[http://www.elechouse.com/elechouse/index.php?main_page=product_info&cPath=90_93&products_id=2242|PN532 module]]
-  * Cat 5 or other cable with at least 7 cores
+  * Alarm cable with at least 7 cores (Cat5 can be used but is not recommended)
 The reader enclosure is formed from three layers of 3mm black acrylic. The layers should be joined with cyanoacrylate adhesive.
@@ Line 85: / Line 90: @@
 Bend and cut the LED leads to the correct shape and length. Solder the LED and cable before gluing the module into the enclosure.
-Cat 5 cable colours:
+Cable colours in Hacklab installations:
-| blue | GND |
+^ Pin ^ G1/G2/G8 ^ G11 (and photos) ^
-| green | VCC |
+| GND | blue | blue |
-| brown | RST |
+| VCC | green | orange |
-| orange | SDA |
+| RST | brown | brown |
-| white-green | SCL |
+| SDA | orange | green |
-| white-brown | LED +ve |
+| SCL | white-green | white-green |
-| white-blue | Piezo |
+| LED +ve | white-brown | white-brown |
-| white-orange | not used |
+| Piezo | white-blue | white-blue |
-Note that on the G11 door and **in the photos**, orange=VCC and green=SDA.
+The LED should be connected between LED and GND, with a 120R series resistor. To avoid damaging the LED, use hot-melt glue to secure it in place (not cyanoacrylate).
-The LED should be connected between white-brown and GND (blue), with a 120R series resistor. To avoid damaging the LED, use hot-melt glue to secure it in place (not cyanoacrylate).
+The piezo should be connected between PIEZO and VCC (green). The piezo may be secured with cyanoacrylate or hot-melt glue, but try to give the disc some freedom of movement or the sound output may be reduced.
-The piezo should be connected between white-blue and VCC (green). The piezo may be secured with cyanoacrylate or hot-melt glue, but try to give the disc some freedom of movement or the sound output may be reduced.
 Test the reader and controller together before securing the reader to the wall with double-sided adhesive foam tape.
 ===== Software =====
+Two versions of firmware and server back-end are currently in operation.
+Common features:
+  * Ability to read any 13.54MHz ISO-14443 Type A token including MIFARE Classic/UltraLight and NFC tags.
+  * Network-based checking of tokens with fallback to syncronised on-board database.
+  * Detection of door open/closed state via reed switch.
+  * Exit request handling, either opening for a set time or opening as long as in input is held (for our capacitive-touch door handle).
+  * "Snib" feature to hold the door unlocked for an extended period, with automatic timeout.
+  * Remote enable/disable of exit request for additional security.
+  * Remote enable/disable/renewal/timeout of snib state to allow presence detection to trigger timeout of snib state.
+  * Input DC voltage measurement, using low voltage as an indication of battery backup during a power outage. Snib feature can be disabled during power outage to extend battery life (for fail-secure locks).
+Legacy/Stable: The older version uses UDP networking and requires a dedicated wifi network for security. All of the Hacklab doors use this version at the time of writing.
+New: A new firmware and back-end use TLS-enabled TCP networking, so do not require a special wifi network. The modern codebase is better-written, more flexible and features OTA upgrades.