Repository navigation
Releases: paclema/iot-postbox
Release list
IoT-PostBox v1.2
🚀 Overview
This release focuses on improving hardware documentation and refactoring the project. Key highlights include migration to KiCad v9, documentation for IoT-PostBox v1.2 release, project structure cleanup, and integration with the WebConfigServer library ecosystem.
🛠️ Hardware
KiCad v9 Migration
- Migrated all PCB designs to KiCad v9 for improved compatibility and latest features
- Fixed missing 3D models and improved visual representation of components
- Updated connector footprints with more appropriate alternatives for better assembly
Release IoT-PostBox v1.2
- New gerber files (
iot-postbox_v1.2.rar), interactive BOM, and complete 3D render set - STEP files for mechanical integration and updated schematic PDFs
Cleanup
- Added missing TTL to USB adapter documentation
- Removed obsolete panelized PCB files and outdated documentation images
💾 Firmware
WebConfigServer Integration
- Removed local webserver folder - now uses WebConfigServer library's default dashboard
📚 Documentation
- Reorganized hardware documentation with dedicated v1.0, v1.2, and v0.3 folders
- Refactorized and enhanced pcb_designs readme with comprehensive hardware descriptions and version comparisons
- Updated and refactorized repo readme, updating installation and configuration instructions and WebConfigServer integration
- Added proyect License
See the full commit history for all details.
IoT-Postbox v1.1
🚀 Overview
This release brings major improvements to both hardware and firmware for the IoT-PostBox v1 platform. It introduces support for 16MB flash, a significant refactor of the power management and sensing logic, expanded telemetry, and updated documentation and configuration for the new hardware revision.
🛠️ Hardware
-
ESP32 16MB Flash Support
- Added a new partition table for ESP32 boards with 16MB flash:
board_partitions/esp32/iotpostboxv1_16MB.csv
- Added a new partition table for ESP32 boards with 16MB flash:
-
Schematics & PCB Updates
- All main schematics updated to revision v1.1, with improved organization, references, and annotations after testing findings.
- Added explanatory notes for ADC measurement (VBAT/VBUS) on ESP32-S2.
- Improved component placement, labels, and wiring for clarity.
- Updated bottom PCB image and added a temporary pinout diagram:
pcb_desings/iot-postbox_v1/docs/iot-postbox_v1.0_bot.png
pcb_desings/iot-postbox_v1/docs/iot-postbox_v1.0_pinout_temp.png
-
BOM & Documentation
- Updated interactive BOM:
pcb_desings/iot-postbox_v1/bom/ibom.html - Removed temporary and autosave files.
- Updated interactive BOM:
💾 Firmware
-
Power Management Refactor
- Introduced new
PowerManagementandADCSenseclasses for centralized power and ADC handling. - Improved ADC calibration, averaging, and reporting for battery and VBUS.
- Enhanced detection of power and charging states.
- Introduced new
-
Expanded MQTT Payload
- Now includes vBat, vBus, PowerStatus, ChargingStatus, and event counter.
-
Code Modularization
- Added new
PostBoxandPostBoxSwitchclasses to modularize mailbox logic and switch handling. - Refactored main firmware to use these new classes for better maintainability.
- Added new
-
Configuration Updates
- Updated SSID, hostname, device name, and repository URL in config files.
- Adjusted sleep and NTP settings for improved operation.
See the full commit history for all details.
IoT-Postbox v1.0
🚀 Overview
This release introduces a new hardware platform based on the ESP32-S2, expanding the IoT-Postbox project with a more powerful MCU, modular schematic, and support for future features like LoRa. The firmware and documentation have been updated for compatibility and clarity, while maintaining all previous mailbox and sensor functionalities.
🛠️ Hardware
-
IoT-Postbox v1 board
pcb_desings/iot-postbox_v1/- New custom PCB design for ESP32-S2.
- Modular schematic split into INTERFACE, MCU, and POWER sections.
- Footprint and 3D model additions for ESP32-S2, LoRa (RFM95W), antennas, battery holders, and more.
- Support for 16MB flash and 8MB PSRAM.
- Digital triggers for wake-up (no longer using CH_PU pin).
- BOM, Gerber files, and extensive documentation and images included.
- Schematic v1.0
- More information and differences between the previous board and the new one can be found under the
pcb_desings/readme.
-
KiCad Libraries
- Added Espressif official KiCad libraries as a submodule.
- New custom footprints and 3D models in
pcb_desings/libs/.
💾 Firmware
- Added
mhetesp32devkit_stableas a new PlatformIO target for ESP32-S2. - Updated
PostBoxSwitchstruct and main firmware for ESP32 compatibility. - Minor fixes and documentation updates.
- No LoRa support in firmware yet, but hardware is ready for future expansion.
📚 Documentation
- Updated
pcb_desings/readme.mdto describe the new v1.0 board and its differences. - Added new images, PDFs, and BOMs for the v1.0 hardware.
See the full commit history for all details.
IoT-Postbox v0.0
🚀 Overview
First public release of IoT-Postbox, evolved from the original iot_button project.
This version introduces a custom PCB based on the ESP-12 (ESP8266) module, designed for mailbox applications.
The device uses switch sensors to trigger power-on when mail is delivered, allowing the MCU to wake up, process the event, and publish a real-time notification via MQTT.
Device configuration and monitoring are available through a modern Angular web interface thanks to the WebConfigServer library.
🛠️ Hardware
-
IoT-Postbox board
pcb_desings/iot-postbox/- ESP-12F or ESP-07S as main MCU.
- Battery charger (TP4056) and LDO regulator (MCP1700 or ME6211) for battery charging and power management.
- Two switch sensor inputs (J1, J2) to detect mailbox events.
- Wake-up logic: Switches trigger the enable pin, GPIO14 keeps the MCU awake until the firmware cycle completes and MQTT notification is sent.
- UART header for programming/debugging.
-
TTL to USB Adapter board
pcb_desings/ttl_to_usb_adapter/- Designed for convenient programming and debugging of the IoT-Postbox PCB.
- Ensures proper wake-up and flashing of the ESP-12 via UART header.
💾 Firmware
- Firmware for ESP8266 (ESP-12), with support for ESP32 and generic dev boards in earlier stages.
- Real-time mail detection and MQTT notification.
- Angular web application (Bootstrap, Nebular UI) for device configuration and data visualization.
- WebSockets integration for live dashboard updates.
- File backup/restore management and dynamic configuration via web interface.
- OTA updates, FTP server, AP+STA WiFi modes, mDNS, NTP, NAT features.
- DeepSleep and LightSleep support, power management, and hardware interrupts.
- Gzipped webapp assets for efficient storage and serving.
- Modularized codebase with WebConfigServer, WrapperOTA, and WrapperWebSockets classes.
See the full commit history for all details.
IoT-Postbox v0.3
🚀 Overview
This release introduces important hardware improvements and new features, keeping the ESP-12 custom PCB as the core but expanding its capabilities for mailbox and sensor applications.
🛠️ Hardware
- IoT-Postbox board
pcb_desings/iot-postbox/- Added support for WS2812b LED strip for visual notifications.
- Updated battery voltage divider for improved ADC measurement accuracy.
- Changed switch pinouts for better integration and flexibility.
- Added dedicated battery sensor input.
- Improved silkscreen and documentation.
- Schematic v0.3 vs Schematic v0.0
- All design files and documentation updated for v0.3.
💾 Firmware
- Added WS2812b LED strip control and configuration.
- Improved battery sensing and ADC routines.
- Enhanced event handling for new hardware features.
- Refined power management and charging status detection.
- Bug fixes for switch counter and LED strip features.
- Added new platformio targets and updated board definitions.
- Updated configuration and web interface to support new hardware options.
- Updated PCB and schematic references in code and documentation.
- General code cleanup and refactoring.
- Improved documentation and folder structure for hardware and firmware.
See the full commit history for all details.