PEC 16 V0.2

MB_ModulBox_NG — Contrôleur MIDI Modulaire (Écosystème MIDIbox NG)

Construisez votre propre contrôleur MIDI modulaire.
MB_ModulBox_NG rassemble des front-ends originaux et des ré-implémentations KiCad de modules MIDIbox. Les niveaux de validation et les fichiers de fabrication disponibles varient d'une carte à l'autre : consulter la matrice ci-dessous avant toute commande.

---

🎯 Le projet en bref

MB_ModulBox_NG est une bibliothèque de cartes de contrôle physiques pour le système MIDIbox NG. Les sources, schémas, PCB et fichiers de fabrication ne sont pas tous disponibles pour chaque carte. Les états indiqués ci-dessous décrivent les fichiers présents dans le dépôt, pas une certification de fabrication.

Les modules standards MIDIbox (AIN, DIN, DOUT, Core, IO) sont fournis en bonus de référence pour alimenter ces front-ends — ils ne sont pas le cœur du projet. L'essence de ce dépôt, ce sont les custom-frontends/.

🧩 Les modules: Custom Front-ends — le cœur du dépôt

Modules standards MIDIbox — ré-implémentations KiCad

---

---

🚀 Démarrage rapide

1. Cloner le dépôt

   git clone https://github.com/papaya/MB_ModulBox_NG.git
   cd MB_ModulBox_NG

2. Ouvrir un front-end dans KiCad

   • Choisissez une carte dans custom-frontends/ (ex: 4x-faders/)
   • Ouvrez le fichier .kicad_pro avec KiCad (v9 recommandé)

3. Lier les bibliothèques partagées

   • sym-lib-table → Mes_Librairies_KiCad/symbols/
   • fp-lib-table → Mes_Librairies_KiCad/footprints/ (chemins relatifs via ${KIPRJMOD})

4. Fabriquer

   • Vérifiez d'abord que la matrice ci-dessus indique des Gerbers et perçages pour la carte choisie.
   • Ouvrez les Gerbers dans un visualiseur indépendant et comparez-les au PCB KiCad avant commande.
   • Ne commandez pas une carte marquée prototype, non routée ou sans Gerbers ; un BOM/netlist seul n'est pas un jeu de fichiers de fabrication.
   • Les modèles 3D et fichiers sources supplémentaires, lorsqu'ils existent, sont sur l'archive Google Drive.

Guide maker : assemblage et commande des PCB

1. Choisissez un module dont la matrice indique des Gerbers et lisez son README avant de fabriquer.
2. Vérifiez le nombre de couches, le contour, les ouvertures de masque, les perçages PTH/NPTH et l'orientation des composants dans les fichiers de production.
3. Transmettez au fabricant les couches et fichiers de perçage publiés pour la carte choisie. Ne modifiez pas l'épaisseur de cuivre, le stack-up ou les dimensions sans revoir les contraintes électriques et mécaniques.
4. Utilisez la BOM et le fichier de positions uniquement s'ils sont publiés pour cette carte ; comparez références, valeurs et empreintes avec le schéma KiCad.
5. Assemblez hors tension, contrôlez les courts-circuits d'alimentation au multimètre, puis alimentez avec une alimentation limitée en courant.
6. Pour les cartes WS2812, utilisez une alimentation 5 V dimensionnée pour la charge et une masse commune. Le Core ne fournit pas l'alimentation des LED.

La présence de Gerbers ne certifie pas une carte ni ne garantit l'absence de défauts. Consultez les avertissements DRC/ERC et les limites propres à chaque README.

