Introduction

Documentation pour l'introduction.

Présentation du micrologiciel

Le micrologiciel Open Source Sex Machine (OSSM) est un système de contrôle basé sur ESP32 qui gère les mouvements, les entrées de l'utilisateur et la communication de votre appareil. Ce guide présente l'architecture du projet et vous aide à configurer votre environnement de développement.

Technologies de base

Le micrologiciel OSSM s'appuie sur quatre technologies clés qui fonctionnent ensemble pour offrir un contrôle de mouvement réactif et fiable.

Premiers pas

Configurez votre environnement de développement en suivant ces étapes.

Conditions préalables

Avant de commencer, assurez-vous d'avoir :

  • Un ordinateur exécutant Windows, macOS ou Linux
  • Git installé sur votre système
  • Une connexion Internet pour télécharger les dépendances

Installer VS Code et PlatformIO

Téléchargez et installez Visual Studio Code, puis ajoutez l'extension PlatformIO.

  1. Ouvrez VS Code
  2. Accédez au panneau Extensions (Ctrl+Shift+X / Cmd+Shift+X)
  3. Recherchez « PlatformIO IDE »
  4. Cliquez sur Installer et attendez la fin de l'installation.
  5. Redémarrez VS Code lorsque vous y êtes invité

Pour des instructions détaillées de configuration de PlatformIO, consultez notre Guide de configuration de PlatformIO.

Cloner le dépôt

Ouvrez un terminal et clonez le dépôt OSSM sur votre ordinateur local.

git clone https://github.com/KinkyMakers/OSSM-hardware.git
cd OSSM-hardware/Software

Si vous envisagez d'apporter des modifications, forkez d'abord le dépôt, puis clonez votre fork.

Ouvrez le projet dans VS Code

Lancez le projet à l'aide de PlatformIO.

  1. Ouvrez VS Code
  2. Sélectionnez Fichier > Ouvrir le dossier.
  3. Accédez au répertoire OSSM-hardware/Software que vous venez de cloner
  4. Cliquez sur Sélectionner un dossier (ou Ouvrir sur macOS)

PlatformIO détecte automatiquement le fichier platformio.ini et configure le projet.

Vous devriez voir la barre d'outils PlatformIO apparaître au bas de VS Code avec les boutons de compilation, de téléversement et de surveillance.

Compiler et téléverser le micrologiciel

Compilez le projet et flashez-le sur votre ESP32.

  1. Connectez votre carte ESP32 via USB
  2. Cliquez sur le bouton PlatformIO: Build (icône de coche) pour compiler
  3. Une fois la compilation réussie, cliquez sur PlatformIO: Upload (icône de flèche) pour flasher le micrologiciel.

Assurez-vous de sélectionner le bon port COM si plusieurs périphériques série sont connectés. Vous pouvez configurer cela dans platformio.ini ou via le moniteur de périphérique PlatformIO.

Prochaines étapes

Sur cette page