feat: implement door lock-out feature

app/api/index.py

@@ -4,6 +4,8 @@
 from .routes import accessLog, camera, card, user
 import os
 import multiprocessing
+from classes.RFID_Reader import door_controller
+import traceback
 
 os.environ["FLASK_RUN_FROM_CLI"] = "false"
 
@@ -65,3 +67,13 @@ def destroy_api():
 @app.route("/")
 def hello_world():
     return jsonify("Hello World"), 200
+
+@app.route("/lockout", methods=["POST"])
+def set_lockout():
+    try:
+        _, locked_out_state = door_controller.get_state()
+        door_controller.set_lockout(not locked_out_state)
+
+        return jsonify({"locked_out": str(not locked_out_state)}), 200
+    except Exception as e:
+        return jsonify({"error": str(e), "stack": traceback.format_exc()}), 400

app/aws/S3.py

@@ -6,6 +6,7 @@
     aws_access_key_id=os.getenv("AWS_ACCESS_KEY_ID"),
     aws_secret_access_key=os.getenv("AWS_SECRET_ACCESS_KEY"),
     aws_session_token=os.getenv("AWS_SESSION_TOKEN"),
+    region_name=os.getenv("AWS_REGION")
 )
 
 

app/classes/DoorControl.py

@@ -8,42 +8,60 @@
 
 sysfs_path = "/sys/kernel/led_toggle/led_toggle"
 
+
 class DoorState(Enum):
     LOCKED = "0" # Light Off [LOW]
     UNLOCKED = "1" # Light On [HIGH]
 
 class DoorController:
     def __init__(self):
+        self.locked_out = False
         if not path.exists(sysfs_path):
-            raise FileNotFoundError(f"Sysfs File Not Found. Expected Location: {sysfs_path}")
+            raise FileNotFoundError(
+                f"Sysfs File Not Found. Expected Location: {sysfs_path}"
+            )
 
     def get_state(self):
         with open(sysfs_path, "r") as file:
             state = file.read().strip()
-        return int(state)
-
+            is_active = state == "1"
+        return is_active, self.locked_out
+    def get_locked_out(self):
+        return self.locked_out
+
     def lock(self):
-        thread_logger.info("LOCKING DOOR")
+        if self.locked_out:
+            return False
+
         self._write_state(DoorState.LOCKED)
 
     def unlock(self, seconds: int):
-        thread_logger.info("UNLOCKING DOOR")
+        if self.locked_out:
+            return False
+
         self._write_state(DoorState.UNLOCKED)
         if seconds:
             sleep(seconds)
             self.lock()
 
     def toggle_lock(self):
-        if self.get_state() == DoorState.LOCKED:
+        state, locked_out = self.get_state()
+        if locked_out:
+            return False
+
+        if state:
             self.unlock()
         else:
             self.lock()
 
+    def set_lockout(self, shouldLockout: bool):
+        self.locked_out = shouldLockout
+
     def _write_state(self, state: DoorState):
         thread_logger.info(f"Attempting to write state {str(state.value)}")
 
         try:
             subprocess.run(['sudo', 'sh', '-c', f'echo {state.value} > {sysfs_path}'], check=True)
             thread_logger.info(f"Successfully wrote state {str(state.value)} to {sysfs_path}")
         except subprocess.CalledProcessError as e:
-            thread_logger.error(f"Failed to write state to sysfs: {e}")
+            thread_logger.error(f"Failed to write state to sysfs: {e}")

app/classes/RFID_Reader.py

@@ -82,7 +82,7 @@ def _start_reader(self):
                     f"*{'VALID' if is_valid else 'INVALID'} TAG READ* | ID: {id} | Text: '{text}'"
                 )
 
-                if is_valid:
+                if is_valid and not door_controller.get_locked_out():
                     door_controller.unlock(3)
                     self.logger.info("Attempting upload to bucket.")
                     bucket, file_object = self.camera.record_and_upload(

app/requirements.txt

@@ -1,5 +1,4 @@
 boto3
-python-dotenv
 picamera
 smbus2
 mfrc522

kernel/load_module.sh

@@ -1,5 +1,8 @@
 #!/bin/bash
 # Compile LKM
+echo "Cleaning up......"
+make clean
+
 echo "Compiling Linux Kernel Module (led_toggle)..."
 make
 

startup.sh

@@ -1,4 +1,9 @@
 #!/bin/bash
+if [ "$(id -u)" -ne 0 ]; then
+  echo "This script must executed as root (OR with the sudo command)"
+  exit 1
+fi
+
 echo "Setting up Linux Kernel Module..."
 cd kernel/
 sudo ./load_module.sh
@@ -7,4 +12,4 @@ cd ..
 
 echo "Setting up Python Application..."
 cd app
-./load_python.sh
+sudo ./load_python.sh