📦 Contenu de ce dépôt Git (et ce qui n'y est pas)

Ce dépôt est allégé pour rester léger et rapide à cloner. Sont versionnés :

📥 Les fichiers 3D et les sources complètes sont disponibles via l'archive Google Drive : ALL FILES — Archive complète

Les modèles 3D manquants peuvent aussi être récupérés via kicad-cli / KiCad 3D Viewer directement depuis les bibliothèques officielles (kicad-footprints, kicad-symbols).

📖 Articles et ressources du blog ksir-diy.blogspot.com

Articles par carte :

---

⚡ Modules standards MIDIbox (bonus de référence)

Ces modules standards alimentent les front-ends en bus AIN / DIN / DOUT. Ils sont fournis à titre de référence — ce ne sont pas la raison d’être de ce dépôt.

---

⚠️ Note importante sur les LEDs RGB WS2812/WS2812B : Les cartes encoders-led-rgb, pad-rgb et keysw-4x2 utilisent des LEDs adressables qui se connectent en 1 fil de données sur une sortie WS2812 du Core STM32F4 (J4A broches 6/8 = PB10/PB11, J4B broches 6/8 = PB6 (TIM4)/PB9) — PAS sur le bus DOUT (74HC595). Voir les README respectifs et spécifications WS2812 MIOS32.

ℹ️ Sur les cartes encodeurs, pads et clavier, les LED sont montées en cascade série et adressables individuellement depuis une ligne de données.

---

Licences, crédits et conditions d'utilisation

Ce dépôt contient deux catégories de matériel distinctes :

1. Modules standards officiels (standard-modules/)

Core, AIN, DIN, DOUT, IO — Ces modules sont des ré-implémentations sous KiCad basées sur les schémas originaux de la plateforme MIDIbox (MBHP) conçue par Thorsten Klose / ucapps.de.
Crédits : Thorsten Klose & ucapps.de.
Usage : strictement personnel, éducatif et DIY — Non-Commercial.

2. Modules et front-ends originaux (custom-frontends/)

4x-faders, 8x-pots, 8x-buttons, encoders-led-rgb, pad-rgb, keysw-4x2, carte-puissance, oled-128x64, surface-control — Cartes d'interface originales conçues pour l'écosystème MB MODULBOX NG, compatibles selon leur README avec les bus et modules MIDIbox NG.
Usage indiqué dans les README : DIY/personnel ; les conditions de redistribution et d'utilisation commerciale restent à formaliser.

Licence non publiée : le dépôt ne contient actuellement aucun fichier LICENSE. Les conditions applicables aux ré-implémentations des modules MIDIbox et aux créations originales doivent être clarifiées séparément avant toute redistribution ou utilisation commerciale. Les mentions DIY/non-commercial des README ne remplacent pas une licence formelle.

Badge OSHWA non affiché : une restriction non-commerciale n'est pas une licence open-source matérielle conforme à la définition OSHWA. Il faut d'abord publier des conditions cohérentes, avec attribution et périmètre distincts pour les dérivés MIDIbox et les créations originales.

La documentation de brochage des bus s'appuie sur les pages officielles MIDIbox NG Hardware, DIN, DOUT, AINSER64 et Core STM32F4. Les brochages des cartes custom sont décrits à partir des sources KiCad locales ; ne pas extrapoler le brochage officiel à un connecteur custom sans vérification.

---

Documentation

• 📄 common-docs/README.md — Hub de la documentation générale
• 📄 common-docs/bus-midibox-ng.md — Schéma de principe des bus AIN, DIN et DOUT de MIDIbox NG
• 📁 common-docs/connecteurs/ — Brochage détaillé des connecteurs de bus
• Chaque module standard et chaque front-end possède un README dans son dossier, avec ses limites et les fichiers disponibles
• 🖼️ docs/assets/ — Rendus 3D des PCB (vues top et isométrique)
• 🗺️ PLAN.md — Feuille de route complète du projet (phases 0-10)

---

Retrouvez plus de photos sur Ksir DIY'S — article principal : "ModulBox V2" (mai 2023).

---

⚠️ Avertissement

Ce projet n'est pas réalisé par un professionnel. Les fichiers schématiques, PCB, gerbers et documentations publiés ici sont issus d'un travail amateur, réalisé sur mon temps libre, à des fins personnelles et pédagogiques uniquement.

L'utilisation de ces fichiers ne m'engage à rien. Aucune garantie de conformité, de sécurité, de fonctionnalité n'est donnée, ni implicitement ni explicitement.

Il peut y avoir des erreurs : schématiques incomplètes, erreurs de routage, valeurs de composants inadaptées, impédances non respectées, alimentation insuffisante, isolation électrique non garantie, défauts de sérigraphie, etc. Certaines cartes listées ici sont explicitement marquées comme non fonctionnelles ou non testées.

À vos risques et périls. Vous êtes seul responsable de la fabrication, de l'assemblage, de la mise sous tension et de l'utilisation des fichiers de ce dépôt. Vérifiez systématiquement les schémas, les contraintes de fabrication (épaisseurs de cuivre, empilages, clearances), les chaînages de masse et les tensions avant de fabriquer.

Les droits et conditions de redistribution ne sont pas établis par ce dépôt tant qu'un fichier de licence n'est pas publié. Ce projet n'est pas un support technique, ni un service de conception, ni une référence industrielle.

---

Contribuer

Consulter CONTRIBUTING.md avant de proposer une modification. Les signalements de défauts matériels doivent inclure le chemin du projet, la version de KiCad, le rapport DRC/ERC et les fichiers Gerber concernés.

---

Crédits des modules standards : Thorsten Klose & ucapps.de.
Conception des front-ends : MB MODULBOX NG.> ⚠️ Avertissement : documentation de passion, non professionnelle. Fournie sans garantie ni engagement, sans support technique. Des erreurs sont possibles (schémas, valeurs, câblage, routage). À vos risques et périls : vérifiez tout avant de fabriquer et de mettre sous tension. Le détail complet de l'avertissement figure en fin de fichier.