CyberMind-FR
ccfb58124c
Add complete French (fr) and Chinese (zh) translations for all documentation: - Root files: README, CHANGELOG, SECURITY, BETA-RELEASE - docs/: All 16 core documentation files - DOCS/: All 19 deep-dive documents including embedded/ and archive/ - package/secubox/: All 123+ package READMEs - Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/ Total: 346 translation files created Each file includes language switcher links for easy navigation between English, French, and Chinese versions. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
103 lines
4.7 KiB
Markdown
103 lines
4.7 KiB
Markdown
# secubox-app-device-intel
|
|
|
|
> **Languages:** [English](README.md) | Francais | [中文](README.zh.md)
|
|
|
|
Inventaire unifie des appareils agregeant les donnees de tous les sous-systemes SecuBox. Fait partie de l'ecosysteme SecuBox.
|
|
|
|
## Apercu
|
|
|
|
Couche d'agregation pure qui fusionne les donnees de mac-guardian, client-guardian, DHCP, mesh P2P, scanner d'exposition et modules d'emulation en un inventaire unique d'appareils avec classification heuristique, remplacements utilisateur et visibilite inter-mesh.
|
|
|
|
## Architecture
|
|
|
|
```
|
|
device-intelctl (CLI)
|
|
└── functions.sh (bibliotheque d'agregation)
|
|
├── di_collect_mac_guardian() → /var/run/mac-guardian/clients.db
|
|
├── di_collect_client_guardian() → UCI client-guardian
|
|
├── di_collect_dhcp() → /tmp/dhcp.leases
|
|
├── di_collect_p2p_peers() → ubus luci.secubox-p2p
|
|
├── di_collect_exposure() → /proc/net/tcp
|
|
└── di_collect_emulators() → emulators/*.sh
|
|
├── usb.sh → /sys/bus/usb/devices/
|
|
├── mqtt.sh → mosquitto broker
|
|
└── zigbee.sh → zigbee2mqtt / deCONZ API
|
|
```
|
|
|
|
## Flux de donnees
|
|
|
|
1. **Collecter** — Interroger chaque source de donnees en parallele
|
|
2. **Fusionner** — Indexer par adresse MAC, combiner les champs de toutes les sources
|
|
3. **Classifier** — Appliquer la chaine heuristique (utilisateur > emulateur > mesh > port > vendeur > hostname)
|
|
4. **Mettre en cache** — Stocker dans `/tmp/device-intel/cache-devices.json` (TTL configurable)
|
|
5. **Servir** — CLI ou RPCD retourne du JSON unifie
|
|
|
|
## Priorite de classification
|
|
|
|
| Priorite | Source | Exemple |
|
|
|---|---|---|
|
|
| 1 | Remplacement utilisateur | UCI `device-intel.<mac>.type` |
|
|
| 2 | Source emulateur | Client MQTT → mqtt_device |
|
|
| 3 | Correspondance peer mesh | IP peer P2P → mesh_peer |
|
|
| 4 | Base sur le port | Port 445 → storage |
|
|
| 5 | Base sur le vendeur | Synology → storage |
|
|
| 6 | Base sur le hostname | `.*sensor.*` → iot_sensor |
|
|
| 7 | Par defaut | unknown |
|
|
|
|
## Modules d'emulation
|
|
|
|
Decouverte d'appareils extensible de style KISS :
|
|
|
|
- **usb.sh** — Parcourt `/sys/bus/usb/devices/`, classifie par bDeviceClass (storage, serial, HID, camera, audio, printer, wireless)
|
|
- **mqtt.sh** — Interroge le broker mosquitto via les topics `$SYS` ou les logs
|
|
- **zigbee.sh** — Interroge l'API HTTP zigbee2mqtt ou l'API REST deCONZ
|
|
|
|
Chacun exporte `emulate_<type>()` retournant des entrees d'appareils delimitees par des pipes.
|
|
|
|
## Utilisation CLI
|
|
|
|
```bash
|
|
device-intelctl status # Apercu
|
|
device-intelctl list table # Vue tabulaire
|
|
device-intelctl list json # Sortie JSON
|
|
device-intelctl show aa:bb:cc:dd:ee:ff # Detail de l'appareil
|
|
device-intelctl classify # Classification par lot
|
|
device-intelctl set-type aa:bb:cc:dd:ee:ff iot_sensor # Remplacer le type
|
|
device-intelctl set-label aa:bb:cc:dd:ee:ff "Temp Sensor" # Label personnalise
|
|
device-intelctl emulators # Statut des modules
|
|
device-intelctl mesh-list # Appareils peers mesh
|
|
device-intelctl export json > inventory.json # Export complet
|
|
```
|
|
|
|
## Configuration UCI
|
|
|
|
```
|
|
/etc/config/device-intel
|
|
config device-intel 'main' → enabled, cache_ttl, classify_interval
|
|
config display 'display' → view mode, grouping, refresh
|
|
config emulator 'mqtt' → broker_host, port, discovery_topic
|
|
config emulator 'zigbee' → coordinator, adapter, api_port
|
|
config emulator 'usb' → scan_interval, track_storage, track_serial
|
|
config device_type '<id>' → name, icon, color, regles de correspondance vendor/hostname/port
|
|
config device '<mac_clean>' → remplacements utilisateur (type, label, capabilities, notes)
|
|
```
|
|
|
|
## Fichiers
|
|
|
|
```
|
|
/etc/config/device-intel Configuration UCI
|
|
/etc/init.d/device-intel Script d'initialisation procd
|
|
/usr/sbin/device-intelctl Controleur CLI
|
|
/usr/lib/secubox/device-intel/functions.sh Bibliotheque d'agregation principale
|
|
/usr/lib/secubox/device-intel/classify.sh Moteur de classification heuristique
|
|
/usr/lib/secubox/device-intel/emulators/usb.sh Emulateur de peripheriques USB
|
|
/usr/lib/secubox/device-intel/emulators/mqtt.sh Emulateur de broker MQTT
|
|
/usr/lib/secubox/device-intel/emulators/zigbee.sh Emulateur de coordinateur Zigbee
|
|
```
|
|
|
|
## Dependances
|
|
|
|
- `jsonfilter` (natif OpenWrt)
|
|
- `curl` (pour les appels API des emulateurs)
|
|
- Optionnel : `secubox-app-mac-guardian`, `secubox-app-client-guardian`, `secubox-p2p`
|