CUH405CMD2526MARJUL_Team4

Welcome to the Smart Library IoT Prototype repository! This project is an industrial-grade, highly scalable IoT solution designed for university library seat management, developed by Team 4 for the CUH405 module.

🌟 Core Features 🧠 Ternary State Machine (Cloud Brain): Overcomes the limitations of binary hardware sensors (1/0). It introduces a 45-minute "Grace Period" for temporary leaves (e.g., restroom breaks) before fully releasing the seat.

🔋 Real-time Battery Monitoring: Addresses hardware deployment challenges by integrating a dynamic battery field in the payload, automatically triggering a [SYSTEM ALERT] when power drops below 20%.

⚡ Ultra-lightweight Payload: Edge devices transmit highly compressed JSON payloads (< 70 bytes), minimizing network overhead.

🔌 Decoupled Architecture: Utilizes the MQTT protocol and a public IoT broker (broker.hivemq.com), ensuring high availability and seamless future scalability (e.g., extending to a Cafeteria ordering system).

🛠️ Tech Stack Language: Python 3.9

Protocol: MQTT (via paho-mqtt v1.6.1)

Data Format: JSON

Middleware: HiveMQ Public Broker

📂 Project Structure publisher.py: Edge device simulator. Represents the ESP32 + PIR sensors under the library seats, generating occupancy status and battery levels.

subscriber.py: Cloud backend brain. Intercepts MQTT packets, processes the Ternary State Machine logic, and handles system alerts.

🚀 Quick Start Install Dependencies: Please ensure you install the classic version of the Paho-MQTT library to maintain compatibility with the legacy API. pip install paho-mqtt==1.6.1

Start the Cloud Brain: Run the subscriber first to keep it actively listening to the topic CUC/Library/Floor_2/#. python subscriber.py

Simulate Edge Data: Run the publisher in a separate terminal to transmit the mock JSON payload. python publisher.py

👥 Team Members Peishen: Project Manager & Version Control

Guangci: System Architect (Logical & Physical Design)

Bohan: Edge Hardware Developer (Payload Design)

Yihan: Cloud Backend Lead & CTO (State Machine Logic)

📚 智慧图书馆 IoT 原型系统 - 第四组欢迎来到智慧图书馆 IoT 原型仓库！本项目是由 Team 4 为 CUH405 课程开发的一个工业级、高扩展性的大学图书馆座位管理物联网解决方案。

🌟 核心特性 🧠 三元状态机 (云端大脑): 突破了底层硬件传感器非黑即白 (1/0) 的二元限制。系统引入了 45 分钟的 “暂离保护 (Grace Period)” 机制，完美适配学生上厕所等真实场景。

🔋 实时电量监控: 精准回应硬件部署痛点，在载荷中集成了动态电量字段。当传感器电量低于 20% 时，云端将自动触发 [系统警报]。

⚡ 超轻量级载荷: 边缘设备传输经过极致压缩的 JSON 数据包（小于 70 字节），极大降低了网络带宽消耗。

🔌 解耦架构: 采用 MQTT 协议与公共物联网 Broker (broker.hivemq.com)，保证了系统的高可用性，并为未来的多场景扩展（如：无缝接入咖啡厅系统）打下坚实基础。

🛠️ 技术栈开发语言: Python 3.9

通信协议: MQTT (基于 paho-mqtt v1.6.1)

数据格式: JSON

中间件: HiveMQ Public Broker

📂 项目结构 publisher.py: 边缘端设备模拟器。代表部署在座位下的 ESP32 + PIR 传感器，负责生成座位占用状态与电池电量。

subscriber.py: 云端大脑。负责拦截 MQTT 数据包，处理三元状态机逻辑，并响应低电量系统警报。

🚀 快速启动安装依赖: 请务必安装经典版的 Paho-MQTT 库，以保证与旧版 API 的完美兼容。 pip install paho-mqtt==1.6.1

启动云端大脑: 首先运行订阅者程序，使其持续监听目标主题 CUC/Library/Floor_2/#。 python subscriber.py

模拟边缘数据: 在另一个终端中运行发布者程序，发送模拟的 JSON 载荷数据。 python publisher.py

👥 团队成员 Peishen: 项目大总管 (统筹与版本控制)

Guangci: 系统架构师 (逻辑与物理架构设计)

Bohan: 硬件开发工程师 (极简数据载荷设计)

Yihan: 云端后端负责人 / CTO (状态机与报警逻辑)

pengy14/CUH405CMD2526MARJUL_Team4

About

Resources

Stars

Watchers

Forks

Releases

Contributors 2

Languages