this repo has no description
Update README.md
+239
-24
+239
-24
README.md
+239
-24
README.md
···
1
-
# BaSIL / OSIriS Badge
2
-
Badge Social Irisé Libre / OpenSource Social Iridescent Badge
1
+
2
+
# 🌀 BaSIL — Badge Social Irisé Libre
3
+
4
+
Other potential name : **OSIriS** : OpenSource Social Iridescent Badge
5
+
6
+
> A wearable, open-source social radar that tells you where your friends are
7
+
> — without screens, without cloud, without surveillance.
8
+
9
+
> Un radar social portable et open-source qui vous indique où sont vos amis
10
+
> — sans écran, sans cloud, sans surveillance.
11
+
12
+
---
13
+
14
+
## [EN]
15
+
16
+
### What is BaSIL?
17
+
18
+
BaSIL is a screenless wearable badge that uses light and subtle feedback
19
+
to indicate the direction and distance of nearby trusted contacts.
20
+
21
+
Think of it as a compass that always points toward your friends.
22
+
23
+
**Core principles:**
24
+
- **Zero-screen interface:** Two concentric LED rings (16 + 8 WS2812B)
25
+
provide directional and relational feedback through color, position,
26
+
and animation patterns.
27
+
- **Privacy by design:** No GPS tracking. No cloud. No persistent identity.
28
+
Encryption keys and contact data are automatically purged after 72 hours
29
+
without contact or after a defined date and time (anti-stalking by design).
30
+
- **Open hardware:** KiCad schematics, PCB layout, 3D-printable enclosure
31
+
files — everything needed to build your own.
32
+
- **Heart + Shell philosophy:** The PCB is a standardized electronic core.
33
+
The enclosure is yours to design. Like a lightsaber, each badge should reflects
34
+
its maker.
35
+
36
+
### How does it work?
37
+
38
+
| Range | Technology | Precision |
39
+
|-------|-----------|-----------|
40
+
| 0–30m | BLE 6.0 Channel Sounding (nRF54L15) | Sub-meter |
41
+
| 30m–2km+ | LoRa (SX1262, 868 MHz) | Approximate bearing |
42
+
43
+
The inner LED ring (8 LEDs) represents your **circle of trust** — lasting
44
+
bonds built through recurring proximity. The outer ring (16 LEDs) acts as
45
+
a **directional radar**, pointing toward detected contacts.
46
+
47
+
A companion app (React Native, planned) handles pairing, firmware updates,
48
+
and circle management (including messaging via text and potnetially short audio). The badge operates fully standalone after setup.
49
+
50
+
### Hardware (Badge V1)
51
+
52
+
| Component | Role |
53
+
|-----------|------|
54
+
| Seeed XIAO nRF54L15 Sense | MCU, BLE 6.0, IMU, microphone |
55
+
| Wio-SX1262 or NiceRF LR2021 | LoRa (Gen2 or Gen4) transceiver (868 MHz)|
56
+
| QMC5883L | Magnetometer (heading) |
57
+
| 2x WS2812B rings (16+8) | Zero-screen interface |
58
+
| TTP223 | Capacitive touch button |
59
+
| LiPo 504040 (800 mAh) | Swappable battery |
60
+
61
+
**Enclosure:** Teardrop shape, max 60×80×20mm. 3D-printable (FDM/SLA).
62
+
63
+
### Software stack
64
+
65
+
| Layer | Technology |
66
+
|-------|-----------|
67
+
| RTOS | Zephyr (Nordic nRF Connect SDK) |
68
+
| Radio | BLE 6.0 + LoRa (SPI) |
69
+
| Sensors | IMU (LSM6DS3TR-C) + Magnetometer (I2C) + Microphone|
70
+
| Position engine | Trilateration, Kalman filter, TinyML environment classification |
71
+
| Companion app | React Native (planned) |
72
+
73
+
### Project status
74
+
75
+
| Milestone | Status |
76
+
|-----------|--------|
77
+
| Electrical schematic (KiCad) | ✅ Complete |
78
+
| PCB layout | 🔴 Not started |
79
+
| 3D enclosure (reference design) | 🟡 Mockups done |
80
+
| Firmware — sensors (IMU, magnetometer) | 🟡 In progress |
81
+
| Firmware — LED driver | 🔴 Not started |
82
+
| Firmware — BLE stack | 🔴 Not started |
83
+
| Firmware — LoRa stack | 🔴 Not started |
84
+
| Companion app | 🔴 Not started |
85
+
86
+
### Repository structure
87
+
88
+
BaSIL/
89
+
├── hardware/
90
+
│ ├── kicad/ # Schematic & PCB files
91
+
│ ├── bom/ # Bill of materials
92
+
│ ├── enclosure/ # 3D models (STL, STEP)
93
+
│ └── antennas/ # Textile antenna R&D (V2)
94
+
├── software/
95
+
│ ├── firmware/
96
+
│ │ └── base_badge/ # Zephyr project
97
+
│ └── app/ # React Native companion
98
+
├── docs/
99
+
│ ├── tech_sheet.md # Full technical specification
100
+
│ └── mockups/ # 2D/3D visuals
101
+
├── LICENSE
102
+
└── README.md
103
+
104
+
105
+
### Build your own
106
+
107
+
> ⚠️ Badge V1 is still in active development. Assembly instructions will
108
+
> be published once the PCB layout is validated and a first batch tested.
109
+
110
+
Prerequisites:
111
+
- nRF Connect for VS Code (Nordic toolchain)
112
+
- KiCad 9.x or newer
113
+
- 3D printer (FDM or SLA) for enclosure and eventually FreeCAD 10.X
114
+
115
+
### License
116
+
117
+
Hardware: **CERN-OHL-P v2** (permissive)
118
+
Software: **MIT**
119
+
Documentation: **CC BY-SA 4.0**
120
+
121
+
> License choice is provisional and may evolve before first stable release.
122
+
123
+
### Contact
124
+
125
+
Project maintained by Hans BODART.
126
+
Questions, ideas, contributions: [open an issue](../../issues).
127
+
128
+
---
129
+
---
130
+
131
+
## 🇫🇷 Français
132
+
133
+
### Qu'est-ce que BaSIL ?
134
+
135
+
BaSIL est un badge portable sans écran qui utilise la lumière pour indiquer
136
+
la direction et la distance de vos contacts de confiance à proximité.
137
+
138
+
Un compas qui pointe toujours vers vos proches.
139
+
140
+
**Principes fondamentaux :**
141
+
- **Interface zéro-écran :** Deux anneaux LED concentriques (16 + 8 WS2812B)
142
+
fournissent un retour directionnel et relationnel par la couleur, la position
143
+
et les motifs d'animation.
144
+
- **Vie privée par conception :** Pas de GPS. Pas de cloud. Pas d'identité
145
+
persistante. Les clés de chiffrement et les données de contact sont
146
+
automatiquement purgées après 72 heures sans contact (anti-harcèlement
147
+
par design).
148
+
- **Matériel ouvert :** Schémas KiCad, layout PCB, fichiers boîtier
149
+
imprimables en 3D — tout le nécessaire pour construire le vôtre.
150
+
- **Philosophie Cœur + Enveloppe :** Le PCB est un cœur électronique
151
+
standardisé. Le boîtier vous appartient. Comme un sabre laser, chaque
152
+
badge reflète son créateur.
153
+
154
+
### Comment ça fonctionne ?
155
+
156
+
| Portée | Technologie | Précision |
157
+
|--------|------------|-----------|
158
+
| 0–30m | BLE 6.0 Channel Sounding (nRF54L15) | Sub-métrique |
159
+
| 30m–2km+ | LoRa (SX1262, 868 MHz) | Cap approximatif |
160
+
161
+
L'anneau intérieur (8 LEDs) représente votre **cercle de confiance** —
162
+
des liens durables construits par la proximité récurrente. L'anneau
163
+
extérieur (16 LEDs) agit comme un **radar directionnel**, pointant vers
164
+
les contacts détectés.
165
+
166
+
Une application compagnon (React Native, prévue) gère l'appairage, les
167
+
mises à jour firmware et la gestion du cercle. Le badge fonctionne de
168
+
manière autonome après la configuration initiale.
169
+
170
+
### Matériel (Badge V1)
171
+
172
+
| Composant | Rôle |
173
+
|-----------|------|
174
+
| Seeed XIAO nRF54L15 Sense | MCU, BLE 6.0, IMU, microphone |
175
+
| Wio-SX1262 | Émetteur-récepteur LoRa (868 MHz) |
176
+
| QMC5883L | Magnétomètre (cap) |
177
+
| 2x anneaux WS2812B (16+8) | Interface zéro-écran |
178
+
| TTP223 | Bouton tactile capacitif |
179
+
| LiPo 504040 (800 mAh) | Batterie interchangeable |
180
+
181
+
**Boîtier :** Forme goutte d'eau, max 60×80×20mm. Imprimable 3D (FDM/SLA).
182
+
183
+
### Stack logicielle
184
+
185
+
| Couche | Technologie |
186
+
|--------|------------|
187
+
| RTOS | Zephyr (Nordic nRF Connect SDK) |
188
+
| Radio | BLE 6.0 + LoRa (SPI) |
189
+
| Capteurs | IMU (LSM6DS3TR-C) + Magnétomètre (I2C) |
190
+
| Moteur de position | Trilatération, filtre de Kalman, classification TinyML |
191
+
| App compagnon | React Native (prévue) |
192
+
193
+
### État du projet
194
+
195
+
| Jalon | Statut |
196
+
|-------|--------|
197
+
| Schéma électrique (KiCad) | ✅ Terminé |
198
+
| Layout PCB | 🔴 Non commencé |
199
+
| Boîtier 3D (design de référence) | 🟡 Mockups réalisés |
200
+
| Firmware — capteurs (IMU, magnétomètre) | 🟡 En cours |
201
+
| Firmware — driver LED | 🔴 Non commencé |
202
+
| Firmware — stack BLE | 🔴 Non commencé |
203
+
| Firmware — stack LoRa | 🔴 Non commencé |
204
+
| App compagnon | 🔴 Non commencé |
205
+
206
+
### Structure du dépôt
207
+
208
+
BaSIL/
209
+
├── hardware/
210
+
│ ├── kicad/ # Schéma & fichiers PCB
211
+
│ ├── bom/ # Nomenclature composants
212
+
│ ├── enclosure/ # Modèles 3D (STL, STEP)
213
+
│ └── antennas/ # R&D antennes textiles (V2)
214
+
├── software/
215
+
│ ├── firmware/
216
+
│ │ └── base_badge/ # Projet Zephyr
217
+
│ └── app/ # App compagnon React Native
218
+
├── docs/
219
+
│ ├── tech_sheet.md # Spécification technique complète
220
+
│ └── mockups/ # Visuels 2D/3D
221
+
├── LICENSE
222
+
└── README.md
3
223
4
-
BaSIL (Badge Social Irisé Libre) est une plateforme de localisation relative off-grid conçue pour les événements, festivals et activités de plein air.
5
224
6
-
## 🌟 Présentation
7
-
Le projet BaSIL est un "compas social" utilisant le SoC **Seeed Studio XIAO nRF54L15 Sense**. Il permet de localiser ses amis sans dépendre des réseaux cellulaires ou du GPS, grâce au **Bluetooth 6.0 Channel Sounding** et au maillage **LoRa**.
225
+
### Construire le vôtre
226
+
227
+
> ⚠️ Le Badge V1 est en développement actif. Les instructions d'assemblage
228
+
> seront publiées une fois le layout PCB validé et un premier lot testé.
8
229
9
-
L'aspect "Libre" et "Irisé" souligne la nature open-source du projet et son interface visuelle unique basée sur des anneaux de LEDs (Iris Social).
230
+
Prérequis :
231
+
- nRF Connect for VS Code (toolchain Nordic)
232
+
- KiCad 9.x
233
+
- Imprimante 3D (FDM ou SLA) pour le boîtier
10
234
11
-
## 📂 Structure du Dépôt
12
-
- **[hardware/](hardware/)** : Spécifications physiques, liste des composants (BOM), schémas de câblage et conception mécanique du boîtier "Goutte".
13
-
- **[software/](software/)** : Code source du firmware pour le badge (Zephyr RTOS / nRF Connect SDK).
235
+
### Licence
14
236
15
-
## 🛠️ Caractéristiques Techniques
16
-
- **MCU** : Xiao nRF54L15 Sense (Arm Cortex-M33 @ 128MHz + RISC-V coprocesseur).
17
-
- **Radio** :
18
-
- Bluetooth 6.0 (Précision de 10-30cm via Channel Sounding).
19
-
- LoRa (module SX1262 pour la V1 ou LR2021 pour la V2) pour la communication longue portée et satellitaire.
20
-
- **Capteurs** : Intégré aà la version Sense :
21
-
- Accéléromètre, Gyroscope (IMU LSM6DS3TR-C) et Microphone (MSM261DGT006).
22
-
- Magnétomètre (Boussole QMC5883L).
23
-
- **Interface** : 24 (16+8) LEDs WS2812B (Iris), Bouton tactile TTP223.
24
-
- **Batterie** : 800mAh (V1) ou 1500mAh (V2), autonomie prévue de 4 à 7 jours.
237
+
Matériel : **CERN-OHL-P v2** (permissive)
238
+
Logiciel : **MIT**
239
+
Documentation : **CC BY-SA 4.0**
25
240
26
-
## 🚀 Démarrage Rapide (Firmware)
27
-
Le firmware se trouve dans `software/firmware/base_badge`. Il utilise le SDK **nRF Connect** de Nordic Semiconductor.
241
+
> Le choix de licence est provisoire et pourra évoluer avant la première
242
+
> version stable.
28
243
29
-
Consultez le **[Guide de Développement nRF54L15](software/DEVELOPMENT.md)** pour configurer votre environnement et compiler le projet.
244
+
### Contact
30
245
31
-
# Pour compiler le cœur Application
32
-
west build -b xiao_nrf54l15/nrf54l15/cpuapp --sysbuild software/firmware/base_badge
246
+
Projet maintenu par Hans.
247
+
Questions, idées, contributions : [ouvrir une issue](../../issues).