OpenParcelBox/README.md

OpenParcelBox

🚧 Statut : Reverse Engineering en cours

OpenParcelBox est un projet open-source visant à remplacer l'électronique propriétaire de la boîte à colis connectée Boks One par une solution libre, documentée, maintenable et reproductible.

L'objectif est de conserver autant que possible les éléments mécaniques, électromécaniques et esthétiques d'origine tout en supprimant toute dépendance à l'écosystème propriétaire.

Le projet fournit à la fois :

• un firmware libre ;
• une électronique de remplacement documentée ;
• une intégration native avec Home Assistant ;
• une documentation complète permettant à chacun de reproduire la solution.

---

Pourquoi OpenParcelBox ?

De nombreuses boîtes à colis connectées reposent sur des services cloud et des applications propriétaires.

Lorsque le fabricant arrête son service, modifie ses conditions d'utilisation ou cesse son activité, le matériel peut devenir inutilisable malgré un état mécanique parfaitement fonctionnel.

OpenParcelBox est né de la volonté de prolonger la durée de vie d'une Boks One en remplaçant son électronique propriétaire par une solution libre et documentée, sans aucune dépendance à un service cloud.

Le développement du projet est réalisé sur une Boks One, qui constitue actuellement la seule plateforme officiellement prise en charge.

Cependant, les méthodes employées, l'architecture matérielle et les principes logiciels documentés dans ce dépôt peuvent servir de base à l'adaptation d'autres boîtes à colis ou boîtes aux lettres connectées par la communauté.

L'objectif du projet n'est donc pas de prendre en charge tous les produits du marché, mais de fournir une solution ouverte, reproductible et réutilisable que chacun pourra adapter à ses propres besoins.

---

Fonctionnalités prévues

Fonctionnelles

• Remplacement complet de l'électronique d'origine.
• Conservation du clavier 2 × 6.
• Conservation du mécanisme de verrouillage.
• Fonctionnement sur batterie.
• Intégration native Home Assistant.
• Communication Zigbee.
• Gestion de codes d'accès temporaires et permanents.
• Mises à jour OTA (Over-The-Air).

Techniques

• Fonctionnement entièrement local.
• Aucune dépendance à un service cloud.
• Faible consommation énergétique.
• Matériel reproductible.
• Logiciel libre.
• Documentation complète.

---

Architecture

Matériel

• Seeed Studio XIAO BLE nRF52840

Logiciel

• Zephyr RTOS
• C++
• west
• CMake

Communication

OpenParcelBox communique via Zigbee.

L'exposition éventuelle vers MQTT est assurée par Home Assistant via :

• ZHA
• Zigbee2MQTT
• ou toute autre passerelle compatible.

Le firmware n'utilise donc pas MQTT directement.

---

État du support Zigbee

Le support Zigbee fait partie des objectifs de la V1 mais n'est pas encore validé expérimentalement.

La pile Zigbee retenue ainsi que son intégration dans Home Assistant seront définies au cours du développement.

---

Documentation

Français

• Roadmap
• Architecture

---

Structure du dépôt

OpenParcelBox
├── docs/
│   └── fr/
├── firmware/
├── hardware/
├── homeassistant/
├── images/
├── mobile-app/
├── CHANGELOG.md
├── README.md
├── ROADMAP.md
├── TODO.md
└── LICENSE

---

État du projet

🚧 Projet en cours de reverse engineering.

Travaux actuellement en cours :

• Analyse du matériel d'origine.
• Identification des composants.
• Mesures électriques.
• Validation de l'architecture matérielle.
• Définition des interfaces firmware.

Pour connaître les étapes prévues du développement :

➡️ Consulter la roadmap

---

Licence

Les différents composants du projet sont distribués sous des licences adaptées à leur nature.

Composant	Licence
Projet	LICENSE
Firmware	firmware/LICENSE
Hardware	hardware/LICENSE
Documentation	docs/LICENSE