OpenParcelBox is an open-source project that replaces the proprietary electronics of the Boks One connected parcel box with a documented, local-first, and sustainable solution.

The goal is to preserve as much of the original hardware as possible while removing dependencies on proprietary cloud services and mobile applications.

Goals

Local-first operation
No subscription
No vendor lock-in
Open firmware
Open hardware documentation
Home Assistant integration
Battery-powered design
Reproducible hardware and software

Current Status

The project is under active development.

Completed or validated:

Zephyr RTOS application skeleton
Seeed Studio XIAO nRF52840 development target
RGB LED driver
PCF8574 GPIO expander driver
Development keypad scanning
Active buzzer feedback
Firmware debug output over serial console

In progress:

Original hardware reverse engineering
Lock driver
Production keypad mapping
Hardware validation

Planned:

Access control
NFC
Battery management
Zigbee
OTA updates
Home Assistant integration
Mobile configuration application
Custom PCB

Repository Structure

OpenParcelBox/
+-- docs/                 Project documentation
|   +-- firmware/         Firmware notes and module documentation
|   +-- hardware/         Hardware documentation assets
|   +-- architecture.md   System architecture
+-- firmware/             Zephyr firmware
|   +-- app/              Main firmware application
+-- hardware/             Hardware documentation and reverse engineering
+-- homeassistant/        Home Assistant integration notes
+-- mobile-app/           Mobile application notes
+-- CHANGELOG.md
+-- LICENSE
+-- README.md
+-- ROADMAP.md
+-- TODO.md

Local workspace support directories such as .vscode/, .venv/, .west/, tools/, external/, and build directories are not part of the OpenParcelBox project source.

Firmware

The firmware is written in C17 and uses Zephyr RTOS.

Current firmware modules:

RGB LED
PCF8574 GPIO expander
Matrix keypad
Active buzzer

Firmware documentation is available in:

docs/firmware/
firmware/README.md

Hardware

Current development platform:

Seeed Studio XIAO BLE nRF52840
PCF8574 GPIO expander
Freenove 4x4 matrix keypad for development validation

The production hardware is planned around a custom PCB and the original parcel box mechanical parts.

Documentation

General project tracking:

ROADMAP.md
TODO.md
CHANGELOG.md

Hardware and reverse-engineering notes:

hardware/
docs/hardware/

Firmware notes:

firmware/
docs/firmware/

License

OpenParcelBox is an open-source project.

Different project components may use different licenses depending on their nature.

Component	License
Project	`LICENSE`
Firmware	`firmware/LICENSE`
Hardware	`hardware/LICENSE`
Documentation	`docs/LICENSE`

Disclaimer

OpenParcelBox is an independent open-source project.

It is not affiliated with, endorsed by, or supported by the manufacturer of the Boks One parcel box.