initialize a multitasking framework

docs/developers/010_ide_installation.md

@@ -0,0 +1,78 @@
+# Developer´s Installation with PlatformIO
+
+## Installation of VSCodium (Visual Studio Code)
+
+I prefer the installation of VSCodium, it is an excellent, privacy-focused alternative to Microsoft Visual Studio (VS Code) as it completely eliminatess telemtry, tracking, and proprietary Microsoft licenses.
+
+However, setting up VSCodium with PlatformIO introduces a major technical hurdle:
+Microsoft explicitly restricts the use of its official C/C++ extension (ms-vscode.cpptools) to official Microsoft product distributions.
+Because PlatformIO relies heavily on this extension for code completion, debugging, and naviagation, you cannot simply download everything directly from VSCodium's default extension marketplace.
+
+The following guide walks you through the proven workflows to successfully install and run PlatformIO on VSCodium.
+
+## Method 1: Manual Extension Installation (Recommended for Privacy)
+This method keeps your VSCodium completely decoupled from Microsoft's marketplace servers by manually sideloading the extension files (.vsix).
+
+### 1. Check System Prerequisites
+
+Ensure **Python 3** and **Git** are installed on your system.
+PlatformIO uses them under the hood to manage libraries and compile code.
+
+* Linux Users: You must also install the `python3-venv` packatge via your package manager (e.g. `sudo apt install python3-venv`).
+On **Arch Linux** the core `python` package (installed via `sudo pacman -S python`) **already includes the standard libryre `venv` module by default**.
+
+### 2. Download the Required Extensions
+
+Because of license restrictions, the required versions are not available on VSCodium's default *Open-VSX* registry.
+You need to grap them from the official Visual Studio Marketplace:
+
+1. Go to the Microsoft C/C++ Extension Page.
+On the right-hand side under *Resources*, click **Download Extensions** to save the `.vsix` file.
+
+2. Go to the PlatformIO IDE Extension Page and download its `.vsix` file as well.
+
+### 3. Sideload into VSCodium
+
+1. Open VSCodium.
+
+2. Click on the **Extension** icon in the left Activity Bar (or press `Ctrl+Shift+X` / `Cmd+Shift+X`).
+
+3. Click the `three dots (...)` at the top right of the Extensions view.
+
+4. Select and install the C/C++ Tools `.vsix` file first.
+
+5. Repeat the process to install the PlatformIO IDE `.vsix` file.
+
+### 4. Initialize PlatformIO Core
+
+1. **Restart VSCodium** completely after both installations finish.
+
+2. Upon restarting, PlatformIO will automatically start installing the **PlatformIO Core** framework in the background.
+This may take a few minutes depending on your internet connection.
+
+3. Once completed, you will see the iconic **PlatformIO Alien/Ant icon** appear in your left sidebar.
+
+## Method 2: Switching to the Microsoft Marketplace (Easier Updates)
+
+If you prefer a seamless one-click installation and automatic updates directly inside VSCodium, you can modify VSCodium's configuration to pull extensions directly from Microsoft's official marketplace instead of Open-VSX.
+
+*Note: This connects your editor to Microsoft's gallery infrastructure, which slightly reduces the strict "no-Microsoft-servers" privacy model of VSCodium.*
+
+1. Locate and open the product.json file for your VSCodium installation.
+
+	• Windows: %APPDATA%\VSCodium or inside the installation directory.
+	• Linux: /usr/share/vscodium/resources/app/product.json (requires root privileges to edit) or inside your Flatpak/Snap path.
+	• macOS: /Applications/VSCodium.app/Contents/Resources/app/product.json.
+
+2. Look for the extensionsGallery block and replace it with the following configuration:
+```json
+json
+"extensionsGallery": {
+    "serviceUrl": "https://visualstudio.com",
+    "itemUrl": "https://visualstudio.com"
+}
+```
+
+3. Save the file and restart VSCodium.
+
+4. You can now simply search for PlatformIO IDE and C/C++ in the Extensions tab and click Install.

docs/developers/020_new_project.md

@@ -0,0 +1,19 @@
+# Create New Project
+
+## PlatformIO
+
+1. Open VSCodium.
+
+2. Click on the **Alien Head** (ant head) icon of the PlatformIO in the left Activity bar.
+Continue clicking on "Create New Project", PlatformIO Core -- **PIO Home** opens.
+
+3. Again, press the button **+ New Project** and fill in the *Name* of the new project, e.g. `FoxMesh`.
+
+4. Select the board `TTGO LoRa32-OLED v2.1.6`
+
+5. Choose the Framework either `Arduino` or `Espidf`, we select `Espidf` i.e. **ESP-IDF**.
+
+6. We do not use the default location but `$HOME/github/FoxMesh`.
+
+
+