From a9151d4fd20c4bec0d610ef066f115c66d963d1d Mon Sep 17 00:00:00 2001 From: Eun0us Date: Mon, 19 Jan 2026 11:37:27 +0100 Subject: [PATCH] =?UTF-8?q?=CE=B5=20-=20Update=20README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 1 + README.en.md | 6 ++-- README.md | 72 +++++++++++++++++++++++++++------------- espilon_bot/main/Kconfig | 2 +- tools/flasher/README.md | 2 ++ 5 files changed, 56 insertions(+), 27 deletions(-) diff --git a/.gitignore b/.gitignore index 5e162c2..bd36677 100644 --- a/.gitignore +++ b/.gitignore @@ -46,6 +46,7 @@ tools/c3po/config.json *.log logs/ espilon_bot/logs/ +sdkconfig # IDE and Editor .vscode/ diff --git a/README.en.md b/README.en.md index 79e0de5..c02b7d0 100644 --- a/README.en.md +++ b/README.en.md @@ -56,10 +56,10 @@ cd esp-idf # 2. Clone Espilon cd ~ -git clone https://github.com/yourusername/epsilon.git -cd epsilon/espilon_bot +git clone https://github.com/Espilon-Net/epsilon-source.git +cd Espilon-Net/espilon_bot -# 3. Configure +# 3. Configure with menuconfig or tools/flasher/devices.json idf.py menuconfig # 4. Build and flash diff --git a/README.md b/README.md index f7bee1f..0b28049 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,7 @@ cd esp-idf # 2. Cloner Espilon cd ~ -git clone https://github.com/yourusername/epsilon.git +git clone https://github.com/Espilon-Net/epsilon-source.git cd epsilon/espilon_bot # 3. Configurer @@ -103,26 +103,26 @@ Espilon transforme des microcontrôleurs ESP32 abordables à **~5€** en agents ## Architecture -``` +```md ┌─────────────────────────────────────────────────────┐ │ ESP32 Agent │ -│ ┌───────────┐ ┌──────────┐ ┌─────────────────┐ │ -│ │ WiFi/ │→ │ ChaCha20 │→ │ C2 Protocol │ │ -│ │ GPRS │← │ Crypto │← │ (nanoPB/TCP) │ │ -│ └───────────┘ └──────────┘ └─────────────────┘ │ +│ ┌───────────┐ ┌──────────┐ ┌─────────────────┐ │ +│ │ WiFi/ │→ │ ChaCha20 │→ │ C2 Protocol │ │ +│ │ GPRS │← │ Crypto │← │ (nanoPB/TCP) │ │ +│ └───────────┘ └──────────┘ └─────────────────┘ │ │ ↓ ↓ ↓ │ -│ ┌───────────────────────────────────────────────┐ │ -│ │ Module System (FreeRTOS) │ │ -│ │ [Network] [FakeAP] [Recon] [Custom...] │ │ -│ └───────────────────────────────────────────────┘ │ +│ ┌───────────────────────────────────────────────┐ │ +│ │ Module System (FreeRTOS) │ │ +│ │ [Network] [FakeAP] [Recon] [Custom...] │ │ +│ └───────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────┘ ↕ Encrypted TCP - ┌─────────────────────┐ - │ C2 Server (C3PO) │ - │ - Device Registry │ - │ - Group Management │ - │ - CLI Interface │ - └─────────────────────┘ + ┌──────────────────────┐ + │ C2 Server (C3PO) │ + │ - Device Registry │ + │ - Group Management │ + │ - CLI Interface │ + └──────────────────────┘ ``` ### Composants Clés @@ -130,6 +130,7 @@ Espilon transforme des microcontrôleurs ESP32 abordables à **~5€** en agents - **Core** : Connexion réseau, crypto ChaCha20, protocole nanoPB - **Modules** : Système extensible (Network, FakeAP, Recon, etc.) - **C2 (C3PO)** : Serveur Python asyncio pour contrôle multi-agents +- **C3PO**: Ancien c2 (serveur web - Trilateration + Front affichage caméra) - **Flasher** : Outil de flash multi-device automatisé --- @@ -211,15 +212,39 @@ python3 flash.py --config devices.json ```json { - "project": "/path/to/espilon_bot", + "project": "/home/user/epsilon/espilon_bot", "devices": [ + ## WiFi AGENT ## { - "device_id": "esp001", + "device_id": "ce4f626b", "port": "/dev/ttyUSB0", + "srv_ip": "192.168.1.13", + "srv_port": 2626, "network_mode": "wifi", - "wifi_ssid": "MyNetwork", - "wifi_pass": "MyPassword", - "srv_ip": "192.168.1.100" + "wifi_ssid": "MyWiFi", + "wifi_pass": "MyPassword123", + "hostname": "pixel-8-pro", + "module_network": true, + "module_recon": false, + "module_fakeap": false, + "recon_camera": false, + "recon_ble_trilat": false, + "crypto_key": "testde32chars00000000000000000000", + "crypto_nonce": "noncenonceno" + }, + + ## GPRS AGENT ## + { + "device_id": "a91dd021", + "port": "/dev/ttyUSB1", + "srv_ip": "203.0.113.10", + "srv_port": 2626, + "network_mode": "gprs", + "gprs_apn": "sl2sfr", + "hostname": "galaxy-s24-ultra", + "module_network": true, + "module_recon": false, + "module_fakeap": false } ] } @@ -302,7 +327,8 @@ Espilon doit être utilisé uniquement pour : ### V2.0 (En cours) - [ ] Mesh networking (BLE/WiFi) -- [ ] Améliorer la Documentations +- [ ] Implémenter Module reccoon dans C3PO +- [ ] Améliorer la Documentations [here](https://docs.espilon.net) - [ ] OTA updates - [ ] Multilatération collaborative - [ ] Optimisation mémoire @@ -335,7 +361,7 @@ Voir [LICENSE](LICENSE) pour les détails complets. - **@Eun0us** - Core architecture, modules - **@off-path** - C2 server, protocol -- **@itsoktocryyy** - Network features +- **@itsoktocryyy** - Network features, Wall Hack - **@wepfen** - Documentation, tools ### Contribuer diff --git a/espilon_bot/main/Kconfig b/espilon_bot/main/Kconfig index 2d58170..ec0031e 100644 --- a/espilon_bot/main/Kconfig +++ b/espilon_bot/main/Kconfig @@ -115,7 +115,7 @@ menu "Security" config CRYPTO_KEY string "ChaCha20 Key (32 bytes)" - default "testde32chars00000000000000000000" + default "testde32chars0000000000000000000" config CRYPTO_NONCE string "ChaCha20 Nonce (12 bytes)" diff --git a/tools/flasher/README.md b/tools/flasher/README.md index d86251c..df0283e 100644 --- a/tools/flasher/README.md +++ b/tools/flasher/README.md @@ -42,6 +42,7 @@ The `devices.json` file contains: { "project": "/home/user/epsilon/espilon_bot", "devices": [ + ## WiFi AGENT ## { "device_id": "ce4f626b", "port": "/dev/ttyUSB0", @@ -59,6 +60,7 @@ The `devices.json` file contains: "crypto_key": "testde32chars00000000000000000000", "crypto_nonce": "noncenonceno" }, + ## GPRS AGENT ## { "device_id": "a91dd021", "port": "/dev/ttyUSB1",