https://github.com/chl33/room133

An ESP32-based device for room monitoring, for use with Home Assistant
https://github.com/chl33/room133

esp32 esphome home-assistant kicad openscad pir-sensor platformio radar

Last synced: about 2 months ago
JSON representation

An ESP32-based device for room monitoring, for use with Home Assistant

• Host: GitHub
• URL: https://github.com/chl33/room133
• Owner: chl33
• License: mit
• Created: 2024-08-24T14:44:47.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2025-01-19T01:31:41.000Z (over 1 year ago)
• Last Synced: 2025-03-29T01:42:32.279Z (about 1 year ago)
• Topics: esp32, esphome, home-assistant, kicad, openscad, pir-sensor, platformio, radar
• Language: C++
• Homepage: https://selectiveappeal.org/posts/room133/
• Size: 3.23 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Room133 (v1.0.0)

Room133 is an ESP32-based family of devices which helps with various room-monitoring tasks, particulary for use with [Home Assistant](https://www.home-assistant.io/).

## Features

- **Adaptive Web Interface:** A modern, responsive Svelte UI that automatically detects and displays only the hardware capabilities active on your specific board (Motion, Light, Leak, OLED).

- **Climate Monitoring:** SHTC3-based temperature and humidity tracking.

- **Motion & Presence:** Support for one or more PIR sensors.

- **Environmental Sensing:** Light level measurement and standing water (leak) detection.

- **Unified Configuration:** Standardized JSON API and a clean settings interface for tuning filters and thresholds.

- **Robust Networking:** Automatic captive portal for WiFi setup and auto-reboot on configuration changes.

- **OTA Updates:** Reliable wireless firmware updates (requires `min_spiffs.csv` partition layout).

It is based on the [og3](https://github.com/chl33/og3) C++ software framework.

![Web interface](images/web-ui.png)

This repository includes software for the device, KiCAD files for the circuit board, and OpenSCAD files for creating the project boxes for the different devices.

Please see the [write-up](https://selectiveappeal.org/posts/room133/) on the project in my blog.  I also [wrote about](https://selectiveappeal.org/posts/room133-box/) the EBox design included in this repository.

![Room133 board render](images/room133_board_render.png)

## PCBA design: KiCAD

This project contains KiCAD sources for the Room133 circuit board.  It requires the [chl33_kicad_sym](https://github.com/chl33/chl33_kicad_sym) library.  I'm not experienced with sharing KiCAD projects in github.  I expect you will need to fix some path names if you try to open this project in KiCAD.

## EBox design: OpenSCAD

This project contains OpenSCAD sources for 3D-printing EBoxes for Room133 devices.  They use the library in [ProjectBox](https://github.com/chl33/ProjectBox).

![EBox for use with PIR sensor and photoresistor, with OLED display](images/scad_ebox_oled_pirl_vitamins.png)

You can open [`Ebox/Room133_test.scad`](Ebox/Room133_test.scad) with OpenSCAD and run [`Ebox/gui.sh`](Ebox/gui.sh), and use the user interface to customize the box depending on the application

![GUI for customizing the Ebox](images/scad_ebox_oled_pirl_vitamins.png).

I slice my EBox models with PrusaSlicer and print them in PETG.

## Wires

### PIR wire

JST socket 3x1

| Pin 1 | Pin2 | Pin 3  |

|:------|:-----|:-------|

| +5V   | GND  | Motion |

to

Dupont socket 3x1

| Pin 1 | Pin2 |  Pin 3  |

|:------|:------|:-------|

| +5V   | Motion| GND    |