From 6c958b279486207377ef59ccb60cd105dc68f654 Mon Sep 17 00:00:00 2001 From: "OPC (de)" Date: Mon, 24 Nov 2025 21:32:49 -0800 Subject: [PATCH 1/3] Initial commit of magstrike stuff --- docs/magstrike.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docs/magstrike.md diff --git a/docs/magstrike.md b/docs/magstrike.md new file mode 100644 index 0000000..ba12e1d --- /dev/null +++ b/docs/magstrike.md @@ -0,0 +1,25 @@ +--- +title: Magstrike + +# Overview + +The space has two main computer-controlled doors in the kitchen: an outer one and an inner one. This is so delivery people can deliver items into the kitchen, without being able to access the space. This page is about the inner door. + +The inner door consists of: + +Visionis VIS-3200 keypad, controller, and exit button kit. [Vendor product page](https://www.visionistech.com/en/product/wireless-access-control-kit-vis-3200/) +Visionis VIS-ML300-LED magnetic strike. [Vendor product page](https://www.visionistech.com/en/product/indoor-electromagnetic-lock-vis-ml300led/) +WeMos D1-Mini microcontroller. [Vendor product page](https://www.wemos.cc/en/latest/d1/d1_mini.html) +ESPHome [Home page](https://esphome.io/) +CW-025 12V relay modules [Vendor product page](https://www.amazon.com/dp/B0BHLDW9G5) + +# Theory of Operation + +Opening the door: +The VIS-3200 controller turns the magstrike on and off. It can be commanded to do so wirelessly, using the 433 MHz keypad in the kitchen or the wireless exit button in the main space. It also has a wired connector which will open the door when the pins are shorted. The microcontroller does this when it receives an open command from Home Assistant. + +Sensing the door status: +The VIS-3200 controller is not involved. There's a magnet on the door, and a magnetic sensor on the magstrike. The magnetic sensor is a simple normally-open switch. This is connected to a GPIO on the microcontroller, which exposes the state of the switch to Home Assistant to tell whether the door is open or not. + +# Circuit Diagram + From eed7ddf05610ebe4bf6502cb6b792e7f96fb9243 Mon Sep 17 00:00:00 2001 From: "OPC (de)" Date: Wed, 26 Nov 2025 16:42:48 -0800 Subject: [PATCH 2/3] Added diagram --- docs/magstrike.md | 32 ++++++++++++++++++++++++++++---- 1 file changed, 28 insertions(+), 4 deletions(-) diff --git a/docs/magstrike.md b/docs/magstrike.md index ba12e1d..b341403 100644 --- a/docs/magstrike.md +++ b/docs/magstrike.md @@ -1,9 +1,10 @@ + --- -title: Magstrike +--- # Overview -The space has two main computer-controlled doors in the kitchen: an outer one and an inner one. This is so delivery people can deliver items into the kitchen, without being able to access the space. This page is about the inner door. +The space has two computer-controlled doors in the kitchen: an outer one and an inner one. This is so deliveries can access the kitchen, but not the whole space. This page is about the inner door. The inner door consists of: @@ -16,10 +17,33 @@ CW-025 12V relay modules [Vendor product page](https://www.amazon.com/dp/B0BHLDW # Theory of Operation Opening the door: -The VIS-3200 controller turns the magstrike on and off. It can be commanded to do so wirelessly, using the 433 MHz keypad in the kitchen or the wireless exit button in the main space. It also has a wired connector which will open the door when the pins are shorted. The microcontroller does this when it receives an open command from Home Assistant. +The VIS-3200 controller turns the magstrike on and off. It can be commanded to do so wirelessly, using the 433 MHz keypad in the kitchen or the wireless exit button in the main space. It also has a wired connector which will open the door when the pins are shorted. Home Assistant can command the microcontroller to do this, through a relay to protect the MCU's GPIOs. The most common way Home Assistant will do this is when the exterior door is opened by the Fanvil keypad, because then HA will run automation to open the interior door (after a brief delay). Sensing the door status: -The VIS-3200 controller is not involved. There's a magnet on the door, and a magnetic sensor on the magstrike. The magnetic sensor is a simple normally-open switch. This is connected to a GPIO on the microcontroller, which exposes the state of the switch to Home Assistant to tell whether the door is open or not. +The microcontroller senses the door open/closed status. The VIS-3200 controller is not involved, even though it has an input for it and supports forced open alarms. There's a magnet on the door, and a magnetic sensor on the magstrike. The magnetic sensor is a simple normally-open switch. This is connected to a GPIO on the microcontroller, which exposes the state of the switch to Home Assistant to tell whether the door is open or not. # Circuit Diagram +``` + D1 Mini ++-------+ +| | +| D4 O----------(blue)----------O (relay input) O---> +12V +| | [ RELAY ] VIS-3200 +| | O (relay output) O +------------+ +| D3 O----(green)----+ | +----(black)------O Open +12V O-----(red)-----> +12V +| | | +----------(green)-----------------O Gnd Gnd O-----(black)---> ground ++-------+ | | | + [Door sensor] + -------------(red)-----O Lock+ | + | | +-(black)-O Ground | + v [ MAGSTRIKE ] | +------------+ + ground +-----------+ | + v v + ground +``` + +# Users + +The VIS-3200 has been programmed with two unlimited-use users, #1 and #69, which have PIN codes based on non-random numbers found in popular culture. There are also three one-time use codes for users 020, 021, and 022 (the leading zero indicates a limited-use "guest" user), which have been distributed to the board for use in circumstances where they may need to remotely grant someone access to the space on a one-time use basis. + +The VIS-3200 does have a built-in 125 kHz prox reader, but it is not used in our deployment. From f59be353debe122f1c47a96259fd462422d0b920 Mon Sep 17 00:00:00 2001 From: "OPC (de)" Date: Wed, 26 Nov 2025 17:13:21 -0800 Subject: [PATCH 3/3] Typos --- docs/magstrike.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/magstrike.md b/docs/magstrike.md index b341403..ef89aac 100644 --- a/docs/magstrike.md +++ b/docs/magstrike.md @@ -8,11 +8,11 @@ The space has two computer-controlled doors in the kitchen: an outer one and an The inner door consists of: -Visionis VIS-3200 keypad, controller, and exit button kit. [Vendor product page](https://www.visionistech.com/en/product/wireless-access-control-kit-vis-3200/) -Visionis VIS-ML300-LED magnetic strike. [Vendor product page](https://www.visionistech.com/en/product/indoor-electromagnetic-lock-vis-ml300led/) -WeMos D1-Mini microcontroller. [Vendor product page](https://www.wemos.cc/en/latest/d1/d1_mini.html) -ESPHome [Home page](https://esphome.io/) -CW-025 12V relay modules [Vendor product page](https://www.amazon.com/dp/B0BHLDW9G5) +* Visionis VIS-3200 keypad, controller, and exit button kit. [Vendor product page](https://www.visionistech.com/en/product/wireless-access-control-kit-vis-3200/) +* Visionis VIS-ML300-LED magnetic strike. [Vendor product page](https://www.visionistech.com/en/product/indoor-electromagnetic-lock-vis-ml300led/) +* WeMos D1-Mini microcontroller. [Vendor product page](https://www.wemos.cc/en/latest/d1/d1_mini.html) +* ESPHome [Home page](https://esphome.io/) +* CW-025 12V relay modules [Vendor product page](https://www.amazon.com/dp/B0BHLDW9G5) # Theory of Operation @@ -31,8 +31,8 @@ The microcontroller senses the door open/closed status. The VIS-3200 controller | D4 O----------(blue)----------O (relay input) O---> +12V | | [ RELAY ] VIS-3200 | | O (relay output) O +------------+ -| D3 O----(green)----+ | +----(black)------O Open +12V O-----(red)-----> +12V -| | | +----------(green)-----------------O Gnd Gnd O-----(black)---> ground +| D3 O----(green)----+ | +----(green)------O Open +12V O-----(red)-----> +12V +| | | +----------(black)-----------------O Gnd Gnd O-----(black)---> ground +-------+ | | | [Door sensor] + -------------(red)-----O Lock+ | | | +-(black)-O Ground |