diff --git a/.github/assembly-sync.json b/.github/assembly-sync.json new file mode 100644 index 0000000..5e7dca6 --- /dev/null +++ b/.github/assembly-sync.json @@ -0,0 +1,9 @@ +{ + "version": 1, + "hubRepository": "researchanddesire/rad-app", + "hubPath": "apps/docs-ohai/content", + "spokeRepository": "researchanddesire/assembly-docs", + "spokePath": "content", + "product": null, + "hubCommit": "1b2e12f7bdef4b8d276ca5f5a015a55d3f347ee2" +} diff --git a/.github/workflows/sync-docs-ohai-content.yml b/.github/workflows/sync-docs-ohai-content.yml index 2155b34..5d940bc 100644 --- a/.github/workflows/sync-docs-ohai-content.yml +++ b/.github/workflows/sync-docs-ohai-content.yml @@ -1,54 +1,51 @@ -name: Request RadApp Ohai Import +name: Notify Assembly Content Hub on: push: - branches: - - main - - staging + branches: [staging, main] paths: - - "content/**" - - ".github/workflows/sync-docs-ohai-content.yml" + - content/** + - .github/assembly-sync.json + - .github/workflows/sync-docs-ohai-content.yml workflow_dispatch: inputs: branch: - description: Branch to synchronize - required: true - default: staging + description: Matching hub release track type: choice - options: - - staging - - main + options: [staging, main] + default: staging permissions: contents: read concurrency: - group: request-rad-app-ohai-import-${{ github.event_name == 'push' && github.ref_name || inputs.branch }} + group: assembly-hub-notification-${{ github.event_name == 'push' && github.ref_name || inputs.branch }} cancel-in-progress: false jobs: - request-import: - if: ${{ github.event_name == 'workflow_dispatch' || !contains(github.event.head_commit.message, '[docs-sync]') }} + notify: runs-on: ubuntu-latest timeout-minutes: 5 - env: - SYNC_BRANCH: ${{ github.event_name == 'push' && github.ref_name || inputs.branch }} steps: - - name: Create documentation sync token - id: app-token + - name: Create token scoped to the hub + id: token uses: actions/create-github-app-token@v2 with: app-id: ${{ vars.RAD_VERSION_CONTROL_APP_ID }} private-key: ${{ secrets.RAD_VERSION_CONTROL_PRIVATE_KEY }} owner: researchanddesire repositories: rad-app - - - name: Request matching RadApp import + - name: Wake hub reconciliation + uses: actions/github-script@v7 env: - GH_TOKEN: ${{ steps.app-token.outputs.token }} - run: | - gh workflow run import-docs-content.yml \ - --repo researchanddesire/rad-app \ - --ref "$SYNC_BRANCH" \ - --field site=assembly \ - --field branch="$SYNC_BRANCH" + SYNC_BRANCH: ${{ github.event_name == 'push' && github.ref_name || inputs.branch }} + with: + github-token: ${{ steps.token.outputs.token }} + script: | + const branch = process.env.SYNC_BRANCH; + if (!['staging', 'main'].includes(branch)) throw new Error('Invalid release track'); + await github.rest.repos.createDispatchEvent({ + owner: 'researchanddesire', repo: 'rad-app', + event_type: 'assembly-content-changed', + client_payload: { repository: `${context.repo.owner}/${context.repo.repo}`, branch } + }); diff --git a/AGENTS.md b/AGENTS.md index 2bffb47..61f5fcb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,5 +1,25 @@ # AGENTS.md +## Current Fumadocs synchronization contract + +`rad-app` is the hub. This repository's `content/**` is the complete, bidirectional +mirror of `rad-app/apps/docs-ohai/content/**`, including all locales and assets. +English product pages use `.en.mdx` and English product metadata `meta.en.json`. +Edit content here and open a PR into `staging`; the notifier wakes the hub after +merge. The hub reconciles changes and opens reviewed sync PRs before propagating +to the four English-only hardware spokes. Never sync directly to hardware repos. + +`.github/assembly-sync.json` is the hub-managed baseline, outside mirrored +content. Do not hand-edit it. Preserve `_bom/` CSV, provenance and generated JSON +together. Workflow authentication uses `RAD_VERSION_CONTROL_APP_ID` and +`RAD_VERSION_CONTROL_PRIVATE_KEY`, scoped to rad-app for notifications. + +Both persistent branches must exist. Normal edits synchronize staging to staging; +main is audited and updated through reviewed staging-to-main promotion. No +direct writes or automatic merges into release branches. The legacy MkDocs +instructions below describe historical tooling only and do not govern the +active Fumadocs content tree. Do not regenerate content from that tooling. + Guidance for future agents working in the `assembly-docs` aggregator repo, especially on BOM rendering. diff --git a/README.md b/README.md index 667a206..b17f2eb 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,27 @@ This repository is the public, editable content mirror for [R+D Assembly](https://ohai.researchanddesire.com). Rendered page titles and section headings link to their exact source lines under `content/docs/`. -Public contributions should target `main`. The dedicated synchronization app mirrors approved content into the private Fumadocs renderer; legacy MkDocs assembly tooling remains below for migration and product-source workflows. +Public contributions should target `staging`. `rad-app` is the synchronization +hub: this repository's entire `content/` tree mirrors +`rad-app/apps/docs-ohai/content/`, including every language and asset. English +product pages use `.en.mdx`; navigation uses `meta.en.json`. The hub strips `.en` +only when exporting to the four English-only hardware repositories. + +Merging content changes sends an `assembly-content-changed` notification to +rad-app. The hub detects concurrent edits against `.github/assembly-sync.json`, +opens a draft import PR, and propagates to affected hardware spokes after that +PR merges. Do not hand-edit the checkpoint. Routine sync targets staging; +main follows reviewed staging-to-main releases. No direct spoke-to-spoke writes. + +The notifier needs the organization's existing `RAD_VERSION_CONTROL_APP_ID` +variable and `RAD_VERSION_CONTROL_PRIVATE_KEY` secret with access to rad-app. +Initial seeding is a separate reviewed action in the hub; it does not overwrite +content merely because this notifier is installed. + +## Historical MkDocs tooling (not the active synchronization pipeline) + +The remaining sections document legacy tooling retained for reference. Do not +use it to regenerate the active `content/` tree or dispatch directly to hardware. Aggregates each hardware product's `assembly-docs/` folder into a single MkDocs Material site, following the same architecture as diff --git a/content/docs/dtt/_bom/bom.csv b/content/docs/dtt/_bom/bom.csv new file mode 100644 index 0000000..90bbdfa --- /dev/null +++ b/content/docs/dtt/_bom/bom.csv @@ -0,0 +1,10 @@ +#,Part Name,Category,Description,Qty,UOM,Manufacturer,MFG PN,Vendor,Vendor PN,Source,Notes +1,DTT PCB assembly,PCA,Rev4 printed circuit board assembly,1,each,–,–,–,–,pcb/diptrace-rev4/pcb-bom-full.csv,PCB child BOM is maintained separately +2,DTT loop velcro,FBO,Loop-side hook-and-loop strip used on the PCB,1,each,–,–,–,–,–,Used on the PCB during assembly +3,3D printed DTT housing,FDM,Printed trainer housing,1,each,–,–,–,–,cad/README.md,Clean interior filament strands before assembly +4,OLED screen,ASM,Display module,1,each,–,–,–,–,–,Remove film before installation +5,Sensor,IC,Position sensor module,1,each,–,–,–,–,–,Install flush with casing +6,Battery,BTY,Lithium battery,1,each,–,–,–,–,–,Install writing-side down +7,Cable harness,CHA,Screen sensor battery and PCB cable harness,1,each,–,–,–,–,–,Connects screen sensor battery and PCB +8,0408LTFB screws,FST,PCB mounting screws,4,each,–,0408LTFB,–,–,–,Used to fasten the PCB to the trainer case +9,Hot glue,ADH,Assembly adhesive,1,application,–,–,–,–,–,Used to secure screen sensor and battery diff --git a/content/docs/dtt/_bom/bom.json b/content/docs/dtt/_bom/bom.json new file mode 100644 index 0000000..c484578 --- /dev/null +++ b/content/docs/dtt/_bom/bom.json @@ -0,0 +1,146 @@ +{ + "repo": "DT_Trainer-OSS", + "commit": "f3233e34e4ebc4cc4b50b1d2d63acc2dd4fd6df9", + "columns": [ + "#", + "Part Name", + "Category", + "Description", + "Qty", + "UOM", + "Manufacturer", + "MFG PN", + "Vendor", + "Vendor PN", + "Source", + "Notes" + ], + "rows": [ + [ + "1", + "DTT PCB assembly", + "PCA", + "Rev4 printed circuit board assembly", + "1", + "each", + "–", + "–", + "–", + "–", + "pcb/diptrace-rev4/pcb-bom-full.csv", + "PCB child BOM is maintained separately" + ], + [ + "2", + "DTT loop velcro", + "FBO", + "Loop-side hook-and-loop strip used on the PCB", + "1", + "each", + "–", + "–", + "–", + "–", + "–", + "Used on the PCB during assembly" + ], + [ + "3", + "3D printed DTT housing", + "FDM", + "Printed trainer housing", + "1", + "each", + "–", + "–", + "–", + "–", + "cad/README.md", + "Clean interior filament strands before assembly" + ], + [ + "4", + "OLED screen", + "ASM", + "Display module", + "1", + "each", + "–", + "–", + "–", + "–", + "–", + "Remove film before installation" + ], + [ + "5", + "Sensor", + "IC", + "Position sensor module", + "1", + "each", + "–", + "–", + "–", + "–", + "–", + "Install flush with casing" + ], + [ + "6", + "Battery", + "BTY", + "Lithium battery", + "1", + "each", + "–", + "–", + "–", + "–", + "–", + "Install writing-side down" + ], + [ + "7", + "Cable harness", + "CHA", + "Screen sensor battery and PCB cable harness", + "1", + "each", + "–", + "–", + "–", + "–", + "–", + "Connects screen sensor battery and PCB" + ], + [ + "8", + "0408LTFB screws", + "FST", + "PCB mounting screws", + "4", + "each", + "–", + "0408LTFB", + "–", + "–", + "–", + "Used to fasten the PCB to the trainer case" + ], + [ + "9", + "Hot glue", + "ADH", + "Assembly adhesive", + "1", + "application", + "–", + "–", + "–", + "–", + "–", + "Used to secure screen sensor and battery" + ] + ] +} diff --git a/content/docs/dtt/_bom/source.json b/content/docs/dtt/_bom/source.json new file mode 100644 index 0000000..81738ef --- /dev/null +++ b/content/docs/dtt/_bom/source.json @@ -0,0 +1,4 @@ +{ + "repo": "DT_Trainer-OSS", + "commit": "f3233e34e4ebc4cc4b50b1d2d63acc2dd4fd6df9" +} diff --git a/content/docs/dtt/assembly-guide.de.mdx b/content/docs/dtt/assembly-guide.de.mdx deleted file mode 100644 index d353cf5..0000000 --- a/content/docs/dtt/assembly-guide.de.mdx +++ /dev/null @@ -1,151 +0,0 @@ ---- -title: "Montageanleitung" -description: "Montageanleitung für Deepthroat Trainer." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## Zweck - -Bauen Sie das aktualisierte All-in-One-Gehäuse des Deepthroat Trainer 2026 aus der vorbereiteten Platine, dem Gehäuse, dem Bildschirm, dem Sensor, dem Akku, dem Kabelbaum, dem Klettband und den Schrauben zusammen. - -## Erforderliche Teile und Verbrauchsmaterialien - -- DTT-Platine -- DTT-Schlaufenklettband -- 3D-gedrucktes DTT-Gehäuse -- Bildschirm -- Sensor -- Akku -- Kabelbaum -- 4x `0408LTFB`-Schrauben -- Heißkleber - -## Werkzeuge - -- Heißklebepistole -- T8-Schrauberbit -- Elektroschrauber oder ähnliches Werkzeug -- Brenner - -## Komponenten vorbereiten - -1. Vergewissern Sie sich, dass das vollständige Set vorhanden ist. - - ![DTT-Bausatz mit Platine, Gehäuse, Bildschirm, Sensor, Akku, Kabelbaum, Klettband und Schrauben](assets/build-kit-overview.webp) - - _DTT-Bausatz._ - -2. Vergewissern Sie sich, dass Platine, Schlaufenklettband und Gehäuse bereit sind. - - Vergewissern Sie sich, dass das DTT-Schlaufenklettband vor dem Fortfahren auf der Platine angebracht ist. - - - - ![Rohe DTT-Platine neben Platine mit Schlaufenklettband](assets/pcb-raw-vs-velcro.webp) - - - ![DTT-Platine mit Schlaufenklettband neben Trainergehäuse](assets/pcb-with-trainer-case.webp) - - - -3. Überprüfen Sie die Innenseite des Trainergehäuses. - - ![Innenseite des Trainergehäuses](assets/trainer-case-interior.webp) - - _Innenseite des Trainergehäuses._ - -4. Reinigen und bereiten Sie alles vor der Montage vor. - - Erhitzen Sie die Innenseite des 3D-Gehäuses vorsichtig mit einem Brenner, um Filamentfäden zu entfernen. Flashen Sie die Platine vor der Montage. - -## Montageschritte - -1. Installieren Sie den Bildschirm. - - Entfernen Sie die Folie vom Bildschirm. Biegen Sie das Flachbandkabel vorsichtig nach innen. Richten Sie den Bildschirm an den Passmarkierungen aus und kleben Sie ihn mit Heißkleber fest. Achten Sie darauf, dass der Heißkleber den Tastenarm nicht blockiert. - - ![Bildschirm im Trainergehäuse installiert](assets/display-installed-in-case.webp) - - _Bildschirm im Gehäuse installiert._ - -2. Installieren Sie den Sensor. - - Setzen Sie den Sensor vorsichtig mit einem Schraubendreher in das Gehäuse ein. Drücken Sie dabei auf die silbernen Schrauben, um zusätzlichen Druck auszuüben, ohne den Kunststoff zu beschädigen. Achten Sie darauf, dass der Sensor bündig mit dem Gehäuse abschließt. Kleben Sie ihn mit Heißkleber fest. - - - - ![Sensor mit einem Schraubendreher in das Trainergehäuse einsetzen](assets/sensor-insertion-with-screwdriver.webp) - - - ![Sensor bündig im Trainergehäuse installiert](assets/sensor-installed-flush.webp) - - - -3. Installieren Sie den Akku. - - Legen Sie den Akku mit der beschrifteten Seite nach unten ein. Tragen Sie eine Kleberaupe entlang der oberen Leiste auf, um ihn zu befestigen. - - ![Akku mit der beschrifteten Seite nach unten im Trainergehäuse installiert](assets/battery-installed-writing-down.webp) - - _Akku mit der beschrifteten Seite nach unten installiert._ - -4. Verbinden Sie den Bildschirm- und Sensorkabelbaum. - - Schieben Sie den schwarzen Kabelbaumstecker wie abgebildet über die Bildschirmstifte. Klipsen Sie den weißen Stecker in den Sensor. - - ![Kabelbaum mit den Bildschirmstiften und dem Sensor verbunden](assets/display-sensor-harness-connected.webp) - - _Bildschirmstifte und Sensor mit dem Kabelbaum verbunden._ - -5. Verbinden Sie den Kabelbaum mit der Platine. - - Stecken Sie die Kabelbaumstecker in die entsprechenden Steckverbinder der Platine. - - ![Kabelbaum mit den DTT-Platinensteckern verbunden](assets/harness-connected-to-pcb.webp) - - _Kabelbaum mit der Platine verbunden._ - -6. Verlegen Sie die Drähte. - - Führen Sie die Drähte wie abgebildet um den Stift herum und schieben Sie sie tiefer in das Gehäuse. Vermeiden Sie dabei die Taste und andere Quetschstellen. - - ![Drähte um den Stift im Trainergehäuse verlegt](assets/wires-routed-around-peg.webp) - - _Drähte um den Stift verlegt._ - -7. Befestigen Sie die Platine am Trainergehäuse. - - Befestigen Sie die Platine mit dem Schraubendreher am Trainergehäuse. - - ![Platine wird mit einem Schraubendreher am Trainergehäuse befestigt](assets/pcb-fastened-to-case.webp) - - _Platine am Trainergehäuse befestigen._ - -## Endmontage - -1. Vergewissern Sie sich, dass der Bildschirm festgeklebt ist und der Tastenarm nicht blockiert wird. -2. Vergewissern Sie sich, dass der Sensor bündig mit dem Gehäuse abschließt und festgeklebt ist. -3. Vergewissern Sie sich, dass der Akku mit der beschrifteten Seite nach unten befestigt ist. -4. Vergewissern Sie sich, dass der Kabelbaum mit Bildschirm, Sensor und Platine verbunden ist. -5. Vergewissern Sie sich, dass die Drähte um den Stift herum und von der Taste und den Quetschstellen weg verlegt sind. -6. Vergewissern Sie sich, dass die Platine mit den vier `0408LTFB`-Schrauben am Trainergehäuse befestigt ist. - -## QC-Checkliste - -- [ ] Die Platine wurde vor der Montage geflasht. -- [ ] Filamentfäden im Inneren wurden aus dem 3D-gedruckten Gehäuse entfernt. -- [ ] Die Bildschirmfolie wurde entfernt. -- [ ] Das Bildschirm-Flachbandkabel wurde vorsichtig nach innen gebogen. -- [ ] Der Bildschirm wurde an den Passmarkierungen ausgerichtet. -- [ ] Der Heißkleber blockiert den Tastenarm nicht. -- [ ] Der Sensor schließt bündig mit dem Gehäuse ab. -- [ ] Der Sensor ist festgeklebt. -- [ ] Der Akku ist mit der beschrifteten Seite nach unten eingesetzt. -- [ ] Der Akku ist mit Kleber entlang der oberen Leiste befestigt. -- [ ] Der schwarze Kabelbaumstecker sitzt über den Bildschirmstiften. -- [ ] Der weiße Stecker ist in den Sensor geklipst. -- [ ] Die Kabelbaumstecker sitzen in den Platinen-Steckverbindern. -- [ ] Die Drähte sind um den Stift verlegt. -- [ ] Die Drähte sind tiefer in das Gehäuse geschoben und vermeiden Taste und Quetschstellen. -- [ ] Die Platine ist am Trainergehäuse befestigt. diff --git a/content/docs/dtt/assembly-guide.en.mdx b/content/docs/dtt/assembly-guide.en.mdx new file mode 100644 index 0000000..cfdab46 --- /dev/null +++ b/content/docs/dtt/assembly-guide.en.mdx @@ -0,0 +1,148 @@ +--- +title: Assembly Guide +--- + +## Purpose + +Assemble the Deepthroat Trainer 2026 updated all-in-one case build from the prepared PCB, housing, screen, sensor, battery, cable harness, velcro, and screws. + +## Required Parts and Consumables + +- DTT PCB +- DTT loop velcro +- 3D printed DTT housing +- Screen +- Sensor +- Battery +- Cable harness +- 4x `0408LTFB` screws +- Hot glue + +## Tools + +- Hot glue gun +- T8 screwdriver bit +- Electric screwdriver or similar +- Torch + +## Prepare Components + +1. Confirm the full kit is present. + + + DTT build kit with PCB, housing, screen, sensor, battery, harness, velcro, and screws + + +2. Confirm the PCB, loop velcro, and housing are ready. + + Confirm the DTT loop velcro is installed on the PCB before continuing. + + + + Raw DTT PCB next to PCB with loop velcro + + + DTT PCB with loop velcro next to trainer case + + + +3. Inspect the inside of the trainer case. + + + Inside of the trainer case + + +4. Clean and prepare before assembly. + + Gently torch inside of the 3D housing to remove filament strands. Flash the PCB before assembly. + +## Assembly Steps + +1. Install the screen. + + Remove the film from the screen. Bend the ribbon gently inwards. Align the screen with the registration features and glue it into place with hot glue. Ensure the hot glue does not block the button arm. + + + Screen installed in the trainer case + + +2. Install the sensor. + + Use a screwdriver to gently insert the sensor into the casing, pressing on the silver screws to add force without breaking the plastic. Make sure the sensor lays flush with the casing. Glue it into place with hot glue. + + + + Using a screwdriver to insert the sensor into the trainer casing + + + Sensor installed flush in the trainer casing + + + +3. Install the battery. + + Insert the battery writing-side down. Run a bead of glue along the top bar to secure it in place. + + + Battery installed writing-side down in the trainer case + + +4. Connect the screen and sensor harness. + + Slide the black harness connector over the screen pins as shown. Clip the white connector into the sensor. + + + Cable harness connected to the screen pins and sensor + + +5. Connect the harness to the PCB. + + Clip the harness into the PCB using the appropriate connectors. + + + Cable harness connected to the DTT PCB connectors + + +6. Route the wires. + + Route the wires around the peg as shown, and push the wires deeper into the housing, avoiding the button and other pinch points. + + + Wires routed around the peg inside the trainer housing + + +7. Fasten the PCB to the trainer case. + + Use the screwdriver to fasten the PCB to the trainer case. + + + PCB being fastened to the trainer case with a screwdriver + + +## Final Assembly + +1. Confirm the screen is glued in place and the button arm is not blocked. +2. Confirm the sensor is flush with the casing and glued in place. +3. Confirm the battery is secured writing-side down. +4. Confirm the harness is connected to the screen, sensor, and PCB. +5. Confirm wires are routed around the peg and pushed away from the button and pinch points. +6. Confirm the PCB is fastened to the trainer case with the four `0408LTFB` screws. + +## QC Checklist + +- [ ] PCB was flashed before assembly. +- [ ] Interior filament strands were removed from the 3D printed housing. +- [ ] Screen film was removed. +- [ ] Screen ribbon was bent gently inward. +- [ ] Screen was aligned with registration features. +- [ ] Hot glue does not block the button arm. +- [ ] Sensor lays flush with the casing. +- [ ] Sensor is glued in place. +- [ ] Battery is installed writing-side down. +- [ ] Battery is secured with glue along the top bar. +- [ ] Black harness connector is seated over the screen pins. +- [ ] White connector is clipped into the sensor. +- [ ] Harness is clipped into the PCB connectors. +- [ ] Wires are routed around the peg. +- [ ] Wires are pushed deeper into the housing and avoid the button and pinch points. +- [ ] PCB is fastened to the trainer case. diff --git a/content/docs/dtt/assembly-guide.fr.mdx b/content/docs/dtt/assembly-guide.fr.mdx deleted file mode 100644 index 1f48c77..0000000 --- a/content/docs/dtt/assembly-guide.fr.mdx +++ /dev/null @@ -1,151 +0,0 @@ ---- -title: "Guide d’assemblage" -description: "Guide d’assemblage pour Deepthroat Trainer." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## Objectif - -Assemblez le boîtier tout-en-un mis à jour du Deepthroat Trainer 2026 à partir du PCB préparé, du boîtier, de l’écran, du capteur, de la batterie, du faisceau de câbles, du velcro et des vis. - -## Pièces et consommables requis - -- PCB DTT -- Velcro à boucles DTT -- Boîtier DTT imprimé en 3D -- Écran -- Capteur -- Batterie -- Faisceau de câbles -- 4x vis `0408LTFB` -- Colle chaude - -## Outils - -- Pistolet à colle chaude -- Embout de tournevis T8 -- Tournevis électrique ou similaire -- Chalumeau - -## Préparer les composants - -1. Confirmez que le kit complet est présent. - - ![Kit d’assemblage DTT avec PCB, boîtier, écran, capteur, batterie, faisceau, velcro et vis](assets/build-kit-overview.webp) - - _Kit d’assemblage DTT._ - -2. Confirmez que le PCB, le velcro à boucles et le boîtier sont prêts. - - Confirmez que le velcro à boucles DTT est installé sur le PCB avant de continuer. - - - - ![PCB DTT brut à côté du PCB avec velcro à boucles](assets/pcb-raw-vs-velcro.webp) - - - ![PCB DTT avec velcro à boucles à côté du boîtier du Deepthroat Trainer](assets/pcb-with-trainer-case.webp) - - - -3. Inspectez l’intérieur du boîtier du Deepthroat Trainer. - - ![Intérieur du boîtier du Deepthroat Trainer](assets/trainer-case-interior.webp) - - _Intérieur du boîtier du Deepthroat Trainer._ - -4. Nettoyez et préparez les composants avant l’assemblage. - - Chauffez délicatement l’intérieur du boîtier 3D avec un chalumeau pour retirer les brins de filament. Flashez le PCB avant l’assemblage. - -## Étapes d’assemblage - -1. Installez l’écran. - - Retirez le film de l’écran. Pliez doucement la nappe vers l’intérieur. Alignez l’écran sur les repères de positionnement et collez-le avec de la colle chaude. Assurez-vous que la colle chaude ne bloque pas le bras du bouton. - - ![Écran installé dans le boîtier du Deepthroat Trainer](assets/display-installed-in-case.webp) - - _Écran installé dans le boîtier._ - -2. Installez le capteur. - - Utilisez un tournevis pour insérer délicatement le capteur dans le boîtier, en appuyant sur les vis argentées pour augmenter la force exercée sans casser le plastique. Assurez-vous que le capteur affleure le boîtier. Collez-le avec de la colle chaude. - - - - ![Insertion du capteur dans le boîtier du Deepthroat Trainer avec un tournevis](assets/sensor-insertion-with-screwdriver.webp) - - - ![Capteur installé au ras du boîtier du Deepthroat Trainer](assets/sensor-installed-flush.webp) - - - -3. Installez la batterie. - - Insérez la batterie, côté écrit vers le bas. Appliquez un cordon de colle le long de la barre supérieure pour la maintenir en place. - - ![Batterie installée côté écrit vers le bas dans le boîtier du Deepthroat Trainer](assets/battery-installed-writing-down.webp) - - _Batterie installée côté écrit vers le bas._ - -4. Connectez le faisceau de l’écran et du capteur. - - Faites glisser le connecteur noir du faisceau sur les broches de l’écran comme indiqué. Clipsez le connecteur blanc dans le capteur. - - ![Faisceau connecté aux broches de l’écran et au capteur](assets/display-sensor-harness-connected.webp) - - _Broches de l’écran et capteur connectés au faisceau._ - -5. Connectez le faisceau au PCB. - - Clipsez les connecteurs du faisceau dans les connecteurs correspondants du PCB. - - ![Faisceau connecté aux connecteurs du PCB DTT](assets/harness-connected-to-pcb.webp) - - _Faisceau connecté au PCB._ - -6. Acheminez les fils. - - Acheminez les fils autour de l’ergot comme indiqué et poussez-les plus profondément dans le boîtier, en évitant le bouton et les autres points de pincement. - - ![Fils acheminés autour de l’ergot à l’intérieur du boîtier du Deepthroat Trainer](assets/wires-routed-around-peg.webp) - - _Fils acheminés autour de l’ergot._ - -7. Fixez le PCB au boîtier du Deepthroat Trainer. - - Utilisez le tournevis pour fixer le PCB au boîtier du Deepthroat Trainer. - - ![PCB fixé au boîtier du Deepthroat Trainer avec un tournevis](assets/pcb-fastened-to-case.webp) - - _Fixez le PCB au boîtier du Deepthroat Trainer._ - -## Assemblage final - -1. Vérifiez que l’écran est collé en place et que le bras du bouton n’est pas bloqué. -2. Vérifiez que le capteur affleure le boîtier et est collé en place. -3. Vérifiez que la batterie est fixée, côté écrit vers le bas. -4. Vérifiez que le faisceau est connecté à l’écran, au capteur et au PCB. -5. Vérifiez que les fils sont acheminés autour de l’ergot et éloignés du bouton et des points de pincement. -6. Vérifiez que le PCB est fixé au boîtier du Deepthroat Trainer avec les quatre vis `0408LTFB`. - -## Liste de contrôle qualité - -- [ ] Le PCB a été flashé avant l’assemblage. -- [ ] Les brins de filament intérieurs ont été retirés du boîtier imprimé en 3D. -- [ ] Le film de l’écran a été retiré. -- [ ] La nappe de l’écran a été doucement pliée vers l’intérieur. -- [ ] L’écran a été aligné sur les repères de positionnement. -- [ ] La colle chaude ne bloque pas le bras du bouton. -- [ ] Le capteur affleure le boîtier. -- [ ] Le capteur est collé en place. -- [ ] La batterie est installée côté écrit vers le bas. -- [ ] La batterie est fixée avec de la colle le long de la barre supérieure. -- [ ] Le connecteur noir du faisceau est placé sur les broches de l’écran. -- [ ] Le connecteur blanc est clipsé dans le capteur. -- [ ] Le faisceau est clipsé dans les connecteurs du PCB. -- [ ] Les fils sont acheminés autour de l’ergot. -- [ ] Les fils sont poussés plus profondément dans le boîtier et évitent le bouton et les points de pincement. -- [ ] Le PCB est fixé au boîtier du Deepthroat Trainer. diff --git a/content/docs/dtt/assembly-guide.mdx b/content/docs/dtt/assembly-guide.mdx deleted file mode 100644 index 7c2833c..0000000 --- a/content/docs/dtt/assembly-guide.mdx +++ /dev/null @@ -1,151 +0,0 @@ ---- -title: "Assembly Guide" -description: "Assembly Guide for Deepthroat Trainer." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## Purpose - -Assemble the Deepthroat Trainer 2026 updated all-in-one case build from the prepared PCB, housing, screen, sensor, battery, cable harness, velcro, and screws. - -## Required Parts and Consumables - -- DTT PCB -- DTT loop velcro -- 3D printed DTT housing -- Screen -- Sensor -- Battery -- Cable harness -- 4x `0408LTFB` screws -- Hot glue - -## Tools - -- Hot glue gun -- T8 screwdriver bit -- Electric screwdriver or similar -- Torch - -## Prepare Components - -1. Confirm the full kit is present. - - ![DTT build kit with PCB, housing, screen, sensor, battery, harness, velcro, and screws](assets/build-kit-overview.webp) - - _DTT build kit._ - -2. Confirm the PCB, loop velcro, and housing are ready. - - Confirm the DTT loop velcro is installed on the PCB before continuing. - - - - ![Raw DTT PCB next to PCB with loop velcro](assets/pcb-raw-vs-velcro.webp) - - - ![DTT PCB with loop velcro next to trainer case](assets/pcb-with-trainer-case.webp) - - - -3. Inspect the inside of the trainer case. - - ![Inside of the trainer case](assets/trainer-case-interior.webp) - - _Inside of the trainer case._ - -4. Clean and prepare before assembly. - - Gently torch inside of the 3D housing to remove filament strands. Flash the PCB before assembly. - -## Assembly Steps - -1. Install the screen. - - Remove the film from the screen. Bend the ribbon gently inwards. Align the screen with the registration features and glue it into place with hot glue. Ensure the hot glue does not block the button arm. - - ![Screen installed in the trainer case](assets/display-installed-in-case.webp) - - _Screen installed in the case._ - -2. Install the sensor. - - Use a screwdriver to gently insert the sensor into the casing, pressing on the silver screws to add force without breaking the plastic. Make sure the sensor lays flush with the casing. Glue it into place with hot glue. - - - - ![Using a screwdriver to insert the sensor into the trainer casing](assets/sensor-insertion-with-screwdriver.webp) - - - ![Sensor installed flush in the trainer casing](assets/sensor-installed-flush.webp) - - - -3. Install the battery. - - Insert the battery writing-side down. Run a bead of glue along the top bar to secure it in place. - - ![Battery installed writing-side down in the trainer case](assets/battery-installed-writing-down.webp) - - _Battery installed writing-side down._ - -4. Connect the screen and sensor harness. - - Slide the black harness connector over the screen pins as shown. Clip the white connector into the sensor. - - ![Cable harness connected to the screen pins and sensor](assets/display-sensor-harness-connected.webp) - - _Screen pins and sensor connected to the harness._ - -5. Connect the harness to the PCB. - - Clip the harness into the PCB using the appropriate connectors. - - ![Cable harness connected to the DTT PCB connectors](assets/harness-connected-to-pcb.webp) - - _Harness connected to the PCB._ - -6. Route the wires. - - Route the wires around the peg as shown, and push the wires deeper into the housing, avoiding the button and other pinch points. - - ![Wires routed around the peg inside the trainer housing](assets/wires-routed-around-peg.webp) - - _Wires routed around the peg._ - -7. Fasten the PCB to the trainer case. - - Use the screwdriver to fasten the PCB to the trainer case. - - ![PCB being fastened to the trainer case with a screwdriver](assets/pcb-fastened-to-case.webp) - - _Fasten the PCB to the trainer case._ - -## Final Assembly - -1. Confirm the screen is glued in place and the button arm is not blocked. -2. Confirm the sensor is flush with the casing and glued in place. -3. Confirm the battery is secured writing-side down. -4. Confirm the harness is connected to the screen, sensor, and PCB. -5. Confirm wires are routed around the peg and pushed away from the button and pinch points. -6. Confirm the PCB is fastened to the trainer case with the four `0408LTFB` screws. - -## QC Checklist - -- [ ] PCB was flashed before assembly. -- [ ] Interior filament strands were removed from the 3D printed housing. -- [ ] Screen film was removed. -- [ ] Screen ribbon was bent gently inward. -- [ ] Screen was aligned with registration features. -- [ ] Hot glue does not block the button arm. -- [ ] Sensor lays flush with the casing. -- [ ] Sensor is glued in place. -- [ ] Battery is installed writing-side down. -- [ ] Battery is secured with glue along the top bar. -- [ ] Black harness connector is seated over the screen pins. -- [ ] White connector is clipped into the sensor. -- [ ] Harness is clipped into the PCB connectors. -- [ ] Wires are routed around the peg. -- [ ] Wires are pushed deeper into the housing and avoid the button and pinch points. -- [ ] PCB is fastened to the trainer case. diff --git a/content/docs/dtt/assembly-guide.nl.mdx b/content/docs/dtt/assembly-guide.nl.mdx deleted file mode 100644 index 27a565c..0000000 --- a/content/docs/dtt/assembly-guide.nl.mdx +++ /dev/null @@ -1,151 +0,0 @@ ---- -title: "Montagehandleiding" -description: "Montagehandleiding voor Deepthroat Trainer." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## Doel - -Monteer de bijgewerkte alles-in-één-behuizing van de Deepthroat Trainer 2026 met de voorbereide printplaat, behuizing, scherm, sensor, batterij, kabelboom, klittenband en schroeven. - -## Benodigde onderdelen en verbruiksartikelen - -- DTT-printplaat -- DTT-lusklittenband -- 3D-geprinte DTT-behuizing -- Scherm -- Sensor -- Batterij -- Kabelboom -- 4x `0408LTFB`-schroeven -- Hete lijm - -## Gereedschap - -- Heetlijmpistool -- T8-schroevendraaierbit -- Elektrische schroevendraaier of vergelijkbaar gereedschap -- Brander - -## Componenten voorbereiden - -1. Controleer of de volledige set aanwezig is. - - ![DTT-bouwpakket met printplaat, behuizing, scherm, sensor, batterij, kabelboom, klittenband en schroeven](assets/build-kit-overview.webp) - - _DTT-bouwpakket._ - -2. Controleer of de printplaat, het lusklittenband en de behuizing klaar zijn. - - Controleer voordat u doorgaat of het DTT-lusklittenband op de printplaat is aangebracht. - - - - ![Onbewerkte DTT-printplaat naast printplaat met lusklittenband](assets/pcb-raw-vs-velcro.webp) - - - ![DTT-printplaat met lusklittenband naast trainerbehuizing](assets/pcb-with-trainer-case.webp) - - - -3. Inspecteer de binnenkant van de trainerbehuizing. - - ![Binnenkant van de trainerbehuizing](assets/trainer-case-interior.webp) - - _Binnenkant van de trainerbehuizing._ - -4. Reinig en bereid alles vóór de montage voor. - - Verwarm de binnenkant van de 3D-behuizing voorzichtig met een brander om filamentdraden te verwijderen. Flash de printplaat vóór de montage. - -## Montagestappen - -1. Installeer het scherm. - - Verwijder de folie van het scherm. Buig de lintkabel voorzichtig naar binnen. Lijn het scherm uit met de uitlijningsmarkeringen en lijm het met hete lijm vast. Zorg ervoor dat de hete lijm de knoparm niet blokkeert. - - ![Scherm geïnstalleerd in de trainerbehuizing](assets/display-installed-in-case.webp) - - _Scherm geïnstalleerd in de behuizing._ - -2. Installeer de sensor. - - Gebruik een schroevendraaier om de sensor voorzichtig in de behuizing te plaatsen. Druk daarbij op de zilveren schroeven om extra kracht uit te oefenen zonder het plastic te breken. Zorg ervoor dat de sensor vlak met de behuizing ligt. Lijm hem met hete lijm vast. - - - - ![Een sensor met een schroevendraaier in de trainerbehuizing plaatsen](assets/sensor-insertion-with-screwdriver.webp) - - - ![Sensor vlak in de trainerbehuizing geïnstalleerd](assets/sensor-installed-flush.webp) - - - -3. Installeer de batterij. - - Plaats de batterij met de bedrukte zijde naar beneden. Breng een lijmrups aan langs de bovenste balk om de batterij vast te zetten. - - ![Batterij met de bedrukte zijde naar beneden in de trainerbehuizing geïnstalleerd](assets/battery-installed-writing-down.webp) - - _Batterij met de bedrukte zijde naar beneden geïnstalleerd._ - -4. Sluit de kabelboom aan op het scherm en de sensor. - - Schuif de zwarte kabelboomconnector zoals afgebeeld over de schermpinnen. Klik de witte connector in de sensor. - - ![Kabelboom aangesloten op de schermpinnen en sensor](assets/display-sensor-harness-connected.webp) - - _Schermpinnen en sensor aangesloten op de kabelboom._ - -5. Sluit de kabelboom aan op de printplaat. - - Klik de connectoren van de kabelboom in de juiste aansluitingen op de printplaat. - - ![Kabelboom aangesloten op de DTT-printplaatconnectoren](assets/harness-connected-to-pcb.webp) - - _Kabelboom aangesloten op de printplaat._ - -6. Leid de draden. - - Leid de draden zoals afgebeeld rond de nok en duw ze dieper in de behuizing. Vermijd daarbij de knop en andere knelpunten. - - ![Draden rond de nok in de trainerbehuizing geleid](assets/wires-routed-around-peg.webp) - - _Draden rond de nok geleid._ - -7. Bevestig de printplaat aan de trainerbehuizing. - - Gebruik de schroevendraaier om de printplaat aan de trainerbehuizing te bevestigen. - - ![Printplaat met een schroevendraaier aan de trainerbehuizing bevestigd](assets/pcb-fastened-to-case.webp) - - _Printplaat aan de trainerbehuizing bevestigen._ - -## Eindmontage - -1. Controleer of het scherm is vastgelijmd en de knoparm niet wordt geblokkeerd. -2. Controleer of de sensor vlak met de behuizing ligt en is vastgelijmd. -3. Controleer of de batterij met de bedrukte zijde naar beneden is vastgezet. -4. Controleer of de kabelboom op het scherm, de sensor en de printplaat is aangesloten. -5. Controleer of de draden rond de nok en weg van de knop en knelpunten zijn geleid. -6. Controleer of de printplaat met de vier `0408LTFB`-schroeven aan de trainerbehuizing is bevestigd. - -## QC-checklist - -- [ ] De printplaat is vóór de montage geflasht. -- [ ] Filamentdraden aan de binnenkant zijn uit de 3D-geprinte behuizing verwijderd. -- [ ] De schermfolie is verwijderd. -- [ ] De lintkabel van het scherm is voorzichtig naar binnen gebogen. -- [ ] Het scherm is uitgelijnd met de uitlijningsmarkeringen. -- [ ] De hete lijm blokkeert de knoparm niet. -- [ ] De sensor ligt vlak met de behuizing. -- [ ] De sensor is vastgelijmd. -- [ ] De batterij is met de bedrukte zijde naar beneden geplaatst. -- [ ] De batterij is met lijm langs de bovenste balk vastgezet. -- [ ] De zwarte kabelboomconnector zit over de schermpinnen. -- [ ] De witte connector is in de sensor geklikt. -- [ ] De kabelboomconnectoren zitten in de juiste aansluitingen op de printplaat. -- [ ] De draden zijn rond de nok geleid. -- [ ] De draden zijn dieper in de behuizing geduwd en vermijden de knop en knelpunten. -- [ ] De printplaat is aan de trainerbehuizing bevestigd. diff --git a/content/docs/dtt/assets/battery-installed-writing-down.png b/content/docs/dtt/assets/battery-installed-writing-down.png new file mode 100644 index 0000000..f5cceb1 Binary files /dev/null and b/content/docs/dtt/assets/battery-installed-writing-down.png differ diff --git a/content/docs/dtt/assets/battery-installed-writing-down.webp b/content/docs/dtt/assets/battery-installed-writing-down.webp deleted file mode 100644 index e98b194..0000000 Binary files a/content/docs/dtt/assets/battery-installed-writing-down.webp and /dev/null differ diff --git a/content/docs/dtt/assets/build-kit-overview.png b/content/docs/dtt/assets/build-kit-overview.png new file mode 100644 index 0000000..862cfcb Binary files /dev/null and b/content/docs/dtt/assets/build-kit-overview.png differ diff --git a/content/docs/dtt/assets/build-kit-overview.webp b/content/docs/dtt/assets/build-kit-overview.webp deleted file mode 100644 index 048fbeb..0000000 Binary files a/content/docs/dtt/assets/build-kit-overview.webp and /dev/null differ diff --git a/content/docs/dtt/assets/display-installed-in-case.png b/content/docs/dtt/assets/display-installed-in-case.png new file mode 100644 index 0000000..78adf5c Binary files /dev/null and b/content/docs/dtt/assets/display-installed-in-case.png differ diff --git a/content/docs/dtt/assets/display-installed-in-case.webp b/content/docs/dtt/assets/display-installed-in-case.webp deleted file mode 100644 index de029d9..0000000 Binary files a/content/docs/dtt/assets/display-installed-in-case.webp and /dev/null differ diff --git a/content/docs/dtt/assets/display-sensor-harness-connected.png b/content/docs/dtt/assets/display-sensor-harness-connected.png new file mode 100644 index 0000000..3ffee53 Binary files /dev/null and b/content/docs/dtt/assets/display-sensor-harness-connected.png differ diff --git a/content/docs/dtt/assets/display-sensor-harness-connected.webp b/content/docs/dtt/assets/display-sensor-harness-connected.webp deleted file mode 100644 index d4fae54..0000000 Binary files a/content/docs/dtt/assets/display-sensor-harness-connected.webp and /dev/null differ diff --git a/content/docs/dtt/assets/harness-connected-to-pcb.png b/content/docs/dtt/assets/harness-connected-to-pcb.png new file mode 100644 index 0000000..eda5123 Binary files /dev/null and b/content/docs/dtt/assets/harness-connected-to-pcb.png differ diff --git a/content/docs/dtt/assets/harness-connected-to-pcb.webp b/content/docs/dtt/assets/harness-connected-to-pcb.webp deleted file mode 100644 index 0ea20c9..0000000 Binary files a/content/docs/dtt/assets/harness-connected-to-pcb.webp and /dev/null differ diff --git a/content/docs/dtt/assets/pcb-fastened-to-case.png b/content/docs/dtt/assets/pcb-fastened-to-case.png new file mode 100644 index 0000000..496a9af Binary files /dev/null and b/content/docs/dtt/assets/pcb-fastened-to-case.png differ diff --git a/content/docs/dtt/assets/pcb-fastened-to-case.webp b/content/docs/dtt/assets/pcb-fastened-to-case.webp deleted file mode 100644 index e0d0670..0000000 Binary files a/content/docs/dtt/assets/pcb-fastened-to-case.webp and /dev/null differ diff --git a/content/docs/dtt/assets/pcb-raw-vs-velcro.png b/content/docs/dtt/assets/pcb-raw-vs-velcro.png new file mode 100644 index 0000000..db8d1b3 Binary files /dev/null and b/content/docs/dtt/assets/pcb-raw-vs-velcro.png differ diff --git a/content/docs/dtt/assets/pcb-raw-vs-velcro.webp b/content/docs/dtt/assets/pcb-raw-vs-velcro.webp deleted file mode 100644 index 7b2847c..0000000 Binary files a/content/docs/dtt/assets/pcb-raw-vs-velcro.webp and /dev/null differ diff --git a/content/docs/dtt/assets/pcb-with-trainer-case.png b/content/docs/dtt/assets/pcb-with-trainer-case.png new file mode 100644 index 0000000..79b6b56 Binary files /dev/null and b/content/docs/dtt/assets/pcb-with-trainer-case.png differ diff --git a/content/docs/dtt/assets/pcb-with-trainer-case.webp b/content/docs/dtt/assets/pcb-with-trainer-case.webp deleted file mode 100644 index 43e9bd0..0000000 Binary files a/content/docs/dtt/assets/pcb-with-trainer-case.webp and /dev/null differ diff --git a/content/docs/dtt/assets/sensor-insertion-with-screwdriver.png b/content/docs/dtt/assets/sensor-insertion-with-screwdriver.png new file mode 100644 index 0000000..216120d Binary files /dev/null and b/content/docs/dtt/assets/sensor-insertion-with-screwdriver.png differ diff --git a/content/docs/dtt/assets/sensor-insertion-with-screwdriver.webp b/content/docs/dtt/assets/sensor-insertion-with-screwdriver.webp deleted file mode 100644 index 936b84e..0000000 Binary files a/content/docs/dtt/assets/sensor-insertion-with-screwdriver.webp and /dev/null differ diff --git a/content/docs/dtt/assets/sensor-installed-flush.png b/content/docs/dtt/assets/sensor-installed-flush.png new file mode 100644 index 0000000..629ef06 Binary files /dev/null and b/content/docs/dtt/assets/sensor-installed-flush.png differ diff --git a/content/docs/dtt/assets/sensor-installed-flush.webp b/content/docs/dtt/assets/sensor-installed-flush.webp deleted file mode 100644 index 8b7262e..0000000 Binary files a/content/docs/dtt/assets/sensor-installed-flush.webp and /dev/null differ diff --git a/content/docs/dtt/assets/trainer-case-interior.png b/content/docs/dtt/assets/trainer-case-interior.png new file mode 100644 index 0000000..856a254 Binary files /dev/null and b/content/docs/dtt/assets/trainer-case-interior.png differ diff --git a/content/docs/dtt/assets/trainer-case-interior.webp b/content/docs/dtt/assets/trainer-case-interior.webp deleted file mode 100644 index 62c4cbd..0000000 Binary files a/content/docs/dtt/assets/trainer-case-interior.webp and /dev/null differ diff --git a/content/docs/dtt/assets/wires-routed-around-peg.png b/content/docs/dtt/assets/wires-routed-around-peg.png new file mode 100644 index 0000000..a4fc942 Binary files /dev/null and b/content/docs/dtt/assets/wires-routed-around-peg.png differ diff --git a/content/docs/dtt/assets/wires-routed-around-peg.webp b/content/docs/dtt/assets/wires-routed-around-peg.webp deleted file mode 100644 index d01112d..0000000 Binary files a/content/docs/dtt/assets/wires-routed-around-peg.webp and /dev/null differ diff --git a/content/docs/dtt/bill-of-materials.de.mdx b/content/docs/dtt/bill-of-materials.de.mdx deleted file mode 100644 index 543b9b2..0000000 --- a/content/docs/dtt/bill-of-materials.de.mdx +++ /dev/null @@ -1,611 +0,0 @@ ---- -title: "Stückliste" -description: "Stückliste für Deepthroat Trainer." ---- - -{/* Ported from MkDocs: bom.md */} - -Der Deepthroat Trainer verwendet eine bestückte Leiterplattenbaugruppe mit externem Bildschirm, Sensor, Akku, Kabelbaum, Schlaufenklettband, 3D-gedrucktem Gehäuse, Schrauben und Montagekleber, die für den All-in-One-Gehäuseaufbau erforderlich sind. - -## Teile - -Diese Tabelle wird während des `assembly-docs`-Builds aus [hardware/bom.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv) generiert. Aktualisieren Sie die CSV-Datei, anstatt die generierte Tabelle manuell zu bearbeiten. - -{/* BEGIN GENERATED BOM */} - -
-
-
Repository
-
- -DT_Trainer-OSS - -
-
Quellen-Commit
-
- -bc9861f -{" "} - - (bc9861f47144ef641f495cc9edf52273063967bb) - -
-
-
-Für die Produktion freigegeben. Diese Stückliste entspricht einer getaggten - Hardware-Version. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- # - - Teilename - - Kategorie - - Beschreibung - - Menge - - UOM - - Hersteller - - MFG PN - - Anbieter - - PN des Anbieters - - Quelle - - Notizen -
1 -
- DTT-Platinenbaugruppe -
-		 - -PCA - - -
-Rev4-Platinenbaugruppe -
-		1Stück -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
-Die untergeordnete PCB-Stückliste wird separat verwaltet -
-
2 -
- DTT-Schlaufenklettband -
-		 - -FBO - - -
-Schlaufenseitiger Klettbandstreifen für die Platine -
-		1Stück -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Wird während der Montage auf der Leiterplatte verwendet -
-
3 -
- 3D-gedrucktes DTT-Gehäuse -
-		 - -FDM - - -
- 3D-gedrucktes Trainergehäuse -
-		1Stück -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
-Reinigen Sie die inneren Filamentstränge vor dem Zusammenbau -
-
4 -
- OLED-Bildschirm -
-		 - -ASM - - -
- Anzeigemodul -
-		1Stück -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Folie vor der Montage entfernen -
-
5 -
- Sensor -
-		 - -IC - - -
- Positionssensormodul -
-		1Stück -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Bündig mit dem Gehäuse einbauen -
-
6 -
- Akku -
-		 - -BTY - - -
- Lithium-Akku -
-		1Stück -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Mit der beschrifteten Seite nach unten installieren -
-
7 -
- Kabelbaum -
-		 - -CHA - - -
-Kabelbaum für Bildschirm, Sensor, Akku und PCB -
-		1Stück -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
-Verbindet Bildschirm, Sensor, Akku und PCB -
-
8 -
- 0408LTFB-Schrauben -
-		 - -FST - - -
- Leiterplatten-Befestigungsschrauben -
-		4Stück -
–
-		 -
- 0408LTFB -
-		 -
–
-		 -
–
-		 -
–
-		 -
-Zur Befestigung der Platine am Trainergehäuse -
-
9 -
- Heißkleber -
-		 - -ADH - - -
- Montagekleber -
-		1Anwendung -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
-Zur Befestigung von Bildschirm, Sensor und Akku -
-
-
- -
-{/* END GENERATED BOM */} - -## Montagewerkzeuge - -| Werkzeug | Verwendung | -| --------------------- | ------------------------------------------------------------------------------- | -| Heißklebepistole | Kleben Sie Bildschirm, Sensor und Akku fest. | -| T8-Schraubendreherbit | Platinenschrauben festziehen. | -| Elektroschrauber oder ähnliches Werkzeug | Schrauben eindrehen. | -| Brenner | Filamentfäden im Inneren des 3D-gedruckten Gehäuses vorsichtig entfernen. | - -## Design- und Fertigungsressourcen - -| Ressource | Standort | Hinweise | -| ------------------ | ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | -| PCB-Übersicht | [assembly-docs/pcb-overview.md](pcb-overview) | Quelle der Platine, Produktions-Export und PCB-BOM-Grenze. | -| PCB-Quelle | [hardware/pcb/README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/README.md) | Bearbeitbare Quellen für Platinenentwürfe. | -| Produktions-Exporte | [hardware/production-exports/](https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/production-exports) | An Hersteller gesendete Dateien, einschließlich Gerber-Dateien, Pick-and-Place-Dateien und Produktions-PCB-Stücklisten. | diff --git a/content/docs/dtt/bill-of-materials.fr.mdx b/content/docs/dtt/bill-of-materials.fr.mdx deleted file mode 100644 index 2381efc..0000000 --- a/content/docs/dtt/bill-of-materials.fr.mdx +++ /dev/null @@ -1,611 +0,0 @@ ---- -title: "Nomenclature" -description: "Nomenclature pour Deepthroat Trainer." ---- - -{/* Ported from MkDocs: bom.md */} - -La construction du Deepthroat Trainer utilise un assemblage de circuits imprimés équipé d'un écran externe, d'un capteur, d'une batterie, d'un faisceau de câbles, de bandes auto-agrippantes côté boucle, d'un boîtier DTT imprimé en 3D, de vis et d'un adhésif d'assemblage, tous nécessaires à la construction du boîtier tout-en-un. - -## Pièces - -Ce tableau est généré à partir de [hardware/bom.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv) lors du build `assembly-docs`. Mettez à jour le CSV au lieu de modifier manuellement le tableau généré. - -{/* BEGIN GENERATED BOM */} - -
-
-
Dépôt
-
- -DT_Trainer-OSS - -
-
Commit source
-
- -bc9861f -{" "} - - (bc9861f47144ef641f495cc9edf52273063967bb) - -
-
-
-Validée pour la production. Cette nomenclature correspond à une - version matérielle taguée. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- # - - Nom de la pièce - - Catégorie - - Descriptif - - Quantité - - UdM - - Fabricant - - réf. du fabricant - - Vendeur - - Référence du fournisseur - - Source - - Remarques -
1 -
- Assemblage de circuits imprimés DTT -
-		 - -PCA - - -
-Assemblage de circuits imprimés Rev4 -
-		1unité -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
-La nomenclature enfant du PCB est gérée séparément -
-
2 -
- Bande auto-agrippante côté boucle DTT -
-		 - -FBO - - -
-Bande auto-agrippante côté boucle utilisée sur le PCB -
-		1unité -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Utilisée sur le PCB lors de l'assemblage -
-
3 -
- Boîtier DTT imprimé en 3D -
-		 - -FDM - - -
- Boîtier du Deepthroat Trainer imprimé en 3D -
-		1unité -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
-Nettoyer les brins de filament intérieurs avant l'assemblage -
-
4 -
- Écran OLED -
-		 - -ASM - - -
- Module d'affichage -
-		1unité -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Retirer le film avant l'installation -
-
5 -
- Capteur -
-		 - -IC - - -
- Module capteur de position -
-		1unité -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Installer au ras du boîtier -
-
6 -
- Batterie -
-		 - -BTY - - -
- Batterie au lithium -
-		1unité -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Installer le côté écrit vers le bas -
-
7 -
- Faisceau de câbles -
-		 - -CHA - - -
-Faisceau de câbles pour l’écran, le capteur, la batterie et le PCB -
-		1unité -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
-Relie l’écran, le capteur, la batterie et le PCB -
-
8 -
- Vis 0408LTFB -
-		 - -FST - - -
- Vis de montage de PCB -
-		4unité -
–
-		 -
- 0408LTFB -
-		 -
–
-		 -
–
-		 -
–
-		 -
-Utilisées pour fixer le PCB au boîtier du Deepthroat Trainer -
-
9 -
- Colle chaude -
-		 - -ADH - - -
- Adhésif de montage -
-		1application -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
-Utilisée pour fixer l’écran, le capteur et la batterie -
-
-
- -
-{/* END GENERATED BOM */} - -## Outils d'assemblage - -| Outil | Utilisation | -| --------------------------------- | ---------------------------------------------------------------------------------- | -| Pistolet à colle chaude | Collez l’écran, le capteur et la batterie en place. | -| Embout de tournevis T8 | Fixez les vis du PCB. | -| Tournevis électrique ou similaire | Vissez les vis. | -| Chalumeau | Retirez délicatement les brins de filament à l’intérieur du boîtier imprimé en 3D. | - -## Ressources de conception et de fabrication - -| Ressource | Emplacement | Remarques | -| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | -| Aperçu des PCB | [assembly-docs/pcb-overview.md](pcb-overview) | Source du PCB, export de production et limite de la nomenclature du PCB. | -| Source de PCB | [hardware/pcb/README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/README.md) | Sources de conception de PCB modifiables. | -| Exportations de production | [hardware/production-exports/](https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/production-exports) | Fichiers envoyés aux fabricants, notamment les fichiers Gerber, les fichiers pick-and-place et les nomenclatures de production des PCB. | diff --git a/content/docs/dtt/bill-of-materials.mdx b/content/docs/dtt/bill-of-materials.mdx deleted file mode 100644 index b767a97..0000000 --- a/content/docs/dtt/bill-of-materials.mdx +++ /dev/null @@ -1,611 +0,0 @@ ---- -title: "Bill of Materials" -description: "Bill of Materials for Deepthroat Trainer." ---- - -{/* Ported from MkDocs: bom.md */} - -The DT Trainer build uses a populated PCB assembly with the off-board display, sensor, battery, cable harness, loop velcro, 3D printed housing, screws, and assembly adhesive needed for the all-in-one case build. - -## Parts - -This table is generated from [hardware/bom.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv) during the assembly-docs build. Update the CSV instead of editing the generated table by hand. - -{/* BEGIN GENERATED BOM */} - -
-
-
Repository
-
- - DT_Trainer-OSS - -
-
Source commit
-
- - bc9861f - {" "} - - (bc9861f47144ef641f495cc9edf52273063967bb) - -
-
-
- Released for production. This BOM corresponds to a tagged - hardware release. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- {"#"} - - Part Name - - Category - - Description - - Qty - - UOM - - Manufacturer - - MFG PN - - Vendor - - Vendor PN - - Source - - Notes -
1 -
- DTT PCB assembly -
- 		- - PCA - - -
- Rev4 printed circuit board assembly -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
- PCB child BOM is maintained separately -
-
2 -
- DTT loop velcro -
- 		- - FBO - - -
- Loop-side hook-and-loop strip used on the PCB -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		-
–
- 		-
- Used on the PCB during assembly -
-
3 -
- 3D printed DTT housing -
- 		- - FDM - - -
- Printed trainer housing -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
- Clean interior filament strands before assembly -
-
4 -
- OLED screen -
- 		- - ASM - - -
- Display module -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		-
–
- 		-
- Remove film before installation -
-
5 -
- Sensor -
- 		- - IC - - -
- Position sensor module -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		-
–
- 		-
- Install flush with casing -
-
6 -
- Battery -
- 		- - BTY - - -
- Lithium battery -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		-
–
- 		-
- Install writing-side down -
-
7 -
- Cable harness -
- 		- - CHA - - -
- Screen sensor battery and PCB cable harness -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		-
–
- 		-
- Connects screen sensor battery and PCB -
-
8 -
- 0408LTFB screws -
- 		- - FST - - -
- PCB mounting screws -
- 		4each -
–
- 		-
- 0408LTFB -
- 		-
–
- 		-
–
- 		-
–
- 		-
- Used to fasten the PCB to the trainer case -
-
9 -
- Hot glue -
- 		- - ADH - - -
- Assembly adhesive -
- 		1application -
–
- 		-
–
- 		-
–
- 		-
–
- 		-
–
- 		-
- Used to secure screen sensor and battery -
-
-
- -
-{/* END GENERATED BOM */} - -## Assembly Tools - -| Tool | Use | -| ------------------------------- | ------------------------------------------------------------- | -| Hot glue gun | Glue screen, sensor, and battery in place. | -| T8 screwdriver bit | Fasten PCB screws. | -| Electric screwdriver or similar | Drive screws. | -| Torch | Gently remove filament strands inside the 3D printed housing. | - -## Design and Manufacturing Assets - -| Asset | Location | Notes | -| ------------------ | ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | -| PCB overview | [assembly-docs/pcb-overview.md](pcb-overview) | Board source, production export, and PCB BOM boundary. | -| PCB source | [hardware/pcb/README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/README.md) | Editable board design sources. | -| Production exports | [hardware/production-exports/](https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/production-exports) | Files sent to manufacturers, including gerbers, pick-and-place, and production PCB BOMs. | diff --git a/content/docs/dtt/bill-of-materials.nl.mdx b/content/docs/dtt/bill-of-materials.nl.mdx deleted file mode 100644 index 75eb4e8..0000000 --- a/content/docs/dtt/bill-of-materials.nl.mdx +++ /dev/null @@ -1,611 +0,0 @@ ---- -title: "Stuklijst" -description: "Stuklijst voor Deepthroat Trainer." ---- - -{/* Ported from MkDocs: bom.md */} - -De opbouw van de Deepthroat Trainer gebruikt een bestukte PCB-assemblage met het externe scherm, de sensor, de batterij, de kabelboom, lusklittenband, een 3D-geprinte behuizing, schroeven en montagelijm die nodig zijn voor de alles-in-één-behuizing. - -## Onderdelen - -Deze tabel wordt gegenereerd op basis van [hardware/bom.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv) tijdens de `assembly-docs`-build. Werk de CSV bij in plaats van de gegenereerde tabel handmatig te bewerken. - -{/* BEGIN GENERATED BOM */} - -
-
-
Repository
-
- -DT_Trainer-OSS - -
-
Broncommit
-
- -bc9861f -{" "} - - (bc9861f47144ef641f495cc9edf52273063967bb) - -
-
-
-Vrijgegeven voor productie. Deze stuklijst komt overeen met een getagde - hardwareversie. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- # - - Onderdeelnaam - - Categorie - - Beschrijving - - Aantal - - Eenheid - - Fabrikant - - MFG-PN - - Verkoper - - Leverancier PN - - Bron - - Opmerkingen -
1 -
- DTT-printplaatassemblage -
-		 - -PCA - - -
-Rev4-printplaatassemblage -
-		1stuk -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
-De onderliggende PCB-stuklijst wordt afzonderlijk bijgehouden -
-
2 -
- DTT-lusklittenband -
-		 - -FBO - - -
-Klittenbandstrip aan de luszijde voor gebruik op de printplaat -
-		1stuk -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Gebruikt op de printplaat tijdens montage -
-
3 -
- 3D-geprinte DTT-behuizing -
-		 - -FDM - - -
- 3D-geprinte trainerbehuizing -
-		1stuk -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
-Reinig de interne filamentstrengen vóór montage -
-
4 -
- OLED-scherm -
-		 - -ASM - - -
- Weergavemodule -
-		1stuk -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Verwijder de folie vóór installatie -
-
5 -
- Sensor -
-		 - -IC - - -
- Positiesensormodule -
-		1stuk -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Gelijk met de behuizing installeren -
-
6 -
- Batterij -
-		 - -BTY - - -
- Lithiumbatterij -
-		1stuk -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
- Installeer de schrijfzijde naar beneden -
-
7 -
- Kabelboom -
-		 - -CHA - - -
-Kabelboom voor scherm, sensor, batterij en PCB -
-		1stuk -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
-Verbindt scherm, sensor, batterij en PCB -
-
8 -
- 0408LTFB-schroeven -
-		 - -FST - - -
- PCB-montageschroeven -
-		4stuk -
–
-		 -
- 0408LTFB -
-		 -
–
-		 -
–
-		 -
–
-		 -
-Om de printplaat aan de trainerbehuizing te bevestigen -
-
9 -
- Hete lijm -
-		 - -ADH - - -
- Montagelijm -
-		1toepassing -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
–
-		 -
-Om scherm, sensor en batterij vast te zetten -
-
-
- -
-{/* END GENERATED BOM */} - -## Montagegereedschap - -| Gereedschap | Gebruik | -| ----------------------------------------------- | ---------------------------------------------------------------------- | -| Heetlijmpistool | Lijm het scherm, de sensor en de batterij op hun plaats. | -| T8 schroevendraaierbit | Draai de PCB-schroeven vast. | -| Elektrische schroevendraaier of vergelijkbaar gereedschap | Schroeven indraaien. | -| Brander | Filamentdraden in de 3D-geprinte behuizing voorzichtig verwijderen. | - -## Ontwerp- en productiemiddelen - -| Middel | Locatie | Opmerkingen | -| ---------------- | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | -| PCB-overzicht | [assembly-docs/pcb-overview.md](pcb-overview) | Bron van de printplaat, productie-export en PCB-stuklijstgrens. | -| PCB-bron | [hardware/pcb/README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/README.md) | Bewerkbare bronnen voor printplaatontwerpen. | -| Productie-exports | [hardware/production-exports/](https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/production-exports) | Bestanden die naar fabrikanten worden verzonden, waaronder Gerber-bestanden, pick-and-placebestanden en productie-PCB-stuklijsten. | diff --git a/content/docs/dtt/bom.en.mdx b/content/docs/dtt/bom.en.mdx new file mode 100644 index 0000000..e4a753b --- /dev/null +++ b/content/docs/dtt/bom.en.mdx @@ -0,0 +1,30 @@ +--- +title: Bill of Materials +--- + +The DT Trainer build uses a populated PCB assembly with the off-board display, sensor, battery, cable harness, loop velcro, 3D printed housing, screws, and assembly adhesive needed for the all-in-one case build. + +## Parts + +This table is generated from [hardware/bom.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv) during the assembly-docs build. Update the CSV instead of editing the generated table by hand. + +import bom from "./_bom/bom.json"; + + + +## Assembly Tools + +| Tool | Use | +| --- | --- | +| Hot glue gun | Glue screen, sensor, and battery in place. | +| T8 screwdriver bit | Fasten PCB screws. | +| Electric screwdriver or similar | Drive screws. | +| Torch | Gently remove filament strands inside the 3D printed housing. | + +## Design and Manufacturing Assets + +| Asset | Location | Notes | +| --- | --- | --- | +| PCB overview | [assembly-docs/pcb-overview.md](/dtt/pcb-overview) | Board source, production export, and PCB BOM boundary. | +| PCB source | [hardware/pcb/README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/README.md) | Editable board design sources. | +| Production exports | [hardware/production-exports/](https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/production-exports/) | Files sent to manufacturers, including gerbers, pick-and-place, and production PCB BOMs. | diff --git a/content/docs/dtt/cable-harnesses.de.mdx b/content/docs/dtt/cable-harnesses.de.mdx deleted file mode 100644 index 4d85b4f..0000000 --- a/content/docs/dtt/cable-harnesses.de.mdx +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: "Kabelbäume" -description: "Kabelbäume für Deepthroat Trainer." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -Der Aufbau von DT Trainer umfasst einen Kabelbaum für den Bildschirm, den Sensor, die Batterie und das PCB -als Baugruppenposition der obersten Ebene in der [Stückliste](bill-of-materials). - -Noch keine Wireviz-Kabelbaumquelle wurde nach `hardware/cables/` migriert. Wenn eine -Wireviz-Quelle hinzugefügt wird, konzentrieren Sie die Stückliste auf Produktebene weiterhin auf die -Kabelbaum-Baugruppe und verknüpfen Sie von dieser Seite aus die detaillierte Ausgabe der untergeordneten Stückliste. - -| Element | Speicherort | Hinweise | -| --------------------------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------- | -| Kabelquellenordner | [`hardware/cables/`](https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/cables) | Wireviz YAML-Quellen gehören hierher. | -| Stückliste auf Produktebene | [`hardware/bom.csv`](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv) | Listet den Kabelbaum als Baugruppenposition auf. | diff --git a/content/docs/dtt/cable-harnesses.en.mdx b/content/docs/dtt/cable-harnesses.en.mdx new file mode 100644 index 0000000..c9eb383 --- /dev/null +++ b/content/docs/dtt/cable-harnesses.en.mdx @@ -0,0 +1,15 @@ +--- +title: Cable Harnesses +--- + +The DT Trainer build includes a screen, sensor, battery, and PCB cable harness +as a top-level assembly item in the [Bill of Materials](/dtt/bom). + +No Wireviz harness source has been migrated to `hardware/cables/` yet. When a +Wireviz source is added, keep the product-level BOM focused on the harness +assembly and link detailed child BOM output from this page. + +| Asset | Location | Notes | +| --- | --- | --- | +| Cable source folder | [`hardware/cables/`](https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/cables/) | Wireviz YAML sources belong here. | +| Product-level BOM | [`hardware/bom.csv`](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv) | Lists the cable harness as an assembly line item. | diff --git a/content/docs/dtt/cable-harnesses.fr.mdx b/content/docs/dtt/cable-harnesses.fr.mdx deleted file mode 100644 index fbd3121..0000000 --- a/content/docs/dtt/cable-harnesses.fr.mdx +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: "Faisceaux de câbles" -description: "Faisceaux de câbles pour Deepthroat Trainer." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -L’assemblage de DT Trainer comprend un faisceau de câbles pour l’écran, le capteur, la batterie et le PCB -en tant qu’élément d’assemblage de premier niveau dans la [nomenclature](bill-of-materials). - -Aucune source de faisceau Wireviz n’a encore été migrée vers `hardware/cables/`. Lorsqu’une source -Wireviz est ajoutée, gardez la nomenclature au niveau du produit centrée sur l’assemblage du faisceau -et, depuis cette page, créez un lien vers le résultat détaillé de la sous-nomenclature. - -| Élément | Emplacement | Remarques | -| --------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | -| Dossier source des câbles | [`hardware/cables/`](https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/cables) | Les sources Wireviz YAML appartiennent ici. | -| Nomenclature au niveau du produit | [`hardware/bom.csv`](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv) | Répertorie le faisceau de câbles comme élément d’assemblage. | diff --git a/content/docs/dtt/cable-harnesses.mdx b/content/docs/dtt/cable-harnesses.mdx deleted file mode 100644 index 94d7b68..0000000 --- a/content/docs/dtt/cable-harnesses.mdx +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: "Cable Harnesses" -description: "Cable Harnesses for Deepthroat Trainer." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -The DT Trainer build includes a screen, sensor, battery, and PCB cable harness -as a top-level assembly item in the [Bill of Materials](bill-of-materials). - -No Wireviz harness source has been migrated to `hardware/cables/` yet. When a -Wireviz source is added, keep the product-level BOM focused on the harness -assembly and link detailed child BOM output from this page. - -| Asset | Location | Notes | -| ------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------- | -| Cable source folder | [`hardware/cables/`](https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/cables) | Wireviz YAML sources belong here. | -| Product-level BOM | [`hardware/bom.csv`](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv) | Lists the cable harness as an assembly line item. | diff --git a/content/docs/dtt/cable-harnesses.nl.mdx b/content/docs/dtt/cable-harnesses.nl.mdx deleted file mode 100644 index 99d9d82..0000000 --- a/content/docs/dtt/cable-harnesses.nl.mdx +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: "Kabelbomen" -description: "Kabelbomen voor Deepthroat Trainer." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -De opbouw van DT Trainer omvat een kabelboom voor het scherm, de sensor, de batterij en de PCB -als assemblage-item op het hoogste niveau in de [stuklijst](bill-of-materials). - -Er is nog geen Wireviz-bron voor een kabelboom gemigreerd naar `hardware/cables/`. Wanneer een -Wireviz-bron wordt toegevoegd, moet de stuklijst op productniveau gericht blijven op de -kabelboomassemblage en moet vanaf deze pagina naar de gedetailleerde uitvoer van de onderliggende stuklijst worden verwezen. - -| Item | Locatie | Opmerkingen | -| -------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------ | -| Map met kabelbronnen | [`hardware/cables/`](https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/cables) | Wireviz YAML-bronnen horen hier thuis. | -| Stuklijst op productniveau | [`hardware/bom.csv`](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv) | Vermeldt de kabelboom als assemblage-item. | diff --git a/content/docs/dtt/index.de.mdx b/content/docs/dtt/index.de.mdx deleted file mode 100644 index 8a7dbdd..0000000 --- a/content/docs/dtt/index.de.mdx +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: "Montagedokumentation für den Deepthroat Trainer" -description: "Montagedokumentation für den Deepthroat Trainer." ---- - -{/* Ported from MkDocs: index.md */} - -Montagedokumentationspaket für den aktualisierten All-in-One-Gehäuseaufbau des Deepthroat Trainer 2026. - -## Montagepaket - - - - Bauen Sie den All-in-One-Trainer Schritt für Schritt mit Produktionsfotos und QC-Prüfungen auf. - - - Prüfen Sie die Geräteteileliste und die Quellenangaben für die Fertigung. - - - Informieren Sie sich über die Abgrenzung des Kabelbaums und die Hinweise zu den Kabelquellen. - - - Prüfen Sie die Steuerplatine, die KiCanvas-Vorschau und das Fertigungspaket. - - - -## Produktübersicht - -Dieser Aufbau verwendet eine DTT-Platine, Schlaufenklettband, ein 3D-gedrucktes DTT-Gehäuse, einen Bildschirm, einen Sensor, einen Akku, einen Kabelbaum und vier `0408LTFB`-Schrauben. - -## Material- und Teilehinweise - -- Gehäuse: 3D-gedrucktes DTT-Gehäuse. -- Befestigung der Platine: DTT-Schlaufenklettband. diff --git a/content/docs/dtt/index.en.mdx b/content/docs/dtt/index.en.mdx new file mode 100644 index 0000000..25241f8 --- /dev/null +++ b/content/docs/dtt/index.en.mdx @@ -0,0 +1,24 @@ +--- +title: Deepthroat Trainer Assembly Docs +license: CERN-OHL-S v2 (hardware) / MPL-2.0 (firmware) +--- + +Assembly documentation package for the Deepthroat Trainer 2026 updated all-in-one case build. + +## Assembly Package + +- [Bill of Materials](/dtt/bom) +- [Assembly Guide](/dtt/assembly-guide) + +## Product Overview + +This build uses a DTT PCB, loop velcro, 3D printed DTT housing, screen, sensor, battery, cable harness, and four `0408LTFB` screws. + +## Product Dimensions and Materials + +Dimensions are not specified in the current assembly package. + +Known material/part notes: + +- Housing: 3D printed DTT housing. +- PCB attachment: DTT loop velcro. diff --git a/content/docs/dtt/index.fr.mdx b/content/docs/dtt/index.fr.mdx deleted file mode 100644 index 574c5fc..0000000 --- a/content/docs/dtt/index.fr.mdx +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: "Documentation d’assemblage du Deepthroat Trainer" -description: "Documentation d’assemblage pour le Deepthroat Trainer." ---- - -{/* Ported from MkDocs: index.md */} - -Dossier de documentation d’assemblage pour le boîtier tout-en-un mis à jour du Deepthroat Trainer 2026. - -## Dossier d’assemblage - - - - Assemblez le dispositif tout-en-un dans l’ordre, avec les photos de production et les contrôles qualité. - - - Consultez la liste des pièces du dispositif et les références des sources de fabrication. - - - Consultez le périmètre du faisceau et les notes sur les sources des câbles. - - - Consultez le PCB de commande, l’aperçu KiCanvas et le dossier de production. - - - -## Présentation du produit - -Cette version utilise un PCB DTT, une bande auto-agrippante côté boucle, un boîtier DTT imprimé en 3D, un écran, un capteur, une batterie, un faisceau de câbles et quatre vis `0408LTFB`. - -## Notes sur les matériaux et les pièces - -- Boîtier : boîtier DTT imprimé en 3D. -- Fixation du PCB : bande auto-agrippante côté boucle DTT. diff --git a/content/docs/dtt/index.mdx b/content/docs/dtt/index.mdx deleted file mode 100644 index d889f45..0000000 --- a/content/docs/dtt/index.mdx +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: "Deepthroat Trainer Assembly Docs" -description: "Deepthroat Trainer Assembly Docs for Deepthroat Trainer." ---- - -{/* Ported from MkDocs: index.md */} - -Assembly documentation package for the Deepthroat Trainer 2026 updated all-in-one case build. - -## Assembly Package - - - - Build the all-in-one trainer in order with production photos and QC checks. - - - Review the device-level parts list and manufacturing source references. - - - Find the harness boundary and cable source notes. - - - Inspect the control board, KiCanvas preview, and production package. - - - -## Product Overview - -This build uses a DTT PCB, loop velcro, 3D printed DTT housing, screen, sensor, battery, cable harness, and four `0408LTFB` screws. - -## Materials and Part Notes - -- Housing: 3D printed DTT housing. -- PCB attachment: DTT loop velcro. diff --git a/content/docs/dtt/index.nl.mdx b/content/docs/dtt/index.nl.mdx deleted file mode 100644 index 926b848..0000000 --- a/content/docs/dtt/index.nl.mdx +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: "Montagedocumentatie voor de Deepthroat Trainer" -description: "Montagedocumentatie voor de Deepthroat Trainer." ---- - -{/* Ported from MkDocs: index.md */} - -Montagedocumentatiepakket voor de bijgewerkte alles-in-één-behuizing van de Deepthroat Trainer 2026. - -## Montagepakket - - - - Bouw de alles-in-één-trainer stap voor stap met productiefoto's en QC-controles. - - - Bekijk de onderdelenlijst op apparaatniveau en de bronverwijzingen voor de productie. - - - Bekijk de afbakening van de kabelboom en de opmerkingen over kabelbronnen. - - - Bekijk de besturingsprintplaat, de KiCanvas-preview en het productiepakket. - - - -## Productoverzicht - -Deze opbouw gebruikt een DTT-printplaat, lusklittenband, een 3D-geprinte DTT-behuizing, een scherm, een sensor, een batterij, een kabelboom en vier `0408LTFB`-schroeven. - -## Materiaal- en onderdeelnotities - -- Behuizing: 3D-geprinte DTT-behuizing. -- Bevestiging van de printplaat: DTT-lusklittenband. diff --git a/content/docs/dtt/meta.de.json b/content/docs/dtt/meta.de.json deleted file mode 100644 index 8ed5520..0000000 --- a/content/docs/dtt/meta.de.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "Deep Throat Trainer", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/dtt/meta.en.json b/content/docs/dtt/meta.en.json new file mode 100644 index 0000000..3cad8c7 --- /dev/null +++ b/content/docs/dtt/meta.en.json @@ -0,0 +1,11 @@ +{ + "title": "Deepthroat Trainer Assembly Docs", + "pages": [ + "index", + "pcb-overview", + "cable-harnesses", + "bom", + "assembly-guide", + "..." + ] +} diff --git a/content/docs/dtt/meta.fr.json b/content/docs/dtt/meta.fr.json deleted file mode 100644 index 8ed5520..0000000 --- a/content/docs/dtt/meta.fr.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "Deep Throat Trainer", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/dtt/meta.json b/content/docs/dtt/meta.json deleted file mode 100644 index 5d6b2e7..0000000 --- a/content/docs/dtt/meta.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "Deepthroat Trainer", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/dtt/meta.nl.json b/content/docs/dtt/meta.nl.json deleted file mode 100644 index 8ed5520..0000000 --- a/content/docs/dtt/meta.nl.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "Deep Throat Trainer", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/dtt/pcb-overview.de.mdx b/content/docs/dtt/pcb-overview.de.mdx deleted file mode 100644 index 06695d4..0000000 --- a/content/docs/dtt/pcb-overview.de.mdx +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: "PCB-Übersicht" -description: "PCB-Übersicht für Deepthroat Trainer." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -Die Leiterplatte des DT Trainer rev4 ist die Gerätesteuerungsbaugruppe für den All-in-One-Traineraufbau. Sie enthält die ESP32-Firmware, die Dashboard-Konnektivität, Strom- und Ladeschnittstellen, den Sensoreingang, Display- und LED-Feedback sowie den während des Trainings verwendeten Vibrationsausgang. - - - -Die ursprüngliche bearbeitbare Platinenquelle ist DipTrace rev4. Eine KiCad-Konvertierung für rev4 ist -ebenfalls veröffentlicht und soll bis zur abschließenden Konvertierungsprüfung mit der -ursprünglichen DipTrace-Quelle übereinstimmen. - -## Elektrische Architektur - -| Bereich | Rolle | -| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ESP32-Steuerung | Führt die Firmware aus und übernimmt WLAN-Kommunikation, OTA-Update-Prüfungen, Gerätestatus und Sitzungslogik. | -| Stromversorgung und Laden | Verwaltet den USB-C-Eingang, den Batterieanschluss, die Ladeunterstützung und die geregelte Stromversorgung der Platine. | -| Sensorschnittstelle | Verbindet den Positionssensor des Trainers, der für die Kalibrierung und das Trainingsfeedback verwendet wird. | -| Benutzeroberfläche | Steuert den OLED-Bildschirm, die Tasteneingabe und die RGB-Status-LEDs, die im Ablauf von Baugruppe und Firmware verwendet werden. | -| Haptik und Ausgänge | Steuert den Vibrationsmotor und die lokalen Feedback-Ausgänge während des Trainings. | -| Programmierung und Produktion | Stellt die Platinenquelle, die Produktions-BOM, Gerber-Dateien und das Pick-and-Place-Paket bereit, die für Platinenfertigung und -montage benötigt werden. | - -## PCB-Quelldateien - -| Asset | Standort | Notizen | -| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | -| DipTrace-Schema | [217A_dttrainer_rev4.dch](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/217A_dttrainer_rev4.dch) | Bearbeitbare rev4-Schaltplanquelle. | -| DipTrace-Board-Layout | [217A_dttrainer_rev4.dip](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/217A_dttrainer_rev4.dip) | Bearbeitbare rev4-PCB-Layout-Quelle. | -| KiCad-Projekt | [217A_dttrainer_rev4.kicad_pro](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_pro) | Konvertiertes rev4-KiCad-Projekt. | -| KiCad-Schaltplan | [217A_dttrainer_rev4.kicad_sch](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_sch) | Konvertierter rev4-KiCad-Schaltplan. | -| KiCad-Board-Layout | [217A_dttrainer_rev4.kicad_pcb](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_pcb) | Konvertiertes rev4-KiCad-PCB-Layout. | -| KiCanvas-Vorschau | [rev4-KiCad-Projekt öffnen](https://kicanvas.org/?github=https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4) | Browservorschau des konvertierten KiCad-Projekts. | -| Detaillierte PCB-Stückliste | [pcb-bom-full.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/pcb-bom-full.csv) | Umfangreiche Stückliste auf Board-Ebene, wobei die Beschaffungs- und Montagespalten aus der Quelltabelle erhalten bleiben. | -| Hinweise zur PCB-Quelle | [README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/README.md) | Herkunft, Ordnergrenze und DipTrace/KiCad-Paritätsnotizen. | - -## Produktionspaket - -Der aktuelle Produktionsexport ist das im Mai 2025 als funktionsfähig bestätigte rev4-Bestellpaket. - -| Asset | Standort | Notizen | -| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -| Gerber-Archiv | [Trainer_gerber_Y35.zip](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/Trainer_gerber_Y35.zip) | Fertigungsarchiv des als funktionsfähig bestätigten Auftrags. | -| Produktions-PCB-Stückliste | [Trainer BoM May 15.xls](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/Trainer%20BoM%20May%2015.xls) | BOM der Platinenbestückung für den Produktionsauftrag. | -| Pick-and-Place | [pickplace_dttrainer_rev4 (1).xlsx](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/pickplace_dttrainer_rev4%20%281%29.xlsx) | Komponentenplatzierungsdaten für die Montage. | -| Produktionsexporthinweise | [README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/README.md) | Herkunftshinweise zum als funktionsfähig bestätigten Fertigungsexport. | - -## Stücklistengrenze - -Die kanonische RAD-BOM ist [hardware/bom.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv). Sie führt die bestückte Leiterplatte als eine Baugruppenzeile auf Geräteebene auf, sodass sich die Baugruppendokumentation weiterhin auf den Traineraufbau konzentriert. - -Die untergeordneten Teile auf Platinenebene werden in [hardware/pcb/diptrace-rev4/pcb-bom-full.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/pcb-bom-full.csv) verwaltet, um den Verlust von Hersteller-, Anbieter-, Footprint- und Baugruppendaten aus dem PCB-Quellexport zu vermeiden. diff --git a/content/docs/dtt/pcb-overview.en.mdx b/content/docs/dtt/pcb-overview.en.mdx new file mode 100644 index 0000000..996b252 --- /dev/null +++ b/content/docs/dtt/pcb-overview.en.mdx @@ -0,0 +1,55 @@ +--- +title: PCB Overview +--- + +The DT Trainer rev4 PCB is the device control assembly for the all-in-one trainer build. It carries the ESP32 firmware, dashboard connectivity, power and charging interfaces, sensor input, display and LED feedback, and the vibration output used during training. + + + +The original editable board source is DipTrace rev4. A KiCad rev4 conversion is +also published and intended to remain in parity with the original DipTrace +source pending final conversion verification. + +## Electrical Architecture + +| Area | Role | +| --- | --- | +| ESP32 control | Runs firmware, WiFi communication, OTA update checks, device state, and session logic. | +| Power and charging | Handles USB-C input, battery connection, charging support, and regulated power for the board. | +| Sensor interface | Connects the trainer position sensor used for calibration and training feedback. | +| User interface | Drives the OLED screen, button input, and RGB status LEDs used by the assembly and firmware flow. | +| Haptics and outputs | Drives the vibration motor and local feedback outputs during training. | +| Programming and production | Provides the board source, production BOM, gerbers, and pick-and-place package needed for board fabrication and assembly. | + +## PCB Source Files + +| Asset | Location | Notes | +| --- | --- | --- | +| DipTrace schematic | [217A_dttrainer_rev4.dch](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/217A_dttrainer_rev4.dch) | Editable rev4 schematic source. | +| DipTrace board layout | [217A_dttrainer_rev4.dip](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/217A_dttrainer_rev4.dip) | Editable rev4 PCB layout source. | +| KiCad project | [217A_dttrainer_rev4.kicad_pro](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_pro) | Converted rev4 KiCad project. | +| KiCad schematic | [217A_dttrainer_rev4.kicad_sch](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_sch) | Converted rev4 KiCad schematic. | +| KiCad board layout | [217A_dttrainer_rev4.kicad_pcb](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_pcb) | Converted rev4 KiCad PCB layout. | +| KiCanvas preview | [Open rev4 KiCad project](https://kicanvas.org/?github=https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4) | Browser preview of the converted KiCad project. | +| Detailed PCB BOM | [pcb-bom-full.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/pcb-bom-full.csv) | Rich board-level BOM preserving procurement and assembly columns from the source spreadsheet. | +| PCB source notes | [README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/README.md) | Provenance, folder boundary, and DipTrace/KiCad parity notes. | + +## Production Package + +The current production export is the May 2025 known-good rev4 order package. + +| Asset | Location | Notes | +| --- | --- | --- | +| Gerber archive | [Trainer_gerber_Y35.zip](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/Trainer_gerber_Y35.zip) | Manufacturing archive from the known-good order. | +| Production PCB BOM | [Trainer BoM May 15.xls](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/Trainer%20BoM%20May%2015.xls) | Board assembly BOM used with the production order. | +| Pick-and-place | [pickplace_dttrainer_rev4 (1).xlsx](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/pickplace_dttrainer_rev4%20%281%29.xlsx) | Component placement data for assembly. | +| Production export notes | [README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/README.md) | Provenance notes for the known-good manufacturing export. | + +## BOM Boundary + +The canonical RAD BOM is [hardware/bom.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv). It lists the populated PCB as one device-level assembly row so the assembly documentation stays focused on the trainer build. + +The board-level child parts are maintained in [hardware/pcb/diptrace-rev4/pcb-bom-full.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/pcb-bom-full.csv) to avoid losing manufacturer, vendor, footprint, and assembly data from the PCB source export. diff --git a/content/docs/dtt/pcb-overview.fr.mdx b/content/docs/dtt/pcb-overview.fr.mdx deleted file mode 100644 index ac2b2b3..0000000 --- a/content/docs/dtt/pcb-overview.fr.mdx +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: "Aperçu du PCB" -description: "Présentation du PCB pour Deepthroat Trainer." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -Le PCB DT Trainer rev4 est l’ensemble de commande pour l’assemblage tout-en-un du trainer. Il contient le micrologiciel ESP32, la connectivité du tableau de bord, les interfaces d’alimentation et de charge, l’entrée du capteur, l’affichage et le retour des LED, ainsi que la sortie de vibration utilisée pendant l’entraînement. - - - -La source originale et modifiable du PCB est DipTrace rev4. Une conversion KiCad rev4 est -également publiée et doit rester en parité avec la source DipTrace originale, en attendant la -vérification finale de la conversion. - -## Architecture électrique - -| Zone | Rôle | -| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Contrôle ESP32 | Exécute le micrologiciel et gère la communication WiFi, les vérifications de mise à jour OTA, l’état de l’appareil et la logique de session. | -| Alimentation et chargement | Gère l’entrée USB-C, la connexion de la batterie, la prise en charge de la charge et l’alimentation régulée du PCB. | -| Interface du capteur | Permet de connecter le capteur de position du trainer utilisé pour l’étalonnage et le retour d’information sur l’entraînement. | -| Interface utilisateur | Pilote l’écran OLED, l’entrée des boutons et les LED d’état RVB utilisés dans le processus d’assemblage et le fonctionnement du micrologiciel. | -| Haptique et sorties | Pilote le moteur de vibration et les sorties de retour locales pendant l’entraînement. | -| Programmation et fabrication | Fournit la source du PCB, la BOM de production, les fichiers Gerber et le package pick-and-place nécessaires à la fabrication et à l’assemblage des cartes. | - -## Fichiers sources du PCB - -| Élément | Localisation | Remarques | -| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- | -| Schéma DipTrace | [217A_dttrainer_rev4.dch](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/217A_dttrainer_rev4.dch) | Source modifiable du schéma rev4. | -| Implantation de la carte DipTrace | [217A_dttrainer_rev4.dip](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/217A_dttrainer_rev4.dip) | Source d’implantation PCB rev4 modifiable. | -| Projet KiCad | [217A_dttrainer_rev4.kicad_pro](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_pro) | Projet KiCad rev4 converti. | -| Schéma KiCad | [217A_dttrainer_rev4.kicad_sch](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_sch) | Schéma KiCad rev4 converti. | -| Implantation de la carte KiCad | [217A_dttrainer_rev4.kicad_pcb](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_pcb) | Implantation PCB KiCad rev4 convertie. | -| Aperçu de KiCanvas | [Ouvrir le projet KiCad rev4](https://kicanvas.org/?github=https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4) | Aperçu dans le navigateur du projet KiCad converti. | -| Nomenclature détaillée du PCB | [pcb-bom-full.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/pcb-bom-full.csv) | Nomenclature détaillée au niveau de la carte, conservant les colonnes d’approvisionnement et d’assemblage de la feuille source. | -| Notes sur les sources de PCB | [README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/README.md) | Provenance, limite du dossier et notes de parité DipTrace/KiCad. | - -## Dossier de production - -L’export de production actuel correspond au dossier de commande rev4 validé comme fonctionnel en mai 2025. - -| Élément | Localisation | Remarques | -| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | -| Archive Gerber | [Trainer_gerber_Y35.zip](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/Trainer_gerber_Y35.zip) | Archive de fabrication de la commande validée. | -| Nomenclature de PCB de production | [Trainer BoM May 15.xls](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/Trainer%20BoM%20May%2015.xls) | BOM d’assemblage du PCB utilisée pour la commande de production. | -| Pick-and-place | [pickplace_dttrainer_rev4 (1).xlsx](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/pickplace_dttrainer_rev4%20%281%29.xlsx) | Données de placement des composants pour l’assemblage. | -| Notes d'exportation de la production | [README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/README.md) | Notes de provenance de l’export de fabrication validé. | - -## Limite de la nomenclature - -La nomenclature RAD canonique est [hardware/bom.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv). Elle répertorie le PCB équipé comme une ligne d’assemblage au niveau du dispositif afin que la documentation d’assemblage reste centrée sur l’assemblage du trainer. - -Les composants de niveau inférieur de la carte sont conservés dans [hardware/pcb/diptrace-rev4/pcb-bom-full.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/pcb-bom-full.csv) pour éviter de perdre les données du fabricant, du fournisseur, de l’empreinte et de l’assemblage issues de l’export de la source du PCB. diff --git a/content/docs/dtt/pcb-overview.mdx b/content/docs/dtt/pcb-overview.mdx deleted file mode 100644 index 809e803..0000000 --- a/content/docs/dtt/pcb-overview.mdx +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: "PCB Overview" -description: "PCB Overview for Deepthroat Trainer." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -The DT Trainer rev4 PCB is the device control assembly for the all-in-one trainer build. It carries the ESP32 firmware, dashboard connectivity, power and charging interfaces, sensor input, display and LED feedback, and the vibration output used during training. - - - -The original editable board source is DipTrace rev4. A KiCad rev4 conversion is -also published and intended to remain in parity with the original DipTrace -source pending final conversion verification. - -## Electrical Architecture - -| Area | Role | -| -------------------------- | ------------------------------------------------------------------------------------------------------------------------- | -| ESP32 control | Runs firmware, WiFi communication, OTA update checks, device state, and session logic. | -| Power and charging | Handles USB-C input, battery connection, charging support, and regulated power for the board. | -| Sensor interface | Connects the trainer position sensor used for calibration and training feedback. | -| User interface | Drives the OLED screen, button input, and RGB status LEDs used by the assembly and firmware flow. | -| Haptics and outputs | Drives the vibration motor and local feedback outputs during training. | -| Programming and production | Provides the board source, production BOM, gerbers, and pick-and-place package needed for board fabrication and assembly. | - -## PCB Source Files - -| Asset | Location | Notes | -| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------- | -| DipTrace schematic | [217A_dttrainer_rev4.dch](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/217A_dttrainer_rev4.dch) | Editable rev4 schematic source. | -| DipTrace board layout | [217A_dttrainer_rev4.dip](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/217A_dttrainer_rev4.dip) | Editable rev4 PCB layout source. | -| KiCad project | [217A_dttrainer_rev4.kicad_pro](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_pro) | Converted rev4 KiCad project. | -| KiCad schematic | [217A_dttrainer_rev4.kicad_sch](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_sch) | Converted rev4 KiCad schematic. | -| KiCad board layout | [217A_dttrainer_rev4.kicad_pcb](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_pcb) | Converted rev4 KiCad PCB layout. | -| KiCanvas preview | [Open rev4 KiCad project](https://kicanvas.org/?github=https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4) | Browser preview of the converted KiCad project. | -| Detailed PCB BOM | [pcb-bom-full.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/pcb-bom-full.csv) | Rich board-level BOM preserving procurement and assembly columns from the source spreadsheet. | -| PCB source notes | [README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/README.md) | Provenance, folder boundary, and DipTrace/KiCad parity notes. | - -## Production Package - -The current production export is the May 2025 known-good rev4 order package. - -| Asset | Location | Notes | -| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | -| Gerber archive | [Trainer_gerber_Y35.zip](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/Trainer_gerber_Y35.zip) | Manufacturing archive from the known-good order. | -| Production PCB BOM | [Trainer BoM May 15.xls](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/Trainer%20BoM%20May%2015.xls) | Board assembly BOM used with the production order. | -| Pick-and-place | [pickplace_dttrainer_rev4 (1).xlsx](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/pickplace_dttrainer_rev4%20%281%29.xlsx) | Component placement data for assembly. | -| Production export notes | [README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/README.md) | Provenance notes for the known-good manufacturing export. | - -## BOM Boundary - -The canonical RAD BOM is [hardware/bom.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv). It lists the populated PCB as one device-level assembly row so the assembly documentation stays focused on the trainer build. - -The board-level child parts are maintained in [hardware/pcb/diptrace-rev4/pcb-bom-full.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/pcb-bom-full.csv) to avoid losing manufacturer, vendor, footprint, and assembly data from the PCB source export. diff --git a/content/docs/dtt/pcb-overview.nl.mdx b/content/docs/dtt/pcb-overview.nl.mdx deleted file mode 100644 index 04e0e9f..0000000 --- a/content/docs/dtt/pcb-overview.nl.mdx +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: "PCB-overzicht" -description: "PCB-overzicht voor Deepthroat Trainer." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -De PCB van de DT Trainer rev4 is de besturingsassemblage voor de alles-in-één traineropbouw. Deze bevat de ESP32-firmware, dashboardconnectiviteit, stroom- en oplaadinterfaces, sensorinvoer, display en LED-feedback, en de trillingsoutput die tijdens de training wordt gebruikt. - - - -De oorspronkelijke bewerkbare PCB-bron is DipTrace rev4. Er is ook een KiCad-conversie voor rev4 -gepubliceerd, die tot aan de definitieve verificatie van de conversie gelijk moet blijven aan de -oorspronkelijke DipTrace-bron. - -## Elektrische architectuur - -| Gebied | Rol | -| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | -| ESP32-besturing | Voert de firmware uit en verzorgt WiFi-communicatie, OTA-updatecontroles, apparaatstatus en sessielogica. | -| Stroom en opladen | Verwerkt de USB-C-ingang, batterijaansluiting, oplaadondersteuning en gereguleerde voeding voor de PCB. | -| Sensorinterface | Verbindt de trainerpositiesensor die wordt gebruikt voor kalibratie en trainingsfeedback. | -| Gebruikersinterface | Stuurt het OLED-scherm, de knopinvoer en de RGB-status-LED's aan die worden gebruikt in de assemblage en de firmwareflow. | -| Haptiek en output | Stuurt de vibratiemotor en lokale feedbackuitgangen aan tijdens de training. | -| Programmering en productie | Biedt de PCB-bron, productie-BOM, Gerber-bestanden en het pick-and-place-pakket die nodig zijn voor fabricage en assemblage. | - -## PCB-bronbestanden - -| Asset | Locatie | Opmerkingen | -| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------- | -| DipTrace-schema | [217A_dttrainer_rev4.dch](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/217A_dttrainer_rev4.dch) | Bewerkbare rev4-schemabron. | -| DipTrace-bordindeling | [217A_dttrainer_rev4.dip](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/217A_dttrainer_rev4.dip) | Bewerkbare bron van de rev4-PCB-lay-out. | -| KiCad-project | [217A_dttrainer_rev4.kicad_pro](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_pro) | Geconverteerd rev4 KiCad-project. | -| KiCad-schema | [217A_dttrainer_rev4.kicad_sch](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_sch) | Geconverteerd rev4 KiCad-schema. | -| KiCad-bordindeling | [217A_dttrainer_rev4.kicad_pcb](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4/217A_dttrainer_rev4.kicad_pcb) | Geconverteerde rev4-KiCad-PCB-indeling. | -| KiCanvas-voorbeeld | [KiCad-rev4-project openen](https://kicanvas.org/?github=https://github.com/researchanddesire/DT_Trainer-OSS/tree/main/hardware/pcb/kicad-rev4/217A_dttrainer_rev4) | Browservoorbeeld van het geconverteerde KiCad-project. | -| Gedetailleerde PCB-stuklijst | [pcb-bom-full.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/pcb-bom-full.csv) | Uitgebreide stuklijst op bordniveau, met behoud van de inkoop- en assemblagekolommen uit het bronspreadsheet. | -| PCB-bronnotities | [README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/README.md) | Herkomst, mapgrens en DipTrace/KiCad-pariteitsnotities. | - -## Productiepakket - -De huidige productie-export is het rev4-bestelpakket van mei 2025 waarvan is vastgesteld dat het goed functioneert. - -| Asset | Locatie | Opmerkingen | -| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | -| Gerber-archief | [Trainer_gerber_Y35.zip](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/Trainer_gerber_Y35.zip) | Productiearchief van de beproefde bestelling. | -| Productie PCB BOM | [Trainer BoM May 15.xls](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/Trainer%20BoM%20May%2015.xls) | Productie-PCB-stuklijst voor de productieorder. | -| Pick-and-place | [pickplace_dttrainer_rev4 (1).xlsx](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/pickplace_dttrainer_rev4%20%281%29.xlsx) | Gegevens over plaatsing van componenten voor montage. | -| Productie-exportnota's | [README.md](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/production-exports/pcb-rev4/may-2025-good-results/README.md) | Herkomstnotities voor de beproefde productie-export. | - -## Stuklijstgrens - -De canonieke RAD-BOM is [hardware/bom.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/bom.csv). Deze vermeldt de bestukte PCB als één assemblageregel op apparaatniveau, zodat de assemblagedocumentatie gericht blijft op de traineropbouw. - -De onderliggende onderdelen op bordniveau worden bijgehouden in [hardware/pcb/diptrace-rev4/pcb-bom-full.csv](https://github.com/researchanddesire/DT_Trainer-OSS/blob/main/hardware/pcb/diptrace-rev4/pcb-bom-full.csv) om te voorkomen dat fabrikant-, leverancier-, footprintgegevens en assemblagegegevens uit de PCB-bronexport verloren gaan. diff --git a/content/docs/how-this-site-works.de.mdx b/content/docs/how-this-site-works.de.mdx deleted file mode 100644 index cb3788a..0000000 --- a/content/docs/how-this-site-works.de.mdx +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: "So funktioniert diese Website" -description: "So erreichen öffentliche Montageinhalte die Fumadocs-Website von R+D Assembly." ---- - -R+D Assembly verwaltet die öffentliche Dokumentation und die Anwendung, die sie rendert, in getrennten Repositories. Dadurch können Personen, die die Produkte montieren, an den Anleitungen mitwirken, ohne privaten Anwendungscode oder Bereitstellungskonfiguration offenzulegen. - -## Veröffentlichungsablauf - -```mermaid -flowchart LR - Content["Öffentliche Inhalte von assembly-docs"] - Review["Geprüfter Pull Request"] - Sync["Dokumentations-Synchronisierung"] - App["rad-app-Fumadocs-Anwendung"] - Site["ohai.researchanddesire.com"] - - Content --> Review --> Sync --> App --> Site -``` - -Markdown, MDX, Produktnavigation und Montagebilder liegen in -`content/docs/` in diesem Repository. Eine erfolgreiche Änderung löst den -Dokumentationsimport-Workflow in `rad-app` aus. Dieser synchronisiert den -öffentlichen Inhaltsbaum mit der OHAI-Anwendung und veröffentlicht ihn mit -Fumadocs. - -## Zuständigkeitsgrenzen - -- Anleitungen zur Produktmontage, Bilder und Links zu montagerelevanten Quellen - liegen in diesem Repository. -- Die manuell gepflegten Produkt-BOM-Daten verbleiben im jeweiligen - Produkt-Repository unter `hardware/bom.csv`. -- Die Fumadocs-Shell, gemeinsame Komponenten, die Suche, Authentifizierungslinks - und die Bereitstellungskonfiguration liegen in `rad-app`. -- Gerenderte BOM-Tabellen gehören ausschließlich zu R+D Assembly, nicht zu den - Developer Docs. - -## Mitwirken - -Bearbeiten Sie die relevante Datei unter `content/docs/`, führen Sie -`node scripts/validate-content.mjs content` aus und fügen Sie Screenshots bei, -wenn eine Änderung das Layout oder die Bilddarstellung betrifft. Weitere -Informationen zum Review-Prozess finden Sie im -[Beitragsleitfaden](https://github.com/researchanddesire/assembly-docs/blob/main/CONTRIBUTING.md). - -Der stillgelegte MkDocs-Aggregator ist weiterhin als -[historische Migrationsreferenz](./legacy-mkdocs-pipeline) verfügbar, veröffentlicht -die Produktionswebsite jedoch nicht mehr. diff --git a/content/docs/how-this-site-works.fr.mdx b/content/docs/how-this-site-works.fr.mdx deleted file mode 100644 index 2ca31a4..0000000 --- a/content/docs/how-this-site-works.fr.mdx +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: "Comment fonctionne ce site" -description: "Comment le contenu public d'assemblage arrive sur le site Fumadocs de R+D Assembly." ---- - -R+D Assembly conserve la documentation publique et l'application qui l'affiche -dans des dépôts distincts. Les contributeurs peuvent ainsi participer aux -instructions sans exposer le code privé de l'application ni sa configuration de -déploiement. - -## Flux de publication - -```mermaid -flowchart LR - Content["Contenu public d'assembly-docs"] - Review["Pull request examinée"] - Sync["Synchronisation de la documentation"] - App["Application Fumadocs de rad-app"] - Site["ohai.researchanddesire.com"] - - Content --> Review --> Sync --> App --> Site -``` - -Markdown, MDX, la navigation des produits et les images d'assemblage se trouvent -dans `content/docs/` de ce dépôt. Une modification validée déclenche le workflow -d'importation de la documentation dans `rad-app`, qui synchronise l'arborescence -du contenu public avec l'application OHAI et la publie avec Fumadocs. - -## Limites de responsabilité - -- Les instructions d'assemblage des produits, les images et les liens vers les - sources liées à l'assemblage se trouvent dans ce dépôt. -- Les données de BOM des produits, gérées manuellement, restent dans le dépôt de - chaque produit, sous `hardware/bom.csv`. -- Le shell Fumadocs, les composants partagés, la recherche, les liens - d'authentification et la configuration de déploiement se trouvent dans - `rad-app`. -- Les tableaux de BOM rendus appartiennent uniquement à R+D Assembly, et non aux - Developer Docs. - -## Contribuer - -Modifiez le fichier concerné sous `content/docs/`, exécutez -`node scripts/validate-content.mjs content` et ajoutez des captures d'écran -lorsqu'une modification affecte la mise en page ou les images. Consultez le -[guide de contribution](https://github.com/researchanddesire/assembly-docs/blob/main/CONTRIBUTING.md) -pour connaître le processus de revue. - -L'agrégateur MkDocs retiré reste disponible comme -[référence de migration historique](./legacy-mkdocs-pipeline), mais il ne publie -plus le site de production. diff --git a/content/docs/how-this-site-works.mdx b/content/docs/how-this-site-works.mdx deleted file mode 100644 index 4365811..0000000 --- a/content/docs/how-this-site-works.mdx +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: "How This Site Works" -description: "How public assembly content reaches the R+D Assembly Fumadocs site." ---- - -R+D Assembly keeps public documentation and the application that renders it in -separate repositories. This lets builders contribute to the instructions -without exposing private application code or deployment configuration. - -## Publishing flow - -```mermaid -flowchart LR - Content["assembly-docs public content"] - Review["Reviewed pull request"] - Sync["Documentation sync"] - App["rad-app Fumadocs application"] - Site["ohai.researchanddesire.com"] - - Content --> Review --> Sync --> App --> Site -``` - -Markdown, MDX, product navigation, and assembly images live under -`content/docs/` in this repository. A successful change dispatches the -documentation import workflow in `rad-app`, which synchronizes the public -content tree into the OHAI application and publishes it with Fumadocs. - -## Ownership boundaries - -- Product assembly instructions, images, and assembly-facing source links live - in this repository. -- Human-owned product BOM data remains in each product repository's - `hardware/bom.csv`. -- The Fumadocs shell, shared components, search, authentication links, and - deployment configuration live in `rad-app`. -- Rendered BOM tables belong only on R+D Assembly, not in Developer Docs. - -## Contributing - -Edit the relevant file under `content/docs/`, run -`node scripts/validate-content.mjs content`, and include screenshots when a -change affects layout or imagery. See the repository -[contribution guide](https://github.com/researchanddesire/assembly-docs/blob/main/CONTRIBUTING.md) -for the review process. - -The retired MkDocs aggregator remains available as a -[historical migration reference](./legacy-mkdocs-pipeline), but it no longer -publishes the production site. diff --git a/content/docs/how-this-site-works.nl.mdx b/content/docs/how-this-site-works.nl.mdx deleted file mode 100644 index ead4153..0000000 --- a/content/docs/how-this-site-works.nl.mdx +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: "Hoe deze site werkt" -description: "Hoe openbare assemblage-inhoud de Fumadocs-site van R+D Assembly bereikt." ---- - -R+D Assembly beheert de openbare documentatie en de toepassing die deze -weergeeft in afzonderlijke repositories. Zo kunnen bouwers bijdragen aan de -instructies zonder private applicatiecode of uitrolconfiguratie bloot te -leggen. - -## Publicatiestroom - -```mermaid -flowchart LR - Content["Openbare inhoud van assembly-docs"] - Review["Beoordeelde pull request"] - Sync["Synchronisatie van documentatie"] - App["rad-app-Fumadocs-toepassing"] - Site["ohai.researchanddesire.com"] - - Content --> Review --> Sync --> App --> Site -``` - -Markdown, MDX, productnavigatie en assemblageafbeeldingen staan in -`content/docs/` in deze repository. Een geslaagde wijziging activeert de -documentatie-importworkflow in `rad-app`. Die synchroniseert de openbare -inhoudsstructuur met de OHAI-toepassing en publiceert deze met Fumadocs. - -## Verantwoordelijkheidsgrenzen - -- Instructies voor productassemblage, afbeeldingen en links naar bronnen voor - assemblage staan in deze repository. -- De handmatig beheerde product-BOM-gegevens blijven in de repository van elk - product, in `hardware/bom.csv`. -- De Fumadocs-shell, gedeelde componenten, zoekfunctie, links voor - authenticatie en uitrolconfiguratie staan in `rad-app`. -- Gerenderde BOM-tabellen horen alleen thuis op R+D Assembly, niet in de - Developer Docs. - -## Bijdragen - -Bewerk het relevante bestand onder `content/docs/`, voer -`node scripts/validate-content.mjs content` uit en voeg screenshots toe wanneer -een wijziging de lay-out of afbeeldingen beïnvloedt. Bekijk de -[bijdragengids](https://github.com/researchanddesire/assembly-docs/blob/main/CONTRIBUTING.md) -voor het beoordelingsproces. - -De buiten gebruik gestelde MkDocs-aggregator blijft beschikbaar als -[historische migratiereferentie](./legacy-mkdocs-pipeline), maar publiceert de -productiesite niet meer. diff --git a/content/docs/index.de.mdx b/content/docs/index.de.mdx deleted file mode 100644 index db7d69e..0000000 --- a/content/docs/index.de.mdx +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: R+D-Montage -description: Offizielle Bauanweisungen für unterstützte Research and Desire-Hardware. ---- - -Eine einheitliche Montagedokumentation für Hardwareprodukte von Research and Desire. - -Jedes Produktpaket umfasst seine Montageanleitung, Stückliste, Kabelinformationen, PCB-Referenzen und -unterstützende Bilder. - -## Produkte - - - - Montageanleitung, Stückliste, PCB-Übersicht und Hinweise zu Kabelbäumen. - - - Mechanische Montageschritte, Elektronik-Routing, Stückliste und PCB-Kontext. - - - Schrittweise Montageanleitungen für Aktuatoren und Referenzen zu Hardwarequellen. - - - Montage-Workflow für die Fernbedienung mit Produktionsbildern und Quelllinks. - - - -## Mitwirken - -Die Montageinhalte werden im öffentlichen -[researchanddesire/assembly-docs](https://github.com/researchanddesire/assembly-docs) -Repository gepflegt. Öffnen Sie dort einen gezielten Pull Request, um eine Anleitung zu korrigieren, ein Bild zu aktualisieren -oder ein Produktpaket zu verbessern. - -Informationen zum Veröffentlichungsablauf und zu den Inhaltsgrenzen finden Sie unter -[So funktioniert diese Website](./how-this-site-works). diff --git a/content/docs/index.fr.mdx b/content/docs/index.fr.mdx deleted file mode 100644 index 97e8137..0000000 --- a/content/docs/index.fr.mdx +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Assemblage R+D -description: Instructions de construction officielles pour le matériel Research and Desire pris en charge. ---- - -Documentation unifiée de l’assemblage des produits matériels Research and Desire. - -Chaque dossier produit regroupe son guide d’assemblage, sa nomenclature, les informations sur les câbles, les références de PCB et -les images d’accompagnement. - -## Produits - - - - Guide d’assemblage, nomenclature, aperçu du PCB et notes sur les faisceaux de câbles. - - - Étapes d’assemblage mécanique, routage électronique, nomenclature et contexte du PCB. - - - Instructions étape par étape pour l’assemblage des actionneurs et références aux sources matérielles. - - - Flux d’assemblage de la télécommande avec images de production et liens vers les sources. - - - -## Contributions - -Le contenu d’assemblage est maintenu dans le dépôt public -[researchanddesire/assembly-docs](https://github.com/researchanddesire/assembly-docs). -Ouvrez-y une pull request ciblée pour corriger une instruction, mettre à jour une image -ou améliorer un dossier produit. - -Consultez [Comment fonctionne ce site](./how-this-site-works) pour connaître le processus de publication et les -limites du contenu. diff --git a/content/docs/index.mdx b/content/docs/index.mdx index 742fc89..8784cf3 100644 --- a/content/docs/index.mdx +++ b/content/docs/index.mdx @@ -1,36 +1,8 @@ --- title: R+D Assembly -description: Official build instructions for supported Research and Desire hardware. --- -Unified assembly documentation for Research and Desire hardware products. - -Each product package brings together its assembly guide, bill of materials, -cable information, PCB references, and supporting images. - -## Products - - - - Assembly guide, BOM, PCB overview, and cable harness notes. - - - Mechanical build steps, electronics routing, BOM, and PCB context. - - - Ordered actuator build instructions and hardware source references. - - - Remote assembly workflow with production images and source links. - - - -## Contributing - -Assembly content is maintained in the public -[researchanddesire/assembly-docs](https://github.com/researchanddesire/assembly-docs) -repository. Open a focused pull request there to correct an instruction, update -an image, or improve a product package. - -See [How This Site Works](./how-this-site-works) for the publishing flow and -content boundaries. +- [Deepthroat Trainer](/dtt) +- [Lockbox](/lockbox) +- [RADR Wireless Remote](/radr) +- [OSSM](/ossm) diff --git a/content/docs/index.nl.mdx b/content/docs/index.nl.mdx deleted file mode 100644 index 82824bf..0000000 --- a/content/docs/index.nl.mdx +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: R+D-assemblage -description: Officiële bouwinstructies voor ondersteunde hardware van Research and Desire. ---- - -Gecombineerde montagedocumentatie voor hardwareproducten van Research and Desire. - -Elk productpakket bevat de montagehandleiding, stuklijst, kabelinformatie, PCB-referenties en -ondersteunende afbeeldingen. - -## Producten - - - - Montagehandleiding, stuklijst, PCB-overzicht en opmerkingen over kabelbomen. - - - Mechanische bouwstappen, elektronicarouting, stuklijst en PCB-context. - - - Stapsgewijze bouwinstructies voor actuatoren en verwijzingen naar hardwarebronnen. - - - Assemblageworkflow voor de afstandsbediening met productieafbeeldingen en bronlinks. - - - -## Bijdragen - -De montage-inhoud wordt onderhouden in de openbare -[researchanddesire/assembly-docs](https://github.com/researchanddesire/assembly-docs) -repository. Open daar een gerichte pull request om een instructie te corrigeren, een afbeelding bij te werken -of een productpakket te verbeteren. - -Zie [Hoe deze site werkt](./how-this-site-works) voor het publicatieproces en -de grenzen van de inhoud. diff --git a/content/docs/legacy-mkdocs-pipeline.de.mdx b/content/docs/legacy-mkdocs-pipeline.de.mdx deleted file mode 100644 index f4e055f..0000000 --- a/content/docs/legacy-mkdocs-pipeline.de.mdx +++ /dev/null @@ -1,306 +0,0 @@ ---- -title: "So funktioniert diese Website" -description: "Historische Referenz für die stillgelegte MkDocs-Assembly-Pipeline." ---- - -{/* Ported from MkDocs: how-this-site-works.md */} - - - Diese Seite bewahrt die frühere MkDocs-Assembly-Pipeline als Migrationsreferenz. Fumadocs in - rad-app und die geprüfte bidirektionale Inhaltssynchronisierung sind nun für die - Veröffentlichung zuständig. - - -Diese Website ist ein Aggregator. Produktteams pflegen ihre Montagedokumentation in -den jeweiligen Produkt-Repositorys, und dieses Repository fügt diese Pakete zu einer - einheitlichen MkDocs Material-Website zusammen. - -Die wichtige Regel lautet: Die Inhalte der Produktmontage gehören den Produkt- -Repositorys. Dieses Repository besitzt die Site-Hülle, die Build-Skripte, das gemeinsame -Styling und die Automatisierung, die Produktdokumente in die veröffentlichte Website umwandelt. - -## Quelllayout - -```mermaid -flowchart TD - ProductRepo["Product repo"] - ProductAssembly["assembly-docs/"] - ProductAssets["assembly-docs/assets/"] - ProductNav["assembly-docs/nav.yml"] - ProductBom["hardware/bom.csv"] - Aggregator["assembly-docs repo"] - AssembledDocs["docs/{product}/"] - Site["Published MkDocs site"] - - ProductRepo --> ProductAssembly - ProductRepo --> ProductBom - ProductAssembly --> ProductAssets - ProductAssembly --> ProductNav - ProductAssembly --> Aggregator - ProductBom --> Aggregator - Aggregator --> AssembledDocs - AssembledDocs --> Site -``` - -Jedes für Ohai geeignete Produkt-Repository trägt Folgendes bei: - -- `assembly-docs/`: Markdown-Seiten für die Montageanleitung des Produkts. -- `assembly-docs/assets/`: Produktbilder und andere Seitenressourcen. -- `assembly-docs/site.yml`: Produkt-Slug, Titel, Lizenz und Navigationsreihenfolge. -- `assembly-docs/nav.yml`: Lokale Seitenreihenfolge des Produkts und Abschnittstitel. -- `hardware/bom.csv`: Die vom Menschen gepflegten Quelldaten der Stückliste. -- Hardware-Quellordner unter `hardware/cad/`, `hardware/pcb/` und - `hardware/cables/`. -- GitHub-Thema `ohai-assembly-docs`, nachdem Platzhalter ersetzt wurden und lokale - Montage-/Build-Prüfungen erfolgreich sind. - -Dieses Repository trägt Folgendes bei: - -- `mkdocs.yml`: MkDocs Material-Konfiguration für die einheitliche Website. -- `docs/index.md`: Die Homepage der Website. -- `docs/how-this-site-works.md`: Produktübergreifende Site-Dokumentation. -- `scripts/assemble-docs.sh`: Der zentrale Assembler. -- `scripts/render_bom.py`: Renderer für Stücklisten. -- `scripts/bom_categories.py`: Gemeinsame Bezeichnungen und Farbzuordnung für Stücklistenkategorien. -- `docs/stylesheets/assembly.css`: Gemeinsame Styles der Assembly-Website. -- `.github/workflows/deploy.yml`: Workflow zum Zusammenstellen, Bauen und Veröffentlichen der Website. -- `.github/workflows/bom-release.yml`: Wiederverwendbarer Workflow für eigenständige Stücklisten-Releases. -- `templates/`: In Produkt-Repositorys kopierte Workflows. - -## Build-Ablauf - -```mermaid -flowchart TD - Start["Deploy workflow starts"] - Checkout["Checkout this repo"] - Keys["Write optional read-only deploy keys"] - Assemble["Run scripts/assemble-docs.sh"] - Discover["Discover local or topic-tagged product repos"] - Clone["Clone or use local product repos"] - Copy["Copy each assembly-docs/ folder"] - Nav["Convert nav.yml to .pages"] - Bom["Render hardware/bom.csv into copied bom.md"] - Pcb["Split PCB design assets and insert KiCanvas when possible"] - Links["Rewrite product-relative links to GitHub URLs"] - Build["mkdocs build"] - Upload["Upload Pages artifact"] - Publish["Deploy GitHub Pages"] - - Start --> Checkout --> Keys --> Assemble - Assemble --> Discover --> Clone --> Copy --> Nav --> Bom --> Pcb --> Links - Links --> Build --> Upload --> Publish -``` - -Der Assembler erstellt zunächst für jedes Produkt eine Staging-Ausgabe und ersetzt erst dann -`docs/{product}/`, wenn die Assemblierung dieses Produkts erfolgreich war. Diese Produktordner sind -Ausgaben; bearbeiten Sie sie daher nicht manuell. Ändern Sie die Produktdokumentation stattdessen -im Quell-Repository des Produkts. - -Lokal können Sie denselben Assemblierungsprozess gegen nahegelegene Checkouts ausführen: - -```bash -pip install -r requirements.txt -ASSEMBLE_LOCAL="$HOME/Github" ./scripts/assemble-docs.sh -mkdocs serve -``` - -Ohne `ASSEMBLE_LOCAL` entdeckt der Assembler nicht archivierte -`researchanddesire/*`-Repositorys mit dem Thema `ohai-assembly-docs`. In CI verwendet er -`ASSEMBLE_GITHUB_TOKEN` zur privaten Erkennung und zum Klonen, sofern gesetzt, bevorzugt pro -Repository vorhandene schreibgeschützte Deploy-Schlüssel und greift dann für öffentliche -Repositorys auf anonymes HTTPS zurück. - -## CI-Trigger - -Der zentrale Deployment-Workflow befindet sich unter `.github/workflows/deploy.yml`. - -```mermaid -flowchart TD - ProductPush["Product repo push to main"] - ProductPaths["assembly-docs/**, BOM, PCB, or cable source changed"] - TriggerWorkflow["Product trigger-assembly-docs.yml"] - Dispatch["repository_dispatch: assembly-docs-rebuild"] - RepoPush["Push to this repo main"] - RepoPaths["docs/**, mkdocs.yml, or scripts/** changed"] - Manual["Manual workflow_dispatch"] - Deploy["assembly-docs deploy.yml"] - Pages["GitHub Pages publish"] - - ProductPush --> ProductPaths --> TriggerWorkflow --> Dispatch --> Deploy - RepoPush --> RepoPaths --> Deploy - Manual --> Deploy - Deploy --> Pages -``` - -Produkt-Repositorys sollten `templates/trigger-assembly-docs.yml` nach -`.github/workflows/trigger-assembly-docs.yml` kopieren und `` durch -ihren Repository-Namen ersetzen. Dieser Workflow überwacht `assembly-docs/**`, BOM-CSV-Dateien, -`hardware/pcb/**` und `hardware/cables/**`. Er benötigt ein `DOCS_DISPATCH_TOKEN`- -Secret mit der Berechtigung, einen Repository-Dispatch an dieses Repository zu senden. - -Der Deployment-Workflow: - -1. Checkt dieses Repository aus. -2. Schreibt alle konfigurierten schreibgeschützten Deploy-Schlüssel in das temporäre Verzeichnis des Runners. -3. Führt `scripts/assemble-docs.sh` aus, entdeckt themenmarkierte Produkte und - erstellt für jedes Produkt eine Staging-Ausgabe, bevor die veröffentlichte Ausgabe ersetzt wird. -4. Installiert die MkDocs-Abhängigkeiten von `requirements.txt`. -5. Führt `mkdocs build` aus. -6. Lädt das generierte `site/`-Verzeichnis als Pages-Artefakt hoch. -7. Stellt das Artefakt auf GitHub Pages bereit. - -## Stücklisten-Rendering - -Die maßgebliche Quelle der Stückliste ist immer `hardware/bom.csv` im Produkt-Repository. -Das Rendering ist für diese CSV schreibgeschützt. - -```mermaid -flowchart TD - Csv["hardware/bom.csv"] - Schema["Canonical BOM schema"] - Page["Copied docs/{product}/bom.md"] - Markers["BEGIN/END GENERATED BOM markers"] - Renderer["scripts/render_bom.py"] - Categories["scripts/bom_categories.py"] - Css["docs/stylesheets/assembly.css"] - Output["Rendered BOM block in assembled site"] - - Csv --> Renderer - Schema --> Renderer - Page --> Markers --> Renderer - Categories --> Renderer - Css --> Output - Renderer --> Output -``` - -`scripts/render_bom.py` validiert den kanonischen 12-spaltigen Stücklistenkopf, bevor es -ihn rendert. Es ersetzt nur den Inhalt zwischen diesen Markierungen auf der kopierten Seite: - -```html -{/* BEGIN GENERATED BOM */} {/* END GENERATED BOM */} -``` - -Wenn `assembly-docs/bom.md` eines Produkts diese Markierungen nicht enthält, bleibt die Seite -unverändert. Wenn `hardware/bom.csv` nur eine Kopfzeile und keine Datenzeilen enthält, -überspringt der Renderer sie, anstatt die Seite zu leeren. - -Die gerenderte Stückliste gehört ausschließlich auf diese Assembly-Docs-Website. Entwicklerdokumente können -den Stücklisten-Workflow dokumentieren, sollten aber nicht die gerenderte Stücklistentabelle einbetten. - -## Kabelbäume - -Die Quelldateien der Kabelbäume gehören in `hardware/cables/` des Produkt-Repositorys. -Von Wireviz generierte untergeordnete Stücklisten gehören zu Release-/Build-Artefakten wie -`.bom.tsv`-Dateien. - -Auf Produktebene listet `hardware/bom.csv` Kabelbäume als Baugruppen der obersten Ebene auf. -Wenn ein Kabelbaum eine Wireviz-Quelle besitzt, sollte `Source` in der Produktstückliste auf den -Quellpfad relativ zu `hardware/` verweisen, zum Beispiel -`cables/OSSM-Motor-Control-Harness.yml`. Assembly-Seiten für Kabel verknüpfen generierte -Diagramme und untergeordnete Stücklistenartefakte, statt untergeordnete Kabelzeilen in die -Stückliste auf Produktebene zu kopieren. - -## Release-Stücklistenartefakte - -Getaggte Produkt-Releases können auch ein eigenständiges `bom.html`-Artefakt generieren. - -```mermaid -flowchart TD - Tag["Product repo tag push, v*"] - Caller["Product generate-bom-release.yml"] - Reusable["assembly-docs .github/workflows/bom-release.yml"] - Detect["Check for committed hardware/bom.html"] - Skip["Skip generation"] - Tooling["Checkout assembly-docs scripts"] - Render["Render standalone dist/bom.html"] - Artifact["Upload Actions artifact"] - Release["Attach bom.html to GitHub Release"] - - Tag --> Caller --> Reusable --> Detect - Detect -->|"exists"| Skip - Detect -->|"missing"| Tooling --> Render - Render --> Artifact - Render --> Release -``` - -Produkt-Repositorys sollten `templates/generate-bom-release.yml` nach -`.github/workflows/generate-bom-release.yml` kopieren und Produktname, Repository-URL -und Lizenzzeichenfolge festlegen. Das Produkt-Repository wird vom wiederverwendbaren Workflow ausgecheckt; -nur die BOM-Rendering-Skripte werden aus diesem Repository abgerufen. - -## Richtig beitragen - -Verwenden Sie diese Faustregel: Bearbeiten Sie Inhalte dort, wo sie gepflegt werden. - -| Ändern | Hier bearbeiten | -| --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | -| Produktmontageschritte, Produktbilder, Text der Produktstücklistenseite, PCB-Übersicht, Kabelseiten | Produkt-Repo `assembly-docs/` | -| Produktstücklistendaten | Produkt-Repo `hardware/bom.csv` | -| Reihenfolge der Produktmontagenavigation | Produkt-Repo `assembly-docs/nav.yml` | -| Produktmetadaten für Ohai-Erkennung | Produkt-Repo `assembly-docs/site.yml` | -| CAD-, PCB- und Kabelquellenartefakte | Produkt-Repo `hardware/cad/`, `hardware/pcb/`, `hardware/cables/` | -| Site-Homepage oder produktübergreifende Site-Dokumente | Dieses Repo `docs/` außerhalb der Produktordner | -| Verhalten der Assembly-Pipeline | Dieses Repo `scripts/` | -| Geteiltes Site-Styling | Dieses Repo `docs/stylesheets/assembly.css` | -| Bereitstellung von GitHub Pages | Dieses Repo `.github/workflows/deploy.yml` | -| Auslöservorlage für den erneuten Produkt-Build | Dieses Repo `templates/trigger-assembly-docs.yml` | -| Vorlage zur Generierung von Release-Stücklisten | Dieses Repo `templates/generate-bom-release.yml` | - -Das sollten Sie tun: - -- Nehmen Sie zunächst Änderungen am Produktinhalt im Produkt-Repository vor. -- Halten Sie `hardware/bom.csv` in menschlicher Hand und schemakonform. -- Fügen Sie `{/* BEGIN GENERATED BOM */}` und `{/* END GENERATED BOM */}` in eine - Produktseite `assembly-docs/bom.md` ein, wenn diese Seite für generierten Inhalt bereit ist. -- Halten Sie `assembly-docs/site.yml` echt und platzhalterfrei, bevor Sie das - Thema `ohai-assembly-docs` hinzufügen. -- Testen Sie Site-Änderungen lokal mit `ASSEMBLE_LOCAL="$HOME/Github" ./scripts/assemble-docs.sh` - und `mkdocs serve`. -- Behandeln Sie `scripts/bom_categories.py` als einzige Quelle für Stücklistenkategoriebezeichnungen - und Farben. -- Halten Sie die Ausgabe deterministisch: Es dürfen keine Zeitstempel oder instabilen - Reihenfolgen in generierten Dokumenten enthalten sein. - -Das sollten Sie nicht tun: - -- Bearbeiten Sie `docs/dtt/`, `docs/lockbox/`, `docs/radr/`, `docs/ossm/` oder andere - generierte Produktordner nicht manuell. -- Fügen Sie `ohai-assembly-docs` nicht zu Vorlagen-Repositorys oder Repositorys mit - `PRODUCT_*`-Platzhaltern hinzu. -- Committen Sie generierte Stücklistenblöcke nicht zurück in Produkt-Repositories. -- Kopieren Sie die untergeordneten Wireviz-Kabelstücklistenzeilen nicht in die Stückliste auf Produktebene. -- Ändern Sie das Stücklistenschema in diesem Repository nicht. -- Duplizieren Sie die Farbzuordnung der Stücklistenkategorien nicht in CSS. -- Fügen Sie gerenderte Baugruppen-Stücklistentabellen nicht in Entwicklerdokumente ein. -- Verwenden Sie keine ausschließlich lokalen Assets oder absoluten lokalen Pfade in Produktdokumenten. - -## Neues Produkt hinzufügen - -1. Fügen Sie dem Produkt-Repository einen `assembly-docs/`-Ordner hinzu. -2. Fügen Sie `assembly-docs/site.yml` mit echtem `slug`, `title`, `license` und einer - ganzzahligen `nav_order` hinzu. -3. Fügen Sie `assembly-docs/nav.yml` mit `site_name` und der Standardseitenreihenfolge hinzu. -4. Fügen Sie `index.md`, `pcb-overview.md`, `cable-harnesses.md`, `bom.md` und - `assembly-guide.md`. -5. Legen Sie Seitenbilder und unterstützende Dateien unter `assembly-docs/assets/` ab. -6. Fügen Sie `hardware/bom.csv` zum kanonischen Stücklistenschema hinzu oder validieren Sie es. -7. Stellen Sie sicher, dass `hardware/cad/`, `hardware/pcb/` und `hardware/cables/` vorhanden sind. -8. Kopieren Sie die Trigger-Workflow-Vorlage in das Produkt-Repository. -9. Bestätigen Sie, dass die lokale Assemblierung und `mkdocs build --strict` erfolgreich sind. -10. Fügen Sie das Thema `ohai-assembly-docs` hinzu, um das Produkt in die Website aufzunehmen. - -Konfigurieren Sie für private Repositorys `ASSEMBLE_GITHUB_TOKEN` mit Lesezugriff auf die -Produkt-Repositorys. Schreibgeschützte Deploy-Schlüssel pro Repository werden während des -Übergangs weiterhin unterstützt. Sobald die Repositorys öffentlich sind, genügt anonymes HTTPS-Klonen. - -## Fehlerbehebung - -| Symptom | Prüfen | -| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | -| Produktseite wurde nicht aktualisiert | Hat sich das Quell-Repository des Produkts unter `assembly-docs/**` geändert, und hat der Trigger-Workflow erfolgreich einen Dispatch gesendet? | -| Stückliste wurde nicht gerendert | Enthält `assembly-docs/bom.md` beide generierten Stücklistenmarkierungen? Enthält `hardware/bom.csv` Datenzeilen? | -| Stücklisten-Rendering fehlgeschlagen | Entspricht `hardware/bom.csv` genau dem kanonischen 12-spaltigen Header? | -| Bilder fehlen | Liegen die Assets unter `assembly-docs/assets/`, und sind die Seitenlinks relativ zum Produktdokumentationspaket? | -| Produktbezogene Quelllinks sind defekt | Prüfen Sie `scripts/rewrite_product_links.py` und die Produkt-Repository-/Branch-Konfiguration in `scripts/assemble-docs.sh`. | -| KiCanvas wurde nicht angezeigt | Stellen Sie sicher, dass eine `*.kicad_pcb`-Datei unter `hardware/pcb/` des Produkt-Repositorys vorhanden ist. | -| Produkt wurde bei der Erkennung übersprungen | Prüfen Sie das Thema `ohai-assembly-docs`, das platzhalterfreie `assembly-docs/site.yml` und die erforderlichen Montage-/Hardwarepfade. | diff --git a/content/docs/legacy-mkdocs-pipeline.fr.mdx b/content/docs/legacy-mkdocs-pipeline.fr.mdx deleted file mode 100644 index f530c65..0000000 --- a/content/docs/legacy-mkdocs-pipeline.fr.mdx +++ /dev/null @@ -1,306 +0,0 @@ ---- -title: "Comment fonctionne ce site" -description: "Référence historique pour le pipeline d’assemblage MkDocs retiré." ---- - -{/* Ported from MkDocs: how-this-site-works.md */} - - - Cette page conserve l’ancien pipeline d’assemblage MkDocs comme référence de migration. Fumadocs dans - rad-app et la synchronisation bidirectionnelle vérifiée du contenu sont désormais responsables de la - publication. - - -Ce site est un agrégateur. Les équipes produit gèrent la documentation d’assemblage dans -chaque dépôt de produit, et ce dépôt regroupe ces packages en un seul -site MkDocs Material. - -La règle importante est que le contenu d’assemblage du produit appartient aux dépôts de -produits. Ce dépôt possède l’enveloppe du site, les scripts de build, le style partagé et -l’automatisation qui transforme la documentation des produits en site publié. - -## Disposition des sources - -```mermaid -flowchart TD - ProductRepo["Product repo"] - ProductAssembly["assembly-docs/"] - ProductAssets["assembly-docs/assets/"] - ProductNav["assembly-docs/nav.yml"] - ProductBom["hardware/bom.csv"] - Aggregator["assembly-docs repo"] - AssembledDocs["docs/{product}/"] - Site["Published MkDocs site"] - - ProductRepo --> ProductAssembly - ProductRepo --> ProductBom - ProductAssembly --> ProductAssets - ProductAssembly --> ProductNav - ProductAssembly --> Aggregator - ProductBom --> Aggregator - Aggregator --> AssembledDocs - AssembledDocs --> Site -``` - -Chaque dépôt de produit éligible pour Ohai fournit : - -- `assembly-docs/` : pages Markdown du guide d’assemblage du produit. -- `assembly-docs/assets/` : images du produit et autres ressources de page. -- `assembly-docs/site.yml` : slug, titre, licence et ordre de navigation du produit. -- `assembly-docs/nav.yml` : ordre des pages du produit et titre de la section. -- `hardware/bom.csv` : données sources de la nomenclature gérées par les personnes. -- Répertoires de sources matérielles sous `hardware/cad/`, `hardware/pcb/` et - `hardware/cables/`. -- Le topic GitHub `ohai-assembly-docs`, une fois les espaces réservés remplacés et - les vérifications locales d’assemblage et de build réussies. - -Ce dépôt fournit : - -- `mkdocs.yml` : configuration MkDocs Material du site unifié. -- `docs/index.md` : page d’accueil du site. -- `docs/how-this-site-works.md` : documentation du site multi-produits. -- `scripts/assemble-docs.sh` : assembleur principal. -- `scripts/render_bom.py` : moteur de rendu de la nomenclature. -- `scripts/bom_categories.py` : libellés de catégories et palette de couleurs partagés de la nomenclature. -- `docs/stylesheets/assembly.css` : styles partagés du site d’assemblage. -- `.github/workflows/deploy.yml` : workflow d’assemblage, de build et de publication du site. -- `.github/workflows/bom-release.yml` : workflow réutilisable pour publier une nomenclature autonome. -- `templates/` : workflows copiés dans les dépôts de produits. - -## Déroulement du build - -```mermaid -flowchart TD - Start["Deploy workflow starts"] - Checkout["Checkout this repo"] - Keys["Write optional read-only deploy keys"] - Assemble["Run scripts/assemble-docs.sh"] - Discover["Discover local or topic-tagged product repos"] - Clone["Clone or use local product repos"] - Copy["Copy each assembly-docs/ folder"] - Nav["Convert nav.yml to .pages"] - Bom["Render hardware/bom.csv into copied bom.md"] - Pcb["Split PCB design assets and insert KiCanvas when possible"] - Links["Rewrite product-relative links to GitHub URLs"] - Build["mkdocs build"] - Upload["Upload Pages artifact"] - Publish["Deploy GitHub Pages"] - - Start --> Checkout --> Keys --> Assemble - Assemble --> Discover --> Clone --> Copy --> Nav --> Bom --> Pcb --> Links - Links --> Build --> Upload --> Publish -``` - -L’assembleur prépare d’abord chaque produit, puis ne remplace `docs/{product}/` qu’après -la réussite de l’assemblage du produit. Ces dossiers de produits sont des sorties générées ; -évitez donc de les modifier manuellement. Modifiez plutôt la documentation dans le dépôt -source du produit. - -En local, vous pouvez exécuter le même processus d’assemblage sur des clones voisins : - -```bash -pip install -r requirements.txt -ASSEMBLE_LOCAL="$HOME/Github" ./scripts/assemble-docs.sh -mkdocs serve -``` - -Sans `ASSEMBLE_LOCAL`, l’assembleur découvre les dépôts non archivés -`researchanddesire/*` portant le topic `ohai-assembly-docs`. En CI, il utilise -`ASSEMBLE_GITHUB_TOKEN` pour la découverte et le clonage privés lorsqu’il est défini, privilégie -les clés de déploiement en lecture seule propres à chaque dépôt lorsqu’elles sont disponibles, -puis utilise le clonage HTTPS anonyme pour les dépôts publics. - -## Déclencheurs CI - -Le workflow de déploiement principal se trouve dans `.github/workflows/deploy.yml`. - -```mermaid -flowchart TD - ProductPush["Product repo push to main"] - ProductPaths["assembly-docs/**, BOM, PCB, or cable source changed"] - TriggerWorkflow["Product trigger-assembly-docs.yml"] - Dispatch["repository_dispatch: assembly-docs-rebuild"] - RepoPush["Push to this repo main"] - RepoPaths["docs/**, mkdocs.yml, or scripts/** changed"] - Manual["Manual workflow_dispatch"] - Deploy["assembly-docs deploy.yml"] - Pages["GitHub Pages publish"] - - ProductPush --> ProductPaths --> TriggerWorkflow --> Dispatch --> Deploy - RepoPush --> RepoPaths --> Deploy - Manual --> Deploy - Deploy --> Pages -``` - -Les dépôts de produits doivent copier `templates/trigger-assembly-docs.yml` vers -`.github/workflows/trigger-assembly-docs.yml` et remplacer `` par -le nom de leur dépôt. Ce workflow surveille `assembly-docs/**`, les CSV de nomenclature, -`hardware/pcb/**` et `hardware/cables/**`. Il nécessite un secret `DOCS_DISPATCH_TOKEN` -autorisé à envoyer un événement repository_dispatch à ce dépôt. - -Le workflow de déploiement : - -1. Extrait ce dépôt. -2. Écrit toutes les clés de déploiement en lecture seule configurées dans le répertoire temporaire du runner. -3. Exécute `scripts/assemble-docs.sh`, qui découvre les produits portant le topic et - prépare chaque produit avant de remplacer la sortie publiée. -4. Installe les dépendances MkDocs à partir de `requirements.txt`. -5. Exécute `mkdocs build`. -6. Téléverse le répertoire `site/` généré comme artefact Pages. -7. Déploie l’artefact sur GitHub Pages. - -## Rendu de la nomenclature - -La source de vérité de la nomenclature est toujours `hardware/bom.csv` dans le dépôt du produit. -Le rendu de ce CSV est en lecture seule. - -```mermaid -flowchart TD - Csv["hardware/bom.csv"] - Schema["Canonical BOM schema"] - Page["Copied docs/{product}/bom.md"] - Markers["BEGIN/END GENERATED BOM markers"] - Renderer["scripts/render_bom.py"] - Categories["scripts/bom_categories.py"] - Css["docs/stylesheets/assembly.css"] - Output["Rendered BOM block in assembled site"] - - Csv --> Renderer - Schema --> Renderer - Page --> Markers --> Renderer - Categories --> Renderer - Css --> Output - Renderer --> Output -``` - -`scripts/render_bom.py` valide l’en-tête canonique de nomenclature à 12 colonnes avant de -le rendre. Il remplace uniquement le contenu entre ces marqueurs dans la page copiée : - -```html -{/* BEGIN GENERATED BOM */} {/* END GENERATED BOM */} -``` - -Si la page `assembly-docs/bom.md` d’un produit ne contient pas ces marqueurs, elle -reste inchangée. Si `hardware/bom.csv` ne contient qu’une ligne d’en-tête et aucune ligne de données, -le moteur de rendu ignore le fichier au lieu de vider la page. - -La nomenclature rendue appartient uniquement à ce site assembly-docs. La documentation développeur peut -décrire le workflow de nomenclature, mais ne doit pas intégrer la table rendue. - -## Faisceaux de câbles - -Les fichiers sources des faisceaux de câbles se trouvent dans `hardware/cables/` du dépôt du produit. -Les nomenclatures enfants générées par Wireviz sont des artefacts de release/build tels que les -fichiers `.bom.tsv`. - -Au niveau du produit, `hardware/bom.csv` répertorie les faisceaux de câbles comme assemblages de premier niveau. -Lorsqu’un faisceau possède une source Wireviz, `Source` dans la nomenclature du produit doit pointer -vers le chemin source relatif à `hardware/`, par exemple -`cables/OSSM-Motor-Control-Harness.yml`. Les pages des faisceaux d’assemblage renvoient vers les -diagrammes générés et les artefacts des nomenclatures enfants au lieu de copier les lignes des -câbles enfants dans la nomenclature du produit. - -## Artefacts de nomenclature des releases - -Les releases taguées des produits peuvent également générer un artefact autonome `bom.html`. - -```mermaid -flowchart TD - Tag["Product repo tag push, v*"] - Caller["Product generate-bom-release.yml"] - Reusable["assembly-docs .github/workflows/bom-release.yml"] - Detect["Check for committed hardware/bom.html"] - Skip["Skip generation"] - Tooling["Checkout assembly-docs scripts"] - Render["Render standalone dist/bom.html"] - Artifact["Upload Actions artifact"] - Release["Attach bom.html to GitHub Release"] - - Tag --> Caller --> Reusable --> Detect - Detect -->|"exists"| Skip - Detect -->|"missing"| Tooling --> Render - Render --> Artifact - Render --> Release -``` - -Les dépôts de produits doivent copier `templates/generate-bom-release.yml` vers -`.github/workflows/generate-bom-release.yml` et définir le nom du produit, l’URL du dépôt -et la chaîne de licence. Le dépôt du produit est extrait par le workflow réutilisable ; -seuls les scripts de rendu de la nomenclature sont récupérés depuis ce dépôt. - -## Bien contribuer - -Utilisez cette règle générale : modifiez le contenu là où il appartient. - -| Modification | Modifier ici | -| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | -| Étapes d'assemblage du produit, images du produit, texte de la page de nomenclature du produit, aperçu des PCB, pages de câbles | Référentiel produit `assembly-docs/` | -| Données de nomenclature de produit | Référentiel produit `hardware/bom.csv` | -| Ordre de navigation de l'assemblage du produit | Référentiel produit `assembly-docs/nav.yml` | -| Métadonnées du produit pour la découverte Ohai | Référentiel produit `assembly-docs/site.yml` | -| CAO, PCB, artefacts de source de câble | Référentiel produit `hardware/cad/`, `hardware/pcb/`, `hardware/cables/` | -| Page d'accueil du site ou documents du site multi-produits | Ce dépôt `docs/` en dehors des dossiers de produits | -| Comportement du pipeline d'assemblage | Ce dépôt `scripts/` | -| Style de site partagé | Ce dépôt `docs/stylesheets/assembly.css` | -| Déploiement de GitHub Pages | Ce dépôt `.github/workflows/deploy.yml` | -| Modèle de déclencheur de reconstruction de produit | Ce dépôt `templates/trigger-assembly-docs.yml` | -| Modèle de génération de nomenclature de release | Ce dépôt `templates/generate-bom-release.yml` | - -À faire : - -- Apportez d'abord des modifications au contenu du produit dans le dépôt du produit. -- Gardez `hardware/bom.csv` géré par des personnes et conforme au schéma. -- Incluez `{/* BEGIN GENERATED BOM */}` et `{/* END GENERATED BOM */}` dans la page produit - `assembly-docs/bom.md` lorsqu’elle est prête pour le contenu généré. -- Gardez `assembly-docs/site.yml` réel et sans espace réservé avant d’ajouter le - topic `ohai-assembly-docs`. -- Testez les modifications localement avec `ASSEMBLE_LOCAL="$HOME/Github" ./scripts/assemble-docs.sh` - et `mkdocs serve`. -- Considérez `scripts/bom_categories.py` comme la source unique des libellés de catégories de - nomenclature et de leurs couleurs. -- Gardez la sortie déterministe : ne générez aucun horodatage ni ordre instable dans la - documentation générée. - -À ne pas faire : - -- Ne modifiez pas manuellement `docs/dtt/`, `docs/lockbox/`, `docs/radr/`, `docs/ossm/` ou d’autres - dossiers de produits assemblés. -- N’ajoutez pas `ohai-assembly-docs` aux dépôts modèles ou aux dépôts contenant des espaces réservés - `PRODUCT_*`. -- Ne réintégrez pas les blocs de nomenclature générés dans les dépôts de produits. -- Ne copiez pas les lignes des nomenclatures de câbles enfants Wireviz dans la nomenclature du produit. -- Ne modifiez pas le schéma de nomenclature dans ce dépôt. -- Ne dupliquez pas la palette de couleurs des catégories de nomenclature dans le CSS. -- N’ajoutez pas de tables de nomenclature d’assemblage rendues à la documentation développeur. -- Ne faites pas dépendre la documentation produit d’assets exclusivement locaux ou de chemins locaux absolus. - -## Ajout d'un nouveau produit - -1. Ajoutez un dossier `assembly-docs/` au dépôt du produit. -2. Ajoutez `assembly-docs/site.yml` avec un `slug`, un `title` et une `license` réels, - ainsi qu’un `nav_order` entier. -3. Ajoutez `assembly-docs/nav.yml` avec `site_name` et l'ordre des pages standard. -4. Incluez `index.md`, `pcb-overview.md`, `cable-harnesses.md`, `bom.md` et - `assembly-guide.md`. -5. Placez les images de page et les fichiers de support sous `assembly-docs/assets/`. -6. Ajoutez ou validez `hardware/bom.csv` par rapport au schéma canonique de nomenclature. -7. Veillez à ce que `hardware/cad/`, `hardware/pcb/` et `hardware/cables/` soient présents. -8. Copiez le modèle de workflow de déclenchement dans le dépôt du produit. -9. Vérifiez l’assemblage local et la réussite de `mkdocs build --strict`. -10. Ajoutez le topic `ohai-assembly-docs` pour rejoindre le site. - -Pour les dépôts privés, configurez `ASSEMBLE_GITHUB_TOKEN` avec un accès en lecture aux -dépôts de produits. Les clés de déploiement en lecture seule par dépôt restent prises en charge pendant la -transition. Une fois les dépôts publics, le clonage HTTPS anonyme suffit. - -## Dépannage - -| Symptôme | Vérifier | -| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | -| La page produit n’a pas été mise à jour | Le dépôt source a-t-il changé sous `assembly-docs/**` et le workflow de déclenchement a-t-il envoyé l’événement de dispatch avec succès ? | -| La nomenclature n’a pas été rendue | `assembly-docs/bom.md` contient-il les deux marqueurs générés ? `hardware/bom.csv` contient-il des lignes de données ? | -| Le rendu de la nomenclature a échoué | `hardware/bom.csv` correspond-il exactement à l’en-tête canonique à 12 colonnes ? | -| Des images sont manquantes | Les assets se trouvent-ils sous `assembly-docs/assets/` et les liens de page sont-ils relatifs au package de documentation produit ? | -| Les liens sources relatifs au produit sont rompus | Vérifiez `scripts/rewrite_product_links.py` et la configuration du dépôt/de la branche dans `scripts/assemble-docs.sh`. | -| KiCanvas n’est pas apparu | Confirmez qu’un fichier `*.kicad_pcb` existe sous `hardware/pcb/` du dépôt du produit. | -| Le produit a été ignoré lors de la découverte | Confirmez le topic `ohai-assembly-docs`, le fichier `assembly-docs/site.yml` sans espace réservé et les chemins d’assemblage/matériel requis. | diff --git a/content/docs/legacy-mkdocs-pipeline.mdx b/content/docs/legacy-mkdocs-pipeline.mdx deleted file mode 100644 index 236982f..0000000 --- a/content/docs/legacy-mkdocs-pipeline.mdx +++ /dev/null @@ -1,306 +0,0 @@ ---- -title: "How This Site Works" -description: "Historical reference for the retired MkDocs assembly pipeline." ---- - -{/* Ported from MkDocs: how-this-site-works.md */} - - - This page preserves the previous MkDocs assembly pipeline for migration - reference. Fumadocs in rad-app and the reviewed bidirectional content sync now - own publication. - - -This site is an aggregator. Product teams maintain assembly documentation in -each product repository, and this repository assembles those packages into one -MkDocs Material site. - -The important rule is that product assembly content is owned by the product -repos. This repo owns the site shell, the build scripts, shared styling, and the -automation that turns product docs into the published site. - -## Source layout - -```mermaid -flowchart TD - ProductRepo["Product repo"] - ProductAssembly["assembly-docs/"] - ProductAssets["assembly-docs/assets/"] - ProductNav["assembly-docs/nav.yml"] - ProductBom["hardware/bom.csv"] - Aggregator["assembly-docs repo"] - AssembledDocs["docs/{product}/"] - Site["Published MkDocs site"] - - ProductRepo --> ProductAssembly - ProductRepo --> ProductBom - ProductAssembly --> ProductAssets - ProductAssembly --> ProductNav - ProductAssembly --> Aggregator - ProductBom --> Aggregator - Aggregator --> AssembledDocs - AssembledDocs --> Site -``` - -Each Ohai-eligible product repository contributes: - -- `assembly-docs/`: Markdown pages for the product assembly guide. -- `assembly-docs/assets/`: Product images and other page assets. -- `assembly-docs/site.yml`: Product slug, title, license, and nav order. -- `assembly-docs/nav.yml`: Product-local page order and section title. -- `hardware/bom.csv`: The human-owned bill of materials source data. -- Hardware source folders under `hardware/cad/`, `hardware/pcb/`, and - `hardware/cables/`. -- GitHub topic `ohai-assembly-docs` after placeholders are replaced and local - assembly/build checks pass. - -This repository contributes: - -- `mkdocs.yml`: MkDocs Material configuration for the unified site. -- `docs/index.md`: The site homepage. -- `docs/how-this-site-works.md`: Cross-product site documentation. -- `scripts/assemble-docs.sh`: The main assembler. -- `scripts/render_bom.py`: BOM renderer. -- `scripts/bom_categories.py`: Shared BOM category label and color map. -- `docs/stylesheets/assembly.css`: Shared assembly-site styles. -- `.github/workflows/deploy.yml`: Site assembly, build, and publish workflow. -- `.github/workflows/bom-release.yml`: Reusable standalone BOM release workflow. -- `templates/`: Workflows copied into product repos. - -## Build flow - -```mermaid -flowchart TD - Start["Deploy workflow starts"] - Checkout["Checkout this repo"] - Keys["Write optional read-only deploy keys"] - Assemble["Run scripts/assemble-docs.sh"] - Discover["Discover local or topic-tagged product repos"] - Clone["Clone or use local product repos"] - Copy["Copy each assembly-docs/ folder"] - Nav["Convert nav.yml to .pages"] - Bom["Render hardware/bom.csv into copied bom.md"] - Pcb["Split PCB design assets and insert KiCanvas when possible"] - Links["Rewrite product-relative links to GitHub URLs"] - Build["mkdocs build"] - Upload["Upload Pages artifact"] - Publish["Deploy GitHub Pages"] - - Start --> Checkout --> Keys --> Assemble - Assemble --> Discover --> Clone --> Copy --> Nav --> Bom --> Pcb --> Links - Links --> Build --> Upload --> Publish -``` - -The assembler stages each product first, then replaces `docs/{product}/` only -after that product assembles successfully. Those product folders are assembled -output, so avoid hand-editing them. Change product docs in the source product -repo instead. - -Locally, you can run the same assembly process against nearby checkouts: - -```bash -pip install -r requirements.txt -ASSEMBLE_LOCAL="$HOME/Github" ./scripts/assemble-docs.sh -mkdocs serve -``` - -Without `ASSEMBLE_LOCAL`, the assembler discovers non-archived -`researchanddesire/*` repos with the `ohai-assembly-docs` topic. In CI it uses -`ASSEMBLE_GITHUB_TOKEN` for private discovery/cloning when set, prefers per-repo -read-only deploy keys when present, then falls back to anonymous HTTPS for -public repos. - -## CI triggers - -The main deploy workflow lives at `.github/workflows/deploy.yml`. - -```mermaid -flowchart TD - ProductPush["Product repo push to main"] - ProductPaths["assembly-docs/**, BOM, PCB, or cable source changed"] - TriggerWorkflow["Product trigger-assembly-docs.yml"] - Dispatch["repository_dispatch: assembly-docs-rebuild"] - RepoPush["Push to this repo main"] - RepoPaths["docs/**, mkdocs.yml, or scripts/** changed"] - Manual["Manual workflow_dispatch"] - Deploy["assembly-docs deploy.yml"] - Pages["GitHub Pages publish"] - - ProductPush --> ProductPaths --> TriggerWorkflow --> Dispatch --> Deploy - RepoPush --> RepoPaths --> Deploy - Manual --> Deploy - Deploy --> Pages -``` - -Product repos should copy `templates/trigger-assembly-docs.yml` to -`.github/workflows/trigger-assembly-docs.yml` and replace `` with -their repository name. That workflow watches `assembly-docs/**`, BOM CSVs, -`hardware/pcb/**`, and `hardware/cables/**`. It needs a `DOCS_DISPATCH_TOKEN` -secret with permission to send a repository dispatch to this repo. - -The deploy workflow: - -1. Checks out this repo. -2. Writes any configured read-only deploy keys into the runner temp directory. -3. Runs `scripts/assemble-docs.sh`, which discovers topic-tagged products and - stages each product before replacing published output. -4. Installs the MkDocs dependencies from `requirements.txt`. -5. Runs `mkdocs build`. -6. Uploads the generated `site/` directory as a Pages artifact. -7. Deploys the artifact to GitHub Pages. - -## BOM rendering - -The BOM source of truth is always the product repo's `hardware/bom.csv`. -Rendering is read-only on that CSV. - -```mermaid -flowchart TD - Csv["hardware/bom.csv"] - Schema["Canonical BOM schema"] - Page["Copied docs/{product}/bom.md"] - Markers["BEGIN/END GENERATED BOM markers"] - Renderer["scripts/render_bom.py"] - Categories["scripts/bom_categories.py"] - Css["docs/stylesheets/assembly.css"] - Output["Rendered BOM block in assembled site"] - - Csv --> Renderer - Schema --> Renderer - Page --> Markers --> Renderer - Categories --> Renderer - Css --> Output - Renderer --> Output -``` - -`scripts/render_bom.py` validates the canonical 12-column BOM header before it -renders. It replaces only the content between these markers in the copied page: - -```html -{/* BEGIN GENERATED BOM */} {/* END GENERATED BOM */} -``` - -If a product's `assembly-docs/bom.md` does not contain those markers, the page -is left untouched. If `hardware/bom.csv` has only a header row and no data rows, -the renderer skips it rather than blanking the page. - -The rendered BOM belongs only on this assembly-docs site. Developer docs may -document the BOM workflow, but should not embed the rendered BOM table. - -## Cable harnesses - -Cable harness source files belong under product repo `hardware/cables/`. -Wireviz-generated child BOMs belong to release/build artifacts such as -`.bom.tsv` files. - -Product-level `hardware/bom.csv` lists cable harnesses as top-level assemblies. -When a harness has Wireviz source, the product BOM `Source` should point to the -source path relative to `hardware/`, for example -`cables/OSSM-Motor-Control-Harness.yml`. Assembly cable pages link to generated -diagrams and child BOM artifacts instead of copying cable child rows into the -product-level BOM. - -## Release BOM artifacts - -Tagged product releases can also generate a standalone `bom.html` artifact. - -```mermaid -flowchart TD - Tag["Product repo tag push, v*"] - Caller["Product generate-bom-release.yml"] - Reusable["assembly-docs .github/workflows/bom-release.yml"] - Detect["Check for committed hardware/bom.html"] - Skip["Skip generation"] - Tooling["Checkout assembly-docs scripts"] - Render["Render standalone dist/bom.html"] - Artifact["Upload Actions artifact"] - Release["Attach bom.html to GitHub Release"] - - Tag --> Caller --> Reusable --> Detect - Detect -->|"exists"| Skip - Detect -->|"missing"| Tooling --> Render - Render --> Artifact - Render --> Release -``` - -Product repos should copy `templates/generate-bom-release.yml` to -`.github/workflows/generate-bom-release.yml` and set the product name, repo URL, -and license string. The product repo is checked out by the reusable workflow; -only the BOM rendering scripts are pulled from this repo. - -## Contributing properly - -Use this rule of thumb: edit content where it is owned. - -| Change | Edit here | -| ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | -| Product assembly steps, product images, product BOM page text, PCB overview, cable pages | Product repo `assembly-docs/` | -| Product BOM data | Product repo `hardware/bom.csv` | -| Product assembly nav order | Product repo `assembly-docs/nav.yml` | -| Product metadata for Ohai discovery | Product repo `assembly-docs/site.yml` | -| CAD, PCB, cable source artifacts | Product repo `hardware/cad/`, `hardware/pcb/`, `hardware/cables/` | -| Site homepage or cross-product site docs | This repo `docs/` outside product folders | -| Assembly pipeline behavior | This repo `scripts/` | -| Shared site styling | This repo `docs/stylesheets/assembly.css` | -| GitHub Pages deployment | This repo `.github/workflows/deploy.yml` | -| Product rebuild trigger template | This repo `templates/trigger-assembly-docs.yml` | -| Release BOM generation template | This repo `templates/generate-bom-release.yml` | - -Do: - -- Make product content changes in the product repo first. -- Keep `hardware/bom.csv` human-owned and schema-compliant. -- Include `{/* BEGIN GENERATED BOM */}` and `{/* END GENERATED BOM */}` in a - product `assembly-docs/bom.md` when that page is ready for generated content. -- Keep `assembly-docs/site.yml` real and placeholder-free before adding the - `ohai-assembly-docs` topic. -- Test site changes locally with `ASSEMBLE_LOCAL="$HOME/Github" ./scripts/assemble-docs.sh` - and `mkdocs serve`. -- Treat `scripts/bom_categories.py` as the single source for BOM category labels - and colors. -- Keep output deterministic: no timestamps or unstable ordering in generated - docs. - -Do not: - -- Hand-edit `docs/dtt/`, `docs/lockbox/`, `docs/radr/`, `docs/ossm/`, or other assembled - product folders. -- Add `ohai-assembly-docs` to template repos or repos with `PRODUCT_*` - placeholders. -- Commit generated BOM blocks back to product repos. -- Copy Wireviz child cable BOM rows into the product-level BOM. -- Change the BOM schema in this repo. -- Duplicate the BOM category color map in CSS. -- Add rendered assembly BOM tables to developer docs. -- Depend on local-only assets or absolute local paths in product docs. - -## Adding a new product - -1. Add an `assembly-docs/` folder to the product repo. -2. Add `assembly-docs/site.yml` with real `slug`, `title`, `license`, and - integer `nav_order`. -3. Add `assembly-docs/nav.yml` with `site_name` and the standard page order. -4. Include `index.md`, `pcb-overview.md`, `cable-harnesses.md`, `bom.md`, and - `assembly-guide.md`. -5. Put page images and supporting files under `assembly-docs/assets/`. -6. Add or validate `hardware/bom.csv` against the canonical BOM schema. -7. Keep `hardware/cad/`, `hardware/pcb/`, and `hardware/cables/` present. -8. Copy the trigger workflow template into the product repo. -9. Confirm local assembly and `mkdocs build --strict` pass. -10. Add the `ohai-assembly-docs` topic to opt into the site. - -For private repos, configure `ASSEMBLE_GITHUB_TOKEN` with read access to the -product repos. Per-repo read-only deploy keys remain supported during -transition. Once repos are public, anonymous HTTPS cloning is enough. - -## Troubleshooting - -| Symptom | Check | -| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -| Product page did not update | Did the source product repo change under `assembly-docs/**`, and did the trigger workflow dispatch successfully? | -| BOM did not render | Does `assembly-docs/bom.md` contain both generated BOM markers? Does `hardware/bom.csv` have data rows? | -| BOM render failed | Does `hardware/bom.csv` match the canonical 12-column header exactly? | -| Images are missing | Are assets under `assembly-docs/assets/`, and are page links relative to the product docs package? | -| Product-relative source links are broken | Check `scripts/rewrite_product_links.py` and the product repo/branch configuration in `scripts/assemble-docs.sh`. | -| KiCanvas did not appear | Confirm a `*.kicad_pcb` file exists under the product repo's `hardware/pcb/`. | -| Product was skipped by discovery | Confirm `ohai-assembly-docs` topic, non-placeholder `assembly-docs/site.yml`, and required assembly/hardware paths. | diff --git a/content/docs/legacy-mkdocs-pipeline.nl.mdx b/content/docs/legacy-mkdocs-pipeline.nl.mdx deleted file mode 100644 index d098e9d..0000000 --- a/content/docs/legacy-mkdocs-pipeline.nl.mdx +++ /dev/null @@ -1,306 +0,0 @@ ---- -title: "Hoe deze site werkt" -description: "Historische referentie voor de buiten gebruik gestelde MkDocs-assemblagepijplijn." ---- - -{/* Ported from MkDocs: how-this-site-works.md */} - - - Deze pagina bewaart de eerdere MkDocs-assemblagepijplijn als referentie voor de migratie. Fumadocs in - rad-app en de gecontroleerde bidirectionele contentsynchronisatie zijn nu verantwoordelijk voor de - publicatie. - - -Deze site is een aggregator. Productteams onderhouden de assemblagedocumentatie in -de afzonderlijke productrepository's, en deze repository voegt die pakketten samen tot één -MkDocs Material-site. - -De belangrijkste regel is dat assemblage-inhoud eigendom is van de product- -repository's. Deze repository beheert de siteshell, buildscripts, gedeelde styling en de -automatisering die productdocumentatie omzet in de gepubliceerde site. - -## Bronindeling - -```mermaid -flowchart TD - ProductRepo["Product repo"] - ProductAssembly["assembly-docs/"] - ProductAssets["assembly-docs/assets/"] - ProductNav["assembly-docs/nav.yml"] - ProductBom["hardware/bom.csv"] - Aggregator["assembly-docs repo"] - AssembledDocs["docs/{product}/"] - Site["Published MkDocs site"] - - ProductRepo --> ProductAssembly - ProductRepo --> ProductBom - ProductAssembly --> ProductAssets - ProductAssembly --> ProductNav - ProductAssembly --> Aggregator - ProductBom --> Aggregator - Aggregator --> AssembledDocs - AssembledDocs --> Site -``` - -Elke productrepository die voor Ohai in aanmerking komt, draagt het volgende bij: - -- `assembly-docs/`: Markdownpagina's voor de productmontagehandleiding. -- `assembly-docs/assets/`: productafbeeldingen en andere pagina-assets. -- `assembly-docs/site.yml`: productslug, titel, licentie en navigatievolgorde. -- `assembly-docs/nav.yml`: lokale paginavolgorde van het product en sectietitel. -- `hardware/bom.csv`: door mensen beheerde brongegevens van de stuklijst. -- Hardwarebronmappen onder `hardware/cad/`, `hardware/pcb/` en - `hardware/cables/`. -- GitHub-topic `ohai-assembly-docs` nadat tijdelijke aanduidingen zijn vervangen en lokale - montage-/bouwcontroles zijn geslaagd. - -Deze repository levert: - -- `mkdocs.yml`: MkDocs Material-configuratie voor de verenigde site. -- `docs/index.md`: de startpagina van de site. -- `docs/how-this-site-works.md`: documentatie over meerdere producten. -- `scripts/assemble-docs.sh`: de hoofdassembler. -- `scripts/render_bom.py`: stuklijstrenderer. -- `scripts/bom_categories.py`: gedeeld stuklijstcategorielabel en kleurenkaart. -- `docs/stylesheets/assembly.css`: gedeelde stijlen voor de assemblagesite. -- `.github/workflows/deploy.yml`: workflow voor site-assemblage, bouwen en publiceren. -- `.github/workflows/bom-release.yml`: Herbruikbare, zelfstandige workflow voor het vrijgeven van stuklijsten. -- `templates/`: workflows die naar productrepository's worden gekopieerd. - -## Bouwverloop - -```mermaid -flowchart TD - Start["Deploy workflow starts"] - Checkout["Checkout this repo"] - Keys["Write optional read-only deploy keys"] - Assemble["Run scripts/assemble-docs.sh"] - Discover["Discover local or topic-tagged product repos"] - Clone["Clone or use local product repos"] - Copy["Copy each assembly-docs/ folder"] - Nav["Convert nav.yml to .pages"] - Bom["Render hardware/bom.csv into copied bom.md"] - Pcb["Split PCB design assets and insert KiCanvas when possible"] - Links["Rewrite product-relative links to GitHub URLs"] - Build["mkdocs build"] - Upload["Upload Pages artifact"] - Publish["Deploy GitHub Pages"] - - Start --> Checkout --> Keys --> Assemble - Assemble --> Discover --> Clone --> Copy --> Nav --> Bom --> Pcb --> Links - Links --> Build --> Upload --> Publish -``` - -De assembler prepareert elk product eerst en vervangt pas daarna `docs/{product}/` -nadat het product succesvol is geassembleerd. Deze productmappen zijn geassembleerde -uitvoer; bewerk ze daarom niet handmatig. Wijzig de productdocumentatie in de bron- -repository van het product. - -Lokaal kunt u hetzelfde assemblageproces uitvoeren met lokale of nabijgelegen checkouts: - -```bash -pip install -r requirements.txt -ASSEMBLE_LOCAL="$HOME/Github" ./scripts/assemble-docs.sh -mkdocs serve -``` - -Zonder `ASSEMBLE_LOCAL` ontdekt de assembler niet-gearchiveerde -`researchanddesire/*`-repository's met het topic `ohai-assembly-docs`. In CI gebruikt deze -`ASSEMBLE_GITHUB_TOKEN` voor private ontdekking en het klonen, indien ingesteld, geeft de voorkeur aan -per repository aanwezige alleen-lezen deploysleutels en valt daarna voor openbare repository's terug op -anonieme HTTPS. - -## CI-triggers - -De belangrijkste uitrolworkflow bevindt zich op `.github/workflows/deploy.yml`. - -```mermaid -flowchart TD - ProductPush["Product repo push to main"] - ProductPaths["assembly-docs/**, BOM, PCB, or cable source changed"] - TriggerWorkflow["Product trigger-assembly-docs.yml"] - Dispatch["repository_dispatch: assembly-docs-rebuild"] - RepoPush["Push to this repo main"] - RepoPaths["docs/**, mkdocs.yml, or scripts/** changed"] - Manual["Manual workflow_dispatch"] - Deploy["assembly-docs deploy.yml"] - Pages["GitHub Pages publish"] - - ProductPush --> ProductPaths --> TriggerWorkflow --> Dispatch --> Deploy - RepoPush --> RepoPaths --> Deploy - Manual --> Deploy - Deploy --> Pages -``` - -Productrepository's moeten `templates/trigger-assembly-docs.yml` kopiëren naar -`.github/workflows/trigger-assembly-docs.yml` en `` vervangen door -hun repositorynaam. Deze workflow bewaakt `assembly-docs/**`, BOM-CSV's, -`hardware/pcb/**` en `hardware/cables/**`. Hiervoor is een `DOCS_DISPATCH_TOKEN`- -secret nodig met toestemming om een repository_dispatch naar deze repository te sturen. - -De uitrolworkflow: - -1. Checkt deze repository uit. -2. Schrijft alle geconfigureerde alleen-lezen deploysleutels naar de tijdelijke runnerdirectory. -3. Voert `scripts/assemble-docs.sh` uit, dat producten met een onderwerptag ontdekt en - elk product voorbereidt voordat de gepubliceerde uitvoer wordt vervangen. -4. Installeert de MkDocs-afhankelijkheden uit `requirements.txt`. -5. Voert `mkdocs build` uit. -6. Uploadt de gegenereerde `site/`-directory als een Pages-artefact. -7. Rolt het artefact uit op GitHub Pages. - -## Stuklijstrendering - -De bron van waarheid voor de BOM is altijd `hardware/bom.csv` in de -productrepository. Rendering is alleen-lezen op basis van dat CSV-bestand. - -```mermaid -flowchart TD - Csv["hardware/bom.csv"] - Schema["Canonical BOM schema"] - Page["Copied docs/{product}/bom.md"] - Markers["BEGIN/END GENERATED BOM markers"] - Renderer["scripts/render_bom.py"] - Categories["scripts/bom_categories.py"] - Css["docs/stylesheets/assembly.css"] - Output["Rendered BOM block in assembled site"] - - Csv --> Renderer - Schema --> Renderer - Page --> Markers --> Renderer - Categories --> Renderer - Css --> Output - Renderer --> Output -``` - -`scripts/render_bom.py` valideert de canonieke BOM-koptekst met 12 kolommen voordat het de BOM -rendert. Het vervangt alleen de inhoud tussen deze markeringen op de gekopieerde pagina: - -```html -{/* BEGIN GENERATED BOM */} {/* END GENERATED BOM */} -``` - -Als `assembly-docs/bom.md` van een product deze markeringen niet bevat, blijft de pagina -ongewijzigd. Als `hardware/bom.csv` alleen een koprij en geen gegevensrijen heeft, -slaat de renderer dit over in plaats van de pagina leeg te maken. - -De gerenderde BOM hoort alleen thuis op deze assembly-docs-site. Ontwikkelaarsdocumentatie kan -de BOM-workflow beschrijven, maar mag de gerenderde BOM-tabel niet insluiten. - -## Kabelbomen - -Bronbestanden voor kabelbomen horen in `hardware/cables/` van de productrepository. -Door Wireviz gegenereerde onderliggende BOM's zijn release-/buildartefacten, zoals -`.bom.tsv`-bestanden. - -De `hardware/bom.csv` op productniveau vermeldt kabelbomen als assemblages op het hoogste niveau. -Wanneer een kabelboom een Wireviz-bron heeft, moet `Source` in de product-BOM verwijzen naar -het bronpad relatief ten opzichte van `hardware/`, bijvoorbeeld -`cables/OSSM-Motor-Control-Harness.yml`. Kabelboompagina's voor assemblage verwijzen naar -gegenereerde diagrammen en onderliggende BOM-artefacten in plaats van rijen van de onderliggende -kabelboom naar de BOM op productniveau te kopiëren. - -## Release-BOM-artefacten - -Getagde productreleases kunnen ook een zelfstandig `bom.html`-artefact genereren. - -```mermaid -flowchart TD - Tag["Product repo tag push, v*"] - Caller["Product generate-bom-release.yml"] - Reusable["assembly-docs .github/workflows/bom-release.yml"] - Detect["Check for committed hardware/bom.html"] - Skip["Skip generation"] - Tooling["Checkout assembly-docs scripts"] - Render["Render standalone dist/bom.html"] - Artifact["Upload Actions artifact"] - Release["Attach bom.html to GitHub Release"] - - Tag --> Caller --> Reusable --> Detect - Detect -->|"exists"| Skip - Detect -->|"missing"| Tooling --> Render - Render --> Artifact - Render --> Release -``` - -Productrepository's moeten `templates/generate-bom-release.yml` kopiëren naar -`.github/workflows/generate-bom-release.yml` en de productnaam, repository-URL -en licentiestring instellen. De productrepository wordt door de herbruikbare workflow -uitgecheckt; alleen de BOM-renderscripts worden uit deze repository opgehaald. - -## Een goede bijdrage leveren - -Gebruik deze vuistregel: bewerk inhoud waar die wordt beheerd. - -| Wijziging | Bewerk hier | -| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | -| Productmontagestappen, productafbeeldingen, tekst van de productstuklijstpagina, PCB-overzicht, kabelpagina's | Productrepository `assembly-docs/` | -| Productstuklijstgegevens | Productrepository `hardware/bom.csv` | -| Navigatievolgorde voor productassemblage | Productrepository `assembly-docs/nav.yml` | -| Productmetagegevens voor Ohai-ontdekking | Productrepository `assembly-docs/site.yml` | -| CAD-, PCB- en kabelbronartefacten | Productrepository `hardware/cad/`, `hardware/pcb/`, `hardware/cables/` | -| Sitestartpagina of sitedocumenten voor meerdere producten | Deze repo `docs/` buiten productmappen | -| Gedrag van assemblagepijplijn | Deze repository `scripts/` | -| Gedeelde sitestyling | Deze repository `docs/stylesheets/assembly.css` | -| Implementatie van GitHub Pages | Deze repository `.github/workflows/deploy.yml` | -| Triggersjabloon voor het opnieuw opbouwen van producten | Deze repository `templates/trigger-assembly-docs.yml` | -| Sjabloon voor het genereren van release-BOM's | Deze repository `templates/generate-bom-release.yml` | - -Doen: - -- Breng productinhoudelijke wijzigingen eerst aan in de productrepository. -- Zorg ervoor dat `hardware/bom.csv` door mensen wordt beheerd en aan het schema voldoet. -- Neem `{/* BEGIN GENERATED BOM */}` en `{/* END GENERATED BOM */}` op in een - product `assembly-docs/bom.md` wanneer die pagina gereed is voor gegenereerde inhoud. -- Houd `assembly-docs/site.yml` echt en vrij van tijdelijke aanduidingen voordat u het - topic `ohai-assembly-docs` toevoegt. -- Test wijzigingen lokaal met `ASSEMBLE_LOCAL="$HOME/Github" ./scripts/assemble-docs.sh` - en `mkdocs serve`. -- Beschouw `scripts/bom_categories.py` als de enige bron voor BOM-categorielabels - en -kleuren. -- Houd de uitvoer deterministisch: genereer geen tijdstempels of instabiele volgordes in - gegenereerde documentatie. - -Niet doen: - -- Bewerk `docs/dtt/`, `docs/lockbox/`, `docs/radr/`, `docs/ossm/` of andere geassembleerde - productmappen handmatig. -- Voeg `ohai-assembly-docs` toe aan sjabloonrepository's of repository's met `PRODUCT_*` - als tijdelijke aanduidingen. -- Commit gegenereerde BOM-blokken terug naar productrepository's. -- Kopieer Wireviz-rijen van onderliggende kabelbomen naar de BOM op productniveau. -- Wijzig het BOM-schema in deze repository. -- Dupliceer de BOM-categoriekleurenkaart in CSS. -- Voeg gerenderde assemblage-BOM-tabellen toe aan ontwikkelaarsdocumentatie. -- Vertrouw in productdocumentatie niet op assets die alleen lokaal beschikbaar zijn of op absolute lokale paden. - -## Een nieuw product toevoegen - -1. Voeg een map `assembly-docs/` toe aan de productrepository. -2. Voeg `assembly-docs/site.yml` toe met echte `slug`, `title`, `license` en - een geheel getal als `nav_order`. -3. Voeg `assembly-docs/nav.yml` toe met `site_name` en de standaardpaginavolgorde. -4. Neem `index.md`, `pcb-overview.md`, `cable-harnesses.md`, `bom.md` en - `assembly-guide.md` op. -5. Plaats pagina-afbeeldingen en ondersteunende bestanden onder `assembly-docs/assets/`. -6. Voeg `hardware/bom.csv` toe of valideer deze op basis van het canonieke BOM-schema. -7. Zorg dat `hardware/cad/`, `hardware/pcb/` en `hardware/cables/` aanwezig zijn. -8. Kopieer de triggerworkflowsjabloon naar de productrepository. -9. Controleer de lokale assemblage en laat `mkdocs build --strict` slagen. -10. Voeg het topic `ohai-assembly-docs` toe om het product voor de site aan te melden. - -Configureer voor private repository's `ASSEMBLE_GITHUB_TOKEN` met leestoegang tot de -productrepository's. Alleen-lezen deploysleutels per repository blijven tijdens de -overgang ondersteund. Zodra repository's openbaar zijn, volstaat anoniem klonen via HTTPS. - -## Problemen oplossen - -| Symptoom | Controleer | -| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | -| Productpagina is niet bijgewerkt | Is de bronrepository gewijzigd onder `assembly-docs/**` en heeft de triggerworkflow succesvol een dispatch verzonden? | -| BOM is niet weergegeven | Bevat `assembly-docs/bom.md` beide gegenereerde BOM-markeringen? Heeft `hardware/bom.csv` gegevensrijen? | -| BOM-rendering is mislukt | Komt `hardware/bom.csv` exact overeen met de canonieke koptekst met 12 kolommen? | -| Afbeeldingen ontbreken | Staan assets onder `assembly-docs/assets/` en verwijzen paginalinks relatief naar het productdocumentatiepakket? | -| Productrelatieve bronlinks zijn verbroken | Controleer `scripts/rewrite_product_links.py` en de repository-/branchconfiguratie in `scripts/assemble-docs.sh`. | -| KiCanvas is niet verschenen | Controleer of er een `*.kicad_pcb`-bestand onder `hardware/pcb/` van de productrepository staat. | -| Product is overgeslagen bij ontdekking | Controleer het topic `ohai-assembly-docs`, `assembly-docs/site.yml` zonder tijdelijke aanduidingen en de vereiste assemblage-/hardwarepaden. | diff --git a/content/docs/lockbox/_bom/bom.csv b/content/docs/lockbox/_bom/bom.csv new file mode 100644 index 0000000..29659fe --- /dev/null +++ b/content/docs/lockbox/_bom/bom.csv @@ -0,0 +1,21 @@ +#,Part Name,Category,Description,Qty,UOM,Manufacturer,MFG PN,Vendor,Vendor PN,Source,Notes +1,Top housing,FDM,FDM-printed top enclosure housing,1,each,–,–,–,–,cad/top-housing.step,– +2,Bottom housing,FDM,FDM-printed bottom enclosure housing,1,each,–,–,–,–,cad/bottom-housing.step,– +3,PCB cover,FDM,FDM-printed PCB cover,1,each,–,–,–,–,cad/pcb-cover.step,Secures over the populated PCB. +4,Back button,FDM,FDM-printed back/arrow button cap,1,each,–,–,–,–,cad/back-button.step,– +5,Enter button,FDM,FDM-printed lock/enter button cap,1,each,–,–,–,–,cad/enter-button.step,– +6,Locking latch,FDM,FDM-printed locking latch,1,each,–,–,–,–,cad/locking-latch.step,Installs onto motor shaft. +7,Encoder wheel,FDM,FDM-printed rotary encoder wheel,1,each,–,–,–,–,cad/encoder-wheel.step,Installs onto rotary encoder shaft. +8,Motor clamp,FDM,FDM-printed motor clamp,1,each,–,–,–,–,cad/motor-clamp.step,– +9,Lockbox PCBA,PCA,Populated Lockbox PCB assembly,1,each,JLCPCB,–,JLCPCB,–,pcb/production/v1.4/bom_v1.4.csv,Top-level PCB assembly line item; populated component EBOM is tracked in git at source path. +10,PCB button switch,SWI,Tactile switch for PCB buttons,2,each,Same Sky,TS02-66-100-BK-260-SCR-D,Mouser,179-TS0266100BK260SC,pcb/production/v1.4/bom_v1.4.csv,Vendor link: https://www.mouser.ca/ProductDetail/179-TS0266100BK260SC +11,Rotary encoder,SWI,Rotary encoder,1,each,Bourns,PEC12R-2120F-N0012,Mouser,652-PEC12R-2120F-N12,cad/encoder.step,Vendor link: https://www.mouser.ca/ProductDetail/652-PEC12R-2120F-N12 +12,4 mm magnet,FBO,"N52 neodymium magnet, 4 mm x 5 mm",4,each,Generic Factory,–,TBD,–,–,"One in locking-latch, one in top-housing, and two in bottom-housing. Source costing sheet marks supplier as LOOKING FOR NEW SUPPLIER." +13,Rubber foot,FBO,"Polyurethane bumper foot, 0.312 in diameter, clear",4,each,3M,SJ5302,Digi-Key,SJ5302-7-ND,https://www.digikey.ca/en/products/detail/3m/SJ5302/2345107,Glued onto backplate. +14,Motor,MTR,"DC micro gear motor, 12 V, 60 RPM",1,each,Generic Factory,–,AliExpress,33022320164,cad/motor.step,Drives locking latch. Vendor link: https://www.aliexpress.com/item/33022320164.html +15,Motor wire,CHA,"Motor wire harness, 1 mm pitch female connector, 2P, 100 mm, single head",1,each,Generic Factory,–,AliExpress,1005007218127653,https://www.aliexpress.com/item/1005007218127653.html,Connects motor to PCB. +16,Battery,BTY,3.7 V 500 mAh lithium polymer battery with custom 2-pin JST and 5 cm black/red cable,1,each,Generic Factory,–,AliExpress,1005009279419327,cad/battery.step,Installed into top-housing. Vendor link: https://www.aliexpress.com/item/1005009279419327.html +17,Screen,ASM,PS 2.0 inch 14-pin SPI TFT LCD module,1,each,Generic Factory,–,AliExpress,1005005865407299,cad/screen.step,Installed into top-housing. Vendor link: https://www.aliexpress.com/item/1005005865407299.html +18,Torx screw,FST,"#4-20 x 1/2 in 6-lobe flat Plastite alternative 48-2 screw, black oxide",7,each,Shorpioen,0408LTFB,Shorpioen,BC-0408LTFB,https://shorpioen.com/4-20x1-2-6-lobe-flat-plastite-alternative-48-2-fully-threaded-black-oxide-and-wax-box-qty-10000-bc-0408ltfb/,"2x for motor-clamp, 5x for pcb-cover; installed with T7 Torx driver." +19,USB-C cable,CBL,"USB-A to USB-C cable, 4 ft braided",1,each,Generic Factory,–,Amazon,B0CRYMGXMX,https://www.amazon.ca/dp/B0CRYMGXMX,– +20,Resealable bag,PKG,6 x 8 in resealable bag,1,each,Uline,S-5065,Uline,S-5065,https://www.uline.ca/Product/Detail/S-5065/Resealable-Bags/6-x-8-15-Mil-Resealable-Bags,– diff --git a/content/docs/lockbox/_bom/bom.json b/content/docs/lockbox/_bom/bom.json new file mode 100644 index 0000000..2c1c8f1 --- /dev/null +++ b/content/docs/lockbox/_bom/bom.json @@ -0,0 +1,300 @@ +{ + "repo": "Lockbox-OSS", + "commit": "679750e75f11a21455729c5298ec744cf307f4d2", + "columns": [ + "#", + "Part Name", + "Category", + "Description", + "Qty", + "UOM", + "Manufacturer", + "MFG PN", + "Vendor", + "Vendor PN", + "Source", + "Notes" + ], + "rows": [ + [ + "1", + "Top housing", + "FDM", + "FDM-printed top enclosure housing", + "1", + "each", + "–", + "–", + "–", + "–", + "cad/top-housing.step", + "–" + ], + [ + "2", + "Bottom housing", + "FDM", + "FDM-printed bottom enclosure housing", + "1", + "each", + "–", + "–", + "–", + "–", + "cad/bottom-housing.step", + "–" + ], + [ + "3", + "PCB cover", + "FDM", + "FDM-printed PCB cover", + "1", + "each", + "–", + "–", + "–", + "–", + "cad/pcb-cover.step", + "Secures over the populated PCB." + ], + [ + "4", + "Back button", + "FDM", + "FDM-printed back/arrow button cap", + "1", + "each", + "–", + "–", + "–", + "–", + "cad/back-button.step", + "–" + ], + [ + "5", + "Enter button", + "FDM", + "FDM-printed lock/enter button cap", + "1", + "each", + "–", + "–", + "–", + "–", + "cad/enter-button.step", + "–" + ], + [ + "6", + "Locking latch", + "FDM", + "FDM-printed locking latch", + "1", + "each", + "–", + "–", + "–", + "–", + "cad/locking-latch.step", + "Installs onto motor shaft." + ], + [ + "7", + "Encoder wheel", + "FDM", + "FDM-printed rotary encoder wheel", + "1", + "each", + "–", + "–", + "–", + "–", + "cad/encoder-wheel.step", + "Installs onto rotary encoder shaft." + ], + [ + "8", + "Motor clamp", + "FDM", + "FDM-printed motor clamp", + "1", + "each", + "–", + "–", + "–", + "–", + "cad/motor-clamp.step", + "–" + ], + [ + "9", + "Lockbox PCBA", + "PCA", + "Populated Lockbox PCB assembly", + "1", + "each", + "JLCPCB", + "–", + "JLCPCB", + "–", + "pcb/production/v1.4/bom_v1.4.csv", + "Top-level PCB assembly line item; populated component EBOM is tracked in git at source path." + ], + [ + "10", + "PCB button switch", + "SWI", + "Tactile switch for PCB buttons", + "2", + "each", + "Same Sky", + "TS02-66-100-BK-260-SCR-D", + "Mouser", + "179-TS0266100BK260SC", + "pcb/production/v1.4/bom_v1.4.csv", + "Vendor link: https://www.mouser.ca/ProductDetail/179-TS0266100BK260SC" + ], + [ + "11", + "Rotary encoder", + "SWI", + "Rotary encoder", + "1", + "each", + "Bourns", + "PEC12R-2120F-N0012", + "Mouser", + "652-PEC12R-2120F-N12", + "cad/encoder.step", + "Vendor link: https://www.mouser.ca/ProductDetail/652-PEC12R-2120F-N12" + ], + [ + "12", + "4 mm magnet", + "FBO", + "N52 neodymium magnet, 4 mm x 5 mm", + "4", + "each", + "Generic Factory", + "–", + "TBD", + "–", + "–", + "One in locking-latch, one in top-housing, and two in bottom-housing. Source costing sheet marks supplier as LOOKING FOR NEW SUPPLIER." + ], + [ + "13", + "Rubber foot", + "FBO", + "Polyurethane bumper foot, 0.312 in diameter, clear", + "4", + "each", + "3M", + "SJ5302", + "Digi-Key", + "SJ5302-7-ND", + "https://www.digikey.ca/en/products/detail/3m/SJ5302/2345107", + "Glued onto backplate." + ], + [ + "14", + "Motor", + "MTR", + "DC micro gear motor, 12 V, 60 RPM", + "1", + "each", + "Generic Factory", + "–", + "AliExpress", + "33022320164", + "cad/motor.step", + "Drives locking latch. Vendor link: https://www.aliexpress.com/item/33022320164.html" + ], + [ + "15", + "Motor wire", + "CHA", + "Motor wire harness, 1 mm pitch female connector, 2P, 100 mm, single head", + "1", + "each", + "Generic Factory", + "–", + "AliExpress", + "1005007218127653", + "https://www.aliexpress.com/item/1005007218127653.html", + "Connects motor to PCB." + ], + [ + "16", + "Battery", + "BTY", + "3.7 V 500 mAh lithium polymer battery with custom 2-pin JST and 5 cm black/red cable", + "1", + "each", + "Generic Factory", + "–", + "AliExpress", + "1005009279419327", + "cad/battery.step", + "Installed into top-housing. Vendor link: https://www.aliexpress.com/item/1005009279419327.html" + ], + [ + "17", + "Screen", + "ASM", + "PS 2.0 inch 14-pin SPI TFT LCD module", + "1", + "each", + "Generic Factory", + "–", + "AliExpress", + "1005005865407299", + "cad/screen.step", + "Installed into top-housing. Vendor link: https://www.aliexpress.com/item/1005005865407299.html" + ], + [ + "18", + "Torx screw", + "FST", + "#4-20 x 1/2 in 6-lobe flat Plastite alternative 48-2 screw, black oxide", + "7", + "each", + "Shorpioen", + "0408LTFB", + "Shorpioen", + "BC-0408LTFB", + "https://shorpioen.com/4-20x1-2-6-lobe-flat-plastite-alternative-48-2-fully-threaded-black-oxide-and-wax-box-qty-10000-bc-0408ltfb/", + "2x for motor-clamp, 5x for pcb-cover; installed with T7 Torx driver." + ], + [ + "19", + "USB-C cable", + "CBL", + "USB-A to USB-C cable, 4 ft braided", + "1", + "each", + "Generic Factory", + "–", + "Amazon", + "B0CRYMGXMX", + "https://www.amazon.ca/dp/B0CRYMGXMX", + "–" + ], + [ + "20", + "Resealable bag", + "PKG", + "6 x 8 in resealable bag", + "1", + "each", + "Uline", + "S-5065", + "Uline", + "S-5065", + "https://www.uline.ca/Product/Detail/S-5065/Resealable-Bags/6-x-8-15-Mil-Resealable-Bags", + "–" + ] + ] +} diff --git a/content/docs/lockbox/_bom/source.json b/content/docs/lockbox/_bom/source.json new file mode 100644 index 0000000..cfce0b3 --- /dev/null +++ b/content/docs/lockbox/_bom/source.json @@ -0,0 +1,4 @@ +{ + "repo": "Lockbox-OSS", + "commit": "679750e75f11a21455729c5298ec744cf307f4d2" +} diff --git a/content/docs/lockbox/assembly-guide.de.mdx b/content/docs/lockbox/assembly-guide.de.mdx deleted file mode 100644 index acd5db8..0000000 --- a/content/docs/lockbox/assembly-guide.de.mdx +++ /dev/null @@ -1,405 +0,0 @@ ---- -title: "Lockbox-Montageanleitung" -description: "Montageanleitung für die Lockbox." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## Zweck - -Diese Arbeitsanweisung dokumentiert den aktuellen Lockbox-Montageprozess von den gedruckten Teilen bis zur mechanischen Endmontage. - -Verwenden Sie diese Anweisungen mit der aktiven PCB- und CAD-Version für den Build. - -## Erforderliche Teile und Verbrauchsmaterialien - -1. Stellen Sie die erforderlichen Teile bereit, bevor Sie mit der Montage beginnen. - - ![Erforderliche Teile für die Lockboxmontage](assets/assembly-required-parts.webp) - - _Erforderliche Teile für die Lockboxmontage._ - -2. Bestätigen Sie, dass das Montageset Folgendes enthält: - - `top-housing` - - `bottom-housing` - - `pcb-backing` - - `locking-latch` - - `enter-button` - - `back-button` - - `encoder-wheel` - - `encoder` - - `motor` - - `screen` - - `battery` - - 7x `torx-screw` - - 4x `4mm-magnet` - - 4x `rubber-foot` - - `VHB-double-sided-tape` - - `hot-glue` - - `SA-glue` - -3. Wenn alle benötigten Teile vorhanden sind, fahren Sie fort. - -## Werkzeuge - -- Elektroschrauber oder Handschrauber mit T7-Torx-Bit -- `flat-jaw-pliers` -- `tweezers` -- `paperclip` -- `isopropyl-alcohol` -- `microfibre-cloth` - -## Kunststoffteile vorbereiten - -1. Arbeiten Sie mit einem weichen Tuch. Die Vorderseite verkratzt leicht. - -2. Überprüfen Sie jedes gedruckte Teil vor dem Zusammenbau bei guter Beleuchtung. Achten Sie auf gewellte Ecken, gequetschte Schichten, große Plastikklumpen, blockierte Magneteinsätze und blockierte Schraubenlöcher. - -3. Verwenden Sie ein glattes PEI-Druckbett für nach vorne gerichtete kosmetische Teile und ein strukturiertes PEI-Druckbett für interne Teile. - -4. Überprüfen Sie jedes gedruckte Teil, bevor Sie die Elektronik installieren. -5. Stellen Sie sicher, dass die Kunststoffkomponenten sauber, korrekt bedruckt und frei von Hindernissen sind, bevor Sie fortfahren. - -### Teilreferenzfotos - -Verwenden Sie diese Fotos bei der Inspektion gedruckter Teile. - -#### `top-housing` - - - - ![Oberes Gehäuse](assets/part-top-housing-main.webp) - - - ![Seitenansicht des oberen Gehäuses](assets/part-top-housing-side.webp) - - - -#### `bottom-housing` - - - - ![Unteres Gehäuse](assets/part-bottom-housing-main.webp) - - - ![Seitenansicht des unteren Gehäuses](assets/part-bottom-housing-side.webp) - - - -#### `motor-clamp` - - - - ![Motorklemme](assets/part-motor-clamp-main.webp) - - - ![Seitenansicht der Motorklemme](assets/part-motor-clamp-side.webp) - - - -#### `pcb-cover` - - - - ![PCB-Abdeckung](assets/part-pcb-cover-main.webp) - - - ![Seitenansicht der Leiterplattenabdeckung](assets/part-pcb-cover-side.webp) - - - -#### `encoder-wheel` - - - - ![Encoderrad](assets/part-encoder-wheel-main.webp) - - - ![Seitenansicht des Encoderrads](assets/part-encoder-wheel-side.webp) - - - -#### `locking-latch` - - - - ![Verriegelungsriegel](assets/part-locking-latch-main.webp) - - - ![Seitenansicht des Verriegelungsriegels](assets/part-locking-latch-side.webp) - - - -#### `enter-button` - - - - ![Eingabetaste](assets/part-enter-button-main.webp) - - - ![Seitenansicht der Eingabetaste](assets/part-enter-button-side.webp) - - - -#### `back-button` - - - - ![Zurück-Taste](assets/part-back-button-main.webp) - - - ![Seitenansicht der Zurück-Taste](assets/part-back-button-side.webp) - - - -## Magnete anbringen - -1. Installieren Sie vier Magnete: einen im `locking-latch`, einen im `top-housing` und zwei im `bottom-housing`. - -2. Tragen Sie mit einem `paperclip` eine dünne Schicht `SA-glue` auf die Innenseite jedes Magneteinsatzes auf. - - ![Sekundenkleber mit einer Büroklammer auf den Magneteinsatz auftragen](assets/build-magnet-glue-paperclip.webp) - - _Tragen Sie eine dünne Schicht Kleber auf die Innenseite des Magneteinsatzes auf._ - -3. Überprüfen Sie die Polarität der Magnete, bevor Sie jeden Magneten an seinen Platz drücken: - - `locking-latch`: Nordpol oben - - `top-housing` Frontmagnet: Südseite nach oben - - `bottom-housing` Frontmagnet: Nordseite nach oben - - `bottom-housing` Rückmagnet: Südseite nach oben - - - - ![Polarität des vorderen Gehäusemagneten prüfen](assets/build-top-housing-magnet-polarity.webp) - - - ![Überprüfen der Polarität des vorderen Magneten im unteren Gehäuse](assets/build-bottom-housing-front-magnet-polarity.webp) - - - ![Überprüfen der Polarität des hinteren Magneten des unteren Gehäuses](assets/build-bottom-housing-back-magnet-polarity.webp) - - - -4. Drücken Sie die Magnete mit `flat-jaw-pliers` in ihre Einsätze. Platzieren Sie ein gefaltetes `microfibre-cloth` zwischen der Zange und dem Lockbox-Körper, um die bedruckte Oberfläche zu schützen. - - - - ![Schutz des Gehäuses beim Andrücken von Magneten](assets/build-magnet-press-protection.webp) - - - ![Drücken des Verriegelungsarmmagneten mit einer Flachbackenzange](assets/build-locking-latch-magnet-press.webp) - - - -5. Stellen Sie sicher, dass jeder Magnet bündig oder tief genug für seinen Einsatz sitzt. - - - - ![Magnet im oberen Gehäuse installiert](assets/build-top-housing-magnet-installed.webp) - - - ![Rückseitiger Magnet im unteren Gehäuse installiert](assets/build-bottom-housing-back-magnet-installed.webp) - - - ![Magnet im Verriegelungsriegel installiert](assets/step-01-magnet-locking-latch.webp) - - - -6. Stellen Sie sicher, dass die Magnete vollständig sitzen und festgeklebt sind, bevor Sie fortfahren. - -## Bildschirm und Batterie einbauen - -1. Entfernen Sie die Schutzfolie vom `screen`. - -2. Richten Sie den `screen` an der oberen und rechten Leiste des `top-housing` aus. - -3. Halten Sie den Bildschirm fest und befestigen Sie ihn mit `hot-glue` an den Ecken und restlichen Kanten. - -4. Wischen Sie die Rückseite des `screen` und die beschriftete Seite des `battery` mit `isopropyl-alcohol` ab. - -5. Tragen Sie ein 3/4 Zoll großes quadratisches Stück `VHB-double-sided-tape` auf die beschriftete Seite des `battery` auf. - - ![VHB-Band an der Batterie angebracht](assets/build-battery-vhb-tape.webp) - - _VHB-Klebeband auf der Batterie angebracht._ - -6. Platzieren Sie den `battery` mit der Vorderseite nach unten auf der Rückseite des `screen`, wobei die Kabel nach unten rechts austreten. Fixieren Sie ihn bei Bedarf mit `hot-glue`. - - - - ![Bildschirm und Batterie im oberen Gehäuse installiert](assets/build-screen-battery-layout.webp) - - - ![Referenz zum Bildschirm-, Batterie- und Motorlayout](assets/build-screen-motor-layout.webp) - - - -7. Stellen Sie sicher, dass der Bildschirm und die Batterie fest sitzen und dass die Kabel zugänglich bleiben. - -## Encoder installieren - -1. Setzen Sie den `encoder-wheel` vor dem Löten oder Kleben probeweise ein. - -2. Tragen Sie `SA-glue` auf die flache Seite der Encoderwelle auf. - -3. Richten Sie die Abflachung der Encoderwelle mit der flachen Fläche im Inneren des `encoder-wheel` aus und montieren Sie dann das Rad. - -4. Löten Sie den `encoder` auf die Platine. Stellen Sie sicher, dass der Encoder vollständig sitzt, damit das Rad gerade bleibt. - - - - ![Encoder auf Platine installiert](assets/step-03-encoder-on-pcb.webp) - - - ![Encoderrad installiert](assets/step-03-encoder-wheel-installed.webp) - - - -5. Stellen Sie sicher, dass sich das Encoderrad frei dreht, bevor Sie fortfahren. - -## Motor einbauen - -1. Überprüfen Sie die Polarität des Motors, bevor Sie die Motorbaugruppe installieren. - -2. Wenn Sie das Motorkabel während dieses Aufbaus verlöten, kürzen Sie die Länge des Motoranschlusskabels vor der endgültigen Verlegung auf 7 cm. - -3. Platzieren Sie den `locking-latch` auf dem `motor`. Kleben Sie den Riegel nicht auf den Motor. - - ![Verriegelungsriegel am Motor platziert](assets/step-04-latch-on-motor.webp) - - _Sperrriegel am Motor angebracht._ - -4. Schieben Sie den Riegel etwa zur Hälfte auf die Motorbaugruppe und setzen Sie dann den `motor` in den `top-housing` ein. - - - - ![Verriegelungsriegel zur Hälfte am Motor installiert](assets/build-motor-latch-halfway.webp) - - - ![Motor im Gehäuse platziert](assets/step-04-motor-in-housing.webp) - - - -5. Platzieren Sie den `motor-clamp` über dem Motor und befestigen Sie ihn mit 2x `torx-screw`. - - ![Motorklemme installiert](assets/build-motor-clamp-installed.webp) - - _Motorklemme installiert._ - -6. Stellen Sie sicher, dass der Motor sitzt und sich die Verriegelung ohne Behinderung bewegen kann. - -## Tasten und Platine installieren - -1. Platzieren Sie `enter-button` und `back-button` in den Tastenöffnungen. - - ![Tasten im Gehäuse platziert](assets/step-05-buttons-in-housing.webp) - - _Knöpfe im Gehäuse platziert._ - -2. Platzieren Sie den `back-button` links und die Sperr-/Eingabetaste rechts. - -3. Wenn die Tasten noch nicht montiert sind, löten Sie sie auf der Unterseite der Platine an, also auf der Seite ohne andere Komponenten. - -4. Platzieren Sie die Platine so auf den Tasten, dass der `encoder-wheel` durch das vordere Loch verläuft. - - ![PCB-Platzierung über Tasten](assets/step-05-pcb-placement.webp) - - _PCB-Platzierung über Tasten._ - -5. Decken Sie `screen-ribbon-wire`, `battery-wire` oder `motor-wire` nicht ab. - - ![Platine sitzt im Gehäuse](assets/step-05-pcb-seated.webp) - - _PCB sitzt im Gehäuse._ - -6. Stellen Sie sicher, dass die Tasten richtig funktionieren und das Encoderrad in der Mitte der Öffnung zentriert ist. - -## Kabel anschließen - -1. Öffnen Sie die Verriegelung des Bildschirmbandanschlusses. - -2. Setzen Sie den `screen-ribbon-wire` ein und schließen Sie dann den Riegel. Der untere weiße Balken sollte nach dem Schließen des Riegels nicht sichtbar sein. - -3. Stecken Sie `battery-wire` und `motor-wire` in die Platine. - -4. Verlegen Sie die Motorkabel nach links und über die Platine. - -5. Halten Sie das Batteriekabel von der Montageöffnung darunter fern, damit das Kabel nicht von der Abdeckung eingeklemmt wird. - - - - ![Bildschirm-, Batterie- und Motorkabel angeschlossen](assets/step-06-cables-connected.webp) - - - ![Referenz zur PCB-Kabelführung](assets/build-pcb-cable-routing.webp) - - - -6. Vergewissern Sie sich, dass jedes Kabel richtig sitzt, bevor Sie fortfahren. - -## PCB-Abdeckung installieren - -1. Platzieren Sie den `pcb-cover` über der Platine. - - ![Platzierung der Leiterplattenabdeckung](assets/step-07-pcb-cover-placement.webp) - - _Platzierung der Leiterplattenabdeckung._ - -2. Befestigen Sie die Abdeckung mit 5x `torx-screw`. - - ![PCB-Abdeckung installiert](assets/build-pcb-cover-installed.webp) - - _PCB-Abdeckung installiert._ - -3. Stellen Sie sicher, dass keine Kabel unter der Abdeckung eingeklemmt sind. - -## Gummifüße montieren - -1. Kleben Sie 4x `rubber-foot` auf die Rückplatte. - - - - ![Gummifüße Nahaufnahme](assets/step-08-rubber-feet-closeup.webp) - - - ![Gummifüße auf der Rückplatte installiert](assets/build-backplate-rubber-feet-installed.webp) - - - -2. Stellen Sie sicher, dass alle vier Füße vorhanden und sicher sind. - -## Endmontage - -1. Schieben Sie die Rückplatte auf das Hauptgehäuse. - - - - ![Rückplatte gleitet auf Gehäuse](assets/step-09-backplate-slide.webp) - - - ![Endgültige Lockboxmontage](assets/step-09-final-assembly.webp) - - - -2. Der Zusammenbau ist abgeschlossen. Weiter zur Funktionsprüfung. - -## QC-Checkliste - -- Vergewissern Sie sich vor dem Zusammenbau, dass alle erforderlichen Teile vorhanden sind. -- Stellen Sie sicher, dass die gedruckten Teile frei von gewellten Ecken, gequetschten Schichten, großen Klecksen, blockierten Magneteinsätzen und blockierten Schraubenlöchern sind. -- Stellen Sie sicher, dass Magnete in `top-housing`, `bottom-housing` und `locking-latch` installiert sind. -- Stellen Sie sicher, dass alle 4 Magnete mit der dokumentierten Polarität installiert sind. -- Bestätigen Sie, dass `screen` und `battery` mit `hot-glue` gesichert sind. -- Stellen Sie sicher, dass `screen-ribbon-wire` verriegelt ist und der untere weiße Balken nicht sichtbar ist. -- Stellen Sie sicher, dass `encoder` verlötet ist und sich `encoder-wheel` frei dreht. -- Stellen Sie sicher, dass der `locking-latch` ohne Kleber auf dem `motor` platziert ist. -- Bestätigen Sie die Polarität des Motors und, falls von Hand gefertigt, die Länge des Motoranschlusskabels von 7 cm. -- Bestätigen Sie, dass `motor-clamp` mit 2x `torx-screw` gesichert ist. -- Stellen Sie sicher, dass die Motorklemme gerade ist. -- Stellen Sie sicher, dass die Platine sitzt, ohne `screen-ribbon-wire`, `battery-wire` oder `motor-wire` abzudecken. -- Bestätigen Sie, dass `screen-ribbon-wire`, `battery-wire` und `motor-wire` verbunden sind. -- Bestätigen Sie, dass die Tasten sauber klicken. -- Stellen Sie sicher, dass das Encoderrad im vorderen Ausschnitt ausgerichtet ist und sich frei dreht. -- Bestätigen Sie, dass `pcb-cover` mit 5x `torx-screw` gesichert ist. -- Bestätigen Sie, dass 4x `rubber-foot` auf der Rückplatte installiert sind. -- Vergewissern Sie sich, dass die Rückplatte auf das Hauptgehäuse gleitet. diff --git a/content/docs/lockbox/assembly-guide.en.mdx b/content/docs/lockbox/assembly-guide.en.mdx new file mode 100644 index 0000000..f3d57ea --- /dev/null +++ b/content/docs/lockbox/assembly-guide.en.mdx @@ -0,0 +1,404 @@ +--- +title: Lockbox Assembly Guide +--- + +## Purpose + +This work instruction documents the current Lockbox assembly process from printed parts through final mechanical assembly. + +Use these instructions with the active PCB and CAD release for the build. + +## Required parts and consumables + +1. Gather the required parts before starting assembly. + + + Required Lockbox assembly parts + + +2. Confirm the assembly set includes: + + - `top-housing` + - `bottom-housing` + - `pcb-backing` + - `locking-latch` + - `enter-button` + - `back-button` + - `encoder-wheel` + - `encoder` + - `motor` + - `screen` + - `battery` + - 7x `torx-screw` + - 4x `4mm-magnet` + - 4x `rubber-foot` + - `VHB-double-sided-tape` + - `hot-glue` + - `SA-glue` + +3. If all required parts are present, continue onward. + +## Tools + +- Electric screwdriver or hand driver with T7 Torx bit +- `flat-jaw-pliers` +- `tweezers` +- `paperclip` +- `isopropyl-alcohol` +- `microfibre-cloth` + +## Prepare plastic components + +1. Work on a soft cloth. The front face scratches easily. + +2. Check each printed part in good lighting before assembly. Look for curled corners, squished layers, large plastic blobs, blocked magnet inserts, and blocked screw holes. + +3. Use a smooth PEI print bed for front-facing cosmetic parts and a textured PEI print bed for internal parts. + +4. Inspect each printed part before installing electronics. +5. Confirm the plastic components are clean, correctly printed, and free of obstructions before continuing. + +### Part reference photos + +Use these photos while inspecting printed parts. + +#### `top-housing` + + + + Top housing + + + Top housing side view + + + +#### `bottom-housing` + + + + Bottom housing + + + Bottom housing side view + + + +#### `motor-clamp` + + + + Motor clamp + + + Motor clamp side view + + + +#### `pcb-cover` + + + + PCB cover + + + PCB cover side view + + + +#### `encoder-wheel` + + + + Encoder wheel + + + Encoder wheel side view + + + +#### `locking-latch` + + + + Locking latch + + + Locking latch side view + + + +#### `enter-button` + + + + Enter button + + + Enter button side view + + + +#### `back-button` + + + + Back button + + + Back button side view + + + +## Install magnets + +1. Install four magnets: one in the `locking-latch`, one in the `top-housing`, and two in the `bottom-housing`. + +2. Use a `paperclip` to lightly coat the inside of each magnet insert with `SA-glue`. + + + Applying superglue to magnet insert with a paperclip + + +3. Check magnet polarity before pressing each magnet into place: + + - `locking-latch`: north pole up + - `top-housing` front magnet: south side up + - `bottom-housing` front magnet: north side up + - `bottom-housing` back magnet: south side up + + + + Checking front housing magnet polarity + + + Checking bottom housing front magnet polarity + + + Checking bottom housing back magnet polarity + + + +4. Use `flat-jaw-pliers` to press magnets into their inserts. Place a folded `microfibre-cloth` between the pliers and the Lockbox body to protect the printed surface. + + + + Protecting the housing while pressing magnets + + + Pressing lock arm magnet with flat jaw pliers + + + +5. Confirm each magnet is seated flush or deep enough for its insert. + + + + Magnet installed in top housing + + + Back magnet installed in bottom housing + + + Magnet installed in locking latch + + + +6. Confirm the magnets are fully seated and glued before continuing. + +## Install screen and battery + +1. Remove the protective film from the `screen`. + +2. Align the `screen` with the top and right ledges of the `top-housing`. + +3. Hold the screen in place and set it with `hot-glue` at the corners and remaining edges. + +4. Wipe the rear of the `screen` and the side of the `battery` with writing using `isopropyl-alcohol`. + +5. Apply a 3/4 inch square piece of `VHB-double-sided-tape` to the writing side of the `battery`. + + + VHB tape applied to battery + + +6. Place the `battery` face down on the back of the `screen` with the cables exiting toward the lower right. Set with `hot-glue` as needed. + + + + Screen and battery installed in top housing + + + Screen, battery, and motor layout reference + + + +7. Confirm the screen and battery are secure and that wires remain accessible. + +## Install encoder + +1. Test-fit the `encoder-wheel` before soldering or gluing. + +2. Apply `SA-glue` to the flat face of the encoder shaft. + +3. Line up the flat of the encoder shaft with the flat face inside the `encoder-wheel`, then install the wheel. + +4. Solder the `encoder` onto the PCB. Make sure the encoder is fully seated so the wheel stays straight. + + + + Encoder installed on PCB + + + Encoder wheel installed + + + +5. Confirm the encoder wheel rotates freely before continuing. + +## Install motor + +1. Check motor polarity before installing the motor assembly. + +2. If soldering the motor lead during this build, cut the motor connector lead length to 7 cm before final routing. + +3. Place the `locking-latch` on the `motor`. Do not glue the latch to the motor. + + + Locking latch placed on motor + + +4. Slide the latch onto the motor assembly about halfway, then place the `motor` in the `top-housing`. + + + + Locking latch installed halfway on motor + + + Motor placed in housing + + + +5. Place the `motor-clamp` over the motor and secure it with 2x `torx-screw`. + + + Motor clamp installed + + +6. Confirm the motor is seated and the latch can move without obstruction. + +## Install buttons and PCB + +1. Place the `enter-button` and `back-button` into the button holes. + + + Buttons placed in housing + + +2. Place the `back-button` on the left and the lock/enter button on the right. + +3. If the buttons are not already populated, solder the buttons onto the bottom of the PCB, the side with no other components. + +4. Place the PCB onto the buttons so the `encoder-wheel` passes through the front hole. + + + PCB placement over buttons + + +5. Do not cover the `screen-ribbon-wire`, `battery-wire`, or `motor-wire`. + + + PCB seated in housing + + +6. Confirm the buttons actuate correctly and the encoder wheel is centered in the opening. + +## Connect cables + +1. Open the screen ribbon connector latch. + +2. Insert the `screen-ribbon-wire`, then close the latch. The lower white bar should not be visible after the latch is closed. + +3. Plug the `battery-wire` and `motor-wire` into the PCB. + +4. Route the motor wires left and over the PCB. + +5. Keep the battery cable away from the mounting hole below it so the cable does not get pinched by the cover. + + + + Screen, battery, and motor cables connected + + + PCB cable routing reference + + + +6. Confirm each cable is fully seated before continuing. + +## Install PCB cover + +1. Place the `pcb-cover` over the PCB. + + + PCB cover placement + + +2. Secure the cover with 5x `torx-screw`. + + + PCB cover installed + + +3. Confirm no wires are pinched under the cover. + +## Install rubber feet + +1. Glue 4x `rubber-foot` onto the backplate. + + + + Rubber feet closeup + + + Rubber feet installed on backplate + + + +2. Confirm all four feet are present and secure. + +## Final assembly + +1. Slide the backplate onto the main housing. + + + + Backplate sliding onto housing + + + Final Lockbox assembly + + + +2. Assembly is complete. Continue to functional testing. + +## QC checklist + +- Confirm all required parts were present before assembly. +- Confirm printed parts are free of curled corners, squished layers, large blobs, blocked magnet inserts, and blocked screw holes. +- Confirm magnets are installed in the `top-housing`, `bottom-housing`, and `locking-latch`. +- Confirm all 4 magnets are installed with the documented polarity. +- Confirm the `screen` and `battery` are secured with `hot-glue`. +- Confirm the `screen-ribbon-wire` is latched and the lower white bar is not visible. +- Confirm the `encoder` is soldered and the `encoder-wheel` rotates freely. +- Confirm the `locking-latch` is placed on the `motor` without glue. +- Confirm motor polarity and, if built by hand, the 7 cm motor connector lead length. +- Confirm the `motor-clamp` is secured with 2x `torx-screw`. +- Confirm the motor clamp is straight. +- Confirm the PCB is seated without covering the `screen-ribbon-wire`, `battery-wire`, or `motor-wire`. +- Confirm the `screen-ribbon-wire`, `battery-wire`, and `motor-wire` are connected. +- Confirm the buttons click cleanly. +- Confirm the encoder wheel is aligned in the front cutout and spins freely. +- Confirm the `pcb-cover` is secured with 5x `torx-screw`. +- Confirm 4x `rubber-foot` are installed on the backplate. +- Confirm the backplate slides onto the main housing. diff --git a/content/docs/lockbox/assembly-guide.fr.mdx b/content/docs/lockbox/assembly-guide.fr.mdx deleted file mode 100644 index 0f0206f..0000000 --- a/content/docs/lockbox/assembly-guide.fr.mdx +++ /dev/null @@ -1,405 +0,0 @@ ---- -title: "Guide d'assemblage du Lockbox" -description: "Guide d'assemblage du Lockbox." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## But - -Cette instruction de travail documente le processus d'assemblage actuel du Lockbox, depuis les pièces imprimées jusqu'à l'assemblage mécanique final. - -Utilisez ces instructions avec la version active du PCB et de la CAO pour le montage. - -## Pièces et consommables requis - -1. Rassemblez les pièces requises avant de commencer l'assemblage. - - ![Pièces requises pour l'assemblage du Lockbox](assets/assembly-required-parts.webp) - - _Pièces d'assemblage du Lockbox requises._ - -2. Confirmez que l'ensemble d'assemblage comprend : - - `top-housing` - - `bottom-housing` - - `pcb-backing` - - `locking-latch` - - `enter-button` - - `back-button` - - `encoder-wheel` - - `encoder` - - `motor` - - `screen` - - `battery` - - 7x `torx-screw` - - 4x `4mm-magnet` - - 4x `rubber-foot` - - `VHB-double-sided-tape` - - `hot-glue` - - `SA-glue` - -3. Si toutes les pièces requises sont présentes, continuez. - -## Outils - -- Tournevis électrique ou tournevis manuel avec embout Torx T7 -- `flat-jaw-pliers` -- `tweezers` -- `paperclip` -- `isopropyl-alcohol` -- `microfibre-cloth` - -## Préparer les composants en plastique - -1. Travaillez sur un chiffon doux. La face avant se raye facilement. - -2. Vérifiez chaque pièce imprimée sous un bon éclairage avant l'assemblage. Recherchez les coins recourbés, les couches écrasées, les grosses gouttes de plastique, les inserts magnétiques bloqués et les trous de vis bloqués. - -3. Utilisez un lit d'impression PEI lisse pour les pièces cosmétiques orientées vers l'avant et un lit d'impression PEI texturé pour les pièces internes. - -4. Inspectez chaque pièce imprimée avant d'installer l'électronique. -5. Vérifiez que les composants en plastique sont propres, correctement imprimés et exempts d'obstructions avant de continuer. - -### Photos de référence des pièces - -Utilisez ces photos lors de l'inspection des pièces imprimées. - -#### `top-housing` - - - - ![Boîtier supérieur](assets/part-top-housing-main.webp) - - - ![Vue latérale du boîtier supérieur](assets/part-top-housing-side.webp) - - - -#### `bottom-housing` - - - - ![Boîtier inférieur](assets/part-bottom-housing-main.webp) - - - ![Vue latérale du boîtier inférieur](assets/part-bottom-housing-side.webp) - - - -#### `motor-clamp` - - - - ![Bride de moteur](assets/part-motor-clamp-main.webp) - - - ![Vue latérale de la bride de moteur](assets/part-motor-clamp-side.webp) - - - -#### `pcb-cover` - - - - ![Couvercle du PCB](assets/part-pcb-cover-main.webp) - - - ![Vue latérale du couvercle du PCB](assets/part-pcb-cover-side.webp) - - - -#### `encoder-wheel` - - - - ![Roue codeuse](assets/part-encoder-wheel-main.webp) - - - ![Vue latérale de la roue codeuse](assets/part-encoder-wheel-side.webp) - - - -#### `locking-latch` - - - - ![Loquet de verrouillage](assets/part-locking-latch-main.webp) - - - ![Vue latérale du loquet de verrouillage](assets/part-locking-latch-side.webp) - - - -#### `enter-button` - - - - ![Bouton Entrée](assets/part-enter-button-main.webp) - - - ![Vue latérale du bouton Entrée](assets/part-enter-button-side.webp) - - - -#### `back-button` - - - - ![Bouton Retour](assets/part-back-button-main.webp) - - - ![Vue latérale du bouton Retour](assets/part-back-button-side.webp) - - - -## Installer des aimants - -1. Installez quatre aimants : un dans le `locking-latch`, un dans le `top-housing` et deux dans le `bottom-housing`. - -2. Utilisez un `paperclip` pour enduire légèrement l'intérieur de chaque insert magnétique avec `SA-glue`. - - ![Appliquer de la superglue sur l'insert magnétique avec un trombone](assets/build-magnet-glue-paperclip.webp) - - _Appliquez une légère couche de colle à l'intérieur de l'insert magnétique._ - -3. Vérifiez la polarité de l'aimant avant d'appuyer sur chaque aimant pour le mettre en place : - - `locking-latch`: pôle nord en haut - - Aimant frontal `top-housing` : côté sud vers le haut - - Aimant frontal `bottom-housing` : côté nord vers le haut - - Aimant arrière `bottom-housing` : côté sud vers le haut - - - - ![Vérification de la polarité de l'aimant du boîtier avant](assets/build-top-housing-magnet-polarity.webp) - - - ![Vérification de la polarité de l'aimant avant du boîtier inférieur](assets/build-bottom-housing-front-magnet-polarity.webp) - - - ![Vérification de la polarité de l'aimant arrière du boîtier inférieur](assets/build-bottom-housing-back-magnet-polarity.webp) - - - -4. Utilisez `flat-jaw-pliers` pour enfoncer les aimants dans leurs inserts. Placez un `microfibre-cloth` plié entre la pince et le corps du Lockbox pour protéger la surface imprimée. - - - - ![Protéger le boîtier en appuyant sur les aimants](assets/build-magnet-press-protection.webp) - - - ![Appuyer sur l'aimant du bras de verrouillage avec une pince à mâchoires plates](assets/build-locking-latch-magnet-press.webp) - - - -5. Vérifiez que chaque aimant est à fleur ou suffisamment enfoncé dans son insert. - - - - ![Aimant installé dans le boîtier supérieur](assets/build-top-housing-magnet-installed.webp) - - - ![Aimant arrière installé dans le boîtier inférieur](assets/build-bottom-housing-back-magnet-installed.webp) - - - ![Aimant installé dans le loquet de verrouillage](assets/step-01-magnet-locking-latch.webp) - - - -6. Vérifiez que les aimants sont bien en place et collés avant de continuer. - -## Installer l'écran et la batterie - -1. Retirez le film protecteur du `screen`. - -2. Alignez le `screen` avec les rebords supérieur et droit du `top-housing`. - -3. Maintenez l'écran en place et fixez-le avec `hot-glue` dans les coins et sur les bords restants. - -4. Essuyez l'arrière du `screen` et le côté imprimé du `battery` avec `isopropyl-alcohol`. - -5. Appliquez un morceau carré de 3/4 de pouce de `VHB-double-sided-tape` sur le côté imprimé du `battery`. - - ![Ruban VHB appliqué à la batterie](assets/build-battery-vhb-tape.webp) - - _Ruban VHB appliqué sur la batterie._ - -6. Placez le `battery` face vers le bas à l'arrière du `screen`, avec les câbles sortant vers le bas à droite. Fixez-le avec `hot-glue` si nécessaire. - - - - ![Écran et batterie installés dans le boîtier supérieur](assets/build-screen-battery-layout.webp) - - - ![Référence de configuration de l'écran, de la batterie et du moteur](assets/build-screen-motor-layout.webp) - - - -7. Confirmez que l'écran et la batterie sont solidement fixés et que les fils restent accessibles. - -## Installer l'encodeur - -1. Effectuez un montage d’essai de l’`encoder-wheel` avant de le souder ou de le coller. - -2. Appliquez `SA-glue` sur la face plate de l'arbre du codeur. - -3. Alignez le plat de l'arbre de l'encodeur avec la face plate à l’intérieur de l’`encoder-wheel`, puis installez la roue. - -4. Soudez l’`encoder` sur le PCB. Assurez-vous que l'encodeur est bien en place afin que la roue reste droite. - - - - ![Encodeur installé sur le PCB](assets/step-03-encoder-on-pcb.webp) - - - ![Roue d'encodeur installée](assets/step-03-encoder-wheel-installed.webp) - - - -5. Vérifiez que la roue codeuse tourne librement avant de continuer. - -## Installer le moteur - -1. Vérifiez la polarité du moteur avant d'installer l'ensemble moteur. - -2. Si vous soudez le fil du moteur pendant ce montage, raccourcissez la longueur du câble du connecteur du moteur à 7 cm avant son acheminement final. - -3. Placez le `locking-latch` sur le `motor`. Ne collez pas le loquet sur le moteur. - - ![Loquet de verrouillage placé sur le moteur](assets/step-04-latch-on-motor.webp) - - _Loquet de verrouillage placé sur le moteur._ - -4. Faites glisser le loquet sur l'ensemble moteur à mi-chemin, puis placez le `motor` dans le `top-housing`. - - - - ![Loquet de verrouillage installé à mi-course sur le moteur](assets/build-motor-latch-halfway.webp) - - - ![Moteur placé dans le boîtier](assets/step-04-motor-in-housing.webp) - - - -5. Placez le `motor-clamp` sur le moteur et fixez-le avec 2x `torx-screw`. - - ![Bride de moteur installée](assets/build-motor-clamp-installed.webp) - - _Bride de moteur installée._ - -6. Vérifiez que le moteur est bien en place et que le loquet peut bouger sans obstruction. - -## Installer les boutons et le PCB - -1. Placez les `enter-button` et `back-button` dans les ouvertures prévues pour les boutons. - - ![Boutons placés dans le boîtier](assets/step-05-buttons-in-housing.webp) - - _Boutons placés dans le boîtier._ - -2. Placez le `back-button` à gauche et le bouton de verrouillage/entrée à droite. - -3. Si les boutons ne sont pas déjà montés, soudez-les sur la face inférieure du PCB, celle qui ne comporte aucun autre composant. - -4. Placez le PCB sur les boutons de manière à ce que l’`encoder-wheel` passe par le trou avant. - - ![Placement du PCB sur les boutons](assets/step-05-pcb-placement.webp) - - _Placement du PCB sur les boutons._ - -5. Ne couvrez pas le `screen-ribbon-wire`, le `battery-wire` ou le `motor-wire`. - - ![PCB installé dans le boîtier](assets/step-05-pcb-seated.webp) - - _PCB installé dans le boîtier._ - -6. Vérifiez que les boutons fonctionnent correctement et que la roue codeuse est centrée dans l'ouverture. - -## Connecter les câbles - -1. Ouvrez le loquet du connecteur du ruban d'écran. - -2. Insérez le `screen-ribbon-wire`, puis fermez le loquet. La barre blanche inférieure ne doit pas être visible une fois le loquet fermé. - -3. Branchez le `battery-wire` et le `motor-wire` dans le PCB. - -4. Acheminez les fils du moteur vers la gauche et par-dessus le PCB. - -5. Éloignez le câble de la batterie du trou de montage situé en dessous afin qu'il ne soit pas pincé par le couvercle. - - - - ![Câbles d'écran, de batterie et de moteur connectés](assets/step-06-cables-connected.webp) - - - ![Référence d'acheminement des câbles PCB](assets/build-pcb-cable-routing.webp) - - - -6. Vérifiez que chaque câble est bien inséré avant de continuer. - -## Installer le couvercle du PCB - -1. Placez le `pcb-cover` sur le PCB. - - ![Placement du couvercle du PCB](assets/step-07-pcb-cover-placement.webp) - - _Placement du couvercle du PCB._ - -2. Fixez le couvercle avec 5x `torx-screw`. - - ![Couvercle du PCB installé](assets/build-pcb-cover-installed.webp) - - _Couvercle PCB installé._ - -3. Vérifiez qu'aucun fil n'est coincé sous le couvercle. - -## Installer les pieds en caoutchouc - -1. Collez 4x `rubber-foot` sur la plaque arrière. - - - - ![Pieds en caoutchouc en gros plan](assets/step-08-rubber-feet-closeup.webp) - - - ![Pieds en caoutchouc installés sur la plaque arrière](assets/build-backplate-rubber-feet-installed.webp) - - - -2. Confirmez que les quatre pieds sont présents et solidement fixés. - -## Assemblage final - -1. Faites glisser la plaque arrière sur le boîtier principal. - - - - ![Plaque arrière coulissant sur le boîtier](assets/step-09-backplate-slide.webp) - - - ![Assemblage final du Lockbox](assets/step-09-final-assembly.webp) - - - -2. L'assemblage est terminé. Continuez avec les tests fonctionnels. - -## Liste de contrôle qualité - -- Confirmez que toutes les pièces requises étaient présentes avant l'assemblage. -- Vérifiez que les pièces imprimées sont exemptes de coins recourbés, de couches écrasées, de grosses taches, d'inserts magnétiques bloqués et de trous de vis bloqués. -- Confirmez que les aimants sont installés dans le `top-housing`, le `bottom-housing` et le `locking-latch`. -- Confirmez que les 4 aimants sont installés avec la polarité documentée. -- Confirmez que le `screen` et la `battery` sont fixés avec `hot-glue`. -- Vérifiez que le `screen-ribbon-wire` est verrouillé et que la barre blanche inférieure n'est pas visible. -- Vérifiez que l’`encoder` est soudé et que l’`encoder-wheel` tourne librement. -- Confirmez que le `locking-latch` est placé sur le `motor` sans colle. -- Confirmez la polarité du moteur et, s'il est construit à la main, la longueur du câble du connecteur du moteur de 7 cm. -- Confirmez que la bride de moteur `motor-clamp` est fixée avec 2x `torx-screw`. -- Vérifiez que la bride de moteur est droite. -- Vérifiez que le PCB est bien en place sans recouvrir le `screen-ribbon-wire`, le `battery-wire` ou le `motor-wire`. -- Confirmez que les `screen-ribbon-wire`, `battery-wire` et `motor-wire` sont connectés. -- Confirmez que les boutons cliquent proprement. -- Vérifiez que la roue codeuse est alignée dans la découpe avant et tourne librement. -- Confirmez que le `pcb-cover` est fixé avec 5x `torx-screw`. -- Confirmez que 4x `rubber-foot` sont installés sur la plaque arrière. -- Vérifiez que la plaque arrière glisse sur le boîtier principal. diff --git a/content/docs/lockbox/assembly-guide.mdx b/content/docs/lockbox/assembly-guide.mdx deleted file mode 100644 index a3cbf7b..0000000 --- a/content/docs/lockbox/assembly-guide.mdx +++ /dev/null @@ -1,405 +0,0 @@ ---- -title: "Lockbox Assembly Guide" -description: "Lockbox Assembly Guide for Lockbox." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## Purpose - -This work instruction documents the current Lockbox assembly process from printed parts through final mechanical assembly. - -Use these instructions with the active PCB and CAD release for the build. - -## Required parts and consumables - -1. Gather the required parts before starting assembly. - - ![Required Lockbox assembly parts](assets/assembly-required-parts.webp) - - _Required Lockbox assembly parts._ - -2. Confirm the assembly set includes: - - `top-housing` - - `bottom-housing` - - `pcb-backing` - - `locking-latch` - - `enter-button` - - `back-button` - - `encoder-wheel` - - `encoder` - - `motor` - - `screen` - - `battery` - - 7x `torx-screw` - - 4x `4mm-magnet` - - 4x `rubber-foot` - - `VHB-double-sided-tape` - - `hot-glue` - - `SA-glue` - -3. If all required parts are present, continue onward. - -## Tools - -- Electric screwdriver or hand driver with T7 Torx bit -- `flat-jaw-pliers` -- `tweezers` -- `paperclip` -- `isopropyl-alcohol` -- `microfibre-cloth` - -## Prepare plastic components - -1. Work on a soft cloth. The front face scratches easily. - -2. Check each printed part in good lighting before assembly. Look for curled corners, squished layers, large plastic blobs, blocked magnet inserts, and blocked screw holes. - -3. Use a smooth PEI print bed for front-facing cosmetic parts and a textured PEI print bed for internal parts. - -4. Inspect each printed part before installing electronics. -5. Confirm the plastic components are clean, correctly printed, and free of obstructions before continuing. - -### Part reference photos - -Use these photos while inspecting printed parts. - -#### `top-housing` - - - - ![Top housing](assets/part-top-housing-main.webp) - - - ![Top housing side view](assets/part-top-housing-side.webp) - - - -#### `bottom-housing` - - - - ![Bottom housing](assets/part-bottom-housing-main.webp) - - - ![Bottom housing side view](assets/part-bottom-housing-side.webp) - - - -#### `motor-clamp` - - - - ![Motor clamp](assets/part-motor-clamp-main.webp) - - - ![Motor clamp side view](assets/part-motor-clamp-side.webp) - - - -#### `pcb-cover` - - - - ![PCB cover](assets/part-pcb-cover-main.webp) - - - ![PCB cover side view](assets/part-pcb-cover-side.webp) - - - -#### `encoder-wheel` - - - - ![Encoder wheel](assets/part-encoder-wheel-main.webp) - - - ![Encoder wheel side view](assets/part-encoder-wheel-side.webp) - - - -#### `locking-latch` - - - - ![Locking latch](assets/part-locking-latch-main.webp) - - - ![Locking latch side view](assets/part-locking-latch-side.webp) - - - -#### `enter-button` - - - - ![Enter button](assets/part-enter-button-main.webp) - - - ![Enter button side view](assets/part-enter-button-side.webp) - - - -#### `back-button` - - - - ![Back button](assets/part-back-button-main.webp) - - - ![Back button side view](assets/part-back-button-side.webp) - - - -## Install magnets - -1. Install four magnets: one in the `locking-latch`, one in the `top-housing`, and two in the `bottom-housing`. - -2. Use a `paperclip` to lightly coat the inside of each magnet insert with `SA-glue`. - - ![Applying superglue to magnet insert with a paperclip](assets/build-magnet-glue-paperclip.webp) - - _Apply a light coat of glue inside the magnet insert._ - -3. Check magnet polarity before pressing each magnet into place: - - `locking-latch`: north pole up - - `top-housing` front magnet: south side up - - `bottom-housing` front magnet: north side up - - `bottom-housing` back magnet: south side up - - - - ![Checking front housing magnet polarity](assets/build-top-housing-magnet-polarity.webp) - - - ![Checking bottom housing front magnet polarity](assets/build-bottom-housing-front-magnet-polarity.webp) - - - ![Checking bottom housing back magnet polarity](assets/build-bottom-housing-back-magnet-polarity.webp) - - - -4. Use `flat-jaw-pliers` to press magnets into their inserts. Place a folded `microfibre-cloth` between the pliers and the Lockbox body to protect the printed surface. - - - - ![Protecting the housing while pressing magnets](assets/build-magnet-press-protection.webp) - - - ![Pressing lock arm magnet with flat jaw pliers](assets/build-locking-latch-magnet-press.webp) - - - -5. Confirm each magnet is seated flush or deep enough for its insert. - - - - ![Magnet installed in top housing](assets/build-top-housing-magnet-installed.webp) - - - ![Back magnet installed in bottom housing](assets/build-bottom-housing-back-magnet-installed.webp) - - - ![Magnet installed in locking latch](assets/step-01-magnet-locking-latch.webp) - - - -6. Confirm the magnets are fully seated and glued before continuing. - -## Install screen and battery - -1. Remove the protective film from the `screen`. - -2. Align the `screen` with the top and right ledges of the `top-housing`. - -3. Hold the screen in place and set it with `hot-glue` at the corners and remaining edges. - -4. Wipe the rear of the `screen` and the side of the `battery` with writing using `isopropyl-alcohol`. - -5. Apply a 3/4 inch square piece of `VHB-double-sided-tape` to the writing side of the `battery`. - - ![VHB tape applied to battery](assets/build-battery-vhb-tape.webp) - - _VHB tape applied to the battery._ - -6. Place the `battery` face down on the back of the `screen` with the cables exiting toward the lower right. Set with `hot-glue` as needed. - - - - ![Screen and battery installed in top housing](assets/build-screen-battery-layout.webp) - - - ![Screen, battery, and motor layout reference](assets/build-screen-motor-layout.webp) - - - -7. Confirm the screen and battery are secure and that wires remain accessible. - -## Install encoder - -1. Test-fit the `encoder-wheel` before soldering or gluing. - -2. Apply `SA-glue` to the flat face of the encoder shaft. - -3. Line up the flat of the encoder shaft with the flat face inside the `encoder-wheel`, then install the wheel. - -4. Solder the `encoder` onto the PCB. Make sure the encoder is fully seated so the wheel stays straight. - - - - ![Encoder installed on PCB](assets/step-03-encoder-on-pcb.webp) - - - ![Encoder wheel installed](assets/step-03-encoder-wheel-installed.webp) - - - -5. Confirm the encoder wheel rotates freely before continuing. - -## Install motor - -1. Check motor polarity before installing the motor assembly. - -2. If soldering the motor lead during this build, cut the motor connector lead length to 7 cm before final routing. - -3. Place the `locking-latch` on the `motor`. Do not glue the latch to the motor. - - ![Locking latch placed on motor](assets/step-04-latch-on-motor.webp) - - _Locking latch placed on the motor._ - -4. Slide the latch onto the motor assembly about halfway, then place the `motor` in the `top-housing`. - - - - ![Locking latch installed halfway on motor](assets/build-motor-latch-halfway.webp) - - - ![Motor placed in housing](assets/step-04-motor-in-housing.webp) - - - -5. Place the `motor-clamp` over the motor and secure it with 2x `torx-screw`. - - ![Motor clamp installed](assets/build-motor-clamp-installed.webp) - - _Motor clamp installed._ - -6. Confirm the motor is seated and the latch can move without obstruction. - -## Install buttons and PCB - -1. Place the `enter-button` and `back-button` into the button holes. - - ![Buttons placed in housing](assets/step-05-buttons-in-housing.webp) - - _Buttons placed in housing._ - -2. Place the `back-button` on the left and the lock/enter button on the right. - -3. If the buttons are not already populated, solder the buttons onto the bottom of the PCB, the side with no other components. - -4. Place the PCB onto the buttons so the `encoder-wheel` passes through the front hole. - - ![PCB placement over buttons](assets/step-05-pcb-placement.webp) - - _PCB placement over buttons._ - -5. Do not cover the `screen-ribbon-wire`, `battery-wire`, or `motor-wire`. - - ![PCB seated in housing](assets/step-05-pcb-seated.webp) - - _PCB seated in housing._ - -6. Confirm the buttons actuate correctly and the encoder wheel is centered in the opening. - -## Connect cables - -1. Open the screen ribbon connector latch. - -2. Insert the `screen-ribbon-wire`, then close the latch. The lower white bar should not be visible after the latch is closed. - -3. Plug the `battery-wire` and `motor-wire` into the PCB. - -4. Route the motor wires left and over the PCB. - -5. Keep the battery cable away from the mounting hole below it so the cable does not get pinched by the cover. - - - - ![Screen, battery, and motor cables connected](assets/step-06-cables-connected.webp) - - - ![PCB cable routing reference](assets/build-pcb-cable-routing.webp) - - - -6. Confirm each cable is fully seated before continuing. - -## Install PCB cover - -1. Place the `pcb-cover` over the PCB. - - ![PCB cover placement](assets/step-07-pcb-cover-placement.webp) - - _PCB cover placement._ - -2. Secure the cover with 5x `torx-screw`. - - ![PCB cover installed](assets/build-pcb-cover-installed.webp) - - _PCB cover installed._ - -3. Confirm no wires are pinched under the cover. - -## Install rubber feet - -1. Glue 4x `rubber-foot` onto the backplate. - - - - ![Rubber feet closeup](assets/step-08-rubber-feet-closeup.webp) - - - ![Rubber feet installed on backplate](assets/build-backplate-rubber-feet-installed.webp) - - - -2. Confirm all four feet are present and secure. - -## Final assembly - -1. Slide the backplate onto the main housing. - - - - ![Backplate sliding onto housing](assets/step-09-backplate-slide.webp) - - - ![Final Lockbox assembly](assets/step-09-final-assembly.webp) - - - -2. Assembly is complete. Continue to functional testing. - -## QC checklist - -- Confirm all required parts were present before assembly. -- Confirm printed parts are free of curled corners, squished layers, large blobs, blocked magnet inserts, and blocked screw holes. -- Confirm magnets are installed in the `top-housing`, `bottom-housing`, and `locking-latch`. -- Confirm all 4 magnets are installed with the documented polarity. -- Confirm the `screen` and `battery` are secured with `hot-glue`. -- Confirm the `screen-ribbon-wire` is latched and the lower white bar is not visible. -- Confirm the `encoder` is soldered and the `encoder-wheel` rotates freely. -- Confirm the `locking-latch` is placed on the `motor` without glue. -- Confirm motor polarity and, if built by hand, the 7 cm motor connector lead length. -- Confirm the `motor-clamp` is secured with 2x `torx-screw`. -- Confirm the motor clamp is straight. -- Confirm the PCB is seated without covering the `screen-ribbon-wire`, `battery-wire`, or `motor-wire`. -- Confirm the `screen-ribbon-wire`, `battery-wire`, and `motor-wire` are connected. -- Confirm the buttons click cleanly. -- Confirm the encoder wheel is aligned in the front cutout and spins freely. -- Confirm the `pcb-cover` is secured with 5x `torx-screw`. -- Confirm 4x `rubber-foot` are installed on the backplate. -- Confirm the backplate slides onto the main housing. diff --git a/content/docs/lockbox/assembly-guide.nl.mdx b/content/docs/lockbox/assembly-guide.nl.mdx deleted file mode 100644 index 9df6d23..0000000 --- a/content/docs/lockbox/assembly-guide.nl.mdx +++ /dev/null @@ -1,405 +0,0 @@ ---- -title: "Montagehandleiding voor de Lockbox" -description: "Montagehandleiding voor de Lockbox." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## Doel - -Deze werkinstructie documenteert het huidige assemblageproces van de Lockbox, van gedrukte onderdelen tot en met de uiteindelijke mechanische assemblage. - -Gebruik deze instructies met de actieve PCB- en CAD-release voor de build. - -## Benodigde onderdelen en verbruiksartikelen - -1. Verzamel de benodigde onderdelen voordat u met de montage begint. - - ![Vereiste onderdelen voor de Lockbox-montage](assets/assembly-required-parts.webp) - - _Benodigde onderdelen voor de Lockbox-montage._ - -2. Controleer of de montageset het volgende bevat: - - `top-housing` - - `bottom-housing` - - `pcb-backing` - - `locking-latch` - - `enter-button` - - `back-button` - - `encoder-wheel` - - `encoder` - - `motor` - - `screen` - - `battery` - - 7x `torx-screw` - - 4x `4mm-magnet` - - 4x `rubber-foot` - - `VHB-double-sided-tape` - - `hot-glue` - - `SA-glue` - -3. Als alle benodigde onderdelen aanwezig zijn, gaat u verder. - -## Hulpmiddelen - -- Elektrische schroevendraaier of handschroevendraaier met T7 Torx-bit -- `flat-jaw-pliers` -- `tweezers` -- `paperclip` -- `isopropyl-alcohol` -- `microfibre-cloth` - -## Plastic onderdelen voorbereiden - -1. Werk op een zachte doek. De voorkant krast gemakkelijk. - -2. Controleer elk afgedrukt onderdeel vóór montage in goede verlichting. Zoek naar gekrulde hoeken, platgedrukte lagen, grote plastic klodders, geblokkeerde magneetinzetstukken en geblokkeerde schroefgaten. - -3. Gebruik een glad PEI-printbed voor naar voren gerichte cosmetische onderdelen en een getextureerd PEI-printbed voor interne onderdelen. - -4. Inspecteer elk afgedrukt onderdeel voordat u elektronica installeert. -5. Controleer of de plastic onderdelen schoon zijn, correct zijn bedrukt en vrij zijn van obstakels voordat u verdergaat. - -### Referentiefoto's van onderdelen - -Gebruik deze foto's bij het inspecteren van afgedrukte onderdelen. - -#### `top-housing` - - - - ![Bovenste behuizing](assets/part-top-housing-main.webp) - - - ![Zijaanzicht bovenbehuizing](assets/part-top-housing-side.webp) - - - -#### `bottom-housing` - - - - ![Onderbehuizing](assets/part-bottom-housing-main.webp) - - - ![Zijaanzicht van de onderbehuizing](assets/part-bottom-housing-side.webp) - - - -#### `motor-clamp` - - - - ![Motorklem](assets/part-motor-clamp-main.webp) - - - ![Motorklem zijaanzicht](assets/part-motor-clamp-side.webp) - - - -#### `pcb-cover` - - - - ![PCB-afdekking](assets/part-pcb-cover-main.webp) - - - ![PCB-deksel zijaanzicht](assets/part-pcb-cover-side.webp) - - - -#### `encoder-wheel` - - - - ![Encoderwiel](assets/part-encoder-wheel-main.webp) - - - ![Encoderwiel zijaanzicht](assets/part-encoder-wheel-side.webp) - - - -#### `locking-latch` - - - - ![Vergrendeling](assets/part-locking-latch-main.webp) - - - ![Vergrendeling zijaanzicht](assets/part-locking-latch-side.webp) - - - -#### `enter-button` - - - - ![Enter-knop](assets/part-enter-button-main.webp) - - - ![Enter-knop zijaanzicht](assets/part-enter-button-side.webp) - - - -#### `back-button` - - - - ![Terug-knop](assets/part-back-button-main.webp) - - - ![Terugknop zijaanzicht](assets/part-back-button-side.webp) - - - -## Installeer magneten - -1. Installeer vier magneten: één in de `locking-latch`, één in de `top-housing` en twee in de `bottom-housing`. - -2. Gebruik een `paperclip` om de binnenkant van elk magneetinzetstuk lichtjes met `SA-glue` te bestrijken. - - ![Superlijm op magneetinzet aanbrengen met een paperclip](assets/build-magnet-glue-paperclip.webp) - - _Breng een dun laagje lijm aan in het magneetinzetstuk._ - -3. Controleer de magneetpolariteit voordat u elke magneet op zijn plaats drukt: - - `locking-latch`: noordpool omhoog - - `top-housing` frontmagneet: zuidkant naar boven - - `bottom-housing` frontmagneet: noordkant naar boven - - `bottom-housing` achtermagneet: zuidkant naar boven - - - - ![Polariteit van de voorste magneet van de bovenbehuizing controleren](assets/build-top-housing-magnet-polarity.webp) - - - ![Polariteit van de voorste magneet van de onderbehuizing controleren](assets/build-bottom-housing-front-magnet-polarity.webp) - - - ![Polariteit van de achterste magneet van de onderbehuizing controleren](assets/build-bottom-housing-back-magnet-polarity.webp) - - - -4. Gebruik `flat-jaw-pliers` om magneten in hun inzetstukken te drukken. Plaats een gevouwen `microfibre-cloth` tussen de tang en de Lockbox-behuizing om het bedrukte oppervlak te beschermen. - - - - ![Bescherming van de behuizing tijdens het indrukken van magneten](assets/build-magnet-press-protection.webp) - - - ![Druk op de vergrendelarmmagneet met een tang met platte bek](assets/build-locking-latch-magnet-press.webp) - - - -5. Zorg ervoor dat elke magneet vlak of diep genoeg in het magneetinzetstuk zit. - - - - ![Magneet geïnstalleerd in bovenste behuizing](assets/build-top-housing-magnet-installed.webp) - - - ![Achtermagneet van de onderbehuizing geïnstalleerd](assets/build-bottom-housing-back-magnet-installed.webp) - - - ![Magneet geïnstalleerd in vergrendeling](assets/step-01-magnet-locking-latch.webp) - - - -6. Zorg ervoor dat de magneten volledig op hun plaats zitten en vastgelijmd zijn voordat u verdergaat. - -## Installeer scherm en batterij - -1. Verwijder de beschermfolie van de `screen`. - -2. Lijn de `screen` uit met de bovenste en rechter richels van de `top-housing`. - -3. Houd het scherm op zijn plaats en zet het met `hot-glue` vast op de hoeken en overige randen. - -4. Veeg de achterkant van de `screen` en de bedrukte zijde van de `battery` schoon met `isopropyl-alcohol`. - -5. Breng een vierkant stuk `VHB-double-sided-tape` van 3/4 inch aan op de bedrukte zijde van de `battery`. - - ![VHB-tape aangebracht op batterij](assets/build-battery-vhb-tape.webp) - - _VHB-tape aangebracht op de batterij._ - -6. Plaats de `battery` met de voorkant naar beneden op de achterkant van de `screen`, met de kabels naar rechtsonder naar buiten. Zet de batterij indien nodig vast met `hot-glue`. - - - - ![Scherm en batterij geïnstalleerd in bovenste behuizing](assets/build-screen-battery-layout.webp) - - - ![Referentie scherm-, batterij- en motorindeling](assets/build-screen-motor-layout.webp) - - - -7. Controleer of het scherm en de batterij goed vastzitten en of de draden toegankelijk blijven. - -## Encoder installeren - -1. Pas de `encoder-wheel` vóór het solderen of lijmen eerst proef. - -2. Breng `SA-glue` aan op het platte vlak van de encoderas. - -3. Lijn de platte kant van de encoderas uit met de platte kant in de `encoder-wheel` en installeer vervolgens het wiel. - -4. Soldeer de `encoder` op de printplaat. Zorg ervoor dat de encoder volledig op zijn plaats zit, zodat het wiel recht blijft. - - - - ![Encoder geïnstalleerd op printplaat](assets/step-03-encoder-on-pcb.webp) - - - ![Encoderwiel geïnstalleerd](assets/step-03-encoder-wheel-installed.webp) - - - -5. Controleer of het encoderwiel vrij kan draaien voordat u verdergaat. - -## Motor installeren - -1. Controleer de polariteit van de motor voordat u de motoreenheid installeert. - -2. Als u tijdens deze bouw de motorkabel soldeert, kort u de motoraansluitkabel voorzichtig in tot 7 cm voordat u deze definitief aanlegt. - -3. Plaats de `locking-latch` op de `motor`. Lijm de grendel niet op de motor. - - ![Vergrendeling op motor geplaatst](assets/step-04-latch-on-motor.webp) - - _Vergrendeling op de motor geplaatst._ - -4. Schuif de grendel ongeveer halverwege op de motorconstructie en plaats vervolgens de `motor` in de `top-housing`. - - - - ![Vergrendeling halverwege op de motor geïnstalleerd](assets/build-motor-latch-halfway.webp) - - - ![Motor in behuizing geplaatst](assets/step-04-motor-in-housing.webp) - - - -5. Plaats de `motor-clamp` over de motor en zet deze vast met 2x `torx-screw`. - - ![Motorklem geïnstalleerd](assets/build-motor-clamp-installed.webp) - - _Motorklem geïnstalleerd._ - -6. Zorg ervoor dat de motor op zijn plaats zit en dat de grendel ongehinderd kan bewegen. - -## Installeer knoppen en PCB - -1. Plaats de `enter-button` en `back-button` in de knopopeningen. - - ![Knoppen geplaatst in behuizing](assets/step-05-buttons-in-housing.webp) - - _Knoppen geplaatst in behuizing._ - -2. Plaats de `back-button` aan de linkerkant en de lock/enter-knop aan de rechterkant. - -3. Als de knoppen nog niet zijn gemonteerd, soldeer ze dan op de onderkant van de printplaat, de kant zonder andere componenten. - -4. Plaats de printplaat op de knoppen zodat de `encoder-wheel` door het voorste gat gaat. - - ![PCB-plaatsing over knoppen](assets/step-05-pcb-placement.webp) - - _PCB-plaatsing over knoppen._ - -5. Dek de `screen-ribbon-wire`, `battery-wire` of `motor-wire` niet af. - - ![PCB zit in behuizing](assets/step-05-pcb-seated.webp) - - _PCB zit in behuizing._ - -6. Controleer of de knoppen correct werken en of het encoderwiel gecentreerd is in de opening. - -## Sluit de kabels aan - -1. Open de vergrendeling van de schermlintconnector. - -2. Plaats de `screen-ribbon-wire` en sluit vervolgens de vergrendeling. De onderste witte balk mag niet zichtbaar zijn nadat de grendel is gesloten. - -3. Sluit de `battery-wire` en `motor-wire` aan op de printplaat. - -4. Leid de motordraden naar links en over de printplaat. - -5. Houd de accukabel uit de buurt van het montagegat eronder, zodat de kabel niet bekneld raakt door het deksel. - - - - ![Scherm-, batterij- en motorkabels aangesloten](assets/step-06-cables-connected.webp) - - - ![Referentie PCB-kabelgeleiding](assets/build-pcb-cable-routing.webp) - - - -6. Controleer of elke kabel goed op zijn plaats zit voordat u verdergaat. - -## Installeer het PCB-deksel - -1. Plaats de `pcb-cover` over de printplaat. - - ![Plaatsing printplaatafdekking](assets/step-07-pcb-cover-placement.webp) - - _PCB-afdekking plaatsen._ - -2. Zet het deksel vast met 5x `torx-screw`. - - ![PCB-afdekking geïnstalleerd](assets/build-pcb-cover-installed.webp) - - _PCB-afdekking geïnstalleerd._ - -3. Controleer of er geen draden bekneld zitten onder de afdekking. - -## Installeer rubberen voetjes - -1. Lijm 4x `rubber-foot` op de achterplaat. - - - - ![Rubberen voetjes close-up](assets/step-08-rubber-feet-closeup.webp) - - - ![Rubberen voetjes geïnstalleerd op achterplaat](assets/build-backplate-rubber-feet-installed.webp) - - - -2. Controleer of alle vier de voetjes aanwezig zijn en stevig vastzitten. - -## Eindmontage - -1. Schuif de achterplaat op de hoofdbehuizing. - - - - ![Achterplaat schuift op behuizing](assets/step-09-backplate-slide.webp) - - - ![Definitieve Lockbox-montage](assets/step-09-final-assembly.webp) - - - -2. De montage is voltooid. Ga verder met functioneel testen. - -## QC-checklist - -- Bevestig dat alle vereiste onderdelen aanwezig waren vóór de montage. -- Controleer of de afgedrukte onderdelen vrij zijn van omgekrulde hoeken, platgedrukte lagen, grote klodders, geblokkeerde magneetinzetstukken en geblokkeerde schroefgaten. -- Controleer of er magneten zijn geïnstalleerd in de `top-housing`, `bottom-housing` en `locking-latch`. -- Controleer of alle 4 de magneten zijn geïnstalleerd met de gedocumenteerde polariteit. -- Controleer of de `screen` en `battery` zijn beveiligd met `hot-glue`. -- Bevestig dat de `screen-ribbon-wire` is vergrendeld en dat de onderste witte balk niet zichtbaar is. -- Controleer of de `encoder` is gesoldeerd en de `encoder-wheel` vrij kan draaien. -- Controleer of de `locking-latch` zonder lijm op de `motor` is geplaatst. -- Controleer de polariteit van de motor en, indien met de hand gebouwd, de kabellengte van de motorconnector van 7 cm. -- Bevestig dat de `motor-clamp` is beveiligd met 2x `torx-screw`. -- Controleer of de motorklem recht is. -- Controleer of de PCB is geplaatst zonder de `screen-ribbon-wire`, `battery-wire` of `motor-wire` af te dekken. -- Bevestig dat de `screen-ribbon-wire`, `battery-wire` en `motor-wire` zijn aangesloten. -- Bevestig dat de knoppen netjes klikken. -- Controleer of het encoderwiel in de uitsparing aan de voorkant is uitgelijnd en vrij kan draaien. -- Controleer of de `pcb-cover` is beveiligd met 5x `torx-screw`. -- Controleer of er 4x `rubber-foot` op de achterplaat zijn geïnstalleerd. -- Bevestig dat de achterplaat op de hoofdbehuizing schuift. diff --git a/content/docs/lockbox/assets/assembly-required-parts.png b/content/docs/lockbox/assets/assembly-required-parts.png new file mode 100644 index 0000000..a566bc2 Binary files /dev/null and b/content/docs/lockbox/assets/assembly-required-parts.png differ diff --git a/content/docs/lockbox/assets/assembly-required-parts.webp b/content/docs/lockbox/assets/assembly-required-parts.webp deleted file mode 100644 index 122dd8a..0000000 Binary files a/content/docs/lockbox/assets/assembly-required-parts.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-backplate-rubber-feet-installed.jpg b/content/docs/lockbox/assets/build-backplate-rubber-feet-installed.jpg new file mode 100644 index 0000000..b705c88 Binary files /dev/null and b/content/docs/lockbox/assets/build-backplate-rubber-feet-installed.jpg differ diff --git a/content/docs/lockbox/assets/build-backplate-rubber-feet-installed.webp b/content/docs/lockbox/assets/build-backplate-rubber-feet-installed.webp deleted file mode 100644 index e545926..0000000 Binary files a/content/docs/lockbox/assets/build-backplate-rubber-feet-installed.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-battery-vhb-tape.jpg b/content/docs/lockbox/assets/build-battery-vhb-tape.jpg new file mode 100644 index 0000000..79c839c Binary files /dev/null and b/content/docs/lockbox/assets/build-battery-vhb-tape.jpg differ diff --git a/content/docs/lockbox/assets/build-battery-vhb-tape.webp b/content/docs/lockbox/assets/build-battery-vhb-tape.webp deleted file mode 100644 index 9c1f1e6..0000000 Binary files a/content/docs/lockbox/assets/build-battery-vhb-tape.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-bottom-housing-back-magnet-installed.jpg b/content/docs/lockbox/assets/build-bottom-housing-back-magnet-installed.jpg new file mode 100644 index 0000000..35bbae1 Binary files /dev/null and b/content/docs/lockbox/assets/build-bottom-housing-back-magnet-installed.jpg differ diff --git a/content/docs/lockbox/assets/build-bottom-housing-back-magnet-installed.webp b/content/docs/lockbox/assets/build-bottom-housing-back-magnet-installed.webp deleted file mode 100644 index 2913849..0000000 Binary files a/content/docs/lockbox/assets/build-bottom-housing-back-magnet-installed.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-bottom-housing-back-magnet-polarity.jpg b/content/docs/lockbox/assets/build-bottom-housing-back-magnet-polarity.jpg new file mode 100644 index 0000000..80eaf5e Binary files /dev/null and b/content/docs/lockbox/assets/build-bottom-housing-back-magnet-polarity.jpg differ diff --git a/content/docs/lockbox/assets/build-bottom-housing-back-magnet-polarity.webp b/content/docs/lockbox/assets/build-bottom-housing-back-magnet-polarity.webp deleted file mode 100644 index b9add9c..0000000 Binary files a/content/docs/lockbox/assets/build-bottom-housing-back-magnet-polarity.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-bottom-housing-front-magnet-polarity.jpg b/content/docs/lockbox/assets/build-bottom-housing-front-magnet-polarity.jpg new file mode 100644 index 0000000..2a4c485 Binary files /dev/null and b/content/docs/lockbox/assets/build-bottom-housing-front-magnet-polarity.jpg differ diff --git a/content/docs/lockbox/assets/build-bottom-housing-front-magnet-polarity.webp b/content/docs/lockbox/assets/build-bottom-housing-front-magnet-polarity.webp deleted file mode 100644 index b204ee7..0000000 Binary files a/content/docs/lockbox/assets/build-bottom-housing-front-magnet-polarity.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-locking-latch-magnet-press.jpg b/content/docs/lockbox/assets/build-locking-latch-magnet-press.jpg new file mode 100644 index 0000000..1f3394e Binary files /dev/null and b/content/docs/lockbox/assets/build-locking-latch-magnet-press.jpg differ diff --git a/content/docs/lockbox/assets/build-locking-latch-magnet-press.webp b/content/docs/lockbox/assets/build-locking-latch-magnet-press.webp deleted file mode 100644 index 7ecc233..0000000 Binary files a/content/docs/lockbox/assets/build-locking-latch-magnet-press.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-magnet-glue-paperclip.jpg b/content/docs/lockbox/assets/build-magnet-glue-paperclip.jpg new file mode 100644 index 0000000..d86704a Binary files /dev/null and b/content/docs/lockbox/assets/build-magnet-glue-paperclip.jpg differ diff --git a/content/docs/lockbox/assets/build-magnet-glue-paperclip.webp b/content/docs/lockbox/assets/build-magnet-glue-paperclip.webp deleted file mode 100644 index e331dc1..0000000 Binary files a/content/docs/lockbox/assets/build-magnet-glue-paperclip.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-magnet-press-protection.jpg b/content/docs/lockbox/assets/build-magnet-press-protection.jpg new file mode 100644 index 0000000..1acb2b9 Binary files /dev/null and b/content/docs/lockbox/assets/build-magnet-press-protection.jpg differ diff --git a/content/docs/lockbox/assets/build-magnet-press-protection.webp b/content/docs/lockbox/assets/build-magnet-press-protection.webp deleted file mode 100644 index eafa31f..0000000 Binary files a/content/docs/lockbox/assets/build-magnet-press-protection.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-motor-clamp-installed.jpg b/content/docs/lockbox/assets/build-motor-clamp-installed.jpg new file mode 100644 index 0000000..e545633 Binary files /dev/null and b/content/docs/lockbox/assets/build-motor-clamp-installed.jpg differ diff --git a/content/docs/lockbox/assets/build-motor-clamp-installed.webp b/content/docs/lockbox/assets/build-motor-clamp-installed.webp deleted file mode 100644 index 248c416..0000000 Binary files a/content/docs/lockbox/assets/build-motor-clamp-installed.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-motor-latch-halfway.jpg b/content/docs/lockbox/assets/build-motor-latch-halfway.jpg new file mode 100644 index 0000000..5d3c9c6 Binary files /dev/null and b/content/docs/lockbox/assets/build-motor-latch-halfway.jpg differ diff --git a/content/docs/lockbox/assets/build-motor-latch-halfway.webp b/content/docs/lockbox/assets/build-motor-latch-halfway.webp deleted file mode 100644 index 4dc12ba..0000000 Binary files a/content/docs/lockbox/assets/build-motor-latch-halfway.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-pcb-cable-routing.jpg b/content/docs/lockbox/assets/build-pcb-cable-routing.jpg new file mode 100644 index 0000000..5893754 Binary files /dev/null and b/content/docs/lockbox/assets/build-pcb-cable-routing.jpg differ diff --git a/content/docs/lockbox/assets/build-pcb-cable-routing.webp b/content/docs/lockbox/assets/build-pcb-cable-routing.webp deleted file mode 100644 index 4854b36..0000000 Binary files a/content/docs/lockbox/assets/build-pcb-cable-routing.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-pcb-cover-installed.jpg b/content/docs/lockbox/assets/build-pcb-cover-installed.jpg new file mode 100644 index 0000000..bf411e1 Binary files /dev/null and b/content/docs/lockbox/assets/build-pcb-cover-installed.jpg differ diff --git a/content/docs/lockbox/assets/build-pcb-cover-installed.webp b/content/docs/lockbox/assets/build-pcb-cover-installed.webp deleted file mode 100644 index 65b68cb..0000000 Binary files a/content/docs/lockbox/assets/build-pcb-cover-installed.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-screen-battery-layout.jpg b/content/docs/lockbox/assets/build-screen-battery-layout.jpg new file mode 100644 index 0000000..ffaea4b Binary files /dev/null and b/content/docs/lockbox/assets/build-screen-battery-layout.jpg differ diff --git a/content/docs/lockbox/assets/build-screen-battery-layout.webp b/content/docs/lockbox/assets/build-screen-battery-layout.webp deleted file mode 100644 index 0fb9859..0000000 Binary files a/content/docs/lockbox/assets/build-screen-battery-layout.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-screen-motor-layout.jpg b/content/docs/lockbox/assets/build-screen-motor-layout.jpg new file mode 100644 index 0000000..1fd4f00 Binary files /dev/null and b/content/docs/lockbox/assets/build-screen-motor-layout.jpg differ diff --git a/content/docs/lockbox/assets/build-screen-motor-layout.webp b/content/docs/lockbox/assets/build-screen-motor-layout.webp deleted file mode 100644 index 0ae89aa..0000000 Binary files a/content/docs/lockbox/assets/build-screen-motor-layout.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-top-housing-magnet-installed.jpg b/content/docs/lockbox/assets/build-top-housing-magnet-installed.jpg new file mode 100644 index 0000000..5bc0067 Binary files /dev/null and b/content/docs/lockbox/assets/build-top-housing-magnet-installed.jpg differ diff --git a/content/docs/lockbox/assets/build-top-housing-magnet-installed.webp b/content/docs/lockbox/assets/build-top-housing-magnet-installed.webp deleted file mode 100644 index 4b3ebd1..0000000 Binary files a/content/docs/lockbox/assets/build-top-housing-magnet-installed.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/build-top-housing-magnet-polarity.jpg b/content/docs/lockbox/assets/build-top-housing-magnet-polarity.jpg new file mode 100644 index 0000000..d76d59c Binary files /dev/null and b/content/docs/lockbox/assets/build-top-housing-magnet-polarity.jpg differ diff --git a/content/docs/lockbox/assets/build-top-housing-magnet-polarity.webp b/content/docs/lockbox/assets/build-top-housing-magnet-polarity.webp deleted file mode 100644 index 572dfa9..0000000 Binary files a/content/docs/lockbox/assets/build-top-housing-magnet-polarity.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/device-overview.png b/content/docs/lockbox/assets/device-overview.png new file mode 100644 index 0000000..f129827 Binary files /dev/null and b/content/docs/lockbox/assets/device-overview.png differ diff --git a/content/docs/lockbox/assets/device-overview.webp b/content/docs/lockbox/assets/device-overview.webp deleted file mode 100644 index f48739a..0000000 Binary files a/content/docs/lockbox/assets/device-overview.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/electronics-overview.png b/content/docs/lockbox/assets/electronics-overview.png new file mode 100644 index 0000000..348ea31 Binary files /dev/null and b/content/docs/lockbox/assets/electronics-overview.png differ diff --git a/content/docs/lockbox/assets/electronics-overview.webp b/content/docs/lockbox/assets/electronics-overview.webp deleted file mode 100644 index 86c317a..0000000 Binary files a/content/docs/lockbox/assets/electronics-overview.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-back-button-main.png b/content/docs/lockbox/assets/part-back-button-main.png new file mode 100644 index 0000000..8741b71 Binary files /dev/null and b/content/docs/lockbox/assets/part-back-button-main.png differ diff --git a/content/docs/lockbox/assets/part-back-button-main.webp b/content/docs/lockbox/assets/part-back-button-main.webp deleted file mode 100644 index 8ae0a75..0000000 Binary files a/content/docs/lockbox/assets/part-back-button-main.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-back-button-side.png b/content/docs/lockbox/assets/part-back-button-side.png new file mode 100644 index 0000000..cc70ff0 Binary files /dev/null and b/content/docs/lockbox/assets/part-back-button-side.png differ diff --git a/content/docs/lockbox/assets/part-back-button-side.webp b/content/docs/lockbox/assets/part-back-button-side.webp deleted file mode 100644 index 3ed58ef..0000000 Binary files a/content/docs/lockbox/assets/part-back-button-side.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-bottom-housing-main.png b/content/docs/lockbox/assets/part-bottom-housing-main.png new file mode 100644 index 0000000..f93e75e Binary files /dev/null and b/content/docs/lockbox/assets/part-bottom-housing-main.png differ diff --git a/content/docs/lockbox/assets/part-bottom-housing-main.webp b/content/docs/lockbox/assets/part-bottom-housing-main.webp deleted file mode 100644 index 2c8f380..0000000 Binary files a/content/docs/lockbox/assets/part-bottom-housing-main.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-bottom-housing-side.png b/content/docs/lockbox/assets/part-bottom-housing-side.png new file mode 100644 index 0000000..06ddeb5 Binary files /dev/null and b/content/docs/lockbox/assets/part-bottom-housing-side.png differ diff --git a/content/docs/lockbox/assets/part-bottom-housing-side.webp b/content/docs/lockbox/assets/part-bottom-housing-side.webp deleted file mode 100644 index 358871b..0000000 Binary files a/content/docs/lockbox/assets/part-bottom-housing-side.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-encoder-wheel-main.png b/content/docs/lockbox/assets/part-encoder-wheel-main.png new file mode 100644 index 0000000..38a9df8 Binary files /dev/null and b/content/docs/lockbox/assets/part-encoder-wheel-main.png differ diff --git a/content/docs/lockbox/assets/part-encoder-wheel-main.webp b/content/docs/lockbox/assets/part-encoder-wheel-main.webp deleted file mode 100644 index 9daf901..0000000 Binary files a/content/docs/lockbox/assets/part-encoder-wheel-main.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-encoder-wheel-side.png b/content/docs/lockbox/assets/part-encoder-wheel-side.png new file mode 100644 index 0000000..f32bbba Binary files /dev/null and b/content/docs/lockbox/assets/part-encoder-wheel-side.png differ diff --git a/content/docs/lockbox/assets/part-encoder-wheel-side.webp b/content/docs/lockbox/assets/part-encoder-wheel-side.webp deleted file mode 100644 index e5b35e8..0000000 Binary files a/content/docs/lockbox/assets/part-encoder-wheel-side.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-enter-button-main.png b/content/docs/lockbox/assets/part-enter-button-main.png new file mode 100644 index 0000000..da3a87b Binary files /dev/null and b/content/docs/lockbox/assets/part-enter-button-main.png differ diff --git a/content/docs/lockbox/assets/part-enter-button-main.webp b/content/docs/lockbox/assets/part-enter-button-main.webp deleted file mode 100644 index 50496f9..0000000 Binary files a/content/docs/lockbox/assets/part-enter-button-main.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-enter-button-side.png b/content/docs/lockbox/assets/part-enter-button-side.png new file mode 100644 index 0000000..c898081 Binary files /dev/null and b/content/docs/lockbox/assets/part-enter-button-side.png differ diff --git a/content/docs/lockbox/assets/part-enter-button-side.webp b/content/docs/lockbox/assets/part-enter-button-side.webp deleted file mode 100644 index 0c6770d..0000000 Binary files a/content/docs/lockbox/assets/part-enter-button-side.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-locking-latch-main.png b/content/docs/lockbox/assets/part-locking-latch-main.png new file mode 100644 index 0000000..1972017 Binary files /dev/null and b/content/docs/lockbox/assets/part-locking-latch-main.png differ diff --git a/content/docs/lockbox/assets/part-locking-latch-main.webp b/content/docs/lockbox/assets/part-locking-latch-main.webp deleted file mode 100644 index fc798da..0000000 Binary files a/content/docs/lockbox/assets/part-locking-latch-main.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-locking-latch-side.png b/content/docs/lockbox/assets/part-locking-latch-side.png new file mode 100644 index 0000000..be28d7a Binary files /dev/null and b/content/docs/lockbox/assets/part-locking-latch-side.png differ diff --git a/content/docs/lockbox/assets/part-locking-latch-side.webp b/content/docs/lockbox/assets/part-locking-latch-side.webp deleted file mode 100644 index b4bb6a3..0000000 Binary files a/content/docs/lockbox/assets/part-locking-latch-side.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-motor-clamp-main.png b/content/docs/lockbox/assets/part-motor-clamp-main.png new file mode 100644 index 0000000..0af1d3d Binary files /dev/null and b/content/docs/lockbox/assets/part-motor-clamp-main.png differ diff --git a/content/docs/lockbox/assets/part-motor-clamp-main.webp b/content/docs/lockbox/assets/part-motor-clamp-main.webp deleted file mode 100644 index 2f0e9e0..0000000 Binary files a/content/docs/lockbox/assets/part-motor-clamp-main.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-motor-clamp-side.png b/content/docs/lockbox/assets/part-motor-clamp-side.png new file mode 100644 index 0000000..bcd14a5 Binary files /dev/null and b/content/docs/lockbox/assets/part-motor-clamp-side.png differ diff --git a/content/docs/lockbox/assets/part-motor-clamp-side.webp b/content/docs/lockbox/assets/part-motor-clamp-side.webp deleted file mode 100644 index d005511..0000000 Binary files a/content/docs/lockbox/assets/part-motor-clamp-side.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-pcb-cover-main.png b/content/docs/lockbox/assets/part-pcb-cover-main.png new file mode 100644 index 0000000..6214ec0 Binary files /dev/null and b/content/docs/lockbox/assets/part-pcb-cover-main.png differ diff --git a/content/docs/lockbox/assets/part-pcb-cover-main.webp b/content/docs/lockbox/assets/part-pcb-cover-main.webp deleted file mode 100644 index 63b2d05..0000000 Binary files a/content/docs/lockbox/assets/part-pcb-cover-main.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-pcb-cover-side.png b/content/docs/lockbox/assets/part-pcb-cover-side.png new file mode 100644 index 0000000..34878a1 Binary files /dev/null and b/content/docs/lockbox/assets/part-pcb-cover-side.png differ diff --git a/content/docs/lockbox/assets/part-pcb-cover-side.webp b/content/docs/lockbox/assets/part-pcb-cover-side.webp deleted file mode 100644 index c79642d..0000000 Binary files a/content/docs/lockbox/assets/part-pcb-cover-side.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-top-housing-main.png b/content/docs/lockbox/assets/part-top-housing-main.png new file mode 100644 index 0000000..e655481 Binary files /dev/null and b/content/docs/lockbox/assets/part-top-housing-main.png differ diff --git a/content/docs/lockbox/assets/part-top-housing-main.webp b/content/docs/lockbox/assets/part-top-housing-main.webp deleted file mode 100644 index 89878d1..0000000 Binary files a/content/docs/lockbox/assets/part-top-housing-main.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/part-top-housing-side.png b/content/docs/lockbox/assets/part-top-housing-side.png new file mode 100644 index 0000000..3730647 Binary files /dev/null and b/content/docs/lockbox/assets/part-top-housing-side.png differ diff --git a/content/docs/lockbox/assets/part-top-housing-side.webp b/content/docs/lockbox/assets/part-top-housing-side.webp deleted file mode 100644 index f1f5669..0000000 Binary files a/content/docs/lockbox/assets/part-top-housing-side.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-01-magnet-bottom-housing.png b/content/docs/lockbox/assets/step-01-magnet-bottom-housing.png new file mode 100644 index 0000000..aa5f525 Binary files /dev/null and b/content/docs/lockbox/assets/step-01-magnet-bottom-housing.png differ diff --git a/content/docs/lockbox/assets/step-01-magnet-bottom-housing.webp b/content/docs/lockbox/assets/step-01-magnet-bottom-housing.webp deleted file mode 100644 index 484cd22..0000000 Binary files a/content/docs/lockbox/assets/step-01-magnet-bottom-housing.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-01-magnet-locking-latch.png b/content/docs/lockbox/assets/step-01-magnet-locking-latch.png new file mode 100644 index 0000000..3b1dc92 Binary files /dev/null and b/content/docs/lockbox/assets/step-01-magnet-locking-latch.png differ diff --git a/content/docs/lockbox/assets/step-01-magnet-locking-latch.webp b/content/docs/lockbox/assets/step-01-magnet-locking-latch.webp deleted file mode 100644 index 48445f6..0000000 Binary files a/content/docs/lockbox/assets/step-01-magnet-locking-latch.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-01-magnet-top-housing.png b/content/docs/lockbox/assets/step-01-magnet-top-housing.png new file mode 100644 index 0000000..3b575e5 Binary files /dev/null and b/content/docs/lockbox/assets/step-01-magnet-top-housing.png differ diff --git a/content/docs/lockbox/assets/step-01-magnet-top-housing.webp b/content/docs/lockbox/assets/step-01-magnet-top-housing.webp deleted file mode 100644 index fb7eefc..0000000 Binary files a/content/docs/lockbox/assets/step-01-magnet-top-housing.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-02-screen-and-battery.png b/content/docs/lockbox/assets/step-02-screen-and-battery.png new file mode 100644 index 0000000..90f887c Binary files /dev/null and b/content/docs/lockbox/assets/step-02-screen-and-battery.png differ diff --git a/content/docs/lockbox/assets/step-02-screen-and-battery.webp b/content/docs/lockbox/assets/step-02-screen-and-battery.webp deleted file mode 100644 index b5d47da..0000000 Binary files a/content/docs/lockbox/assets/step-02-screen-and-battery.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-03-encoder-on-pcb.png b/content/docs/lockbox/assets/step-03-encoder-on-pcb.png new file mode 100644 index 0000000..055fe86 Binary files /dev/null and b/content/docs/lockbox/assets/step-03-encoder-on-pcb.png differ diff --git a/content/docs/lockbox/assets/step-03-encoder-on-pcb.webp b/content/docs/lockbox/assets/step-03-encoder-on-pcb.webp deleted file mode 100644 index e4aeadf..0000000 Binary files a/content/docs/lockbox/assets/step-03-encoder-on-pcb.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-03-encoder-wheel-installed.png b/content/docs/lockbox/assets/step-03-encoder-wheel-installed.png new file mode 100644 index 0000000..53f18ce Binary files /dev/null and b/content/docs/lockbox/assets/step-03-encoder-wheel-installed.png differ diff --git a/content/docs/lockbox/assets/step-03-encoder-wheel-installed.webp b/content/docs/lockbox/assets/step-03-encoder-wheel-installed.webp deleted file mode 100644 index 3863d31..0000000 Binary files a/content/docs/lockbox/assets/step-03-encoder-wheel-installed.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-04-latch-on-motor.png b/content/docs/lockbox/assets/step-04-latch-on-motor.png new file mode 100644 index 0000000..152d08d Binary files /dev/null and b/content/docs/lockbox/assets/step-04-latch-on-motor.png differ diff --git a/content/docs/lockbox/assets/step-04-latch-on-motor.webp b/content/docs/lockbox/assets/step-04-latch-on-motor.webp deleted file mode 100644 index dfebb24..0000000 Binary files a/content/docs/lockbox/assets/step-04-latch-on-motor.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-04-motor-clamp-installed.png b/content/docs/lockbox/assets/step-04-motor-clamp-installed.png new file mode 100644 index 0000000..9bc8816 Binary files /dev/null and b/content/docs/lockbox/assets/step-04-motor-clamp-installed.png differ diff --git a/content/docs/lockbox/assets/step-04-motor-clamp-installed.webp b/content/docs/lockbox/assets/step-04-motor-clamp-installed.webp deleted file mode 100644 index d651430..0000000 Binary files a/content/docs/lockbox/assets/step-04-motor-clamp-installed.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-04-motor-in-housing.png b/content/docs/lockbox/assets/step-04-motor-in-housing.png new file mode 100644 index 0000000..c180499 Binary files /dev/null and b/content/docs/lockbox/assets/step-04-motor-in-housing.png differ diff --git a/content/docs/lockbox/assets/step-04-motor-in-housing.webp b/content/docs/lockbox/assets/step-04-motor-in-housing.webp deleted file mode 100644 index b7fc73d..0000000 Binary files a/content/docs/lockbox/assets/step-04-motor-in-housing.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-05-buttons-in-housing.png b/content/docs/lockbox/assets/step-05-buttons-in-housing.png new file mode 100644 index 0000000..264a3fa Binary files /dev/null and b/content/docs/lockbox/assets/step-05-buttons-in-housing.png differ diff --git a/content/docs/lockbox/assets/step-05-buttons-in-housing.webp b/content/docs/lockbox/assets/step-05-buttons-in-housing.webp deleted file mode 100644 index f832923..0000000 Binary files a/content/docs/lockbox/assets/step-05-buttons-in-housing.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-05-pcb-placement.png b/content/docs/lockbox/assets/step-05-pcb-placement.png new file mode 100644 index 0000000..a512adb Binary files /dev/null and b/content/docs/lockbox/assets/step-05-pcb-placement.png differ diff --git a/content/docs/lockbox/assets/step-05-pcb-placement.webp b/content/docs/lockbox/assets/step-05-pcb-placement.webp deleted file mode 100644 index 728a16d..0000000 Binary files a/content/docs/lockbox/assets/step-05-pcb-placement.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-05-pcb-seated.png b/content/docs/lockbox/assets/step-05-pcb-seated.png new file mode 100644 index 0000000..1db2453 Binary files /dev/null and b/content/docs/lockbox/assets/step-05-pcb-seated.png differ diff --git a/content/docs/lockbox/assets/step-05-pcb-seated.webp b/content/docs/lockbox/assets/step-05-pcb-seated.webp deleted file mode 100644 index 871d373..0000000 Binary files a/content/docs/lockbox/assets/step-05-pcb-seated.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-06-cables-connected.png b/content/docs/lockbox/assets/step-06-cables-connected.png new file mode 100644 index 0000000..f4f2f14 Binary files /dev/null and b/content/docs/lockbox/assets/step-06-cables-connected.png differ diff --git a/content/docs/lockbox/assets/step-06-cables-connected.webp b/content/docs/lockbox/assets/step-06-cables-connected.webp deleted file mode 100644 index 5c83873..0000000 Binary files a/content/docs/lockbox/assets/step-06-cables-connected.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-07-pcb-cover-installed.png b/content/docs/lockbox/assets/step-07-pcb-cover-installed.png new file mode 100644 index 0000000..9ecbc6d Binary files /dev/null and b/content/docs/lockbox/assets/step-07-pcb-cover-installed.png differ diff --git a/content/docs/lockbox/assets/step-07-pcb-cover-installed.webp b/content/docs/lockbox/assets/step-07-pcb-cover-installed.webp deleted file mode 100644 index edee5c8..0000000 Binary files a/content/docs/lockbox/assets/step-07-pcb-cover-installed.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-07-pcb-cover-placement.png b/content/docs/lockbox/assets/step-07-pcb-cover-placement.png new file mode 100644 index 0000000..9c34c94 Binary files /dev/null and b/content/docs/lockbox/assets/step-07-pcb-cover-placement.png differ diff --git a/content/docs/lockbox/assets/step-07-pcb-cover-placement.webp b/content/docs/lockbox/assets/step-07-pcb-cover-placement.webp deleted file mode 100644 index 0618d4e..0000000 Binary files a/content/docs/lockbox/assets/step-07-pcb-cover-placement.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-08-rubber-feet-closeup.png b/content/docs/lockbox/assets/step-08-rubber-feet-closeup.png new file mode 100644 index 0000000..a049e9d Binary files /dev/null and b/content/docs/lockbox/assets/step-08-rubber-feet-closeup.png differ diff --git a/content/docs/lockbox/assets/step-08-rubber-feet-closeup.webp b/content/docs/lockbox/assets/step-08-rubber-feet-closeup.webp deleted file mode 100644 index 849e377..0000000 Binary files a/content/docs/lockbox/assets/step-08-rubber-feet-closeup.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-08-rubber-feet-installed.png b/content/docs/lockbox/assets/step-08-rubber-feet-installed.png new file mode 100644 index 0000000..f2359af Binary files /dev/null and b/content/docs/lockbox/assets/step-08-rubber-feet-installed.png differ diff --git a/content/docs/lockbox/assets/step-08-rubber-feet-installed.webp b/content/docs/lockbox/assets/step-08-rubber-feet-installed.webp deleted file mode 100644 index 91f25c8..0000000 Binary files a/content/docs/lockbox/assets/step-08-rubber-feet-installed.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-09-backplate-slide.png b/content/docs/lockbox/assets/step-09-backplate-slide.png new file mode 100644 index 0000000..036d1e8 Binary files /dev/null and b/content/docs/lockbox/assets/step-09-backplate-slide.png differ diff --git a/content/docs/lockbox/assets/step-09-backplate-slide.webp b/content/docs/lockbox/assets/step-09-backplate-slide.webp deleted file mode 100644 index 8864d0a..0000000 Binary files a/content/docs/lockbox/assets/step-09-backplate-slide.webp and /dev/null differ diff --git a/content/docs/lockbox/assets/step-09-final-assembly.png b/content/docs/lockbox/assets/step-09-final-assembly.png new file mode 100644 index 0000000..75ced71 Binary files /dev/null and b/content/docs/lockbox/assets/step-09-final-assembly.png differ diff --git a/content/docs/lockbox/assets/step-09-final-assembly.webp b/content/docs/lockbox/assets/step-09-final-assembly.webp deleted file mode 100644 index 0696c84..0000000 Binary files a/content/docs/lockbox/assets/step-09-final-assembly.webp and /dev/null differ diff --git a/content/docs/lockbox/bill-of-materials.de.mdx b/content/docs/lockbox/bill-of-materials.de.mdx deleted file mode 100644 index 68a241d..0000000 --- a/content/docs/lockbox/bill-of-materials.de.mdx +++ /dev/null @@ -1,1418 +0,0 @@ ---- -title: "Stückliste" -description: "Stückliste für Lockbox." ---- - -{/* Ported from MkDocs: bom.md */} - -Die Lockbox verwendet eine individuell gefertigte Leiterplatte mit zusätzlichen externen Komponenten, darunter Display, Batterie, Motor, Encoder, Tasten und Magnete. - -## Teile - -Diese Teileliste wird während der Erstellung der Baugruppendokumente aus [`hardware/bom.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/bom.csv) generiert. Bearbeiten Sie die Tabelle unten nicht manuell. Aktualisieren Sie stattdessen die CSV-Datei. Auf die Teile wird in der gesamten [Montageanleitung](assembly-guide) verwiesen. - -{/* BEGIN GENERATED BOM */} - -
-
-
Repository
-
- -Lockbox-OSS - -
-
Quellen-Commit
-
- -43fffcd -{" "} - - (43fffcdb1f4bee82c7d74d9f610a12e9035b9553) - -
-
-
-Kein getaggtes Release. Diese Stückliste wird aus dem aktuellen{" "} -main gerendert und dient als Vorschau-/Referenzmaterial, nicht als Snapshot eines Produktions-Releases. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- # - - Teilename - - Kategorie - - Beschreibung - - Menge - - UOM - - Hersteller - - MFG PN - - Anbieter - - PN des Anbieters - - Quelle - - Notizen -
1 -
- Oberes Gehäuse -
-		 - -FDM - - -
-FDM-gedrucktes Gehäuseoberteil -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
2 -
- Unteres Gehäuse -
-		 - -FDM - - -
-FDM-gedrucktes Gehäuseunterteil -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
3 -
- Leiterplattenabdeckung -
-		 - -FDM - - -
- FDM-gedruckte Leiterplattenabdeckung -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
- Wird über der bestückten Leiterplatte befestigt. -
-
4 -
- Zurück-Taste -
-		 - -FDM - - -
-FDM-gedruckte Kappe der Zurück-/Pfeiltaste -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
5 -
- Eingabetaste -
-		 - -FDM - - -
-FDM-gedruckte Verriegelungs-/Eingabetastenkappe -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
6 -
- Verriegelungsriegel -
-		 - -FDM - - -
- FDM-gedruckter Verriegelungsriegel -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
- Wird auf der Motorwelle installiert. -
-
7 -
- Encoderrad -
-		 - -FDM - - -
- FDM-gedrucktes Drehgeberrad -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
-Wird auf der Welle des Drehgebers installiert. -
-
8 -
- Motorklemme -
-		 - -FDM - - -
- FDM-gedruckte Motorklemme -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
9 -
- Lockbox PCBA -
-		 - -PCA - - -
- Bestückte Lockbox-Leiterplattenbaugruppe -
-		1each -
- JLCPCB -
-		 -
–
-		 -
- JLCPCB -
-		 -
–
-		 - - -
-PCB-Baugruppenposition auf oberster Ebene; die EBOM der bestückten Komponenten wird in Git am Quellpfad - nachverfolgt. -
-
10 -
- PCB-Knopfschalter -
-		 - -SWI - - -
- Taktiler Schalter für Leiterplattentasten -
-		2each -
- Same Sky -
-		 -
- TS02-66-100-BK-260-SCR-D -
-		 -
- Mouser -
-		 -
- 179-TS0266100BK260SC -
-		 - - - -
11 -
- Drehgeber -
-		 - -SWI - - -
- Drehgeber -
-		1each -
- Bourns -
-		 -
- PEC12R-2120F-N0012 -
-		 -
- Mouser -
-		 -
- 652-PEC12R-2120F-N12 -
-		 - - - -
12 -
- 4 mm Magnet -
-		 - -FBO - - -
-N52 Neodym-Magnet, 4 mm x 5 mm -
-		4each -
- Generic Factory -
-		 -
–
-		 -
- TBD -
-		 -
–
-		 -
–
-		 -
-Im Lieferantenfeld der Quell-Kalkulationstabelle steht „SUCHE NACH NEUEM LIEFERANTEN“. -
-
13 -
- Gummifuß -
-		 - -FBO - - -
-Stoßfängerfuß aus Polyurethan, 0.312 in Durchmesser, transparent -
-		4each -
- 3M -
-		 -
- SJ5302 -
-		 -
- Digi-Key -
-		 -
- SJ5302-7-ND -
-		 - - -
- Auf die Rückplatte geklebt. -
-
14 -
- Motor -
-		 - -MTR - - -
-DC-Mikrogetriebemotor, 12 V, 60 RPM -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 33022320164 -
-		 - - -
-Treibt den Verriegelungsriegel an. Anbieterlink:{" "} - -https://www.aliexpress.com/item/33022320164.html - -
-
15 -
- Motorkabel -
-		 - -CHA - - -
-Motorkabelbaum, 1-mm-Raster-Buchse, 2P, 100 mm, Einzelkopf -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 1005007218127653 -
-		 - - -
- Verbindet den Motor mit der Platine. -
-
16 -
- Batterie -
-		 - -BTY - - -
-3,7 V 500 mAh Lithium-Polymer-Akku mit benutzerdefiniertem 2-Pin-JST und 5 cm langem schwarz/rotem Kabel -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 1005009279419327 -
-		 - - -
-Im oberen Gehäuse eingebaut. Anbieterlink:{" "} - -https://www.aliexpress.com/item/1005009279419327.html - -
-
17 -
- Bildschirm -
-		 - -ASM - - -
-PS 2,0 Zoll 14-poliges SPI-TFT-LCD-Modul -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 1005005865407299 -
-		 - - -
-Im oberen Gehäuse eingebaut. Anbieterlink:{" "} - -https://www.aliexpress.com/item/1005005865407299.html - -
-
18 -
- Torx-Schraube -
-		 - -FST - - -
-#4-20 x 1/2 in, 6-Lobe-Flachkopfschraube, Plastite-Alternative 48-2, Schwarzoxid -
-		7each -
- Shorpioen -
-		 -
- 0408LTFB -
-		 -
- Shorpioen -
-		 -
- BC-0408LTFB -
-		 - - -
-2x für die Motorklemme, 5x für die PCB-Abdeckung; montiert mit einem T7-Torx-Schraubendreher. -
-
19 -
- USB-C-Kabel -
-		 - -CBL - - -
-USB-A-auf-USB-C-Kabel, 4 ft lang, geflochten -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- Amazon -
-		 -
- B0CRYMGXMX -
-		 - - -
–
-
20 -
- Wiederverschließbarer Beutel -
-		 - -PKG - - -
- Wiederverschließbarer Beutel, 6 x 8 in -
-		1each -
- Uline -
-		 -
- S-5065 -
-		 -
- Uline -
-		 -
- S-5065 -
-		 - - -
–
-
-
-
-
- Stückliste erstellt aus{" "}hardware/bom.csv von Research - and Desire mit den BOM-Werkzeugen. -
-
Lizenz: CERN-OHL-S v2 (Hardware) / MPL-2.0 (Firmware).
-
- Quelle:{" "} - -Lockbox-OSS auf GitHub - - . -
-
© Research and Desire.
-
-
-{/* END GENERATED BOM */} - -## Montagewerkzeuge und Werkstattbedarf - -| Artikel | Verwenden Sie | -| ----------------------- | ------------------------------------------------------------------------------ | -| T7-Torx-Schraubendreher | Montage von `torx-screw`-Befestigungselementen | -| `flat-jaw-pliers` | Einpressen von Magneten in Kunststoffeinsätze | -| `tweezers` | Umgang mit Flachbandkabeln und Kleinteilen | -| `paperclip` | Auftragen einer dünnen Schicht `SA-glue` auf die Innenseite der Magneteinsätze | -| `isopropyl-alcohol` | Reinigen der Rückseite des Bildschirms und des Akkus vor dem Anbringen des Klebebands. | -| `microfibre-cloth` | Schutz der Vorderseite und gedruckter Teile bei der Montage | diff --git a/content/docs/lockbox/bill-of-materials.fr.mdx b/content/docs/lockbox/bill-of-materials.fr.mdx deleted file mode 100644 index 67bd95e..0000000 --- a/content/docs/lockbox/bill-of-materials.fr.mdx +++ /dev/null @@ -1,1418 +0,0 @@ ---- -title: "Nomenclature" -description: "Nomenclature pour Lockbox." ---- - -{/* Ported from MkDocs: bom.md */} - -Le Lockbox utilise un PCB personnalisé avec des composants externes supplémentaires, notamment un écran, une batterie, un moteur, un encodeur, des boutons et des aimants. - -## Pièces - -Cette liste de pièces est générée à partir de [`hardware/bom.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/bom.csv) lors de la construction de la documentation d'assemblage — ne modifiez pas le tableau ci-dessous à la main. Mettez plutôt à jour le CSV. Les pièces sont référencées tout au long du [Guide d'assemblage](assembly-guide). - -{/* BEGIN GENERATED BOM */} - -
-
-
Dépôt
-
- -Lockbox-OSS - -
-
Commit source
-
- -43fffcd -{" "} - - (43fffcdb1f4bee82c7d74d9f610a12e9035b9553) - -
-
-
-Aucune release taguée. Cette nomenclature est rendue à partir de la branche{" "} -main actuelle et constitue un support de prévisualisation/référence, pas un instantané d’une release de production. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- # - - Nom de la pièce - - Catégorie - - Descriptif - - Quantité - - UdM - - Fabricant - - réf. du fabricant - - Fournisseur - - Référence fournisseur - - Source - - Remarques -
1 -
- Boîtier supérieur -
-		 - -FDM - - -
-Boîtier supérieur imprimé FDM -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
2 -
- Boîtier inférieur -
-		 - -FDM - - -
-Boîtier inférieur imprimé FDM -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
3 -
- Couvercle du circuit imprimé -
-		 - -FDM - - -
- Couvercle de PCB imprimé en FDM -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
- Se fixe sur le PCB équipé. -
-
4 -
- Bouton Retour -
-		 - -FDM - - -
-Capuchon du bouton Retour/flèche imprimé FDM -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
5 -
- Bouton Entrée -
-		 - -FDM - - -
-Capuchon du bouton de verrouillage/entrée imprimé FDM -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
6 -
- Loquet de verrouillage -
-		 - -FDM - - -
- Loquet de verrouillage imprimé FDM -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
- S'installe sur l'arbre du moteur. -
-
7 -
- Roue codeuse -
-		 - -FDM - - -
- Roue d'encodeur rotative imprimée FDM -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
-S'installe sur l'arbre de l'encodeur rotatif. -
-
8 -
- Bride de moteur -
-		 - -FDM - - -
- Bride de moteur imprimée en FDM -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
9 -
- Lockbox PCBA -
-		 - - PCA - - -
- Assemblage du PCB Lockbox équipé -
-		1each -
- JLCPCB -
-		 -
–
-		 -
- JLCPCB -
-		 -
–
-		 - - -
-Élément de nomenclature d’assemblage du PCB de niveau supérieur ; l’EBOM des composants montés est suivie dans Git sur le chemin source. -
-
10 -
- Interrupteur tactile pour bouton du PCB -
-		 - -SWI - - -
- Interrupteur tactile pour boutons PCB -
-		2each -
- Same Sky -
-		 -
- TS02-66-100-BK-260-SCR-D -
-		 -
- Mouser -
-		 -
- 179-TS0266100BK260SC -
-		 - - - -
11 -
- Encodeur rotatif -
-		 - -SWI - - -
- Encodeur rotatif -
-		1each -
- Bourns -
-		 -
- PEC12R-2120F-N0012 -
-		 -
- Mouser -
-		 -
- 652-PEC12R-2120F-N12 -
-		 - - - -
12 -
- Aimant de 4 mm -
-		 - -FBO - - -
-Aimant néodyme N52, 4 mm x 5 mm -
-		4each -
- Generic Factory -
-		 -
–
-		 -
- TBD -
-		 -
–
-		 -
–
-		 -
-Le champ Fournisseur de la feuille de calcul des coûts source indique « À LA RECHERCHE D’UN NOUVEAU FOURNISSEUR ». -
-
13 -
- Pied en caoutchouc -
-		 - -FBO - - -
- Butée adhésive transparente en polyuréthane de 0.312 in de diamètre -
-		4each -
- 3M -
-		 -
- SJ5302 -
-		 -
- Digi-Key -
-		 -
- SJ5302-7-ND -
-		 - - -
- Collé sur la plaque arrière. -
-
14 -
- Moteur -
-		 - -MTR - - -
-Micromoteur à engrenages CC, 12 V, 60 tr/min -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 33022320164 -
-		 - - -
-Entraîne le loquet de verrouillage. Lien du fournisseur :{" "} - -https://www.aliexpress.com/item/33022320164.html - -
-
15 -
- Fil moteur -
-		 - -CHA - - -
-Faisceau de câbles moteur, connecteur femelle au pas de 1 mm, 2P, 100 mm, - tête unique -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 1005007218127653 -
-		 - - -
- Connecte le moteur au PCB. -
-
16 -
- Batterie -
-		 - -BTY - - -
-Batterie lithium-polymère 3.7 V 500 mAh avec un JST personnalisé à 2 broches et un câble noir/rouge de 5 cm -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 1005009279419327 -
-		 - - -
-Installée dans le boîtier supérieur. Lien du fournisseur :{" "} - -https://www.aliexpress.com/item/1005009279419327.html - -
-
17 -
- Écran -
-		 - -ASM - - -
- Module LCD TFT SPI à 14 broches, PS 2.0 inch -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 1005005865407299 -
-		 - - -
-Installé dans le boîtier supérieur. Lien du fournisseur :{" "} - -https://www.aliexpress.com/item/1005005865407299.html - -
-
18 -
- Vis Torx -
-		 - - FST - - -
-#4-20 x 1/2 in, vis à tête plate Plastite alternative 48-2 à 6 lobes, finition oxyde noir -
-		7each -
- Shorpioen -
-		 -
- 0408LTFB -
-		 -
- Shorpioen -
-		 -
- BC-0408LTFB -
-		 - - -
-2x pour la bride de moteur, 5x pour le couvercle du PCB ; monté avec un tournevis Torx T7. -
-
19 -
- Câble USB-C -
-		 - -CBL - - -
-Câble USB-A vers USB-C, 4 ft tressé -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- Amazon -
-		 -
- B0CRYMGXMX -
-		 - - -
–
-
20 -
- Sac refermable -
-		 - -PKG - - -
- Sac refermable de 6 x 8 in -
-		1each -
- Uline -
-		 -
- S-5065 -
-		 -
- Uline -
-		 -
- S-5065 -
-		 - - -
–
-
-
-
-
- Nomenclature générée à partir de{" "}hardware/bom.csv par Research - and Desire avec les outils de nomenclature. -
-
Licence : CERN-OHL-S v2 (matériel) / MPL-2.0 (firmware).
-
- Source :{" "} - -Lockbox-OSS sur GitHub - - . -
-
© Research and Desire.
-
-
-{/* END GENERATED BOM */} - -## Outils d'assemblage et fournitures d'atelier - -| Article | Utiliser | -| ------------------- | ---------------------------------------------------------------------------------- | -| Tournevis Torx T7 | Installation des fixations `torx-screw` | -| `flat-jaw-pliers` | Enfoncer des aimants dans des inserts en plastique | -| `tweezers` | Manipulation de câbles plats et de petites pièces | -| `paperclip` | Application d'une légère couche de `SA-glue` à l'intérieur des inserts magnétiques | -| `isopropyl-alcohol` | Nettoyage de l’arrière de l’écran et de la batterie avant d’appliquer le ruban adhésif | -| `microfibre-cloth` | Protection de la face avant et des pièces imprimées lors du montage | diff --git a/content/docs/lockbox/bill-of-materials.mdx b/content/docs/lockbox/bill-of-materials.mdx deleted file mode 100644 index f2e3255..0000000 --- a/content/docs/lockbox/bill-of-materials.mdx +++ /dev/null @@ -1,1425 +0,0 @@ ---- -title: "Bill of Materials" -description: "Bill of Materials for Lockbox." ---- - -{/* Ported from MkDocs: bom.md */} - -The Lockbox uses a custom printed PCB with additional off-board components including a display, battery, motor, encoder, buttons, and magnets. - -## Parts - -This parts list is generated from [`hardware/bom.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/bom.csv) during the assembly-docs build — do not edit the table below by hand. Update the CSV instead. Parts are referenced throughout the [Assembly Guide](assembly-guide). - -{/* BEGIN GENERATED BOM */} - -
-
-
Repository
-
- - Lockbox-OSS - -
-
Source commit
-
- - 43fffcd - {" "} - - (43fffcdb1f4bee82c7d74d9f610a12e9035b9553) - -
-
-
- Not a tagged release. This BOM is rendered from the current{" "} - main and is preview / reference material, not a production - release snapshot. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- {"#"} - - Part Name - - Category - - Description - - Qty - - UOM - - Manufacturer - - MFG PN - - Vendor - - Vendor PN - - Source - - Notes -
1 -
- Top housing -
- 		- - FDM - - -
- FDM-printed top enclosure housing -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
2 -
- Bottom housing -
- 		- - FDM - - -
- FDM-printed bottom enclosure housing -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
3 -
- PCB cover -
- 		- - FDM - - -
- FDM-printed PCB cover -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
- Secures over the populated PCB. -
-
4 -
- Back button -
- 		- - FDM - - -
- FDM-printed back/arrow button cap -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
5 -
- Enter button -
- 		- - FDM - - -
- FDM-printed lock/enter button cap -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
6 -
- Locking latch -
- 		- - FDM - - -
- FDM-printed locking latch -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
- Installs onto motor shaft. -
-
7 -
- Encoder wheel -
- 		- - FDM - - -
- FDM-printed rotary encoder wheel -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
- Installs onto rotary encoder shaft. -
-
8 -
- Motor clamp -
- 		- - FDM - - -
- FDM-printed motor clamp -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
9 -
- Lockbox PCBA -
- 		- - PCA - - -
- Populated Lockbox PCB assembly -
- 		1each -
- JLCPCB -
- 		-
–
- 		-
- JLCPCB -
- 		-
–
- 		- - -
- Top-level PCB assembly line item; populated component EBOM is - tracked in git at source path. -
-
10 -
- PCB button switch -
- 		- - SWI - - -
- Tactile switch for PCB buttons -
- 		2each -
- Same Sky -
- 		-
- TS02-66-100-BK-260-SCR-D -
- 		-
- Mouser -
- 		-
- 179-TS0266100BK260SC -
- 		- - - -
11 -
- Rotary encoder -
- 		- - SWI - - -
- Rotary encoder -
- 		1each -
- Bourns -
- 		-
- PEC12R-2120F-N0012 -
- 		-
- Mouser -
- 		-
- 652-PEC12R-2120F-N12 -
- 		- - - -
12 -
- 4 mm magnet -
- 		- - FBO - - -
- N52 neodymium magnet, 4 mm x 5 mm -
- 		4each -
- Generic Factory -
- 		-
–
- 		-
- TBD -
- 		-
–
- 		-
–
- 		-
- One in locking-latch, one in top-housing, and two in - bottom-housing. Source costing sheet marks supplier as LOOKING FOR - NEW SUPPLIER. -
-
13 -
- Rubber foot -
- 		- - FBO - - -
- Polyurethane bumper foot, 0.312 in diameter, clear -
- 		4each -
- 3M -
- 		-
- SJ5302 -
- 		-
- Digi-Key -
- 		-
- SJ5302-7-ND -
- 		- - -
- Glued onto backplate. -
-
14 -
- Motor -
- 		- - MTR - - -
- DC micro gear motor, 12 V, 60 RPM -
- 		1each -
- Generic Factory -
- 		-
–
- 		-
- AliExpress -
- 		-
- 33022320164 -
- 		- - -
- Drives locking latch. Vendor link:{" "} - - https://www.aliexpress.com/item/33022320164.html - -
-
15 -
- Motor wire -
- 		- - CHA - - -
- Motor wire harness, 1 mm pitch female connector, 2P, 100 mm, - single head -
- 		1each -
- Generic Factory -
- 		-
–
- 		-
- AliExpress -
- 		-
- 1005007218127653 -
- 		- - -
- Connects motor to PCB. -
-
16 -
- Battery -
- 		- - BTY - - -
- 3.7 V 500 mAh lithium polymer battery with custom 2-pin JST and 5 - cm black/red cable -
- 		1each -
- Generic Factory -
- 		-
–
- 		-
- AliExpress -
- 		-
- 1005009279419327 -
- 		- - -
- Installed into top-housing. Vendor link:{" "} - - https://www.aliexpress.com/item/1005009279419327.html - -
-
17 -
- Screen -
- 		- - ASM - - -
- PS 2.0 inch 14-pin SPI TFT LCD module -
- 		1each -
- Generic Factory -
- 		-
–
- 		-
- AliExpress -
- 		-
- 1005005865407299 -
- 		- - -
- Installed into top-housing. Vendor link:{" "} - - https://www.aliexpress.com/item/1005005865407299.html - -
-
18 -
- Torx screw -
- 		- - FST - - -
- #4-20 x 1/2 in 6-lobe flat Plastite alternative 48-2 screw, black - oxide -
- 		7each -
- Shorpioen -
- 		-
- 0408LTFB -
- 		-
- Shorpioen -
- 		-
- BC-0408LTFB -
- 		- - -
- 2x for motor-clamp, 5x for pcb-cover; installed with T7 Torx - driver. -
-
19 -
- USB-C cable -
- 		- - CBL - - -
- USB-A to USB-C cable, 4 ft braided -
- 		1each -
- Generic Factory -
- 		-
–
- 		-
- Amazon -
- 		-
- B0CRYMGXMX -
- 		- - -
–
-
20 -
- Resealable bag -
- 		- - PKG - - -
- 6 x 8 in resealable bag -
- 		1each -
- Uline -
- 		-
- S-5065 -
- 		-
- Uline -
- 		-
- S-5065 -
- 		- - -
–
-
-
-
-
- Bill of Materials generated from hardware/bom.csv by Research - and Desire BOM tooling. -
-
License: CERN-OHL-S v2 (hardware) / MPL-2.0 (firmware).
-
- Source:{" "} - - Lockbox-OSS on GitHub - - . -
-
© Research and Desire.
-
-
-{/* END GENERATED BOM */} - -## Assembly tools and shop supplies - -| Item | Use | -| ------------------- | ----------------------------------------------------------- | -| T7 Torx driver | Installing `torx-screw` fasteners | -| `flat-jaw-pliers` | Pressing magnets into plastic inserts | -| `tweezers` | Handling ribbon cable and small parts | -| `paperclip` | Applying a light coat of `SA-glue` inside magnet inserts | -| `isopropyl-alcohol` | Cleaning the rear of the screen and battery before tape | -| `microfibre-cloth` | Protecting the front face and printed parts during assembly | diff --git a/content/docs/lockbox/bill-of-materials.nl.mdx b/content/docs/lockbox/bill-of-materials.nl.mdx deleted file mode 100644 index b5b3ffc..0000000 --- a/content/docs/lockbox/bill-of-materials.nl.mdx +++ /dev/null @@ -1,1419 +0,0 @@ ---- -title: "Stuklijst" -description: "Stuklijst voor Lockbox." ---- - -{/* Ported from MkDocs: bom.md */} - -De Lockbox maakt gebruik van een op maat gemaakte printplaat met extra externe componenten, waaronder een display, batterij, motor, encoder, knoppen en magneten. - -## Onderdelen - -Deze onderdelenlijst wordt gegenereerd op basis van [`hardware/bom.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/bom.csv) tijdens het bouwen van de assemblagedocumenten. Bewerk de onderstaande tabel niet met de hand. Update in plaats daarvan het CSV-bestand. Er wordt overal in de [Montagehandleiding](assembly-guide) naar onderdelen verwezen. - -{/* BEGIN GENERATED BOM */} - -
-
-
Repository
-
- -Lockbox-OSS - -
-
Broncommit
-
- -43fffcd -{" "} - - (43fffcdb1f4bee82c7d74d9f610a12e9035b9553) - -
-
-
-Geen getagde release. Deze stuklijst wordt gegenereerd vanuit de huidige{" "} -main-branch en dient als preview-/referentiemateriaal, niet als momentopname van een productierelease. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- # - - Onderdeelnaam - - Categorie - - Beschrijving - - Aantal - - Eenheid - - Fabrikant - - MFG-PN - - Leverancier - - Leveranciersartikelnummer - - Bron - - Opmerkingen -
1 -
- Bovenste behuizing -
-		 - -FDM - - -
-FDM-geprinte bovenbehuizing -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
2 -
- Onderste behuizing -
-		 - -FDM - - -
-FDM-geprinte onderbehuizing -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
3 -
- PCB-afdekking -
-		 - -FDM - - -
- FDM-gedrukte PCB-afdekking -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
- Wordt over de bestukte PCB bevestigd. -
-
4 -
- Terugknop -
-		 - -FDM - - -
-FDM-geprinte kap voor de terug-/pijlknop -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
5 -
- Enter-knop -
-		 - -FDM - - -
-FDM-gedrukte kap voor vergrendelings-/enterknop -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
6 -
- Vergrendeling -
-		 - -FDM - - -
- FDM-gedrukte vergrendeling -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
- Wordt op de motoras geïnstalleerd. -
-
7 -
- Encoderwiel -
-		 - -FDM - - -
- FDM-gedrukt roterend encoderwiel -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
-Wordt geïnstalleerd op de roterende encoderas. -
-
8 -
- Motorklem -
-		 - -FDM - - -
- FDM-geprinte motorklem -
-		1each -
–
-		 -
–
-		 -
–
-		 -
–
-		 - - -
–
-
9 -
- Lockbox PCBA -
-		 - -PCA - - -
- Bestukte Lockbox-PCB-assemblage -
-		1each -
- JLCPCB -
-		 -
–
-		 -
- JLCPCB -
-		 -
–
-		 - - -
-PCB-assemblagepost op het hoogste niveau; de EBOM van de bestukte componenten wordt in Git op het bronpad bijgehouden. -
-
10 -
- PCB-knopschakelaar -
-		 - - SWI - - -
- Tactiele schakelaar voor PCB-knoppen -
-		2each -
- Same Sky -
-		 -
- TS02-66-100-BK-260-SCR-D -
-		 -
- Mouser -
-		 -
- 179-TS0266100BK260SC -
-		 - - - -
11 -
- Roterende encoder -
-		 - - SWI - - -
- Roterende encoder -
-		1each -
- Bourns -
-		 -
- PEC12R-2120F-N0012 -
-		 -
- Mouser -
-		 -
- 652-PEC12R-2120F-N12 -
-		 - - - -
12 -
- 4 mm magneet -
-		 - -FBO - - -
-N52 neodymiummagneet, 4 mm x 5 mm -
-		4each -
- Generic Factory -
-		 -
–
-		 -
- TBD -
-		 -
–
-		 -
–
-		 -
-In het leveranciersveld van het bronkostenblad staat OP ZOEK NAAR EEN NIEUWE LEVERANCIER. -
-
13 -
- Rubberen voet -
-		 - -FBO - - -
-Transparant polyurethaan stootvoetje met een diameter van 0.312 in -
-		4each -
- 3M -
-		 -
- SJ5302 -
-		 -
- Digi-Key -
-		 -
- SJ5302-7-ND -
-		 - - -
- Gelijmd op achterplaat. -
-
14 -
- Motor -
-		 - -MTR - - -
-DC-micro-reductiemotor, 12 V, 60 RPM -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 33022320164 -
-		 - - -
-Drijft de vergrendelingsgrendel aan. Leverancierslink:{" "} - -https://www.aliexpress.com/item/33022320164.html - -
-
15 -
- Motordraad -
-		 - -CHA - - -
-Motorkabelboom, vrouwelijke connector met steek van 1 mm, 2P, 100 mm, - enkele kop -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 1005007218127653 -
-		 - - -
- Verbindt de motor met de printplaat. -
-
16 -
- Batterij -
-		 - -BTY - - -
-3,7 V 500 mAh lithium-polymeerbatterij met aangepaste 2-pins JST en 5 - cm zwart/rode kabel -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 1005009279419327 -
-		 - - -
-Geïnstalleerd in de bovenste behuizing. Leverancierslink:{" "} - -https://www.aliexpress.com/item/1005009279419327.html - -
-
17 -
- Scherm -
-		 - -ASM - - -
-2,0-inch PS SPI-TFT-LCD-module met 14 pinnen -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- AliExpress -
-		 -
- 1005005865407299 -
-		 - - -
-Geïnstalleerd in de bovenste behuizing. Leverancierslink:{" "} - -https://www.aliexpress.com/item/1005005865407299.html - -
-
18 -
- Torx-schroef -
-		 - -FST - - -
-#4-20 x 1/2 in, 6-lobbige platkopschroef, Plastite-alternatief 48-2, zwart geoxideerd -
-		7each -
- Shorpioen -
-		 -
- 0408LTFB -
-		 -
- Shorpioen -
-		 -
- BC-0408LTFB -
-		 - - -
-2x voor de motorklem, 5x voor de PCB-afdekking; gemonteerd met een T7-Torx-schroevendraaier. -
-
19 -
- USB-C-kabel -
-		 - -CBL - - -
-gevlochten USB-A-naar-USB-C-kabel van 4 ft -
-		1each -
- Generic Factory -
-		 -
–
-		 -
- Amazon -
-		 -
- B0CRYMGXMX -
-		 - - -
–
-
20 -
- Hersluitbare zak -
-		 - -PKG - - -
- Hersluitbare zak van 6 x 8 in -
-		1each -
- Uline -
-		 -
- S-5065 -
-		 -
- Uline -
-		 -
- S-5065 -
-		 - - -
–
-
-
-
-
- Stuklijst gegenereerd uit{" "}hardware/bom.csv door Research - and Desire met BOM-tools. -
-
Licentie: CERN-OHL-S v2 (hardware) / MPL-2.0 (firmware).
-
- Bron:{" "} - -Lockbox-OSS op GitHub - - . -
-
© Research and Desire.
-
-
-{/* END GENERATED BOM */} - -## Montagegereedschap en werkplaatsbenodigdheden - -| Artikel | Gebruik | -| ---------------------- | ------------------------------------------------------------------- | -| T7-Torx-schroevendraaier | `torx-screw`-bevestigingsmiddelen installeren | -| `flat-jaw-pliers` | Magneten in kunststof inzetstukken drukken | -| `tweezers` | Hanteren van lintkabels en kleine onderdelen | -| `paperclip` | Een dunne laag `SA-glue` aanbrengen in de magneetinzetstukken | -| `isopropyl-alcohol` | De achterkant van het scherm en de batterij reinigen voordat u tape aanbrengt | -| `microfibre-cloth` | Bescherming van de voorkant en geprinte onderdelen tijdens montage | diff --git a/content/docs/lockbox/bom.en.mdx b/content/docs/lockbox/bom.en.mdx new file mode 100644 index 0000000..35c5b23 --- /dev/null +++ b/content/docs/lockbox/bom.en.mdx @@ -0,0 +1,25 @@ +--- +title: Bill of Materials +showToc: false +--- + +The Lockbox uses a custom printed PCB with additional off-board components including a display, battery, motor, encoder, buttons, and magnets. + +## Parts + +This parts list is generated from [`hardware/bom.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/bom.csv) during the assembly-docs build — do not edit the table below by hand. Update the CSV instead. Parts are referenced throughout the [Assembly Guide](/lockbox/assembly-guide). + +import bom from "./_bom/bom.json"; + + + +## Assembly tools and shop supplies + +| Item | Use | +| ---- | --- | +| T7 Torx driver | Installing `torx-screw` fasteners | +| `flat-jaw-pliers` | Pressing magnets into plastic inserts | +| `tweezers` | Handling ribbon cable and small parts | +| `paperclip` | Applying a light coat of `SA-glue` inside magnet inserts | +| `isopropyl-alcohol` | Cleaning the rear of the screen and battery before tape | +| `microfibre-cloth` | Protecting the front face and printed parts during assembly | diff --git a/content/docs/lockbox/cable-harnesses.de.mdx b/content/docs/lockbox/cable-harnesses.de.mdx deleted file mode 100644 index a5d7c42..0000000 --- a/content/docs/lockbox/cable-harnesses.de.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Kabelbäume" -description: "Kabelbäume für Lockbox." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -Lockbox umfasst Motor-, Batterie-, USB-C-, Bildschirm- und weitere kleine Kabelverbindungen -im Montageablauf. Die [Stückliste](bill-of-materials) auf Produktebene führt diese als -Positionen auf Geräteebene. - -Bisher wurde keine Wireviz-Kabelbaumquelle nach `hardware/cables/` migriert. Wenn eine -Wireviz-Quelle hinzugefügt wird, verknüpfen Sie von dieser Seite aus das generierte Diagramm und die -Artefakte der untergeordneten Stückliste, statt Zeilen aus untergeordneten Kabelstücklisten in `hardware/bom.csv` zu duplizieren. - -| Asset | Speicherort | Hinweise | -| --------------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | -| Ordner für Kabelquellen | [`hardware/cables/`](https://github.com/researchanddesire/Lockbox-OSS/tree/main/hardware/cables) | Wireviz-YAML-Quellen gehören hierher. | -| Stückliste auf Produktebene | [`hardware/bom.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/bom.csv) | Listet Kabelbaugruppen und handelsübliche Kabelartikel auf. | diff --git a/content/docs/lockbox/cable-harnesses.en.mdx b/content/docs/lockbox/cable-harnesses.en.mdx new file mode 100644 index 0000000..518187d --- /dev/null +++ b/content/docs/lockbox/cable-harnesses.en.mdx @@ -0,0 +1,16 @@ +--- +title: Cable Harnesses +--- + +Lockbox includes motor, battery, USB-C, screen, and other small cable +connections in the assembly flow. The product-level [Bill of Materials](/lockbox/bom) +tracks these as device-level line items. + +No Wireviz harness source has been migrated to `hardware/cables/` yet. When a +Wireviz source is added, link its generated diagram and child BOM artifacts +from this page instead of duplicating child cable BOM rows in `hardware/bom.csv`. + +| Asset | Location | Notes | +| --- | --- | --- | +| Cable source folder | [`hardware/cables/`](https://github.com/researchanddesire/Lockbox-OSS/tree/main/hardware/cables/) | Wireviz YAML sources belong here. | +| Product-level BOM | [`hardware/bom.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/bom.csv) | Lists cable assemblies and off-the-shelf cable items. | diff --git a/content/docs/lockbox/cable-harnesses.fr.mdx b/content/docs/lockbox/cable-harnesses.fr.mdx deleted file mode 100644 index fa6975b..0000000 --- a/content/docs/lockbox/cable-harnesses.fr.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Faisceaux de câbles" -description: "Faisceaux de câbles pour Lockbox." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -Lockbox intègre les connexions câblées du moteur, de la batterie, de l’USB-C, de l’écran et -d’autres petits câbles dans le flux d’assemblage. La [nomenclature](bill-of-materials) au niveau -du produit les répertorie comme postes au niveau de l’appareil. - -Aucune source de faisceau Wireviz n’a encore été migrée vers `hardware/cables/`. Lorsqu’une -source Wireviz est ajoutée, créez depuis cette page des liens vers son diagramme généré et les artefacts de sa nomenclature enfant, -au lieu de dupliquer dans `hardware/bom.csv` les lignes de cette nomenclature enfant. - -| Élément | Emplacement | Remarques | -| --------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -| Dossier des sources de câbles | [`hardware/cables/`](https://github.com/researchanddesire/Lockbox-OSS/tree/main/hardware/cables) | Les sources Wireviz-YAML se trouvent ici. | -| Nomenclature au niveau du produit | [`hardware/bom.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/bom.csv) | Répertorie les assemblages de câbles et les câbles disponibles dans le commerce. | diff --git a/content/docs/lockbox/cable-harnesses.mdx b/content/docs/lockbox/cable-harnesses.mdx deleted file mode 100644 index 051a899..0000000 --- a/content/docs/lockbox/cable-harnesses.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Cable Harnesses" -description: "Cable Harnesses for Lockbox." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -Lockbox includes motor, battery, USB-C, screen, and other small cable -connections in the assembly flow. The product-level [Bill of Materials](bill-of-materials) -tracks these as device-level line items. - -No Wireviz harness source has been migrated to `hardware/cables/` yet. When a -Wireviz source is added, link its generated diagram and child BOM artifacts -from this page instead of duplicating child cable BOM rows in `hardware/bom.csv`. - -| Asset | Location | Notes | -| ------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | -| Cable source folder | [`hardware/cables/`](https://github.com/researchanddesire/Lockbox-OSS/tree/main/hardware/cables) | Wireviz YAML sources belong here. | -| Product-level BOM | [`hardware/bom.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/bom.csv) | Lists cable assemblies and off-the-shelf cable items. | diff --git a/content/docs/lockbox/cable-harnesses.nl.mdx b/content/docs/lockbox/cable-harnesses.nl.mdx deleted file mode 100644 index 5a1d082..0000000 --- a/content/docs/lockbox/cable-harnesses.nl.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Kabelbomen" -description: "Kabelbomen voor Lockbox." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -Lockbox bevat motor-, batterij-, USB-C-, scherm- en andere kleine kabelverbindingen -in het assemblageproces. De [stuklijst](bill-of-materials) op productniveau houdt deze bij als posten op -apparaatniveau. - -Er is nog geen Wireviz-bron voor kabelbomen gemigreerd naar `hardware/cables/`. Wanneer een -Wireviz-bron wordt toegevoegd, verwijs dan vanaf deze pagina naar het gegenereerde diagram en de -onderliggende BOM-artefacten, in plaats van rijen uit onderliggende kabel-BOM's naar `hardware/bom.csv` te kopiëren. - -| Asset | Locatie | Opmerkingen | -| -------------------------- | ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | -| Map met kabelbronnen | [`hardware/cables/`](https://github.com/researchanddesire/Lockbox-OSS/tree/main/hardware/cables) | Wireviz-YAML-bronnen horen hier thuis. | -| Stuklijst op productniveau | [`hardware/bom.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/bom.csv) | Geeft een overzicht van kabelassemblages en kant-en-klare kabelitems. | diff --git a/content/docs/lockbox/index.de.mdx b/content/docs/lockbox/index.de.mdx deleted file mode 100644 index 3858c2b..0000000 --- a/content/docs/lockbox/index.de.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Montagedokumentation für Lockbox" -description: "Montagedokumentation für Lockbox." ---- - -{/* Ported from MkDocs: index.md */} - -## Zweck - -Diese Dokumentation bündelt die Informationen zur Montage der Lockbox-Hardware für OSS-Erbauer -und Fertigungspartner. - -## Lockbox-Übersicht - -Lockbox ist ein kompaktes Produkt der Unterhaltungselektronik auf Basis einer kundenspezifischen Leiterplatte, der ESP32-S3-Firmware, eines motorisierten Riegels, magnetischer Sensoren, eines TFT-Displays, eines Drehgebers, einer Batterie und eines 3D-gedruckten Kunststoffgehäuses. - -![Übersicht über das Lockbox-Gerät](assets/device-overview.webp) - -| Eigenschaft | Wert | -| ------------------------ | -------------------------------------------- | -| Abmessungen | 57 mm x 43 mm x 134 mm | -| Kunststoffvolumen | 156,408.422 mm^3 | -| Aktuelles Gehäusematerial | 3D-gedruckter PLA-Kunststoff | -| Eingebettete Magnete | Drei bis vier Magnete im Kunststoffgehäuse | - -## Montageunterlagen - - - - Befolgen Sie den mechanischen Aufbau, die Elektronikverkabelung und die abschließende Qualitätskontrolle. - - - Prüfen Sie Teile, Lieferanten und Referenzen zu den Hardwarequellen. - - - Hier finden Sie Hinweise zur Zuständigkeit für Kabel und Kabelbäume beim Aufbau. - - - Prüfen Sie die Steuerplatine, die KiCanvas-Vorschau und die Produktionsdateien. - - diff --git a/content/docs/lockbox/index.en.mdx b/content/docs/lockbox/index.en.mdx new file mode 100644 index 0000000..4536ac4 --- /dev/null +++ b/content/docs/lockbox/index.en.mdx @@ -0,0 +1,27 @@ +--- +title: Lockbox Assembly Docs +license: CERN-OHL-S v2 (hardware) / MPL-2.0 (firmware) +--- + +## Purpose + +These docs collect the Lockbox hardware assembly information in a self-contained folder for future aggregation into `ohai.researchanddesire.com`. They are written as open hardware assembly instructions for OSS builders and manufacturing collaborators. + +## Lockbox overview + +Lockbox is a small-scale consumer electronics product built around a custom PCB, ESP32-S3 firmware, a motorized latch, magnetic sensors, TFT display, rotary encoder, battery, and 3D-printed plastic housing. + +![Lockbox device overview](assets/device-overview.png) + +| Property | Value | +| -------- | ----- | +| Dimensions | 57 mm x 43 mm x 134 mm | +| Plastic volume | 156,408.422 mm^3 | +| Current housing material | 3D-printed PLA plastic | +| Embedded magnets | Three to four magnets in the plastic housing | + +## Assembly package + +- [PCB Overview](/lockbox/pcb-overview) +- [Bill of Materials](/lockbox/bom) +- [Assembly Guide](/lockbox/assembly-guide) diff --git a/content/docs/lockbox/index.fr.mdx b/content/docs/lockbox/index.fr.mdx deleted file mode 100644 index 1672c26..0000000 --- a/content/docs/lockbox/index.fr.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Documentation d’assemblage de Lockbox" -description: "Documentation d’assemblage pour Lockbox." ---- - -{/* Ported from MkDocs: index.md */} - -## But - -Cette documentation rassemble les informations d’assemblage du matériel Lockbox pour les constructeurs OSS -et les partenaires de fabrication. - -## Présentation de Lockbox - -Lockbox est un produit électronique grand public de petite taille, construit autour d’un PCB personnalisé, du micrologiciel ESP32-S3, d’un loquet motorisé, de capteurs magnétiques, d’un écran TFT, d’un encodeur rotatif, d’une batterie et d’un boîtier en plastique imprimé en 3D. - -![Présentation du dispositif Lockbox](assets/device-overview.webp) - -| Propriété | Valeur | -| -------------------------- | --------------------------------------------- | -| Dimensions | 57 mm x 43 mm x 134 mm | -| Volume de plastique | 156,408.422 mm^3 | -| Matériau actuel du boîtier | Plastique PLA imprimé en 3D | -| Aimants intégrés | Trois à quatre aimants dans le boîtier en plastique | - -## Dossier d’assemblage - - - - Suivez l’assemblage mécanique, le câblage électronique et la séquence finale de contrôle qualité. - - - Consultez les pièces, les fournisseurs et les références des sources du matériel. - - - Consultez les informations sur la responsabilité des câbles et des faisceaux dans l’assemblage. - - - Examinez la carte de commande, l’aperçu KiCanvas et les fichiers de production. - - diff --git a/content/docs/lockbox/index.mdx b/content/docs/lockbox/index.mdx deleted file mode 100644 index 7c615f5..0000000 --- a/content/docs/lockbox/index.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Lockbox Assembly Docs" -description: "Lockbox Assembly Docs for Lockbox." ---- - -{/* Ported from MkDocs: index.md */} - -## Purpose - -These docs collect the Lockbox hardware assembly information for OSS builders -and manufacturing collaborators. - -## Lockbox overview - -Lockbox is a small-scale consumer electronics product built around a custom PCB, ESP32-S3 firmware, a motorized latch, magnetic sensors, TFT display, rotary encoder, battery, and 3D-printed plastic housing. - -![Lockbox device overview](assets/device-overview.webp) - -| Property | Value | -| ------------------------ | -------------------------------------------- | -| Dimensions | 57 mm x 43 mm x 134 mm | -| Plastic volume | 156,408.422 mm^3 | -| Current housing material | 3D-printed PLA plastic | -| Embedded magnets | Three to four magnets in the plastic housing | - -## Assembly package - - - - Follow the mechanical build, electronics routing, and final QC sequence. - - - Review parts, suppliers, and hardware source references. - - - Find cable and harness ownership notes for the build. - - - Inspect the control board, KiCanvas preview, and production files. - - diff --git a/content/docs/lockbox/index.nl.mdx b/content/docs/lockbox/index.nl.mdx deleted file mode 100644 index 37e5844..0000000 --- a/content/docs/lockbox/index.nl.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Montagedocumentatie voor Lockbox" -description: "Montagedocumentatie voor Lockbox." ---- - -{/* Ported from MkDocs: index.md */} - -## Doel - -Deze documentatie verzamelt de informatie over de assemblage van Lockbox-hardware voor OSS-bouwers -en productiepartners. - -## Lockbox-overzicht - -Lockbox is een compact consumentenelektronicaproduct dat is opgebouwd rond een aangepaste PCB, ESP32-S3-firmware, een gemotoriseerde vergrendeling, magnetische sensoren, een TFT-display, een roterende encoder, een batterij en een 3D-geprinte kunststof behuizing. - -![Overzicht van het Lockbox-apparaat](assets/device-overview.webp) - -| Eigenschap | Waarde | -| ----------------------------- | ---------------------------------------------- | -| Afmetingen | 57 mm x 43 mm x 134 mm | -| Kunststofvolume | 156,408.422 mm^3 | -| Huidig behuizingsmateriaal | 3D-geprinte PLA-kunststof | -| Ingebouwde magneten | Drie tot vier magneten in de kunststof behuizing | - -## Montagedocumentatie - - - - Volg de mechanische opbouw, de bedrading van de elektronica en de afsluitende kwaliteitscontrole. - - - Bekijk onderdelen, leveranciers en verwijzingen naar hardwarebronnen. - - - Bekijk informatie over de verantwoordelijkheid voor kabels en kabelbomen binnen de assemblage. - - - Bekijk de besturingsprint, de KiCanvas-preview en de productiebestanden. - - diff --git a/content/docs/lockbox/meta.de.json b/content/docs/lockbox/meta.de.json deleted file mode 100644 index 8a59739..0000000 --- a/content/docs/lockbox/meta.de.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "Lockbox", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/lockbox/meta.en.json b/content/docs/lockbox/meta.en.json new file mode 100644 index 0000000..58c5c71 --- /dev/null +++ b/content/docs/lockbox/meta.en.json @@ -0,0 +1,11 @@ +{ + "title": "Lockbox Assembly Docs", + "pages": [ + "index", + "pcb-overview", + "cable-harnesses", + "bom", + "assembly-guide", + "..." + ] +} diff --git a/content/docs/lockbox/meta.fr.json b/content/docs/lockbox/meta.fr.json deleted file mode 100644 index 8a59739..0000000 --- a/content/docs/lockbox/meta.fr.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "Lockbox", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/lockbox/meta.json b/content/docs/lockbox/meta.json deleted file mode 100644 index 8a59739..0000000 --- a/content/docs/lockbox/meta.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "Lockbox", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/lockbox/meta.nl.json b/content/docs/lockbox/meta.nl.json deleted file mode 100644 index 8a59739..0000000 --- a/content/docs/lockbox/meta.nl.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "Lockbox", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/lockbox/pcb-overview.de.mdx b/content/docs/lockbox/pcb-overview.de.mdx deleted file mode 100644 index d435bb0..0000000 --- a/content/docs/lockbox/pcb-overview.de.mdx +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: "PCB-Übersicht" -description: "PCB-Übersicht für Lockbox." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -Die Lockbox-Platine ist die Steuer- und Stromverteilungsplatine des Geräts. Sie umfasst die ESP32-S3-Steuerelektronik, die Schnittstelle für den Motortreiber, den Batterie- und USB-Strompfad, die magnetische Positionserfassung, Eingänge für den Drehgeber und die Tasten sowie den Anschluss für das TFT-Display. - - - -## Elektrische Architektur - -| Bereich | Rolle | -| ----------------------------- | ------------------------------------------------------------------------------------------------- | -| `battery_and_power.kicad_sch` | Batterieeingang, USB-Stromerkennung, Lade-/Spannungsregelung und Unterstützung der Strommessung | -| `mcu_and_ui.kicad_sch` | ESP32-S3, Drehgeber, Tasteneingänge, Displayschnittstelle und Bedienelemente für den Benutzer | -| `mag_sensors.kicad_sch` | Hall/TMR-Magnetsensorik zur Erkennung der Rückplatten- und Riegelposition | -| `motor.kicad_sch` | DC-Motorausgang und Motorstecker | -| `screen.kicad_sch` | TFT-Display-Anschluss und unterstützende Anzeigesignale | - -## PCB-Quelldateien - -| Asset | Link | -| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| KiCad-Projekt | [`LockBox.kicad_pro`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_pro) | -| Hauptschaltplan | [`LockBox.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_sch) | -| Platinenlayout | [`LockBox.kicad_pcb`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_pcb) | -| Schaltplanblätter | [`battery_and_power.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/battery_and_power.kicad_sch), [`mag_sensors.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/mag_sensors.kicad_sch), [`mcu_and_ui.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/mcu_and_ui.kicad_sch), [`motor.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/motor.kicad_sch), [`screen.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/screen.kicad_sch) | -| Footprints und Symbole | [`Lockbox.pretty/`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/Lockbox.pretty), [`Lockbox.kicad_sym`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/Lockbox.kicad_sym) | -| STEP-Modell | [`LockBox_v0.1.step`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox_v0.1.step) | -| Datenblätter | [`datasheets/`](https://github.com/researchanddesire/Lockbox-OSS/tree/main/hardware/pcb/datasheets) | -| Hinweise zum Fertigungsexport | [`FAB_OUTPUT.md`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/FAB_OUTPUT.md) | -| Neueste Gerber-Fertigungsdaten | [`production/v1.4/LockBox_V1.4.zip`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/LockBox_V1.4.zip) | -| Neueste Produktions-PCB-Stückliste | [`production/v1.4/bom_v1.4.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/bom_v1.4.csv) | -| Aktuelle Produktionspositionen | [`production/v1.4/positions_v1.4.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/positions_v1.4.csv) | - -## Produktionspaket - -Die aktuelle Produktionsausgabe, auf die in diesen Montagedokumenten verwiesen wird, ist v1.4. Ältere Produktions-Exportpakete v1.2/v1.3 wurden aus dem OSS-Repository entfernt, sodass das öffentliche Hardwarepaket auf die aktuellen Produktionsdateien verweist. diff --git a/content/docs/lockbox/pcb-overview.en.mdx b/content/docs/lockbox/pcb-overview.en.mdx new file mode 100644 index 0000000..8fa1a16 --- /dev/null +++ b/content/docs/lockbox/pcb-overview.en.mdx @@ -0,0 +1,40 @@ +--- +title: PCB Overview +--- + +The Lockbox PCB is the control and power distribution board for the device. It carries the ESP32-S3 control electronics, motor driver interface, battery and USB power path, magnetic position sensing, rotary encoder inputs, button inputs, and TFT display connection. + + + +## Electrical architecture + +| Area | Role | +| ---- | ---- | +| `battery_and_power.kicad_sch` | Battery input, USB power detection, charging/power regulation, and current-sense support | +| `mcu_and_ui.kicad_sch` | ESP32-S3, rotary encoder, button inputs, display interface, and user-facing controls | +| `mag_sensors.kicad_sch` | Hall/TMR magnetic sensing used to detect the backplate and latch position | +| `motor.kicad_sch` | DC motor output and motor connector | +| `screen.kicad_sch` | TFT display connector and supporting display signals | + +## PCB source files + +| Asset | Link | +| ----- | ---- | +| KiCad project | [`LockBox.kicad_pro`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_pro) | +| Main schematic | [`LockBox.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_sch) | +| Board layout | [`LockBox.kicad_pcb`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_pcb) | +| Schematic sheets | [`battery_and_power.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/battery_and_power.kicad_sch), [`mag_sensors.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/mag_sensors.kicad_sch), [`mcu_and_ui.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/mcu_and_ui.kicad_sch), [`motor.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/motor.kicad_sch), [`screen.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/screen.kicad_sch) | +| Footprints and symbols | [`Lockbox.pretty/`](https://github.com/researchanddesire/Lockbox-OSS/tree/main/hardware/pcb/Lockbox.pretty/), [`Lockbox.kicad_sym`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/Lockbox.kicad_sym) | +| STEP model | [`LockBox_v0.1.step`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox_v0.1.step) | +| Datasheets | [`datasheets/`](https://github.com/researchanddesire/Lockbox-OSS/tree/main/hardware/pcb/datasheets/) | +| Fabrication output notes | [`FAB_OUTPUT.md`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/FAB_OUTPUT.md) | +| Latest production Gerbers | [`production/v1.4/LockBox_V1.4.zip`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/LockBox_V1.4.zip) | +| Latest production PCB BOM | [`production/v1.4/bom_v1.4.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/bom_v1.4.csv) | +| Latest production positions | [`production/v1.4/positions_v1.4.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/positions_v1.4.csv) | + +## Production package + +The current production output referenced by these assembly docs is v1.4. Older v1.2/v1.3 production export bundles were removed from the OSS repo so the public hardware package points at the current production assets. diff --git a/content/docs/lockbox/pcb-overview.fr.mdx b/content/docs/lockbox/pcb-overview.fr.mdx deleted file mode 100644 index cf138fb..0000000 --- a/content/docs/lockbox/pcb-overview.fr.mdx +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: "Aperçu du PCB" -description: "Présentation du PCB pour Lockbox." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -Le PCB Lockbox est la carte de commande et de distribution de l’alimentation de l’appareil. Il intègre l’électronique de commande ESP32-S3, l’interface du pilote de moteur, le chemin d’alimentation de la batterie et de l’USB, la détection de position magnétique, les entrées de l’encodeur rotatif et des boutons, ainsi que la connexion de l’écran TFT. - - - -## Architecture électrique - -| Zone | Rôle | -| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | -| `battery_and_power.kicad_sch` | Entrée de batterie, détection de l’alimentation USB, régulation de la charge et de l’alimentation, et prise en charge de la mesure du courant | -| `mcu_and_ui.kicad_sch` | ESP32-S3, encodeur rotatif, entrées des boutons, interface d’affichage et commandes utilisateur | -| `mag_sensors.kicad_sch` | Détection magnétique Hall/TMR servant à détecter la position de la plaque arrière et du loquet | -| `motor.kicad_sch` | Sortie moteur CC et connecteur moteur | -| `screen.kicad_sch` | Connecteur d’écran TFT et signaux d’affichage associés | - -## Fichiers sources du PCB - -| Élément | Lien | -| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Projet KiCad | [`LockBox.kicad_pro`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_pro) | -| Schéma principal | [`LockBox.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_sch) | -| Implantation du PCB | [`LockBox.kicad_pcb`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_pcb) | -| Feuilles schématiques | [`battery_and_power.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/battery_and_power.kicad_sch), [`mag_sensors.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/mag_sensors.kicad_sch), [`mcu_and_ui.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/mcu_and_ui.kicad_sch), [`motor.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/motor.kicad_sch), [`screen.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/screen.kicad_sch) | -| Empreintes et symboles | [`Lockbox.pretty/`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/Lockbox.pretty), [`Lockbox.kicad_sym`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/Lockbox.kicad_sym) | -| Modèle STEP | [`LockBox_v0.1.step`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox_v0.1.step) | -| Fiches techniques | [`datasheets/`](https://github.com/researchanddesire/Lockbox-OSS/tree/main/hardware/pcb/datasheets) | -| Notes sur la sortie de fabrication | [`FAB_OUTPUT.md`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/FAB_OUTPUT.md) | -| Derniers fichiers Gerber de production | [`production/v1.4/LockBox_V1.4.zip`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/LockBox_V1.4.zip) | -| Dernière nomenclature PCB de production | [`production/v1.4/bom_v1.4.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/bom_v1.4.csv) | -| Derniers fichiers de positionnement de production | [`production/v1.4/positions_v1.4.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/positions_v1.4.csv) | - -## Dossier de production - -La sortie de production actuelle référencée par ces documents d’assemblage est la v1.4. Les anciens lots d’exportation de production v1.2/v1.3 ont été supprimés du dépôt OSS afin que l’ensemble public de fichiers matériels pointe vers les fichiers de production actuels. diff --git a/content/docs/lockbox/pcb-overview.mdx b/content/docs/lockbox/pcb-overview.mdx deleted file mode 100644 index f6adc45..0000000 --- a/content/docs/lockbox/pcb-overview.mdx +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: "PCB Overview" -description: "PCB Overview for Lockbox." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -The Lockbox PCB is the control and power distribution board for the device. It carries the ESP32-S3 control electronics, motor driver interface, battery and USB power path, magnetic position sensing, rotary encoder inputs, button inputs, and TFT display connection. - - - -## Electrical architecture - -| Area | Role | -| ----------------------------- | ---------------------------------------------------------------------------------------- | -| `battery_and_power.kicad_sch` | Battery input, USB power detection, charging/power regulation, and current-sense support | -| `mcu_and_ui.kicad_sch` | ESP32-S3, rotary encoder, button inputs, display interface, and user-facing controls | -| `mag_sensors.kicad_sch` | Hall/TMR magnetic sensing used to detect the backplate and latch position | -| `motor.kicad_sch` | DC motor output and motor connector | -| `screen.kicad_sch` | TFT display connector and supporting display signals | - -## PCB source files - -| Asset | Link | -| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| KiCad project | [`LockBox.kicad_pro`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_pro) | -| Main schematic | [`LockBox.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_sch) | -| Board layout | [`LockBox.kicad_pcb`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_pcb) | -| Schematic sheets | [`battery_and_power.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/battery_and_power.kicad_sch), [`mag_sensors.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/mag_sensors.kicad_sch), [`mcu_and_ui.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/mcu_and_ui.kicad_sch), [`motor.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/motor.kicad_sch), [`screen.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/screen.kicad_sch) | -| Footprints and symbols | [`Lockbox.pretty/`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/Lockbox.pretty), [`Lockbox.kicad_sym`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/Lockbox.kicad_sym) | -| STEP model | [`LockBox_v0.1.step`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox_v0.1.step) | -| Datasheets | [`datasheets/`](https://github.com/researchanddesire/Lockbox-OSS/tree/main/hardware/pcb/datasheets) | -| Fabrication output notes | [`FAB_OUTPUT.md`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/FAB_OUTPUT.md) | -| Latest production Gerbers | [`production/v1.4/LockBox_V1.4.zip`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/LockBox_V1.4.zip) | -| Latest production PCB BOM | [`production/v1.4/bom_v1.4.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/bom_v1.4.csv) | -| Latest production positions | [`production/v1.4/positions_v1.4.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/positions_v1.4.csv) | - -## Production package - -The current production output referenced by these assembly docs is v1.4. Older v1.2/v1.3 production export bundles were removed from the OSS repo so the public hardware package points at the current production assets. diff --git a/content/docs/lockbox/pcb-overview.nl.mdx b/content/docs/lockbox/pcb-overview.nl.mdx deleted file mode 100644 index fbabf5b..0000000 --- a/content/docs/lockbox/pcb-overview.nl.mdx +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: "PCB-overzicht" -description: "PCB-overzicht voor Lockbox." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -De Lockbox-PCB is de besturings- en stroomverdeelprint voor het apparaat. Deze bevat de ESP32-S3-besturingselektronica, de interface voor de motordriver, het batterij- en USB-voedingspad, magnetische positiedetectie, ingangen voor de roterende encoder en knoppen, en de TFT-displayaansluiting. - - - -## Elektrische architectuur - -| Gebied | Rol | -| ----------------------------- | ----------------------------------------------------------------------------------------------------- | -| `battery_and_power.kicad_sch` | Batterijingang, USB-voedingsdetectie, laad-/voedingsregeling en ondersteuning voor stroommeting | -| `mcu_and_ui.kicad_sch` | ESP32-S3, roterende encoder, knopingangen, displayinterface en gebruikersbediening | -| `mag_sensors.kicad_sch` | Hall-/TMR-magneetsensoren voor het detecteren van de positie van de achterplaat en de grendel | -| `motor.kicad_sch` | DC-motoruitgang en motorconnector | -| `screen.kicad_sch` | TFT-displayconnector en ondersteunende displaysignalen | - -## PCB-bronbestanden - -| Asset | Link | -| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| KiCad-project | [`LockBox.kicad_pro`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_pro) | -| Hoofdschema | [`LockBox.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_sch) | -| PCB-layout | [`LockBox.kicad_pcb`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox.kicad_pcb) | -| Schemabladen | [`battery_and_power.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/battery_and_power.kicad_sch), [`mag_sensors.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/mag_sensors.kicad_sch), [`mcu_and_ui.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/mcu_and_ui.kicad_sch), [`motor.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/motor.kicad_sch), [`screen.kicad_sch`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/screen.kicad_sch) | -| Footprints en symbolen | [`Lockbox.pretty/`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/Lockbox.pretty), [`Lockbox.kicad_sym`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/Lockbox.kicad_sym) | -| STEP-model | [`LockBox_v0.1.step`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/LockBox_v0.1.step) | -| Gegevensbladen | [`datasheets/`](https://github.com/researchanddesire/Lockbox-OSS/tree/main/hardware/pcb/datasheets) | -| Notities over fabricage-uitvoer | [`FAB_OUTPUT.md`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/FAB_OUTPUT.md) | -| Nieuwste Gerber-productiebestanden | [`production/v1.4/LockBox_V1.4.zip`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/LockBox_V1.4.zip) | -| Nieuwste PCB-productiestuklijst | [`production/v1.4/bom_v1.4.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/bom_v1.4.csv) | -| Laatste productieposities | [`production/v1.4/positions_v1.4.csv`](https://github.com/researchanddesire/Lockbox-OSS/blob/main/hardware/pcb/production/v1.4/positions_v1.4.csv) | - -## Productiepakket - -De huidige productie-uitvoer waarnaar deze assemblagedocumentatie verwijst, is v1.4. Oudere productie-exportbundels v1.2/v1.3 zijn verwijderd uit de OSS-repository, zodat het openbare hardwarepakket naar de huidige productiebestanden verwijst. diff --git a/content/docs/meta.de.json b/content/docs/meta.de.json deleted file mode 100644 index 646e880..0000000 --- a/content/docs/meta.de.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "title": "R+D-Montage", - "pages": ["index", "dtt", "lockbox", "ossm", "radr", "how-this-site-works"] -} diff --git a/content/docs/meta.fr.json b/content/docs/meta.fr.json deleted file mode 100644 index 6893615..0000000 --- a/content/docs/meta.fr.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "title": "Assemblage R+D", - "pages": ["index", "dtt", "lockbox", "ossm", "radr", "how-this-site-works"] -} diff --git a/content/docs/meta.json b/content/docs/meta.json index a426b43..753a64d 100644 --- a/content/docs/meta.json +++ b/content/docs/meta.json @@ -1,4 +1,3 @@ { - "title": "R+D Assembly", - "pages": ["index", "dtt", "lockbox", "ossm", "radr", "how-this-site-works"] + "pages": ["index", "dtt", "lockbox", "radr", "ossm"] } diff --git a/content/docs/meta.nl.json b/content/docs/meta.nl.json deleted file mode 100644 index 8b04a70..0000000 --- a/content/docs/meta.nl.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "title": "R+D-assemblage", - "pages": ["index", "dtt", "lockbox", "ossm", "radr", "how-this-site-works"] -} diff --git a/content/docs/ossm/assembly-guide.en.mdx b/content/docs/ossm/assembly-guide.en.mdx new file mode 100644 index 0000000..362554a --- /dev/null +++ b/content/docs/ossm/assembly-guide.en.mdx @@ -0,0 +1,16 @@ +--- +title: Assembly Guide +--- + +The OSSM assembly guide is awaiting migration from the current operational +hardware sources. + +## Migration Checklist + +- Confirm the release CAD exports in `hardware/cad/`. +- Confirm PCB source migration status in `hardware/pcb/`. +- Confirm Wireviz harness output from `hardware/cables/`. +- Populate `hardware/bom.csv` with product-level line items. +- Replace this checklist with the ordered build sequence and assembly photos. + +Do not invent assembly steps before the release source package is complete. diff --git a/content/docs/ossm/assembly-troubleshooting.de.mdx b/content/docs/ossm/assembly-troubleshooting.de.mdx deleted file mode 100644 index 2297b34..0000000 --- a/content/docs/ossm/assembly-troubleshooting.de.mdx +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Fehlerbehebung bei der Montage -description: Halten Sie sicher an und überprüfen Sie häufig auftretende OSSM-Montageprobleme. ---- -{/* Sources: official build-stage checks and https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-12.0_initial_test */} - -## Vor der Fehlerbehebung anhalten - -Trennen Sie die Stromversorgung und warten Sie, bis jede Bewegung vollständig zum Stillstand gekommen ist, bevor Sie Riemen, Motor, Schlitten, Verkabelung oder Steuerplatine berühren. - -## Der Schlitten klemmt bei manueller Bewegung - -Überprüfen Sie erneut die Ausrichtung der Schienen, die Riemenführung, die Ausrichtung der Lager, den vorderen Endanschlag und die Riemenspannung. Kehren Sie zu dem Montageschritt zurück, an dem die Bewegung erstmals eingeschränkt war. - -## Die Steuerplatine lässt sich nicht einschalten - -Trennen Sie die Stromversorgung. Überprüfen Sie Polarität und Klemmenbelegung anhand der [Verkabelung](/ossm/build/wiring). Prüfen Sie auf lose Litzen oder freiliegende Leiter. Setzen Sie eine Verkabelung mit unklarer Belegung nicht wiederholt unter Spannung. - -## Die Referenzfahrt läuft in die falsche Richtung - -Trennen Sie sofort die Stromversorgung und prüfen Sie erneut Motordrehrichtung und Impulsverkabelung. Fahren Sie nicht mit einem Bewegungstest fort. - -## Der Riemen rutscht oder läuft seitlich - -Trennen Sie die Stromversorgung und prüfen Sie [Riemenscheibe am Motor](/ossm/build/pulley) sowie [Riemenspannung](/ossm/build/belt-tension). Die Riemenscheibe, der Riemen und die Lager müssen über den gesamten von Hand geprüften Verfahrweg ausgerichtet bleiben. - -Wenn die Prüfungen die Ursache nicht identifizieren, wenden Sie sich an [support@researchanddesire.com](https://www.researchanddesire.com/pages/contact-us), bevor Sie die Stromversorgung erneut herstellen. diff --git a/content/docs/ossm/assembly-troubleshooting.fr.mdx b/content/docs/ossm/assembly-troubleshooting.fr.mdx deleted file mode 100644 index 7ba860f..0000000 --- a/content/docs/ossm/assembly-troubleshooting.fr.mdx +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Dépannage de l'assemblage -description: Arrêtez-vous en toute sécurité et vérifiez les problèmes courants d'assemblage OSSM. ---- -{/* Sources: official build-stage checks and https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-12.0_initial_test */} - -## Arrêtez-vous avant le dépannage - -Débranchez l’alimentation et attendez que tout mouvement cesse avant de toucher la courroie, le moteur, le chariot, le câblage ou la carte de commande. - -## Le chariot se bloque lorsqu’on le déplace à la main - -Revérifiez l’alignement des rails, le cheminement de la courroie, l’alignement des roulements, la butée avant et la tension de la courroie. Revenez à l’étape où le mouvement a été limité pour la première fois. - -## La carte de commande ne s’allume pas - -Débranchez l’alimentation. Vérifiez la polarité et l’affectation des bornes en vous reportant à [Câblage](/ossm/build/wiring). Recherchez les brins lâches ou les conducteurs exposés. Ne remettez pas sous tension à plusieurs reprises un câblage incertain. - -## Le référencement se fait dans la mauvaise direction - -Débranchez immédiatement l’alimentation et revérifiez le sens du moteur et le câblage des impulsions. Ne poursuivez pas le test de mouvement. - -## La courroie saute ou se déplace latéralement - -Débranchez l’alimentation et examinez la [poulie du moteur](/ossm/build/pulley) et la [tension de la courroie](/ossm/build/belt-tension). La poulie, la courroie et les roulements doivent rester alignés pendant toute la course vérifiée manuellement. - -Si les vérifications n'identifient pas la cause, contactez [support@researchanddesire.com](https://www.researchanddesire.com/pages/contact-us) avant de remettre sous tension. diff --git a/content/docs/ossm/assembly-troubleshooting.mdx b/content/docs/ossm/assembly-troubleshooting.mdx deleted file mode 100644 index f34aacd..0000000 --- a/content/docs/ossm/assembly-troubleshooting.mdx +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Assembly Troubleshooting -description: Stop safely and check common OSSM assembly problems. ---- -{/* Sources: official build-stage checks and https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-12.0_initial_test */} - -## Stop before troubleshooting - -Disconnect power and wait for all movement to stop before touching the belt, motor, carriage, wiring, or control board. - -## The carriage binds by hand - -Recheck rail alignment, belt routing, bearing alignment, the front hard limit, and belt tension. Return to the stage where movement first became restricted. - -## The control board does not power on - -Disconnect power. Verify polarity and terminal placement against [Wiring](/ossm/build/wiring). Inspect for loose strands or exposed conductor. Do not repeatedly apply power to uncertain wiring. - -## Homing moves in the wrong direction - -Disconnect power immediately and recheck the motor direction and pulse wiring. Do not continue to a motion test. - -## The belt skips or walks sideways - -Disconnect power and review [Pulley on Motor](/ossm/build/pulley) and [Belt Tension](/ossm/build/belt-tension). The pulley, belt, and bearings must stay aligned through the full hand-checked travel. - -If the checks do not identify the cause, contact [support@researchanddesire.com](https://www.researchanddesire.com/pages/contact-us) before applying power again. diff --git a/content/docs/ossm/assembly-troubleshooting.nl.mdx b/content/docs/ossm/assembly-troubleshooting.nl.mdx deleted file mode 100644 index 05399b7..0000000 --- a/content/docs/ossm/assembly-troubleshooting.nl.mdx +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Problemen met montage oplossen -description: Stop veilig en controleer veelvoorkomende OSSM-montageproblemen. ---- -{/* Sources: official build-stage checks and https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-12.0_initial_test */} - -## Stop voordat u problemen oplost - -Koppel de voeding los en wacht tot alle bewegingen volledig tot stilstand zijn gekomen voordat u de riem, de motor, de wagen, de bedrading of de besturingsprint aanraakt. - -## De wagen loopt vast bij handmatige beweging - -Controleer opnieuw de uitlijning van de rails, de riemgeleiding, de uitlijning van de lagers, de voorste vaste aanslag en de riemspanning. Ga terug naar de assemblagestap waarin de beweging voor het eerst werd beperkt. - -## De besturingsprint schakelt niet in - -Koppel de voeding los. Controleer de polariteit en klembezetting aan de hand van [Bedrading](/ossm/build/wiring). Controleer op losse aders of blootliggende geleiders. Zet onzekere bedrading niet herhaaldelijk onder spanning. - -## Homing gaat de verkeerde kant op - -Koppel onmiddellijk de voeding los en controleer opnieuw de motorrichting en pulsbedrading. Ga niet verder met een bewegingstest. - -## De riem slaat over of loopt zijwaarts - -Koppel de voeding los en controleer [Poelie op de motor](/ossm/build/pulley) en [Riemspanning](/ossm/build/belt-tension). De poelie, de riem en de lagers moeten over de volledige, met de hand gecontroleerde verplaatsing uitgelijnd blijven. - -Als uit de controles de oorzaak niet blijkt, neem dan contact op met [support@researchanddesire.com](https://www.researchanddesire.com/pages/contact-us) voordat u de stroom weer inschakelt. diff --git a/content/docs/ossm/bom.en.mdx b/content/docs/ossm/bom.en.mdx new file mode 100644 index 0000000..d5c12d6 --- /dev/null +++ b/content/docs/ossm/bom.en.mdx @@ -0,0 +1,10 @@ +--- +title: Bill of Materials +--- + +The OSSM product-level BOM is generated from `hardware/bom.csv` +during the assembly-docs build. Update the CSV instead of editing the generated +block by hand. + +The BOM is currently a header-only migration placeholder. Until product rows are +added, Ohai leaves this page text intact. diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_24v_fully_enclosed_power_supply.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_24v_fully_enclosed_power_supply.webp deleted file mode 100644 index 8d80903..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_24v_fully_enclosed_power_supply.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_IHS57-30-18.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_IHS57-30-18.webp deleted file mode 100644 index 9a01d90..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_IHS57-30-18.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_bearing_alignment.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_bearing_alignment.webp deleted file mode 100644 index 847e785..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_bearing_alignment.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_bottom.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_bottom.webp deleted file mode 100644 index abcbca4..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_bottom.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_closeup.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_closeup.webp deleted file mode 100644 index 4168aa2..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_closeup.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_tension_end.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_tension_end.webp deleted file mode 100644 index f09e996..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_tension_end.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_top.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_top.webp deleted file mode 100644 index 16d9d3d..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_clamp_top.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_tensioner.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_tensioner.webp deleted file mode 100644 index 15adc88..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_tensioner.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_wrap_around_pulley.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_wrap_around_pulley.webp deleted file mode 100644 index d44807c..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_wrap_around_pulley.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_xray_path.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_xray_path.webp deleted file mode 100644 index 8455cc6..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_belt_xray_path.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_base.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_base.webp deleted file mode 100644 index 34cd6f3..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_base.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_cover.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_cover.webp deleted file mode 100644 index fb0e182..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_cover.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_middle.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_middle.webp deleted file mode 100644 index e4c9d66..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_middle.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_middle_pivot.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_middle_pivot.webp deleted file mode 100644 index 826e4bd..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_body_middle_pivot.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_build_up_idler_bearings.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_build_up_idler_bearings.webp deleted file mode 100644 index b15cf4f..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_build_up_idler_bearings.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_gt2_pulley.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_gt2_pulley.webp deleted file mode 100644 index ab8c9af..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_gt2_pulley.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_gt2_timing_belt.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_gt2_timing_belt.webp deleted file mode 100644 index aa4427f..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_gt2_timing_belt.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_idler_bearings.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_idler_bearings.webp deleted file mode 100644 index 03ac03a..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_idler_bearings.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_install_align_pulley.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_install_align_pulley.webp deleted file mode 100644 index 13fbb64..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_install_align_pulley.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_mate_base_plate_with_motor.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_mate_base_plate_with_motor.webp deleted file mode 100644 index a68add0..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_mate_base_plate_with_motor.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_metric_cap_screw_kit.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_metric_cap_screw_kit.webp deleted file mode 100644 index 8e2e3cb..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_metric_cap_screw_kit.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_middle_body_install.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_middle_body_install.webp deleted file mode 100644 index 3f40ab0..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_middle_body_install.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_middle_pivot_install.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_middle_pivot_install.webp deleted file mode 100644 index 82e9d45..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_middle_pivot_install.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_ossm.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_ossm.webp deleted file mode 100644 index 340ef46..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_ossm.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_ossm_pcb_and_remote.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_ossm_pcb_and_remote.webp deleted file mode 100644 index c48d9d3..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_ossm_pcb_and_remote.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_pcb_support_cover.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_pcb_support_cover.webp deleted file mode 100644 index 78ea42e..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_pcb_support_cover.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_rail_install.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_rail_install.webp deleted file mode 100644 index f820fc2..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_rail_install.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_rail_install_cap_screws.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_rail_install_cap_screws.webp deleted file mode 100644 index b4d5254..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_rail_install_cap_screws.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_remote_body.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_remote_body.webp deleted file mode 100644 index 325df19..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_remote_body.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_remote_knobs.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_remote_knobs.webp deleted file mode 100644 index 4b78785..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_remote_knobs.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_remote_top_cover.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_remote_top_cover.webp deleted file mode 100644 index f9d2c55..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_remote_top_cover.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_roller_bearings.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_roller_bearings.webp deleted file mode 100644 index 43373c0..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_roller_bearings.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_toy_mount_24mm_jam_nut.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_toy_mount_24mm_jam_nut.webp deleted file mode 100644 index d6a182b..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_toy_mount_24mm_jam_nut.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_toy_mount_rail_to_24mm_thread.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_toy_mount_rail_to_24mm_thread.webp deleted file mode 100644 index c687047..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_toy_mount_rail_to_24mm_thread.webp and /dev/null differ diff --git a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_vac_u_lock_adapter.webp b/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_vac_u_lock_adapter.webp deleted file mode 100644 index 4c65f15..0000000 Binary files a/content/docs/ossm/build/assets/legacy/legacy_assembly_instructions_vac_u_lock_adapter.webp and /dev/null differ diff --git a/content/docs/ossm/build/belt-tension.de.mdx b/content/docs/ossm/build/belt-tension.de.mdx deleted file mode 100644 index 95ddc25..0000000 --- a/content/docs/ossm/build/belt-tension.de.mdx +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: "8. Spannungseinstellung" -description: "Endgültige Einstellung der Riemenspannung, um die richtige Ausrichtung und optimale Leistung des OSSM-Aktuators sicherzustellen" ---- - -Nachdem alle Antriebskomponenten zusammengebaut sind, müssen Sie die endgültige Einstellung der Riemenspannung durchführen. Dieser Schritt stellt sicher, dass der Riemen richtig gespannt und ausgerichtet ist und mit allen erforderlichen Komponenten in Kontakt steht, um eine optimale Leistung zu gewährleisten. - -## Erforderliche Komponenten und Werkzeuge - -### Komponenten - -| Komponente | Anzahl | Spezifikation / Hinweise | -|-----------|-------|----------------------| -| Einstellschraube | 1 | Bereits im hinteren Spanner installierte M5-Schraube | - -### Werkzeuge - -| Werkzeug | Anzahl | Spezifikation / Hinweise | -|------|-------|----------------------| -| Handkraft | 1 | Zum Festziehen der Einstellschraube | - - -Die Einstellschraube (M5-Schraube) sollte bereits in früheren Montageschritten im hinteren Spanner installiert worden sein. Bei dieser letzten Einstellung wird die richtige Riemenspannung durch manuelles Anziehen eingestellt. - - -## Schritt-für-Schritt-Anleitung - - - -Suchen Sie die M5-Einstellschraube, die aus dem hinteren Spannerstück herausragt. - - -Sie sollten die M5-Schraube sehen, die aus dem hinteren Spanner herausragt und für die endgültige Einstellung bereit ist. - - - - -Ziehen Sie die Einstellschraube mit der Hand so fest an, wie es für Sie bequem ist. Greifen und drehen Sie die Schraube mit festem, gleichmäßigem Druck. - - -Die durch das Ergreifen und Drehen mit der Hand ausgeübte Kraft ist die angestrebte Anfangsspannung. Sie müssen weder Werkzeuge verwenden noch übermäßig viel Kraft aufwenden – das Anziehen von Hand sorgt für die richtige Spannung für eine optimale Riemenleistung. - - - -Verwenden Sie keine Werkzeuge oder übermäßige Kraft, um die Schraube weiter festzuziehen, als Sie bequem mit der Hand erreichen können. Ein zu starkes Anziehen kann zur Beschädigung von Bauteilen oder zu übermäßigem Verschleiß des Riemens und der Lager führen. - - - - -Bewegen Sie den Linearschienenschlitten (die Baugruppe) über seinen gesamten Bewegungsbereich hin und her, um sicherzustellen, dass alle Komponenten richtig ausgerichtet sind. - - -Der Schlitten sollte sich reibungslos entlang der Schiene bewegen, ohne zu klemmen oder übermäßigen Widerstand zu verursachen. Alle Komponenten sollten während des gesamten Bewegungsbereichs richtig ausgerichtet bleiben. - - - - -Stellen Sie sicher, dass der Riemen alle drei Lager auf beiden Seiten des Motorkopfs berührt. Der Riemen sollte über den gesamten Bewegungsbereich Kontakt mit allen sechs Lagern (drei auf jeder Seite) halten. - - -Überprüfen Sie beide Seiten des Motorkopfs visuell, um sicherzustellen, dass der Riemen alle drei Lager auf jeder Seite berührt. Der Riemen darf während der Bewegung an keinem Lager überspringen oder den Kontakt verlieren. - - - - -Stellen Sie sicher, dass der Riemen mittig auf der Riemenscheibe liegt. Der Riemen sollte gleichmäßig auf der Riemenscheibe laufen, ohne auf die eine oder andere Seite zu rutschen. - - -Wenn der Riemen nicht mittig auf der Riemenscheibe liegt, müssen Sie möglicherweise die Position der Riemenscheibe anpassen oder überprüfen, ob die Motorkopfkomponenten richtig ausgerichtet sind. Der Riemen sollte gerade entlang der Mittelrille der Riemenscheibe laufen. - - - -Der Riemen sollte auf der Riemenscheibe zentriert sein und über den gesamten Bewegungsbereich zentriert bleiben. Es sollte keine sichtbare Verschiebung oder Fehlausrichtung vorhanden sein. - - - - -## Verifizierungscheckliste - -Überprüfen Sie nach Abschluss der Spannungseinstellung Folgendes: - -- [ ] Die Einstellschraube ist handfest auf ein angenehmes Maß angezogen -- [ ] Der lineare Schienenschlitten bewegt sich reibungslos und ohne Blockierung -- [ ] Der Riemen hält Kontakt zu allen drei Lagern auf beiden Seiten des Motorkopfes -- [ ] Der Riemen ist auf der Riemenscheibe zentriert -- [ ] Alle Komponenten bleiben über den gesamten Bewegungsbereich richtig ausgerichtet - - -Wenn eine dieser Prüfungen fehlschlägt, müssen Sie möglicherweise die Spannschraube leicht anpassen oder überprüfen, ob alle Komponenten ordnungsgemäß zusammengebaut sind. Die Riemenspannung sollte ausreichend sein, um den Kontakt mit allen Lagern aufrechtzuerhalten und dennoch eine reibungslose Bewegung zu ermöglichen. - - -## Nächste Schritte - -Nachdem der Riemen richtig gespannt und alle Komponenten überprüft wurden, fahren Sie mit der Elektronikbaugruppe fort, um die OSSM-Steuerplatine zu montieren und die Aktuatorbaugruppe fertigzustellen. - -[← Motorabdeckung](/ossm/build/motor-cover) · [Weiter: Elektronik →](/ossm/build/electronics) diff --git a/content/docs/ossm/build/belt-tension.fr.mdx b/content/docs/ossm/build/belt-tension.fr.mdx deleted file mode 100644 index 762ef56..0000000 --- a/content/docs/ossm/build/belt-tension.fr.mdx +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: "8. Réglage de la tension" -description: "Réglage final de la tension de la courroie pour garantir un alignement correct et des performances optimales de l'actionneur OSSM" ---- - -Une fois tous les composants de l'actionneur assemblés, vous devez effectuer le réglage final de la tension de la courroie. Cette étape garantit que la courroie est correctement tendue, alignée et en contact avec tous les composants requis pour des performances optimales. - -## Composants et outils requis - -### Composants - -| Composant | Qté | Spécification / Remarques | -|-----------|-------|----------------------| -| Boulon de réglage | 1 | Boulon M5 déjà installé dans le tendeur arrière | - -### Outils - -| Outil | Qté | Spécification / Remarques | -|------|-------|----------------------| -| Force manuelle | 1 | Sert à serrer le boulon de réglage | - - -Le boulon de réglage (boulon M5) doit déjà être installé dans le tendeur arrière lors des étapes d'assemblage précédentes. Ce réglage final utilise la force de serrage manuelle pour régler la tension appropriée de la courroie. - - -## Instructions étape par étape - - - -Localisez le boulon de réglage M5 qui dépasse de la pièce du tendeur arrière. - - -Vous devriez voir le boulon M5 sortir du tendeur arrière, prêt pour le réglage final. - - - - -Serrez le boulon de réglage à la main, aussi fermement que possible sans inconfort. Appliquez une pression ferme et régulière en saisissant et en tournant le boulon. - - -La force appliquée par la préhension et la torsion constitue la tension initiale cible. Vous n'avez pas besoin d'utiliser d'outils ni de force excessive : le serrage manuel fournit le niveau de tension approprié pour des performances optimales de la courroie. - - - -N'utilisez pas d'outils ni de force excessive pour serrer le boulon au-delà de ce que vous pouvez facilement réaliser à la main. Un serrage excessif peut endommager les composants ou créer une usure excessive de la courroie et des roulements. - - - - -Déplacez le chariot du rail linéaire (l’assemblage) d’avant en arrière sur toute sa plage de mouvement pour vous assurer que tous les composants sont correctement alignés. - - -La glissière doit se déplacer en douceur le long du rail sans grippage ni résistance excessive. Tous les composants doivent rester correctement alignés sur toute l’amplitude de mouvement. - - - - -Vérifiez que la courroie est en contact avec les trois roulements des deux côtés de la tête du moteur. La courroie doit maintenir le contact avec les six roulements (trois de chaque côté) sur toute l’amplitude de mouvement. - - -Inspectez visuellement les deux côtés de la tête du moteur pour vérifier que la courroie entre en contact avec les trois roulements de chaque côté. La courroie ne doit pas sauter ou perdre le contact avec un roulement pendant le mouvement. - - - - -Confirmez que la courroie est centrée sur la poulie. La courroie doit rouler uniformément sur la poulie sans dériver d’un côté ou de l’autre. - - -Si la courroie n'est pas centrée sur la poulie, vous devrez peut-être ajuster la position de la poulie ou vérifier que les composants de la tête du moteur sont correctement alignés. La courroie doit suivre une trajectoire rectiligne dans la rainure centrale de la poulie. - - - -La courroie doit être centrée sur la poulie et rester centrée sur toute l’amplitude de mouvement. Il ne doit y avoir aucune dérive ou désalignement visible. - - - - -## Liste de contrôle de vérification - -Après avoir terminé le réglage de la tension, vérifiez les points suivants : - -- [ ] Le boulon de réglage est serré à la main à un niveau confortable -- [ ] Le chariot du rail linéaire se déplace en douceur sans se coincer -- [ ] La courroie maintient le contact avec les trois roulements des deux côtés de la tête du moteur -- [ ] La courroie est centrée sur la poulie -- [ ] Tous les composants restent correctement alignés sur toute la plage de mouvement - - -Si l'une de ces vérifications échoue, vous devrez peut-être ajuster légèrement le boulon de tension ou vérifier que tous les composants sont correctement assemblés. La tension de la courroie doit être suffisante pour maintenir le contact avec tous les roulements tout en permettant un mouvement fluide. - - -## Prochaines étapes - -Une fois la courroie correctement tendue et tous les composants vérifiés, passez à l'assemblage électronique pour monter la carte de commande OSSM et terminer l'assemblage de l'actionneur. - -[← Capot moteur](/ossm/build/motor-cover) · [Suivant : Électronique →](/ossm/build/electronics) diff --git a/content/docs/ossm/build/belt-tension.mdx b/content/docs/ossm/build/belt-tension.mdx deleted file mode 100644 index acbd57d..0000000 --- a/content/docs/ossm/build/belt-tension.mdx +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: "8. Tension Adjustment" -description: "Final belt tension adjustment to ensure proper alignment and optimal performance of the OSSM actuator" ---- - -After all actuator components are assembled, you need to perform the final belt tension adjustment. This step ensures the belt is properly tensioned, aligned, and in contact with all required components for optimal performance. - -## Required Components and Tools - -### Components - -| Component | Count | Specification / Notes | -|-----------|-------|----------------------| -| Adjustment Bolt | 1 | M5 bolt already installed in the Rear Tensioner | - -### Tools - -| Tool | Count | Specification / Notes | -|------|-------|----------------------| -| Your Hand/Grip | 1 | Used to tighten the adjustment bolt | - - -The adjustment bolt (M5 bolt) should already be installed in the rear tensioner from earlier assembly steps. This final adjustment uses hand-tightening force to set the proper belt tension. - - -## Step-by-Step Instructions - - - -Locate the M5 adjustment bolt that is protruding from the rear tensioner piece. - - -You should see the M5 bolt extending from the rear tensioner, ready for final adjustment. - - - - -Tighten the adjustment bolt using your hand/grip as much as you comfortably can. Apply firm, steady pressure by gripping and twisting the bolt. - - -The force applied by hand-gripping and twisting is the target initial tension. You don't need to use tools or excessive force—hand-tightening provides the appropriate tension level for optimal belt performance. - - - -Do not use tools or excessive force to tighten the bolt beyond what you can comfortably achieve by hand. Over-tightening can damage components or create excessive wear on the belt and bearings. - - - - -Move the linear rail slide (the assembly) back and forth along its full range of motion to ensure all components are properly aligned. - - -The slide should move smoothly along the rail without binding or excessive resistance. All components should remain properly aligned throughout the full range of motion. - - - - -Confirm that the belt is in contact with all three bearings on both sides of the motor head. The belt should maintain contact with all six bearings (three on each side) throughout the entire range of motion. - - -Visually inspect both sides of the motor head to verify the belt contacts all three bearings on each side. The belt should not skip or lose contact with any bearing during movement. - - - - -Confirm that the belt is centered on the pulley. The belt should ride evenly on the pulley without drifting to one side or the other. - - -If the belt is not centered on the pulley, you may need to adjust the pulley position or check that the motor head components are properly aligned. The belt should track straight along the pulley's center groove. - - - -The belt should be centered on the pulley and remain centered throughout the full range of motion. There should be no visible drift or misalignment. - - - - -## Verification Checklist - -After completing the tension adjustment, verify the following: - -- [ ] The adjustment bolt is hand-tightened to a comfortable level -- [ ] The linear rail slide moves smoothly without binding -- [ ] The belt maintains contact with all three bearings on both sides of the motor head -- [ ] The belt is centered on the pulley -- [ ] All components remain properly aligned throughout the full range of motion - - -If any of these checks fail, you may need to adjust the tension bolt slightly or verify that all components are properly assembled. The belt tension should be sufficient to maintain contact with all bearings while still allowing smooth movement. - - -## Next Steps - -With the belt properly tensioned and all components verified, proceed to the electronics assembly to mount the OSSM Control Board and complete the actuator assembly. - -[← Motor cover](/ossm/build/motor-cover) · [Next: Electronics →](/ossm/build/electronics) diff --git a/content/docs/ossm/build/belt-tension.nl.mdx b/content/docs/ossm/build/belt-tension.nl.mdx deleted file mode 100644 index 82581a2..0000000 --- a/content/docs/ossm/build/belt-tension.nl.mdx +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: "8. Riemspanning afstellen" -description: "Laatste afstelling van de riemspanning om een goede uitlijning en optimale prestaties van de OSSM-actuator te garanderen" ---- - -Nadat alle actuatorcomponenten zijn gemonteerd, moet u de laatste riemspanning aanpassen. Deze stap zorgt ervoor dat de riem goed wordt gespannen, uitgelijnd en in contact komt met alle vereiste componenten voor optimale prestaties. - -## Vereiste componenten en gereedschappen - -### Componenten - -| Onderdeel | Aantal | Specificatie / Opmerkingen | -|-----------|-------|----------------------| -| Stelbout | 1 | M5-bout die al in de achterspanner is geïnstalleerd | - -### Gereedschap - -| Gereedschap | Aantal | Specificatie / Opmerkingen | -|------|-------|----------------------| -| Handkracht | 1 | Voor het met de hand vastdraaien van de stelbout | - - -De stelbout (M5-bout) moet tijdens eerdere montagestappen al in de achterspanner zijn geïnstalleerd. Bij deze laatste afstelling gebruikt u handkracht om de juiste riemspanning in te stellen. - - -## Stapsgewijze instructies - - - -Zoek de M5-stelbout die uit het achterste spanstuk steekt. - - -U zou de M5-bout uit de achterste spanner moeten zien steken, klaar voor de laatste afstelling. - - - - -Draai de stelbout met uw hand zo vast als comfortabel is. Oefen een stevige, gelijkmatige druk uit door de bout vast te pakken en te draaien. - - -De kracht die wordt uitgeoefend door het met de hand vastgrijpen en draaien is de beoogde initiële spanning. U hoeft geen gereedschap of overmatige kracht te gebruiken; met de hand aandraaien zorgt voor het juiste spanningsniveau voor optimale riemprestaties. - - - -Gebruik geen gereedschap of overmatige kracht om de bout verder vast te draaien dan wat u gemakkelijk met de hand kunt bereiken. Te strak aandraaien kan onderdelen beschadigen of overmatige slijtage van de riem en lagers veroorzaken. - - - - -Beweeg de lineaire railschuif (het geheel) heen en weer over het volledige bewegingsbereik om ervoor te zorgen dat alle componenten goed zijn uitgelijnd. - - -De slede moet soepel langs de rail bewegen, zonder haperingen of overmatige weerstand te ondervinden. Alle componenten moeten tijdens het volledige bewegingsbereik goed uitgelijnd blijven. - - - - -Controleer of de riem in contact is met alle drie de lagers aan beide zijden van de motorkop. De riem moet tijdens het gehele bewegingsbereik contact houden met alle zes lagers (drie aan elke kant). - - -Inspecteer beide zijden van de motorkop visueel om te controleren of de riem contact maakt met alle drie de lagers aan elke kant. De riem mag tijdens de beweging niet overslaan of het contact met een lager verliezen. - - - - -Controleer of de riem gecentreerd is op de poelie. De riem moet gelijkmatig over de poelie lopen, zonder naar de ene of de andere kant te glijden. - - -Als de riem niet gecentreerd is op de poelie, moet u mogelijk de poeliepositie aanpassen of controleren of de onderdelen van de motorkop goed zijn uitgelijnd. De riem moet recht langs de middengroef van de poelie lopen. - - - -De riem moet gecentreerd zijn op de poelie en gecentreerd blijven gedurende het volledige bewegingsbereik. Er mag geen zichtbare afwijking of verkeerde uitlijning zijn. - - - - -## Verificatiechecklist - -Controleer na het voltooien van de spanningsafstelling het volgende: - -- [ ] De stelbout is met de hand tot een comfortabel niveau aangedraaid -- [ ] De lineaire railschuif beweegt soepel en zonder vastlopen -- [ ] De riem houdt contact met alle drie de lagers aan beide zijden van de motorkop -- [ ] De riem is gecentreerd op de poelie -- [ ] Alle componenten blijven tijdens het volledige bewegingsbereik goed uitgelijnd - - -Als een van deze controles mislukt, moet u mogelijk de spanbout iets aanpassen of controleren of alle componenten correct zijn gemonteerd. De riemspanning moet voldoende zijn om contact te houden met alle lagers en toch een soepele beweging mogelijk te maken. - - -## Volgende stappen - -Nu de riem goed is gespannen en alle componenten zijn gecontroleerd, gaat u verder met de elektronica-assemblage om de OSSM-besturingskaart te monteren en de actuatorassemblage te voltooien. - -[← Motorkap](/ossm/build/motor-cover) · [Volgende: Elektronica →](/ossm/build/electronics) diff --git a/content/docs/ossm/build/bill-of-materials.de.mdx b/content/docs/ossm/build/bill-of-materials.de.mdx deleted file mode 100644 index 7928809..0000000 --- a/content/docs/ossm/build/bill-of-materials.de.mdx +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Stückliste -description: Gekaufte Komponenten für den offiziellen Standardaufbau des OSSM. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-1.1_purchasing-parts */} - -## Gekaufte Komponenten - -Diese Liste gilt für die offizielle Standardkonfiguration, die in diesem Handbuch beschrieben wird. - -| Komponente | Standardspezifikation | Menge | -| --- | --- | ---: | -| Integrierter Servomotor | NEMA 23, 57AIM30-Klasse, 100 W | 1 | -| OSSM-Steuerplatine | Offizielle 24-V-OSSM-Platine | 1 | -| Controller | Offizielle kabelgebundene Fernbedienung oder RADR | 1 | -| Zahnriemenscheibe | GT2, 20 Zähne, 8 mm Bohrung, für einen 10 mm breiten Riemen | 1 | -| Zahnriemen | GT2, 10 mm breit, mindestens 500 mm lang | 1 | -| Lager | MR115, 5 × 11 × 4 mm | 6 | -| Stromversorgung | Sicherheitszertifiziert, vollständig geschlossen, 24 V DC, 5 A | 1 | -| Linearschiene | 350 mm Schiene mit Schlitten | 1 | -| Metrische Hardware | M3- und M5-Schrauben, Muttern und Unterlegscheiben, für jede Stufe aufgeführt | 1 Satz | -| Motorverkabelung | Offizielle Stromkabel und vierpolige Datenkabel | 1 Satz | - - - ![Integrierter NEMA 23-Servomotor mit Kabelstecker](./assets/legacy/legacy_assembly_instructions_IHS57-30-18.webp) - - - - Verwenden Sie ein für Ihre Region geeignetes, sicherheitszertifiziertes Netzteil. Das Netzteil muss vollständig gekapselt sein; lassen Sie die Netzklemmen nicht freiliegen. - - -Für die Grenzwerte der Steckverbinder und Details zur Platine verwenden Sie die [OSSM-Entwicklerreferenz](https://dev.researchanddesire.com/ossm/hardware/pcb/introduction). - - - Überprüfen Sie Motor, Steuerplatine, Stromversorgung, Riemenscheibenbohrung, Riemenbreite und Schienenlänge, bevor Sie die gedruckten Teile öffnen oder zusammenbauen. - - -[← Werkzeuge und Teile](/ossm/build/tools-and-parts) · [Weiter: Gedruckte Teile →](/ossm/build/printed-parts) diff --git a/content/docs/ossm/build/bill-of-materials.fr.mdx b/content/docs/ossm/build/bill-of-materials.fr.mdx deleted file mode 100644 index 9bd7b1f..0000000 --- a/content/docs/ossm/build/bill-of-materials.fr.mdx +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Nomenclature -description: Composants achetés pour la configuration OSSM standard officielle. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-1.1_purchasing-parts */} - -## Composants achetés - -Cette liste concerne la configuration standard officielle décrite par ce guide. - -| Composant | Spécification standard | Quantité | -| --- | --- | ---: | -| Servomoteur intégré | NEMA 23, classe 57AIM30, 100 W | 1 | -| Carte de commande OSSM | PCB OSSM officiel 24 V | 1 | -| Contrôleur | Télécommande filaire officielle ou RADR | 1 | -| Poulie dentée | GT2, 20 dents, alésage 8 mm, pour une courroie de 10 mm de large | 1 | -| Courroie crantée | GT2, 10 mm de large, au moins 500 mm de long | 1 | -| Roulements | MR115, 5 × 11 × 4 mm | 6 | -| Alimentation | Certifiée conforme aux normes de sécurité, entièrement fermée, 24 V DC, 5 A | 1 | -| Rail linéaire | Rail de 350 mm avec chariot | 1 | -| Quincaillerie métrique | Boulons, écrous et rondelles M3 et M5 répertoriés pour chaque étape | 1 ensemble | -| Câblage du moteur | Câbles d’alimentation officiels et câbles de données à quatre broches | 1 ensemble | - - - ![Servomoteur intégré NEMA 23 avec connecteur de câblage](./assets/legacy/legacy_assembly_instructions_IHS57-30-18.webp) - - - - Utilisez une alimentation électrique certifiée conforme aux normes de sécurité et adaptée à votre région. L’alimentation électrique doit être entièrement fermée ; ne laissez pas les bornes secteur exposées. - - -Pour connaître les limites des connecteurs et les détails de la carte, utilisez la [référence pour les développeurs OSSM](https://dev.researchanddesire.com/ossm/hardware/pcb/introduction). - - - Vérifiez le moteur, la carte de commande, l'alimentation électrique, l'alésage de la poulie, la largeur de la courroie et la longueur du rail avant d'ouvrir ou d'assembler les pièces imprimées. - - -[← Outils et pièces](/ossm/build/tools-and-parts) · [Suivant : Pièces imprimées →](/ossm/build/printed-parts) diff --git a/content/docs/ossm/build/bill-of-materials.mdx b/content/docs/ossm/build/bill-of-materials.mdx deleted file mode 100644 index 9725bdd..0000000 --- a/content/docs/ossm/build/bill-of-materials.mdx +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Bill of Materials -description: Purchased components for the official standard OSSM build. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-1.1_purchasing-parts */} - -## Purchased components - -This list is for the official standard configuration described by this guide. - -| Component | Standard specification | Quantity | -| --- | --- | ---: | -| Integrated servo motor | NEMA 23, 57AIM30 class, 100 W | 1 | -| OSSM control board | Official 24 V OSSM PCB | 1 | -| Controller | Official wired remote or RADR | 1 | -| Timing pulley | GT2, 20 tooth, 8 mm bore, for 10 mm belt | 1 | -| Timing belt | GT2, 10 mm wide, at least 500 mm long | 1 | -| Bearings | MR115, 5 × 11 × 4 mm | 6 | -| Power supply | Safety-certified, fully enclosed, 24 V DC, 5 A | 1 | -| Linear rail | 350 mm rail with carriage | 1 | -| Metric hardware | M3 and M5 bolts, nuts, and washers listed by each stage | 1 set | -| Motor wiring | Official power and four-pin data cables | 1 set | - - - ![NEMA 23 integrated servo motor with wiring connector](./assets/legacy/legacy_assembly_instructions_IHS57-30-18.webp) - - - - Use a safety-certified power supply appropriate for your region. The power supply must be fully enclosed; do not leave mains terminals exposed. - - -For connector limits and board details, use the [OSSM developer reference](https://dev.researchanddesire.com/ossm/hardware/pcb/introduction). - - - Confirm the motor, control board, power supply, pulley bore, belt width, and rail length before opening or assembling the printed parts. - - -[← Tools and parts](/ossm/build/tools-and-parts) · [Next: Printed parts →](/ossm/build/printed-parts) diff --git a/content/docs/ossm/build/bill-of-materials.nl.mdx b/content/docs/ossm/build/bill-of-materials.nl.mdx deleted file mode 100644 index 8b85b25..0000000 --- a/content/docs/ossm/build/bill-of-materials.nl.mdx +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Stuklijst -description: Gekochte onderdelen voor de officiële standaard-OSSM-configuratie. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-1.1_purchasing-parts */} - -## Gekochte onderdelen - -Deze lijst geldt voor de officiële standaardconfiguratie die in deze handleiding wordt beschreven. - -| Onderdeel | Standaardspecificatie | Hoeveelheid | -| --- | --- | ---: | -| Geïntegreerde servomotor | NEMA 23, 57AIM30-klasse, 100 W | 1 | -| OSSM-besturingskaart | Officiële 24 V OSSM-printplaat | 1 | -| Controller | Officiële bedrade afstandsbediening of RADR | 1 | -| Tandriempoelie | GT2, 20 tanden, boring van 8 mm, voor een 10 mm brede riem | 1 | -| Tandriem | GT2, 10 mm breed, minimaal 500 mm lang | 1 | -| Lagers | MR115, 5 × 11 × 4 mm | 6 | -| Voeding | Veiligheidsgecertificeerd, volledig gesloten, 24 V DC, 5 A | 1 | -| Lineaire rail | Rail van 350 mm met slede | 1 | -| Metrische hardware | M3- en M5-bouten, moeren en ringen die per fase zijn vermeld | 1 set | -| Motorbedrading | Officiële voedingskabels en vierpolige datakabels | 1 set | - - - ![Geïntegreerde NEMA 23-servomotor met kabelconnector](./assets/legacy/legacy_assembly_instructions_IHS57-30-18.webp) - - - - Gebruik een veiligheidsgecertificeerde voeding die geschikt is voor uw regio. De voeding moet volledig omsloten zijn; laat de netklemmen niet bloot liggen. - - -Voor de grenswaarden van de connectoren en details van de printplaat gebruikt u de [OSSM-ontwikkelaarsreferentie](https://dev.researchanddesire.com/ossm/hardware/pcb/introduction). - - - Controleer de motor, de besturingskaart, de voeding, de poelieboring, de riembreedte en de raillengte voordat u de gedrukte onderdelen opent of monteert. - - -[← Gereedschappen en onderdelen](/ossm/build/tools-and-parts) · [Volgende: Gedrukte onderdelen →](/ossm/build/printed-parts) diff --git a/content/docs/ossm/build/electronics.de.mdx b/content/docs/ossm/build/electronics.de.mdx deleted file mode 100644 index c575632..0000000 --- a/content/docs/ossm/build/electronics.de.mdx +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: "9. Elektronikmontage" -description: "Montieren Sie die OSSM-Steuerplatine an ihrer Rahmenhalterung und befestigen Sie die Elektronikabdeckung" ---- - -Die Elektronikmontage umfasst die Montage der OSSM-Steuerplatine an ihrer Rahmenhalterung und die Befestigung der Schutzabdeckung. Dieser Schritt schützt die Steuerplatine und bereitet sie für die Verkabelung im nächsten Abschnitt vor. - -## Erforderliche Komponenten und Werkzeuge - -### Komponenten - -| Komponente | Anzahl | Spezifikation / Hinweise | -| ------------------------- | ----- | ------------------------------------------ | -| OSSM-Steuerplatine | 1 | Die Elektronikplatine | -| PCB-Gehäuse | 1 | Die Halterung für die Steuerplatine | -| M3-Schrauben (Platinenmontage) | 2 | Typischerweise 8 bis 15 mm lang | -| Abdeckung (Elektronikplatine) | 1 | Schutzabdeckung für die Elektronikplatine | -| M3-Schrauben (Elektronikabdeckung) | 4 | Typischerweise 8 bis 15 mm lang | - -### Werkzeuge - -| Werkzeug | Anzahl | Spezifikation / Hinweise | -| ---------- | ----- | --------------------- | -| 2,5-mm-Inbusschlüssel | 1 | Zur Montage der M3-Schrauben | - - - Die M3-Schrauben sowohl für die Platinenhalterung als auch für die Abdeckung können zwischen 8 mm und 15 mm lang sein. Wählen Sie eine Länge, die eine sichere Montage ermöglicht, ohne übermäßig hervorzustehen. - - -## Schritt-für-Schritt-Montage - - - - Nehmen Sie die OSSM-Steuerplatine und die PCB-Extrusionsrahmenhalterung. - -Die Platine gleitet unter einen kleinen Vorsprung an der Halterung. Da sie fest sitzt, müssen Sie sie möglicherweise vorsichtig an ihren Platz drücken. - - - Wenn sich die Platine nicht leicht einschieben lässt, prüfen Sie, ob sie richtig ausgerichtet ist. Der Vorsprung an der Halterung sollte in das entsprechende Merkmal auf der Platine eingreifen. - - - Die Steuerplatine sitzt vollständig unter dem Vorsprung an der Halterung und liegt bündig auf der Montagefläche auf. - - - - Befestigen Sie die Steuerplatine mit den beiden M3-Schrauben an ihrer Halterung. - -Ziehen Sie sie gerade so fest an, dass die Platine an Ort und Stelle bleibt und sich nicht bewegen kann. - - - Ziehen Sie die Schrauben nicht zu fest an. Ein zu hohes Drehmoment kann die Leiterplatte beschädigen oder die Gewinde in der Halterung ausreißen. Die Platine sollte sicher sitzen, aber keiner übermäßigen Belastung ausgesetzt sein. - - - Die Steuerplatine ist sicher montiert und bewegt sich bei leichtem Druck nicht; beide M3-Schrauben sind gleichmäßig angezogen. - - - - Platzieren Sie die Abdeckung (Elektronikplatine) über der Baugruppe. - -Stellen Sie sicher, dass die Abdeckung richtig an den Befestigungslöchern ausgerichtet ist und bündig auf der Halterung sitzt. - - - Die Abdeckung schützt die Steuerplatine vor Staub, Schmutz und versehentlichem Kontakt während des Betriebs. - - - - Befestigen Sie die Abdeckung mit den verbleibenden vier M3-Schrauben. - -Ziehen Sie die Schrauben gleichmäßig an, um sicherzustellen, dass die Abdeckung flach sitzt und ausreichend Schutz bietet. - - - Ziehen Sie die Schrauben über Kreuz an (zuerst an den gegenüberliegenden Ecken), um einen gleichmäßigen Druck zu gewährleisten und ein Verziehen der Abdeckung zu verhindern. - - - Die Abdeckung ist sicher befestigt; alle vier M3-Schrauben sind gleichmäßig angezogen. Die Abdeckung sollte bündig an der Halterung anliegen, ohne Lücken oder Fehlausrichtung. - - - - -## Nächste Schritte - -Nachdem die Elektronikplatine montiert und abgedeckt ist, können Sie mit der Verkabelung der Stromversorgungs- und Datenkabel im nächsten Abschnitt der Bauanleitung fortfahren. - -[← Riemenspannung](/ossm/build/belt-tension) · [Weiter: Verkabelung →](/ossm/build/wiring) diff --git a/content/docs/ossm/build/electronics.fr.mdx b/content/docs/ossm/build/electronics.fr.mdx deleted file mode 100644 index 78af632..0000000 --- a/content/docs/ossm/build/electronics.fr.mdx +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: "9. Assemblage électronique" -description: "Montez la carte de commande OSSM sur son support de cadre et fixez le couvercle de l’électronique." ---- - -L'assemblage électronique implique le montage de la carte de commande OSSM sur son support de cadre et la fixation du capot de protection. Cette étape protège la carte de commande et la prépare au câblage dans la section suivante. - -## Composants et outils requis - -### Composants - -| Composant | Qté | Spécification / Remarques | -| ------------------------- | ----- | ------------------------------------------ | -| Carte de commande OSSM | 1 | Le PCB électronique | -| Boîtier de PCB | 1 | Le support de la carte de commande | -| Boulons M3 (montage de la carte) | 2 | Généralement de 8 mm à 15 mm de longueur | -| Couvercle (carte électronique) | 1 | Couvercle de protection pour la carte électronique | -| Boulons M3 (couvercle de l’électronique) | 4 | Généralement de 8 mm à 15 mm de longueur | - -### Outils - -| Outil | Qté | Spécification / Remarques | -| ---------- | ----- | --------------------- | -| Clé hexagonale de 2,5 mm | 1 | Pour monter les boulons M3 | - - - Les boulons M3 pour le support de carte et le couvercle peuvent avoir une longueur comprise entre 8 mm et 15 mm. Choisissez une longueur permettant une fixation solide sans dépasser excessivement. - - -## Assemblage étape par étape - - - - Prenez la carte de commande OSSM et le support de PCB pour cadre en profilé extrudé. - -La carte glisse sous une petite saillie du support. L’emboîtement est serré ; vous devrez donc peut-être la pousser doucement pour la mettre en place. - - - Si la carte ne glisse pas facilement, vérifiez qu’elle est correctement orientée. La saillie du support doit s’engager dans l’élément correspondant de la carte. - - - La carte de commande est entièrement placée sous la saillie du support et affleure la surface de montage. - - - - Utilisez les deux boulons M3 pour fixer la carte de commande à son support. - -Serrez-les juste assez pour maintenir la carte en place et l’empêcher de bouger. - - - Ne serrez pas trop les boulons. Un couple excessif peut endommager le PCB ou arracher les filetages du support. La carte doit être solidement fixée, sans être soumise à des contraintes excessives. - - - La carte de commande est solidement montée et ne bouge pas lorsqu’on appuie doucement. Les deux boulons M3 sont serrés uniformément. - - - - Placez le couvercle (carte électronique) sur l’assemblage. - -Assurez-vous que le couvercle s’aligne correctement avec les trous de montage et qu’il affleure le support. - - - Le couvercle protège la carte de commande de la poussière, des débris et des contacts accidentels pendant le fonctionnement. - - - - Utilisez les quatre boulons M3 restants pour fixer le couvercle. - -Serrez les boulons uniformément pour garantir que le couvercle repose à plat et offre une protection adéquate. - - - Serrez les boulons en croix (les coins opposés en premier) pour assurer une pression uniforme et empêcher le couvercle de se déformer. - - - Le couvercle est solidement fixé avec les quatre boulons M3 serrés uniformément. Le couvercle doit affleurer le support, sans espace ni désalignement. - - - - -## Prochaines étapes - -Une fois la carte électronique montée et recouverte, vous êtes prêt à raccorder les câbles d’alimentation et de données dans la section suivante du guide de construction. - -[← Tension de courroie](/ossm/build/belt-tension) · [Suivant : Câblage →](/ossm/build/wiring) diff --git a/content/docs/ossm/build/electronics.mdx b/content/docs/ossm/build/electronics.mdx deleted file mode 100644 index 927aec9..0000000 --- a/content/docs/ossm/build/electronics.mdx +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: "9. Electronics Assembly" -description: "Mount the OSSM control board to its frame mount and secure the electronics cover" ---- - -The electronics assembly involves mounting the OSSM Control Board to its frame mount and securing the protective cover. This step protects the control board and prepares it for wiring in the next section. - -## Required Components and Tools - -### Components - -| Component | Count | Specification / Notes | -| ------------------------- | ----- | ------------------------------------------ | -| OSSM Control Board | 1 | The electronics PCB | -| PCB Enclosure | 1 | The mount for the control board | -| M3 Bolts (Board Mount) | 2 | Typically 8mm to 15mm length | -| Cover (Electronics Board) | 1 | Protective cover for the electronics board | -| M3 Bolts (Elec. Cover) | 4 | Typically 8mm to 15mm length | - -### Tools - -| Tool | Count | Specification / Notes | -| ---------- | ----- | --------------------- | -| 2.5 mm Hex | 1 | To fit the M3 bolts | - - - The M3 bolts for both the board mount and cover can be between 8mm and 15mm in length. Choose a length that provides secure mounting without protruding excessively. - - -## Step-by-Step Assembly - - - - Take the OSSM Control Board and the PCB Extrusion Frame Mount. - - The board will slide under a small protrusion on the mount. It's a tight fit, so you may need to gently push it into place. - - - If the board doesn't slide in easily, check that it's oriented correctly. The protrusion on the mount should engage with the corresponding feature on the board. - - - The control board is fully seated under the protrusion on the mount and sits flush against the mounting surface. - - - - Use the two M3 bolts to secure the control board to its mount. - - Tighten them just enough to hold the board in place and prevent it from moving. - - - Do not overtighten the bolts. Excessive torque can damage the PCB or strip the threads in the mount. The board should be secure but not under excessive stress. - - - The control board is securely mounted and does not move when gently pressed. Both M3 bolts are tightened evenly. - - - - Place the Cover (Electronics Board) over the assembly. - - Ensure the cover aligns properly with the mounting holes and sits flush on the mount. - - - The cover protects the control board from dust, debris, and accidental contact during operation. - - - - Use the remaining four M3 bolts to secure the cover. - - Tighten the bolts evenly to ensure the cover sits flat and provides proper protection. - - - Tighten the bolts in a cross pattern (opposite corners first) to ensure even pressure and prevent the cover from warping. - - - The cover is securely attached with all four M3 bolts tightened evenly. The cover should sit flush against the mount with no gaps or misalignment. - - - - -## Next Steps - -With the electronics board mounted and covered, you're ready to proceed with wiring the voltage and data cables in the next section of the build guide. - -[← Belt tension](/ossm/build/belt-tension) · [Next: Wiring →](/ossm/build/wiring) diff --git a/content/docs/ossm/build/electronics.nl.mdx b/content/docs/ossm/build/electronics.nl.mdx deleted file mode 100644 index cea3a9e..0000000 --- a/content/docs/ossm/build/electronics.nl.mdx +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: "9. Elektronicamontage" -description: "Monteer de OSSM-besturingskaart op de framehouder en zet de elektronicakap vast" ---- - -De elektronicamontage omvat het monteren van de OSSM-besturingskaart op de framehouder en het bevestigen van de beschermkap. Deze stap beschermt de besturingskaart en bereidt deze voor op de bedrading in het volgende gedeelte. - -## Vereiste componenten en gereedschappen - -### Componenten - -| Onderdeel | Aantal | Specificatie / Opmerkingen | -| ------------------------- | ----- | ------------------------------------------ | -| OSSM-besturingskaart | 1 | De elektronicaprintplaat | -| PCB-behuizing | 1 | De houder voor de besturingskaart | -| M3-bouten (kaartmontage) | 2 | Gewoonlijk 8 mm tot 15 mm lang | -| Afdekking (elektronicakaart) | 1 | Beschermende afdekking voor de elektronicaprintplaat | -| M3-bouten (elektronicakap) | 4 | Gewoonlijk 8 mm tot 15 mm lang | - -### Gereedschap - -| Gereedschap | Aantal | Specificatie / Opmerkingen | -| ---------- | ----- | --------------------- | -| Inbussleutel van 2,5 mm | 1 | Voor montage van de M3-bouten | - - - De M3-bouten voor zowel de kaartmontage als de afdekking kunnen tussen 8 mm en 15 mm lang zijn. Kies een lengte die een veilige montage mogelijk maakt zonder te veel uit te steken. - - -## Stapsgewijze montage - - - - Neem de OSSM-besturingskaart en de PCB-extrusieframebevestiging. - -De kaart schuift onder een klein uitsteeksel op de houder. De passing is krap, dus mogelijk moet u de kaart voorzichtig op zijn plaats duwen. - - - Als de kaart niet gemakkelijk naar binnen schuift, controleer dan of deze goed is georiënteerd. Het uitsteeksel op de houder moet in het bijbehorende onderdeel van de kaart vallen. - - - De besturingskaart zit volledig onder het uitsteeksel van de houder en ligt vlak tegen het montageoppervlak. - - - - Gebruik de twee M3-bouten om de besturingskaart aan de houder te bevestigen. - -Draai ze net genoeg vast om de kaart op zijn plaats te houden en te voorkomen dat deze beweegt. - - - Draai de bouten niet te vast. Overmatig koppel kan de printplaat beschadigen of de schroefdraad in de houder doldraaien. De kaart moet stevig vastzitten, maar mag niet onder overmatige spanning staan. - - - De besturingskaart is stevig gemonteerd en beweegt niet als er zachtjes op wordt gedrukt; beide M3-bouten zijn gelijkmatig aangedraaid. - - - - Plaats de afdekking (elektronicakaart) over het geheel. - -Zorg ervoor dat de afdekking goed uitgelijnd is met de montagegaten en vlak op de houder zit. - - - De afdekking beschermt de besturingskaart tegen stof, vuil en onbedoeld contact tijdens het gebruik. - - - - Gebruik de overige vier M3-bouten om de afdekking vast te zetten. - -Draai de bouten gelijkmatig aan om ervoor te zorgen dat de afdekking plat ligt en goede bescherming biedt. - - - Draai de bouten kruislings aan (eerst de tegenoverliggende hoeken) om een gelijkmatige druk te garanderen en te voorkomen dat de afdekking kromtrekt. - - - De afdekking is stevig bevestigd en alle vier de M3-bouten zijn gelijkmatig vastgedraaid. De afdekking moet vlak tegen de houder zitten, zonder openingen of scheefstand. - - - - -## Volgende stappen - -Nu de elektronicakaart is gemonteerd en afgedekt, bent u klaar om verder te gaan met het aansluiten van de voedings- en datakabels in het volgende gedeelte van de bouwhandleiding. - -[← Riemspanning](/ossm/build/belt-tension) · [Volgende: Bedrading →](/ossm/build/wiring) diff --git a/content/docs/ossm/build/end-effector.de.mdx b/content/docs/ossm/build/end-effector.de.mdx deleted file mode 100644 index 76ea458..0000000 --- a/content/docs/ossm/build/end-effector.de.mdx +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: "2. Endeffektor" -description: "Installieren Sie den Endeffektor an der Linearschiene, um den Schlitten zu sichern und die Schienenmontage abzuschließen" ---- - -Der Endeffektor ist das Gewinde-Endstück, das an der Linearschiene montiert wird. Er bietet einen sicheren Befestigungspunkt für Zubehör und verhindert, dass der Schlitten während des Betriebs von der Schiene rutscht. - -## Erforderliche Komponenten und Werkzeuge - -### Komponenten - -| Komponente | Anzahl | Spezifikation / Hinweise | -|-----------|-------|----------------------| -| Endeffektor | 1 | Das Gewinde-Endstück für die Schiene | -| M3-Schrauben, 8 mm | 2 | Zur Befestigung des Endeffektors an der Schiene | -| Muttern (für M3-Schrauben, 8 mm) | 2 | Für die M3-Schrauben, 8 mm | -| Gummi-Endanschlag | 1 | Wird von der Linearschiene entfernt | - -### Werkzeuge - -| Werkzeug | Anzahl | Spezifikation / Hinweise | -|------|-------|----------------------| -| 2,5-mm-Sechskantschlüssel | 1 | Zum Anziehen der M3-Schrauben | -| Kleiner Schlitzschraubendreher | 1 | Oder ein gleichwertiges Werkzeug zum Festhalten der Muttern | - - -Die Montage des Endeffektors sollte erfolgen, nachdem der hintere Spanner montiert wurde. Damit ist die grundlegende Montage der Linearschiene abgeschlossen, bevor Sie mit den anderen Komponenten fortfahren. - - -## Schritt-für-Schritt-Montage - - - -Entfernen Sie den verbleibenden kleinen Gummi-Endanschlag von der Linearschiene und legen Sie ihn beiseite. - - -Die Linearschiene sollte nun an beiden Enden ohne Endanschlag sein: An einem Ende befindet sich der hintere Spanner, und am gegenüberliegenden Ende ist sie für den Endeffektor bereit. - - - - -Richten Sie die Vertiefungen des Endeffektors an den Vertiefungen der Linearschiene aus, bis die Schraubenlöcher fluchten. - - -Die Vertiefungen am Endeffektor und an der Schiene erleichtern die korrekte Ausrichtung. Prüfen Sie, ob die Löcher perfekt fluchten, bevor Sie die Schrauben einsetzen. - - - - -Führen Sie die beiden M3-Schrauben (8 mm) von einer Seite durch die Bohrungen des Endeffektors. - -Setzen Sie auf der gegenüberliegenden Seite jeweils eine passende M3-Mutter auf die Schrauben. - -Drehen Sie die Baugruppe um, halten Sie die Muttern mit dem kleinen Schlitzschraubendreher oder einem gleichwertigen Werkzeug fest und ziehen Sie die Schrauben mit dem 2,5-mm-Sechskantschlüssel an. - - -Die Schrauben müssen nicht übermäßig fest angezogen werden, sondern nur so fest, dass der Endeffektor sicher an der Schiene gehalten wird. Zu starkes Anziehen kann Komponenten beschädigen oder die Gewinde ausreißen. - - - -Der Endeffektor sollte mit beiden angezogenen Schrauben sicher an der Schiene befestigt sein. Damit ist die Schiene davor geschützt, dass der Schlitten während des Betriebs abrutscht. - - - - -## Nächste Schritte - -Mit installiertem Endeffektor ist die Montage der Linearschiene abgeschlossen. Installieren Sie als Nächstes den vorderen Spanner, um die feste Hubbegrenzung einzustellen. - - -[← Hinterer Spanner](/ossm/build/rear-tensioner) · [Weiter: Vorderer Spanner →](/ossm/build/front-tensioner) diff --git a/content/docs/ossm/build/end-effector.fr.mdx b/content/docs/ossm/build/end-effector.fr.mdx deleted file mode 100644 index dcf0017..0000000 --- a/content/docs/ossm/build/end-effector.fr.mdx +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: "2. Effecteur final" -description: "Installez l’effecteur final sur le rail linéaire pour retenir le coulisseau sur le rail et terminer l’assemblage du rail" ---- - -L’effecteur final est l’embout fileté qui se monte sur le rail linéaire. Il fournit un point de fixation sûr pour les accessoires et empêche le coulisseau de sortir du rail pendant le fonctionnement. - -## Composants et outils requis - -### Composants - -| Composant | Quantité | Spécifications / remarques | -|-----------|-------|----------------------| -| Effecteur final | 1 | Embout fileté pour le rail | -| Boulons M3 de 8 mm | 2 | Pour fixer l’effecteur final au rail | -| Écrous (pour boulons M3 de 8 mm) | 2 | Pour les boulons M3 de 8 mm | -| Butée d’extrémité en caoutchouc | 1 | À retirer du rail linéaire | - -### Outils - -| Outil | Quantité | Spécifications / remarques | -|------|-------|----------------------| -| Clé hexagonale de 2,5 mm | 1 | Pour les boulons M3 | -| Petit tournevis plat | 1 | Ou outil équivalent pour maintenir les écrous en place | - - -L’installation de l’effecteur final doit être effectuée après celle du tendeur arrière. Cette étape termine l’assemblage de base du rail linéaire avant de passer aux autres composants. - - -## Assemblage étape par étape - - - -Retirez la petite butée d’extrémité en caoutchouc restante du rail linéaire et mettez-la de côté. - - -Les deux butées d’extrémité doivent maintenant être retirées du rail linéaire : le tendeur arrière se trouve à une extrémité et l’autre extrémité est prête à recevoir l’effecteur final. - - - - -Alignez les encoches de l’effecteur final avec celles du rail linéaire jusqu’à ce que les trous de vis coïncident. - - -Les encoches de l’effecteur final et du rail facilitent l’alignement. Vérifiez que les trous coïncident parfaitement avant d’insérer les boulons. - - - - -Insérez les deux boulons M3 de 8 mm dans les trous, depuis un côté de l’effecteur final. - -Placez un écrou M3 correspondant sur chaque boulon, de l’autre côté. - -Retournez l’assemblage, maintenez les écrous en place avec le petit tournevis plat ou un outil équivalent, et serrez les boulons avec la clé hexagonale de 2,5 mm. - - -Les boulons n’ont pas besoin d’être serrés excessivement : serrez-les juste assez pour maintenir solidement l’effecteur final sur le rail. Un serrage excessif pourrait endommager les composants ou arracher les filetages. - - - -L’effecteur final doit être solidement fixé au rail avec les deux boulons serrés. Le coulisseau ne peut désormais pas sortir du rail pendant le fonctionnement. - - - - -## Prochaines étapes - -Une fois l’effecteur final installé, l’assemblage du rail linéaire est terminé. Installez ensuite le tendeur avant pour définir la butée fixe de la course. - - -[← Tendeur arrière](/ossm/build/rear-tensioner) · [Suivant : Tendeur avant →](/ossm/build/front-tensioner) diff --git a/content/docs/ossm/build/end-effector.mdx b/content/docs/ossm/build/end-effector.mdx deleted file mode 100644 index 11f4070..0000000 --- a/content/docs/ossm/build/end-effector.mdx +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: "2. End Effector" -description: "Install the end effector on the linear rail to secure the slide and complete the rail assembly" ---- - -The end effector is the threaded end piece that mounts to the linear rail, providing a secure attachment point for accessories and preventing the slide from coming off the rail during operation. - -## Required Components and Tools - -### Components - -| Component | Count | Specification / Notes | -|-----------|-------|----------------------| -| End Effector | 1 | The threaded end piece for the rail | -| M3 8 mm Bolts | 2 | Used to secure the end effector to the rail | -| Nuts (for M3 8mm bolts) | 2 | For the M3 8 mm bolts | -| Rubber End Stop | 1 | To be removed from the linear rail | - -### Tools - -| Tool | Count | Specification / Notes | -|------|-------|----------------------| -| 2.5 mm Hex | 1 | To fit the M3 bolt | -| Small Flathead Screwdriver | 1 | Or equivalent tool to help hold nuts in place | - - -The end effector installation should be performed after the rear tensioner is installed. This completes the basic linear rail assembly before moving on to other components. - - -## Step-by-Step Assembly - - - -Remove the remaining small rubber end stop from the linear rail and set it aside. - - -The linear rail should now have both end stops removed, with the rear tensioner on one end and ready for the end effector on the opposite end. - - - - -Align the end effector's indentations with the indentations on the linear rail until the screw holes line up. - - -The indentations on both the end effector and rail help ensure proper alignment. Take a moment to verify that the holes are perfectly aligned before inserting the bolts. - - - - -Insert the two M3 8 mm bolts through the holes from one side of the end effector. - -Place a corresponding M3 nut on each bolt on the opposite side. - -Flip the assembly, hold the nuts in place with the small flathead screwdriver or equivalent tool, and tighten the bolts with the 2.5 mm hex tool. - - -The bolts do not need to be excessively tight, just snug enough to hold the end effector securely to the rail. Overtightening could damage the components or strip the threads. - - - -The end effector should be securely mounted to the rail with both bolts tightened. The rail is now safe from the slide coming off during operation. - - - - -## Next Steps - -With the end effector installed, the linear rail assembly is complete. Proceed to install the front tensioner to set the hard limit for the stroke. - - -[← Rear tensioner](/ossm/build/rear-tensioner) · [Next: Front tensioner →](/ossm/build/front-tensioner) diff --git a/content/docs/ossm/build/end-effector.nl.mdx b/content/docs/ossm/build/end-effector.nl.mdx deleted file mode 100644 index 0aba9c0..0000000 --- a/content/docs/ossm/build/end-effector.nl.mdx +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: "2. Eindeffector" -description: "Installeer de eindeffector op de lineaire rail om de slede op de rail te houden en de railmontage te voltooien" ---- - -De eindeffector is het van schroefdraad voorziene eindstuk dat op de lineaire rail wordt gemonteerd. Het biedt een veilig bevestigingspunt voor accessoires en voorkomt dat de slede tijdens gebruik van de rail losraakt. - -## Vereiste onderdelen en gereedschappen - -### Componenten - -| Onderdeel | Aantal | Specificatie / opmerkingen | -|-----------|-------|----------------------| -| Eindeffector | 1 | Het van schroefdraad voorziene eindstuk voor de rail | -| M3-bouten van 8 mm | 2 | Om de eindeffector aan de rail te bevestigen | -| Moeren (voor M3-bouten van 8 mm) | 2 | Voor de M3-bouten van 8 mm | -| Rubberen eindstop | 1 | Moet van de lineaire rail worden verwijderd | - -### Gereedschap - -| Gereedschap | Aantal | Specificatie / opmerkingen | -|------|-------|----------------------| -| Inbussleutel van 2,5 mm | 1 | Voor de M3-bouten | -| Kleine platte schroevendraaier | 1 | Of een gelijkwaardig hulpmiddel om de moeren op hun plaats te houden | - - -De eindeffector moet worden geïnstalleerd nadat de achterste spanner is gemonteerd. Hiermee is de basismontage van de lineaire rail voltooid voordat u verdergaat met andere onderdelen. - - -## Stapsgewijze montage - - - -Verwijder de resterende kleine rubberen eindstop van de lineaire rail en leg deze opzij. - - -Beide eindstoppen moeten nu van de lineaire rail verwijderd zijn: aan het ene uiteinde zit de achterspanner en het andere uiteinde is klaar voor de eindeffector. - - - - -Lijn de inkepingen van de eindeffector uit met die op de lineaire rail totdat de schroefgaten uitgelijnd zijn. - - -De inkepingen op de eindeffector en de rail helpen bij een correcte uitlijning. Controleer of de gaten perfect uitgelijnd zijn voordat u de bouten plaatst. - - - - -Steek de twee M3-bouten van 8 mm vanaf één kant door de gaten in de eindeffector. - -Plaats aan de andere kant een bijpassende M3-moer op elke bout. - -Draai de assemblage om, houd de moeren op hun plaats met de kleine platte schroevendraaier of een gelijkwaardig hulpmiddel en draai de bouten vast met de inbussleutel van 2,5 mm. - - -De bouten hoeven niet extreem strak te worden aangedraaid; draai ze alleen zo vast dat de eindeffector stevig op de rail blijft zitten. Te strak aandraaien kan onderdelen beschadigen of de schroefdraad doldraaien. - - - -De eindeffector moet met beide vastgedraaide bouten stevig aan de rail zijn bevestigd. De slede kan nu tijdens gebruik niet van de rail lopen. - - - - -## Volgende stappen - -Nu de eindeffector is geïnstalleerd, is de montage van de lineaire rail voltooid. Ga verder met de installatie van de voorste spanner om de vaste slagbegrenzing in te stellen. - - -[← Achterste spanner](/ossm/build/rear-tensioner) · [Volgende: Voorste spanner →](/ossm/build/front-tensioner) diff --git a/content/docs/ossm/build/first-test.de.mdx b/content/docs/ossm/build/first-test.de.mdx deleted file mode 100644 index fe6d890..0000000 --- a/content/docs/ossm/build/first-test.de.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "11. Erster Test" -description: "Überprüfen Sie nach dem Zusammenbau die Referenzfahrt und Bewegung bei niedriger Geschwindigkeit." ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-12.0_initial_test */} - -## Vor dem Einschalten der Stromversorgung - -- Befestigen Sie den Aktuator an seiner Standardhalterung. -- Lassen Sie vor dem Endeffektor mindestens 200 mm freien Bewegungsweg. -- Überprüfen Sie jedes Befestigungselement, die Riemenausrichtung, jeden Spanner, jeden Stecker und jeden Stromanschluss. -- Halten Sie Hände, Haare, Kleidung, Werkzeuge und Kabel von beweglichen Teilen fern. -- Halten Sie die Stoppsteuerung in unmittelbarer Reichweite. - - - Testen Sie keinen ungesicherten Aktuator. Trennen Sie die Stromversorgung sofort, wenn die Bewegung in die falsche Richtung läuft, behindert oder instabil ist oder unerwartet viel Kraft entwickelt. - - -## Referenzfahrt testen - -1. Stellen Sie die Geschwindigkeit des Controllers auf null. -2. Schließen Sie die offizielle Kabelfernbedienung an oder schalten Sie einen geladenen RADR in der Nähe ein. -3. Schließen Sie die 24-V-Stromversorgung an. -4. Halten Sie Abstand und beobachten Sie die vollständige Referenzfahrt. -5. Trennen Sie die Stromversorgung, wenn sich der Schlitten einem Hindernis nähert, klemmt oder sich in die falsche Richtung bewegt. - -## Einen kurzen Hub testen - -1. Wählen Sie nach Abschluss der Referenzfahrt den einfachsten Bewegungsmodus. -2. Stellen Sie eine kurze Tiefe ein. -3. Erhöhen Sie die Geschwindigkeit nur so weit, dass sich die reibungslose Bewegung bestätigen lässt. -4. Betätigen Sie die Stoppsteuerung und prüfen Sie, ob sie die Bewegung anhält. -5. Trennen Sie die Stromversorgung und überprüfen Sie Riemen, Riemenscheibe, Befestigungselemente und Verkabelung noch einmal. - - - Der OSSM führt die Referenzfahrt in die richtige Richtung aus, bewegt sich reibungslos, ohne dass der Riemen überspringt oder scheuert, und stoppt sofort über die Steuerung. - - -Wenn eine Prüfung fehlschlägt, lesen Sie vor dem erneuten Einschalten der Stromversorgung die [Fehlerbehebung bei der Montage](/ossm/assembly-troubleshooting). - -[← Verkabelung](/ossm/build/wiring) · [Verwenden Sie Ihr OSSM →](https://docs.researchanddesire.com/ossm/get-started) diff --git a/content/docs/ossm/build/first-test.fr.mdx b/content/docs/ossm/build/first-test.fr.mdx deleted file mode 100644 index 20f9c67..0000000 --- a/content/docs/ossm/build/first-test.fr.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "11. Premier test" -description: "Vérifiez le référencement et le mouvement à basse vitesse après l’assemblage." ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-12.0_initial_test */} - -## Avant la mise sous tension - -- Fixez l’actionneur à son support standard. -- Laissez au moins 200 mm de course libre devant l’effecteur final. -- Vérifiez chaque élément de fixation, l’alignement de la courroie, le tendeur, le connecteur et la borne d’alimentation. -- Gardez les mains, les cheveux, les vêtements, les outils et les câbles éloignés des pièces mobiles. -- Gardez la commande d’arrêt à portée immédiate. - - - Ne testez pas un actionneur non fixé. Débranchez immédiatement l’alimentation si le mouvement s’inverse, est entravé, devient instable ou développe une force inattendue. - - -## Tester le référencement - -1. Réglez la vitesse du contrôleur à zéro. -2. Connectez la télécommande filaire officielle ou allumez un RADR chargé à proximité. -3. Connectez l’alimentation 24 V. -4. Tenez-vous à l’écart et observez l’intégralité du référencement. -5. Débranchez l’alimentation si le chariot se dirige vers un obstacle, se bloque ou se déplace dans la mauvaise direction. - -## Tester une course courte - -1. Une fois le référencement terminé, sélectionnez le mode de mouvement le plus simple. -2. Réglez une faible profondeur. -3. Augmentez la vitesse juste assez pour confirmer un mouvement fluide. -4. Actionnez la commande d’arrêt et vérifiez qu’elle immobilise le mouvement. -5. Débranchez l’alimentation et inspectez à nouveau la courroie, la poulie, les fixations et le câblage. - - - L’OSSM effectue le référencement dans la bonne direction, se déplace en douceur sans que la courroie saute ou frotte, et s’arrête immédiatement sur commande du contrôleur. - - -Si une vérification échoue, consultez [Dépannage de l’assemblage](/ossm/assembly-troubleshooting) avant de remettre sous tension. - -[← Câblage](/ossm/build/wiring) · [Utilisez votre OSSM →](https://docs.researchanddesire.com/ossm/get-started) diff --git a/content/docs/ossm/build/first-test.mdx b/content/docs/ossm/build/first-test.mdx deleted file mode 100644 index 25ad351..0000000 --- a/content/docs/ossm/build/first-test.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "11. First Test" -description: "Verify homing and motion at low speed after assembly." ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-12.0_initial_test */} - -## Before applying power - -- Secure the actuator to its standard mount. -- Leave at least 200 mm of clear travel in front of the end effector. -- Check every fastener, belt alignment, tensioner, connector, and power terminal. -- Keep hands, hair, clothing, tools, and cables away from moving parts. -- Put the stop control within immediate reach. - - - Do not test an unsecured actuator. Disconnect power immediately if motion is reversed, obstructed, unstable, or unexpectedly forceful. - - -## Test homing - -1. Set the controller speed to zero. -2. Connect the official wired remote, or power on a charged RADR nearby. -3. Connect the 24 V power supply. -4. Stand clear and watch the complete homing movement. -5. Disconnect power if the carriage moves toward an obstruction, binds, or moves in the wrong direction. - -## Test a short stroke - -1. After homing completes, select the simplest motion mode. -2. Set a short depth. -3. Increase speed only enough to confirm smooth motion. -4. Stop and verify the stop control halts motion. -5. Disconnect power and inspect the belt, pulley, fasteners, and wiring once more. - - - The OSSM homes in the correct direction, moves smoothly without belt skipping or rubbing, and stops immediately from the controller. - - -If any check fails, use [Assembly Troubleshooting](/ossm/assembly-troubleshooting) before applying power again. - -[← Wiring](/ossm/build/wiring) · [Use your OSSM →](https://docs.researchanddesire.com/ossm/get-started) diff --git a/content/docs/ossm/build/first-test.nl.mdx b/content/docs/ossm/build/first-test.nl.mdx deleted file mode 100644 index 75ed428..0000000 --- a/content/docs/ossm/build/first-test.nl.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "11. Eerste test" -description: "Controleer de homing en beweging op lage snelheid na montage." ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-12.0_initial_test */} - -## Voordat u de stroom inschakelt - -- Bevestig de actuator op de standaardbevestiging. -- Laat vóór de eindeffector minimaal 200 mm vrije bewegingsruimte over. -- Controleer elk bevestigingsmiddel, de riemuitlijning, de spanner, de connector en de stroomaansluiting. -- Houd handen, haar, kleding, gereedschap en kabels uit de buurt van bewegende onderdelen. -- Plaats de stopbediening binnen handbereik. - - - Test geen actuator die niet fysiek is vastgezet. Koppel de voeding onmiddellijk los als de beweging de verkeerde kant op gaat, wordt belemmerd of instabiel is, of onverwacht veel kracht ontwikkelt. - - -## Homing testen - -1. Stel de controllersnelheid in op nul. -2. Sluit de officiële bedrade afstandsbediening aan, of schakel een opgeladen RADR in de buurt in. -3. Sluit de 24 V-voeding aan. -4. Houd afstand en observeer de volledige homingbeweging. -5. Koppel de voeding onmiddellijk los als de wagen op een obstakel af beweegt, vastloopt of in de verkeerde richting beweegt. - -## Een korte slag testen - -1. Nadat de homing is voltooid, selecteert u de eenvoudigste bewegingsmodus. -2. Stel een korte diepte in. -3. Verhoog de snelheid slechts voldoende om een vloeiende beweging te bevestigen. -4. Bedien de stopbediening en controleer of deze de beweging stopt. -5. Koppel de stroom los en inspecteer de riem, poelie, bevestigingsmiddelen en bedrading nogmaals. - - - De OSSM voert de homing in de juiste richting uit, beweegt soepel zonder dat de riem overslaat of schuurt, en stopt onmiddellijk via de controller. - - -Als een controle mislukt, raadpleeg dan [Problemen oplossen bij de montage](/ossm/assembly-troubleshooting) voordat u de voeding opnieuw aansluit. - -[← Bedrading](/ossm/build/wiring) · [Gebruik uw OSSM →](https://docs.researchanddesire.com/ossm/get-started) diff --git a/content/docs/ossm/build/front-tensioner.de.mdx b/content/docs/ossm/build/front-tensioner.de.mdx deleted file mode 100644 index 3e247ae..0000000 --- a/content/docs/ossm/build/front-tensioner.de.mdx +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: "3. Vorderer Spanner" -description: "Installieren Sie den vorderen Spanner und stellen Sie die feste Hubbegrenzung ein, um die Spannerbaugruppe fertigzustellen" ---- - -Der vordere Spanner sichert das verbleibende lose Riemenende und legt die feste Hubbegrenzung des Aktuators fest. Diese Komponente enthält ein verstellbares Begrenzungsstück, das den maximalen Verfahrweg des Schlittens bestimmt. - -## Erforderliche Komponenten und Werkzeuge - -### Komponenten - -| Komponente | Anzahl | Spezifikation / Hinweise | -|-----------|-------|----------------------| -| Vorderes Spannstück | 1 | Hauptkomponente des Spanners (in diesem Schritt lose montiert) | -| Riemen | 1 | Das nach der Montage des hinteren Spanners verbleibende lose Riemenende | -| M3-Schraube | 1 | Legt die feste Hubbegrenzung fest | -| M3-Mutter | 1 | Für die M3-Schraube | - -### Werkzeuge - -| Werkzeug | Anzahl | Spezifikation / Hinweise | -|------|-------|----------------------| -| 2,5-mm-Sechskantschlüssel | 1 | Zum Anziehen der M3-Schraube | - - -Der vordere Spanner ist in diesem Schritt lose montiert. Sie stellen die Riemenspannung später im Bauprozess ein und befestigen den Spanner ordnungsgemäß, nachdem alle Komponenten montiert wurden. - - -## Schritt-für-Schritt-Montage - - - -Das vordere Spannstück sollte aus früheren Montageschritten bereits lose auf der Linearschiene montiert sein. - - -Das vordere Spannstück ist vorhanden, aber noch nicht gesichert oder gespannt. - - - - -Nehmen Sie das lose Ende des Riemens und führen Sie es nach unten in das Spannstück. - -Stellen Sie sicher, dass sich das Schraubenloch auf der linken Seite des Spanners befindet. - - -Der Riemenverlauf bestimmt die Funktion des Spanners. Stellen Sie sicher, dass der Riemen reibungslos und ohne Knicke oder Verdrehungen durch die Nuten des Spannstücks läuft. - - - - -Setzen Sie das kleinere Begrenzungsstück (das die feste Hubbegrenzung festlegt) in die Nuten des Hauptspannstücks ein. - -Richten Sie das Loch im Begrenzungsstück am entsprechenden Loch im Hauptspannstück aus. - - -Das Begrenzungsstück sollte sicher in den Nuten sitzen und die Löcher sollten perfekt fluchten. - - - - -Führen Sie die M3-Schraube durch die ausgerichteten Löcher ein. - -Für maximalen Hub (ca. 20 cm bei einer 350-mm-Schiene) positionieren Sie die Schraube ganz am Ende des Begrenzungsstücks. - - -Die Position der M3-Schraube bestimmt die maximale Hublänge. Durch die Platzierung am Ende des Begrenzungsstücks wird der größtmögliche Verfahrweg erreicht. - - - - -Setzen Sie die M3-Mutter von der gegenüberliegenden Seite auf die Schraube. - -Halten Sie die Mutter fest, während Sie die Schraube mit dem 2,5-mm-Sechskantschlüssel leicht anziehen. - - -Diese Baugruppe muss unbedingt lose befestigt bleiben. Sie müssen die Riemenspannung später im Bauprozess anpassen; wenn Sie jetzt zu fest anziehen, werden diese Anpassungen schwierig oder unmöglich. - - - -Die M3-Schraube und -Mutter sollten gesichert, aber locker genug sein, um zukünftige Anpassungen der Riemenspannung zu ermöglichen. Das Begrenzungsstück sollte sich bei Bedarf leicht bewegen lassen. - - - - -## Nächste Schritte - -Wenn der vordere Spanner installiert und die feste Hubbegrenzung eingestellt ist, ist die grundlegende Spannerbaugruppe abgeschlossen. Installieren Sie als Nächstes den OSSM-Motorkopf, um mit der Aktuatormontage fortzufahren. - -[← Endeffektor](/ossm/build/end-effector) · [Weiter: Motorhead →](/ossm/build/motorhead) diff --git a/content/docs/ossm/build/front-tensioner.fr.mdx b/content/docs/ossm/build/front-tensioner.fr.mdx deleted file mode 100644 index 186ff82..0000000 --- a/content/docs/ossm/build/front-tensioner.fr.mdx +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: "3. Tendeur avant" -description: "Installez le tendeur avant et définissez la butée fixe de la course pour terminer l’assemblage du tendeur" ---- - -Le tendeur avant maintient l’extrémité libre restante de la courroie et définit la butée fixe de la course de l’actionneur. Cette pièce comprend une butée mécanique réglable qui détermine la course maximale du coulisseau. - -## Composants et outils requis - -### Composants - -| Composant | Quantité | Spécifications / remarques | -|-----------|-------|----------------------| -| Pièce du tendeur avant | 1 | Composant principal du tendeur (monté sans serrage à ce stade) | -| Courroie | 1 | L’extrémité libre restante après l’installation du tendeur arrière | -| Boulon M3 | 1 | Définit la butée fixe de la course | -| Écrou M3 | 1 | Pour le boulon M3 | - -### Outils - -| Outil | Quantité | Spécifications / remarques | -|------|-------|----------------------| -| Clé hexagonale de 2,5 mm | 1 | Pour le boulon M3 | - - -Le tendeur avant est monté sans serrage à ce stade. Vous réglerez la tension de la courroie et fixerez correctement le tendeur plus tard, une fois tous les composants assemblés. - - -## Assemblage étape par étape - - - -La pièce du tendeur avant doit déjà être montée sans serrage sur le rail linéaire lors des étapes d’assemblage précédentes. - - -La pièce du tendeur avant est en place, mais n’est pas encore fixée ni tendue. - - - - -Prenez l’extrémité libre de la courroie et faites-la passer vers le bas dans la pièce du tendeur. - -Assurez-vous que le trou de vis est positionné sur le côté gauche du tendeur. - - -Le cheminement de la courroie détermine le fonctionnement du tendeur. Assurez-vous que la courroie passe sans à-coups et sans plis ni torsions dans les rainures du tendeur. - - - - -Placez la petite pièce de butée (qui définit la butée fixe de la course) dans les rainures de la pièce principale du tendeur. - -Alignez le trou de la pièce de butée avec le trou correspondant de la pièce principale du tendeur. - - -La pièce de butée doit être bien positionnée dans les rainures, avec les trous parfaitement alignés. - - - - -Insérez le boulon M3 dans les trous alignés. - -Pour obtenir la course maximale (environ 20 cm sur un rail de 350 mm), placez le boulon à l’extrémité de la pièce de butée. - - -La position du boulon M3 détermine la longueur de course maximale. Le placer à l’extrémité de la pièce de butée permet d’obtenir la distance de déplacement la plus longue possible. - - - - -Placez l’écrou M3 sur le boulon, du côté opposé. - -Maintenez l’écrou en place tout en serrant légèrement le boulon avec la clé hexagonale de 2,5 mm. - - -Il est essentiel que cet assemblage reste fixé sans être serré. Vous devrez régler la tension de la courroie plus tard dans le processus de construction ; un serrage excessif maintenant rendrait ces réglages difficiles, voire impossibles. - - - -Le boulon et l’écrou M3 doivent être fixés, mais rester suffisamment desserrés pour permettre de futurs réglages de tension de la courroie. La pièce de butée doit pouvoir bouger légèrement si nécessaire. - - - - -## Prochaines étapes - -Une fois le tendeur avant installé et la butée fixe réglée, l’assemblage de base du tendeur est terminé. Installez ensuite la tête du moteur OSSM pour poursuivre l’assemblage de l’actionneur. - -[← Effecteur final](/ossm/build/end-effector) · [Suivant : Motorhead →](/ossm/build/motorhead) diff --git a/content/docs/ossm/build/front-tensioner.mdx b/content/docs/ossm/build/front-tensioner.mdx deleted file mode 100644 index c49bc80..0000000 --- a/content/docs/ossm/build/front-tensioner.mdx +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: "3. Front Tensioner" -description: "Install the front tensioner and set the hard limit for the stroke to complete the tensioner assembly" ---- - -The front tensioner secures the remaining loose end of the belt and sets the hard limit for the actuator's stroke. This component includes an adjustable hard limit piece that determines the maximum travel distance of the slide. - -## Required Components and Tools - -### Components - -| Component | Count | Specification / Notes | -|-----------|-------|----------------------| -| Front Tensioner Piece | 1 | Main tensioner component (installed loosely at this stage) | -| Belt | 1 | The remaining loose end from the rear tensioner installation | -| M3 Bolt | 1 | Sets the stroke hard limit | -| M3 Nut | 1 | For the M3 bolt | - -### Tools - -| Tool | Count | Specification / Notes | -|------|-------|----------------------| -| 2.5 mm Hex | 1 | To fit the M3 bolt | - - -The front tensioner is installed loosely at this stage. You'll adjust the belt tension and secure the tensioner properly later in the build process after all components are assembled. - - -## Step-by-Step Assembly - - - -The front tensioner piece should already be installed loosely on the linear rail from earlier assembly steps. - - -The front tensioner piece is in place but not yet secured or tensioned. - - - - -Take the loose end of the belt and route it down into the tensioner piece. - -Ensure the screw hole is positioned on the left side of the tensioner. - - -The belt routing determines how the tensioner functions. Make sure the belt follows the path through the tensioner grooves smoothly without kinks or twists. - - - - -Place the smaller hard limit piece (which sets the hard limit for the stroke) into the grooves of the main tensioner piece. - -Align the hole in the hard limit piece with the corresponding hole in the main tensioner piece. - - -The hard limit piece should sit securely in the grooves with the holes perfectly aligned. - - - - -Insert the M3 bolt through the aligned holes. - -For maximum stroke (approximately 20 cm on a 350 mm rail), position the bolt all the way to the end of the hard limit piece. - - -The position of the M3 bolt determines the maximum stroke length. Placing it at the end of the hard limit piece provides the longest possible travel distance. - - - - -Place the M3 nut on the bolt from the opposite side. - -Hold the nut in place while lightly tightening the bolt with the 2.5 mm hex tool. - - -It is crucial for this assembly to remain loosely attached. You will need to adjust the belt tension later in the build process, and overtightening now will make those adjustments difficult or impossible. - - - -The M3 bolt and nut should be secured but loose enough to allow for future belt tension adjustments. The hard limit piece should be able to move slightly if needed. - - - - -## Next Steps - -With the front tensioner installed and the hard limit set, the basic tensioner assembly is complete. Proceed to install the OSSM motor head to continue the actuator assembly. - -[← End effector](/ossm/build/end-effector) · [Next: Motorhead →](/ossm/build/motorhead) diff --git a/content/docs/ossm/build/front-tensioner.nl.mdx b/content/docs/ossm/build/front-tensioner.nl.mdx deleted file mode 100644 index 0e7f182..0000000 --- a/content/docs/ossm/build/front-tensioner.nl.mdx +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: "3. Voorste spanner" -description: "Installeer de voorste spanner en stel de vaste slagbegrenzing in om de montage van de spanner te voltooien" ---- - -De voorste spanner zet het resterende losse uiteinde van de riem vast en bepaalt de vaste slagbegrenzing van de actuator. Dit onderdeel bevat een verstelbaar begrenzingsstuk dat de maximale verplaatsing van de slede bepaalt. - -## Vereiste onderdelen en gereedschappen - -### Componenten - -| Onderdeel | Aantal | Specificatie / opmerkingen | -|-----------|-------|----------------------| -| Voorste spanstuk | 1 | Hoofdcomponent van de spanner (in dit stadium los gemonteerd) | -| Riem | 1 | Het losse riemuiteinde dat na de montage van de achterste spanner overblijft | -| M3-bout | 1 | Stelt de vaste slagbegrenzing in | -| M3-moer | 1 | Voor de M3-bout | - -### Gereedschappen - -| Gereedschap | Aantal | Specificatie / opmerkingen | -|------|-------|----------------------| -| Inbussleutel van 2,5 mm | 1 | Voor de M3-bout | - - -De voorste spanner is in dit stadium los gemonteerd. Later in het bouwproces past u, nadat alle onderdelen zijn gemonteerd, de riemspanning aan en zet u de spanner goed vast. - - -## Stapsgewijze montage - - - -Het voorste spanstuk moet tijdens eerdere montagestappen al los op de lineaire rail zijn gemonteerd. - - -Het voorste spanstuk zit op zijn plaats, maar is nog niet vastgezet of gespannen. - - - - -Voer het losse uiteinde van de riem naar beneden door het spanstuk. - -Zorg ervoor dat het schroefgat zich aan de linkerkant van de spanner bevindt. - - -De loop van de riem bepaalt de werking van de spanner. Zorg ervoor dat de riem soepel en zonder knikken of verdraaiingen door de groeven van het spanstuk loopt. - - - - -Plaats het kleinere begrenzingsstuk (dat de vaste slagbegrenzing instelt) in de groeven van het hoofdspanstuk. - -Lijn het gat in het begrenzingsstuk uit met het overeenkomstige gat in het hoofdspanstuk. - - -Het begrenzingsstuk moet stevig in de groeven zitten, met de gaten perfect uitgelijnd. - - - - -Steek de M3-bout door de uitgelijnde gaten. - -Voor maximale slag (ongeveer 20 cm op een rail van 350 mm) plaatst u de bout helemaal aan het uiteinde van het begrenzingsstuk. - - -De positie van de M3-bout bepaalt de maximale slaglengte. Door deze aan het uiteinde van het begrenzingsstuk te plaatsen, wordt de grootst mogelijke verplaatsing bereikt. - - - - -Plaats de M3-moer op de bout vanaf de andere kant. - -Houd de moer op zijn plaats en draai de bout met de inbussleutel van 2,5 mm licht aan. - - -Het is cruciaal dat deze assemblage losjes bevestigd blijft. U moet de riemspanning later in het bouwproces aanpassen; als u nu te strak aandraait, worden deze aanpassingen moeilijk of onmogelijk. - - - -De M3-bout en -moer moeten vastzitten, maar los genoeg zijn om toekomstige aanpassingen van de riemspanning mogelijk te maken. Het begrenzingsstuk moet indien nodig licht kunnen bewegen. - - - - -## Volgende stappen - -Nu de voorste spanner is geïnstalleerd en de vaste slagbegrenzing is ingesteld, is de basismontage van de spanner voltooid. Ga verder met de installatie van de OSSM-motorkop om de montage van de actuator voort te zetten. - -[← Eindeffector](/ossm/build/end-effector) · [Volgende: Motorhead →](/ossm/build/motorhead) diff --git a/content/docs/ossm/build/introduction.de.mdx b/content/docs/ossm/build/introduction.de.mdx deleted file mode 100644 index b671288..0000000 --- a/content/docs/ossm/build/introduction.de.mdx +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Bevor Sie bauen -description: Machen Sie sich mit der offiziellen OSSM-Montagereihenfolge und den Sicherheitsprüfungen vertraut. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-0.0_introduction */} - -## Bauen Sie die offizielle OSSM-Konfiguration - -Dieser Leitfaden behandelt den Standard-OSSM-Aktuator, die offizielle Steuerplatine, den integrierten 100-W-Servomotor, die offiziellen Druckteile sowie einen kabelgebundenen Controller oder RADR. - - - Die Montage umfasst netzbetriebene Geräte, Gleichstromverkabelung für hohe Ströme, bewegliche Maschinen und Quetschstellen. Trennen Sie die Stromversorgung, bevor Sie die Verkabelung anschließen oder Hardware anpassen. Wenn Sie nicht qualifiziert sind, sicher mit der gewählten Stromversorgung zu arbeiten, beauftragen Sie eine qualifizierte Person mit dieser Arbeit. - - -## Bauabfolge - -1. Sammeln Sie die [Werkzeuge und Teile](/ossm/build/tools-and-parts). -2. Überprüfen Sie die [Stückliste](/ossm/build/bill-of-materials) und die [gedruckten Teile](/ossm/build/printed-parts). -3. Montieren Sie die Schiene, den Riemen, die Spannelemente und den Endeffektor. -4. Montieren Sie den Motorkopf und stellen Sie die Riemenspannung ein. -5. Montieren Sie die Elektronik und schließen Sie die Verkabelung ab. -6. Sichern Sie den Aktuator, räumen Sie den Bewegungsweg frei und führen Sie den ersten Test bei niedriger Geschwindigkeit durch. - -## Bevor Sie fortfahren - -- Lesen Sie jede Phase, bevor Sie damit beginnen. -- Gleichen Sie jedes Befestigungselement mit der Teiletabelle für diese Phase ab. -- Tauschen Sie elektrische Komponenten nicht aus, ohne die freigegebenen Spezifikationen zu prüfen. -- Lassen Sie die Stromversorgung getrennt, bis auf der Seite zum ersten Test ausdrücklich dazu aufgefordert wird, sie anzuschließen. - - - Fahren Sie nur fort, wenn Sie über einen freien Arbeitsbereich, die richtigen offiziellen Teile und eine sichere Möglichkeit verfügen, die Stromversorgung sofort zu trennen. - - -[Weiter: Werkzeuge und Teile →](/ossm/build/tools-and-parts) diff --git a/content/docs/ossm/build/introduction.fr.mdx b/content/docs/ossm/build/introduction.fr.mdx deleted file mode 100644 index 19c0f47..0000000 --- a/content/docs/ossm/build/introduction.fr.mdx +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Avant de construire -description: Comprendre la séquence officielle d’assemblage de l’OSSM et les contrôles de sécurité. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-0.0_introduction */} - -## Construire la configuration officielle OSSM - -Ce guide couvre l’actionneur OSSM standard, la carte de commande officielle, le servomoteur intégré de 100 W, les pièces imprimées officielles et le contrôleur filaire ou RADR. - - - L’assemblage comprend des équipements alimentés par le secteur, un câblage CC à fort courant, des machines en mouvement et des points de pincement. Débranchez l’alimentation avant de câbler ou d’ajuster le matériel. Si vous n’êtes pas qualifié pour travailler en toute sécurité avec l’alimentation choisie, demandez à une personne qualifiée de s’en charger. - - -## Séquence de construction - -1. Rassemblez les [outils et pièces](/ossm/build/tools-and-parts). -2. Vérifiez la [nomenclature](/ossm/build/bill-of-materials) et les [pièces imprimées](/ossm/build/printed-parts). -3. Assemblez le rail, la courroie, les tendeurs et l’effecteur final. -4. Assemblez la tête du moteur et réglez la tension de la courroie. -5. Montez l’électronique et terminez le câblage. -6. Fixez l’actionneur, dégagez la trajectoire de mouvement et effectuez le premier test à basse vitesse. - -## Avant de continuer - -- Lisez chaque étape avant de la démarrer. -- Vérifiez que chaque élément de fixation correspond au tableau des pièces de cette étape. -- Ne remplacez pas les composants électriques sans vérifier les spécifications compatibles. -- Laissez l’alimentation débranchée jusqu’à ce que la page du premier test vous indique explicitement de la brancher. - - - Continuez uniquement lorsque vous disposez d’une zone de travail dégagée, des pièces officielles correctes et d’un moyen sûr de débrancher immédiatement l’alimentation. - - -[Suivant : Outils et pièces →](/ossm/build/tools-and-parts) diff --git a/content/docs/ossm/build/introduction.mdx b/content/docs/ossm/build/introduction.mdx deleted file mode 100644 index a336386..0000000 --- a/content/docs/ossm/build/introduction.mdx +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Before You Build -description: Understand the official OSSM assembly sequence and safety checks. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-0.0_introduction */} - -## Build the official OSSM configuration - -This guide covers the standard OSSM actuator, official control board, 100 W integrated servo motor, official printed parts, and wired or RADR controller. - - - Assembly includes mains-powered equipment, high-current DC wiring, moving machinery, and pinch points. Disconnect power before wiring or adjusting hardware. If you are not qualified to work safely with the chosen power supply, ask a qualified person to complete that work. - - -## Build sequence - -1. Gather the [tools and parts](/ossm/build/tools-and-parts). -2. Check the [bill of materials](/ossm/build/bill-of-materials) and [printed parts](/ossm/build/printed-parts). -3. Assemble the rail, belt, tensioners, and end effector. -4. Assemble the motorhead and set belt tension. -5. Mount the electronics and complete the wiring. -6. Secure the actuator, clear the motion path, and perform the first test at low speed. - -## Before continuing - -- Read each stage before starting it. -- Match every fastener to the parts table for that stage. -- Do not substitute electrical components without reviewing the supported specifications. -- Keep power disconnected until the first-test page explicitly tells you to connect it. - - - Continue only when you have a clear work area, the correct official parts, and a safe way to disconnect power immediately. - - -[Next: Tools and parts →](/ossm/build/tools-and-parts) diff --git a/content/docs/ossm/build/introduction.nl.mdx b/content/docs/ossm/build/introduction.nl.mdx deleted file mode 100644 index 43d3f23..0000000 --- a/content/docs/ossm/build/introduction.nl.mdx +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Voordat u gaat bouwen -description: Begrijp de officiële OSSM-montagevolgorde en veiligheidscontroles. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-0.0_introduction */} - -## Bouw de officiële OSSM-configuratie - -Deze handleiding behandelt de standaard OSSM-actuator, de officiële besturingskaart, de geïntegreerde servomotor van 100 W, officiële gedrukte onderdelen en de bekabelde of RADR-controller. - - - De montage omvat apparatuur die op netspanning werkt, gelijkstroombedrading voor hoge stromen, bewegende machines en knelpunten. Koppel de stroom los voordat u bedrading aansluit of hardware aanpast. Als u niet gekwalificeerd bent om veilig met de gekozen voeding te werken, vraag dan een gekwalificeerd persoon om dat werk uit te voeren. - - -## Bouwvolgorde - -1. Verzamel de [gereedschappen en onderdelen](/ossm/build/tools-and-parts). -2. Controleer de [stuklijst](/ossm/build/bill-of-materials) en [gedrukte onderdelen](/ossm/build/printed-parts). -3. Monteer de rail, de riem, de spanners en de eindeffector. -4. Monteer de motorkop en stel de riemspanning in. -5. Monteer de elektronica en voltooi de bedrading. -6. Zet de actuator vast, maak het bewegingspad vrij en voer de eerste test uit op lage snelheid. - -## Voordat u verdergaat - -- Lees elke fase voordat u eraan begint. -- Controleer of elk bevestigingsmiddel overeenkomt met de onderdelentabel voor die fase. -- Vervang geen elektrische componenten zonder de ondersteunde specificaties te controleren. -- Houd de stroom losgekoppeld totdat de pagina voor de eerste test expliciet aangeeft dat u deze moet aansluiten. - - - Ga alleen verder als u over een vrije werkplek en de juiste officiële onderdelen beschikt en de stroom onmiddellijk veilig kunt loskoppelen. - - -[Volgende: Gereedschappen en onderdelen →](/ossm/build/tools-and-parts) diff --git a/content/docs/ossm/build/meta.de.json b/content/docs/ossm/build/meta.de.json deleted file mode 100644 index 869d3ab..0000000 --- a/content/docs/ossm/build/meta.de.json +++ /dev/null @@ -1,20 +0,0 @@ -{ - "title": "Build-Sequenz", - "pages": [ - "introduction", - "tools-and-parts", - "bill-of-materials", - "printed-parts", - "rear-tensioner", - "end-effector", - "front-tensioner", - "motorhead", - "pulley", - "motorhead-middle", - "motor-cover", - "belt-tension", - "electronics", - "wiring", - "first-test" - ] -} diff --git a/content/docs/ossm/build/meta.fr.json b/content/docs/ossm/build/meta.fr.json deleted file mode 100644 index 31923c7..0000000 --- a/content/docs/ossm/build/meta.fr.json +++ /dev/null @@ -1,20 +0,0 @@ -{ - "title": "Séquence de construction", - "pages": [ - "introduction", - "tools-and-parts", - "bill-of-materials", - "printed-parts", - "rear-tensioner", - "end-effector", - "front-tensioner", - "motorhead", - "pulley", - "motorhead-middle", - "motor-cover", - "belt-tension", - "electronics", - "wiring", - "first-test" - ] -} diff --git a/content/docs/ossm/build/meta.json b/content/docs/ossm/build/meta.json deleted file mode 100644 index a3dd5ce..0000000 --- a/content/docs/ossm/build/meta.json +++ /dev/null @@ -1,20 +0,0 @@ -{ - "title": "Build Sequence", - "pages": [ - "introduction", - "tools-and-parts", - "bill-of-materials", - "printed-parts", - "rear-tensioner", - "end-effector", - "front-tensioner", - "motorhead", - "pulley", - "motorhead-middle", - "motor-cover", - "belt-tension", - "electronics", - "wiring", - "first-test" - ] -} diff --git a/content/docs/ossm/build/meta.nl.json b/content/docs/ossm/build/meta.nl.json deleted file mode 100644 index addbb59..0000000 --- a/content/docs/ossm/build/meta.nl.json +++ /dev/null @@ -1,20 +0,0 @@ -{ - "title": "Bouwreeks", - "pages": [ - "introduction", - "tools-and-parts", - "bill-of-materials", - "printed-parts", - "rear-tensioner", - "end-effector", - "front-tensioner", - "motorhead", - "pulley", - "motorhead-middle", - "motor-cover", - "belt-tension", - "electronics", - "wiring", - "first-test" - ] -} diff --git a/content/docs/ossm/build/motor-cover.de.mdx b/content/docs/ossm/build/motor-cover.de.mdx deleted file mode 100644 index 6324862..0000000 --- a/content/docs/ossm/build/motor-cover.de.mdx +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: "7. Abdeckung (Motorkopf)" -description: "Bringen Sie die Motorkopfabdeckung an, um die Motormontage abzuschließen" ---- - -Die Motorkopfabdeckung umschließt und schützt den Motor und die Riemenscheibe. In diesem Schritt richten Sie die Abdeckung aus und befestigen sie mit vier M3×8-mm-Schrauben – zwei oben und zwei unten. - -## Erforderliche Komponenten und Werkzeuge - -### Komponenten - -- Abdeckung (Motorkopf) × 1 – Endgültige Abdeckung für den Motorkopf -- M3 × 8 mm Schrauben × 4 – Zwei für die Oberseite, zwei für die Unterseite - -### Werkzeuge - -- 2,5-mm-Inbusschlüssel × 1 – Passend für M3-Schrauben -- Kleiner Schlitzschraubendreher oder Ausrichtungsstift × 1 – hilfreich zum Ausrichten der Löcher - - -Voraussetzung: In der Motorkopfbaugruppe sollten Motor, Riemenscheibe und Mittelteil bereits in den vorherigen Schritten installiert worden sein. - - - - Schraubensicherung ist optional. Wenn Sie sie verwenden möchten, tragen Sie eine kleine Menge eines mittelfesten Schraubensicherungsmittels nur auf Metall-auf-Metall-Verbindungselemente auf. Verwenden Sie kein Schraubensicherungsmittel für Kunststoffteile. - - -## Schritt-für-Schritt-Montage - - - -Setzen Sie die Motorkopfabdeckung auf die Baugruppe und achten Sie darauf, dass ihre Oberkante auf gleicher Höhe mit der Oberseite des Motorkopfs bleibt. - -Die Abdeckung sollte bündig am Mittelteil anliegen und alle vier Befestigungslöcher ungefähr ausgerichtet sein. - - -Die Abdeckung sitzt waagerecht und bündig am Mittelteil. Alle vier Befestigungslöcher sind sichtbar und zugänglich. - - - - -Setzen Sie zwei M3 × 8 mm Schrauben in die oberen Löcher ein. Drehen Sie jede Schraube von Hand an, um ein Verkanten des Gewindes zu vermeiden, und ziehen Sie sie dann vorsichtig an, bis sie leicht fest sitzt – ziehen Sie sie noch nicht vollständig an. - - -Zu starkes Anziehen kann zu Schäden an den Einsätzen oder zum Durchdrehen einer unverlierbaren Mutter führen. Ziehen Sie nur so weit an, dass die Schraube sitzt und die Abdeckung an Ort und Stelle gehalten wird. - - - -Beide oberen Schrauben sind sauber angesetzt (kein Verkanten) und leicht festgezogen, sodass die Abdeckung in Position bleibt. - - - - -Wenn ein Loch leicht verschoben ist, führen Sie einen kleinen Schraubendreher oder Ausrichtungsstift durch das Loch, um die Abdeckung oder das Innenteil vor dem Festziehen auszurichten. - - -Wenn die Ausrichtung weiterhin schwierig ist, vergewissern Sie sich, dass der Mittelteil vollständig sitzt und kein Kabel, kein Riemen und keine Riemenscheibe die Abdeckung behindert. - - - - -Setzen Sie die verbleibenden zwei M3 × 8 mm Schrauben in die unteren Löcher ein. Diese Löcher sind abgewinkelt – lassen Sie die Schwerkraft dabei helfen, die Schrauben in die Gewindeeinsätze bzw. unverlierbaren Muttern zu führen. Setzen Sie die Gewinde von Hand an und ziehen Sie die Schrauben dann so weit an, dass sie genauso fest sitzen wie die oberen Schrauben. - - -Die abgewinkelten unteren Löcher sollen die Installation vereinfachen. Wenn eine Schraube nicht leicht greift, drehen Sie sie heraus, richten Sie sie neu aus und versuchen Sie es erneut – üben Sie keine Gewalt aus. - - - -Alle vier Schrauben (zwei oben, zwei unten) sind installiert und sitzen gleichmäßig fest. Die Abdeckung sitzt gleichmäßig und spaltfrei. - - - - -Drücken Sie vorsichtig auf den Umfang der Abdeckung, um sicherzustellen, dass sie vollständig sitzt, und ziehen Sie dann jede Schraube abschließend gleichmäßig an, damit die Last verteilt wird. - - -Die Abdeckung verschiebt sich beim Drücken nicht und es entsteht kein reibender Kontakt mit der Riemenscheibe oder dem Riemen, wenn die Baugruppe von Hand bewegt wird. - - - - -## Fehlerbehebung - - - -- Halten Sie an und drehen Sie die Schraube sofort heraus. -- Richten Sie die Abdeckung mit einem kleinen Schraubendreher oder Ausrichtungsstift durch das Loch neu aus. -- Drehen Sie die Schraube die ersten paar Umdrehungen von Hand an, bevor Sie den Innensechskantschlüssel verwenden. - - - -- Ziehen Sie nicht weiter fest – dies kann zur Beschädigung des Teils führen. -- Drehen Sie die Schraube heraus, richten Sie sie neu aus und ziehen Sie sie vorsichtiger fest. -- Wenn sich der Einsatz weiterhin dreht, entfernen Sie die Abdeckung und überprüfen Sie den Einsatz oder die Mutter, bevor Sie fortfahren. - - - -- Lösen Sie alle Schrauben um 1–2 Umdrehungen. -- Drücken Sie die Abdeckung vollständig an ihren Platz. -- Ziehen Sie die Schrauben abwechselnd an (oben links, unten rechts, oben rechts, unten links). - - - -- Lösen Sie die Schrauben leicht und zentrieren Sie die Abdeckung neu. -- Stellen Sie sicher, dass keine Drähte oder Riemen eingeklemmt sind. -- Ziehen Sie sie gleichmäßig wieder an und prüfen Sie erneut. - - - -## Nächste Schritte - -Mit der montierten Motorkopfabdeckung ist die Motormontage abgeschlossen. Passen Sie vor dem ersten Einschalten die Riemenspannung an, um einen reibungslosen und zuverlässigen OSSM-Betrieb zu gewährleisten. - - -[← Mittlerer Teil des Motorheads](/ossm/build/motorhead-middle) · [Weiter: Riemenspannung →](/ossm/build/belt-tension) diff --git a/content/docs/ossm/build/motor-cover.fr.mdx b/content/docs/ossm/build/motor-cover.fr.mdx deleted file mode 100644 index a4f0c73..0000000 --- a/content/docs/ossm/build/motor-cover.fr.mdx +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: "7. Couvercle (tête de moteur)" -description: "Installez le couvercle de la tête du moteur pour terminer l'assemblage du moteur" ---- - -Le couvercle de la tête du moteur entoure et protège le moteur et la poulie. Au cours de cette étape, vous alignez le couvercle et le fixez avec quatre boulons M3 × 8 mm : deux en haut et deux en bas. - -## Composants et outils requis - -### Composants - -- Couvercle (tête de moteur) × 1 — Couvercle final de la tête de moteur -- Boulons M3 × 8 mm × 4 — Deux pour le haut, deux pour le bas - -### Outils - -- Clé hexagonale de 2,5 mm × 1 — S’adapte aux boulons M3 -- Petit tournevis à lame plate ou pic d’alignement × 1 — Utile pour aligner les trous - - -Prérequis : L’ensemble de tête de moteur doit déjà avoir le moteur, la poulie et la section centrale installés lors des étapes précédentes. - - - - Le frein-filet est facultatif. Si vous choisissez de l’utiliser, appliquez une petite quantité de frein-filet de résistance moyenne uniquement sur les fixations métal sur métal. N’utilisez pas de frein-filet sur les pièces en plastique. - - -## Assemblage étape par étape - - - -Placez le couvercle de la tête du moteur sur l’assemblage, en veillant à ce que son bord supérieur soit au même niveau que le haut de la tête du moteur. - -Le couvercle doit affleurer la section centrale avec les quatre trous de montage grossièrement alignés. - - -Le couvercle est de niveau et affleure la section centrale. Les quatre trous de montage sont visibles et accessibles. - - - - -Insérez deux boulons M3 × 8 mm dans les trous supérieurs. Engagez chaque boulon à la main pour éviter de l’engager de travers, puis serrez doucement jusqu’à ce qu’il soit légèrement serré (ne serrez pas encore complètement). - - -Un serrage excessif peut endommager les inserts ou faire tourner un écrou imperdable. Serrez uniquement jusqu’à ce que le boulon soit bien en place et que le couvercle soit maintenu en place. - - - -Les deux boulons supérieurs sont correctement engagés (sans être engagés de travers) et légèrement serrés, de sorte que le couvercle reste en position. - - - - -Si un trou est légèrement décalé, faites passer un petit tournevis ou un pic dans le trou pour aligner le couvercle ou la partie interne avant de serrer. - - -Si l’alignement reste difficile, vérifiez que la section centrale est bien en place et qu’aucun câblage, courroie ou poulie n’interfère avec le couvercle. - - - - -Insérez les deux boulons M3 × 8 mm restants dans les trous inférieurs. Ces trous sont inclinés : laissez la gravité guider les boulons vers les inserts filetés/écrous imperdables. Engagez le filetage à la main, puis serrez les boulons jusqu’à obtenir le même serrage léger que pour les boulons supérieurs. - - -Les trous inférieurs inclinés sont conçus pour simplifier l’installation. Si un boulon ne prend pas facilement, dévissez-le, réalignez-le et réessayez – ne forcez pas. - - - -Les quatre boulons (deux en haut, deux en bas) sont installés et uniformément serrés. Le couvercle est uniformément en place, sans espace. - - - - -Appuyez doucement sur le périmètre du couvercle pour confirmer qu’il est bien en place, puis resserrez légèrement chaque boulon de manière uniforme afin de répartir la charge. - - -Le couvercle ne bouge pas lorsqu’on appuie dessus et il n’y a aucun contact de frottement avec la poulie ou la courroie lorsque l’ensemble est déplacé à la main. - - - - -## Dépannage - - - -- Arrêtez-vous et dévissez immédiatement le boulon. -- Réalignez le couvercle à l’aide d’un petit tournevis ou d’un pic à travers le trou. -- Engagez le boulon à la main pendant les premiers tours avant d’utiliser la clé hexagonale. - - - -- Ne continuez pas à serrer, cela pourrait endommager la pièce. -- Dévissez le boulon, réalignez-le et serrez plus doucement. -- Si l’insert continue de tourner, retirez le couvercle et inspectez l’insert ou l’écrou avant de continuer. - - - -- Desserrez tous les boulons de 1 à 2 tours. -- Appuyez sur le couvercle pour le mettre complètement en place. -- Resserrez les boulons en alternance (en haut à gauche, en bas à droite, en haut à droite, en bas à gauche). - - - -- Desserrez légèrement les boulons et recentrez le couvercle. -- Vérifiez qu’aucun fil ni aucune courroie ne sont pincés. -- Resserrez uniformément et vérifiez à nouveau. - - - -## Étapes suivantes - -Une fois le couvercle de la tête du moteur installé, l’ensemble moteur est terminé. Procédez au réglage de la tension de la courroie avant la première mise sous tension pour garantir un fonctionnement OSSM fluide et fiable. - - -[← Section centrale du Motorhead](/ossm/build/motorhead-middle) · [Suivant : Tension de courroie →](/ossm/build/belt-tension) diff --git a/content/docs/ossm/build/motor-cover.mdx b/content/docs/ossm/build/motor-cover.mdx deleted file mode 100644 index 78e1f97..0000000 --- a/content/docs/ossm/build/motor-cover.mdx +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: "7. Cover (Motor Head)" -description: "Install the motor head cover to complete the motor assembly" ---- - -The motor head cover encloses and protects the motor and pulley. In this step, you align the cover and secure it with four M3×8 mm bolts—two on the top and two on the bottom. - -## Required components and tools - -### Components - -- Cover (Motor Head) × 1 — Final enclosure for the motor head -- M3 × 8 mm bolts × 4 — Two for the top, two for the bottom - -### Tools - -- 2.5 mm hex key × 1 — Fits the M3 bolts -- Small flat-blade screwdriver or alignment pick × 1 — Helpful for aligning holes - - -Prerequisite: The motor head assembly should already have the motor, pulley, and middle section installed from previous steps. - - - -Threadlocker is optional. If you choose to use it, apply a tiny amount of medium-strength threadlocker only to metal-to-metal fasteners. Do not use threadlocker on plastic parts. - - -## Step-by-step assembly - - - -Place the motor head cover onto the assembly, keeping its top edge level with the top of the motor head. - -The cover should sit flush against the middle section with all four mounting holes roughly aligned. - - -The cover sits level and flush with the middle section. All four mounting holes are visible and accessible. - - - - -Insert two M3 × 8 mm bolts into the top holes. Start each bolt by hand to avoid cross‑threading, then tighten gently until snug—do not fully torque yet. - - -Overtightening can damage inserts or cause a captive nut to spin. Tighten only until the bolt seats and the cover is held in place. - - - -Both top bolts are started cleanly (no cross‑threading) and lightly snug, holding the cover in position. - - - - -If any hole is slightly off, use a small screwdriver or pick through the hole to nudge the cover or internal part into alignment before tightening. - - -If alignment remains difficult, confirm the middle section is fully seated and that no wiring, belt, or pulley feature interferes with the cover. - - - - -Insert the remaining two M3 × 8 mm bolts into the bottom holes. These holes are angled—let gravity help the bolts find the threaded inserts/captive nuts. Start the threads by hand, then tighten until snug to match the top bolts. - - -The angled bottom holes are designed to streamline installation. If a bolt doesn’t catch easily, back it out, realign, and try again—don’t force it. - - - -All four bolts (two top, two bottom) are installed and evenly snug. The cover is uniformly seated with no gaps. - - - - -Gently press around the cover perimeter to confirm it’s fully seated, then give each bolt a final, even snug so the load is shared. - - -The cover does not shift when pressed, and there is no rubbing contact with the pulley or belt when the assembly is moved by hand. - - - - -## Troubleshooting - - - -- Stop and back the bolt out immediately. -- Re‑align the cover using a small screwdriver/pick through the hole. -- Start the bolt by hand for the first few turns before using the hex key. - - - -- Do not continue tightening—this can damage the part. -- Back the bolt out, realign, and tighten more gently. -- If the insert continues to spin, remove the cover and inspect the insert or nut before proceeding. - - - -- Loosen all bolts 1–2 turns. -- Press the cover fully into place. -- Re‑snug bolts in an alternating pattern (top‑left, bottom‑right, top‑right, bottom‑left). - - - -- Loosen bolts slightly and re‑center the cover. -- Verify no wires or belt are pinched. -- Re‑snug evenly and recheck. - - - -## Next steps - -With the motor head cover installed, the motor assembly is complete. Proceed to adjust the belt tension before first power‑on to ensure smooth, reliable OSSM operation. - - -[← Motorhead middle](/ossm/build/motorhead-middle) · [Next: Belt tension →](/ossm/build/belt-tension) diff --git a/content/docs/ossm/build/motor-cover.nl.mdx b/content/docs/ossm/build/motor-cover.nl.mdx deleted file mode 100644 index 1f51f96..0000000 --- a/content/docs/ossm/build/motor-cover.nl.mdx +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: "7. Afdekking (motorkop)" -description: "Installeer het motorkopdeksel om de motormontage te voltooien" ---- - -De motorkopafdekking omsluit en beschermt de motor en poelie. In deze stap lijnt u de afdekking uit en zet u deze vast met vier M3×8 mm-bouten: twee aan de bovenkant en twee aan de onderkant. - -## Benodigde componenten en gereedschappen - -### Componenten - -- Afdekking (motorkop) × 1 — Eindafdekking voor de motorkop -- M3 × 8 mm bouten × 4 — Twee voor de bovenkant, twee voor de onderkant - -### Gereedschappen - -- 2,5 mm inbussleutel × 1 — Past op de M3-bouten -- Kleine platte schroevendraaier of uitlijningspen × 1 — Handig voor het uitlijnen van de gaten - - -Vereiste: De motor, de poelie en het middengedeelte moeten in eerdere stappen al op de motorkopconstructie zijn geïnstalleerd. - - - -Schroefdraadborging is optioneel. Als u ervoor kiest om dit te gebruiken, breng dan alleen een kleine hoeveelheid middelsterk schroefdraadborgmiddel aan op metaal-op-metaal bevestigingsmiddelen. Gebruik geen schroefdraadborgmiddel op kunststof onderdelen. - - -## Stapsgewijze montage - - - -Plaats de motorkopafdekking op de assemblage, waarbij de bovenrand op gelijke hoogte blijft met de bovenkant van de motorkop. - -De afdekking moet vlak tegen het middengedeelte liggen, waarbij alle vier de montagegaten ongeveer op één lijn liggen. - - -De afdekking zit waterpas en vlak tegen het middengedeelte. Alle vier de montagegaten zijn zichtbaar en toegankelijk. - - - - -Steek twee M3 × 8 mm bouten in de bovenste gaten. Draai elke bout met de hand aan om scheef indraaien te voorkomen, en draai vervolgens voorzichtig vast tot hij goed vastzit. Draai nog niet volledig aan. - - -Te vast aandraaien kan de inzetstukken beschadigen of ervoor zorgen dat een onverliegbare moer gaat draaien. Draai slechts vast totdat de bout op zijn plaats zit en de afdekking op zijn plaats wordt gehouden. - - - -Beide bovenste bouten zijn correct aangezet (niet scheef aangezet) en licht vastgedraaid, zodat de afdekking op zijn plaats blijft. - - - - -Als een gat iets verschoven is, steek dan een kleine schroevendraaier of uitlijningspen door het gat om de afdekking of het interne onderdeel uit te lijnen voordat u het vastdraait. - - -Als het uitlijnen moeilijk blijft, controleer dan of het middengedeelte goed op zijn plaats zit en of bedrading, riem of poelie de afdekking niet hindert. - - - - -Steek de resterende twee M3 × 8 mm-bouten in de onderste gaten. Deze gaten staan onder een hoek. Laat de zwaartekracht de bouten naar de schroefdraadinzetstukken/onverliegbare moeren leiden. Draai de bouten eerst met de hand enkele slagen in en draai ze vervolgens zo vast dat ze even stevig zitten als de bovenste bouten. - - -De schuine gaten aan de onderkant zijn ontworpen om de installatie te vereenvoudigen. Als een bout niet gemakkelijk pakt, draai hem dan terug, lijn hem opnieuw uit en probeer het opnieuw. Forceer hem niet. - - - -Alle vier de bouten (twee boven, twee onder) zijn geïnstalleerd en zitten gelijkmatig vast. De afdekking zit gelijkmatig en zonder spleten. - - - - -Druk zachtjes rond de omtrek van de afdekking om te controleren of deze volledig op zijn plaats zit, en draai vervolgens elke bout gelijkmatig nog eenmaal licht vast, zodat de belasting wordt verdeeld. - - -De afdekking verschuift niet wanneer erop wordt gedrukt en er is geen wrijvend contact met de poelie of riem wanneer het geheel met de hand wordt bewogen. - - - - -## Problemen oplossen - - - -- Stop en draai de bout onmiddellijk terug. -- Lijn de afdekking opnieuw uit met een kleine schroevendraaier of uitlijningspen door het gat. -- Start de bout de eerste paar slagen met de hand voordat u de inbussleutel gebruikt. - - - -- Ga niet verder met vastdraaien; dit kan het onderdeel beschadigen. -- Draai de bout terug, lijn hem opnieuw uit en draai hem voorzichtig vast. -- Als het inzetstuk blijft draaien, verwijdert u de afdekking en inspecteert u het inzetstuk of de moer voordat u verdergaat. - - - -- Draai alle bouten 1–2 slagen los. -- Druk de afdekking volledig op zijn plaats. -- Draai de bouten opnieuw vast in een afwisselend patroon (linksboven, rechtsonder, rechtsboven, linksonder). - - - -- Draai de bouten iets los en centreer de afdekking opnieuw. -- Controleer of er geen draden of een riem bekneld zijn geraakt. -- Draai de bouten gelijkmatig weer vast en controleer opnieuw. - - - -## Volgende stappen - -Als de motorkopafdekking is geïnstalleerd, is de motormontage compleet. Ga door met het afstellen van de riemspanning voordat u de machine voor het eerst inschakelt, om een soepele, betrouwbare werking van de OSSM te garanderen. - - -[← Middendeel van de Motorhead](/ossm/build/motorhead-middle) · [Volgende: Riemspanning →](/ossm/build/belt-tension) diff --git a/content/docs/ossm/build/motorhead-middle.de.mdx b/content/docs/ossm/build/motorhead-middle.de.mdx deleted file mode 100644 index c1a3bd2..0000000 --- a/content/docs/ossm/build/motorhead-middle.de.mdx +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: "6. Mittlerer Teil des Motorheads" -description: "Installieren Sie den mittleren Teil des Standard-Motorheads." ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-7.0_ossm_motor_head_middle */} - -## Teile und Werkzeuge - -| Artikel | Anzahl | -| --- | ---: | -| Mittlerer Teil des Standard-Motorheads | 1 | -| M5 × 35-mm-Schrauben | 4 | -| M5-Muttern | 4 | -| 4-mm-Innensechskantschlüssel | 1 | -| Kleiner Schlitzschraubendreher | 1 | - -## Mittelteil installieren - -1. Entfernen Sie alle provisorischen Schrauben, mit denen der Motor an der Bodenplatte befestigt ist, und halten Sie dabei Motor und Riemenscheibe ausgerichtet. -2. Setzen Sie den mittleren Teil des Standard-Motorheads zwischen Motor und Bodenplatte ein. -3. Führen Sie die vier M5 × 35-mm-Schrauben von der Motorseite aus durch den Mittelteil. -4. Setzen Sie die M5-Muttern auf der Rückseite des Motors auf. -5. Ziehen Sie die Schrauben schrittweise über Kreuz an, damit der Mittelteil gleichmäßig sitzt. -6. Vergewissern Sie sich, dass Riemenscheibe und Riemen ausgerichtet bleiben und sich von Hand frei drehen lassen. - - - Alle vier Befestigungselemente sind fest, das Gehäuse sitzt rechtwinklig, und der Riemen läuft, ohne am gedruckten Gehäuse zu scheuern. - - -[← Riemenscheibe](/ossm/build/pulley) · [Weiter: Motorabdeckung →](/ossm/build/motor-cover) diff --git a/content/docs/ossm/build/motorhead-middle.fr.mdx b/content/docs/ossm/build/motorhead-middle.fr.mdx deleted file mode 100644 index 6958ff8..0000000 --- a/content/docs/ossm/build/motorhead-middle.fr.mdx +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: "6. Section centrale du Motorhead" -description: "Installez la section centrale du Motorhead standard." ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-7.0_ossm_motor_head_middle */} - -## Pièces et outils - -| Pièce | Quantité | -| --- | ---: | -| Section centrale du Motorhead standard | 1 | -| Boulons M5 × 35 mm | 4 | -| Écrous M5 | 4 | -| Clé hexagonale de 4 mm | 1 | -| Petit tournevis plat | 1 | - -## Installer la section centrale - -1. Retirez tous les boulons provisoires qui fixent le moteur à la plaque inférieure, tout en maintenant l’alignement du moteur et de la poulie. -2. Placez la section centrale du Motorhead standard entre le moteur et la plaque inférieure. -3. Insérez les quatre boulons M5 × 35 mm depuis le côté du moteur, à travers la section centrale. -4. Montez les écrous M5 à l’arrière du moteur. -5. Serrez progressivement les boulons en croix afin que la section centrale soit plaquée uniformément. -6. Vérifiez que la poulie et la courroie restent alignées et tournent librement à la main. - - - Les quatre fixations sont bien serrées, le boîtier est d’équerre et la courroie passe sans frotter contre le boîtier imprimé. - - -[← Poulie](/ossm/build/pulley) · [Suivant : Capot du moteur →](/ossm/build/motor-cover) diff --git a/content/docs/ossm/build/motorhead-middle.mdx b/content/docs/ossm/build/motorhead-middle.mdx deleted file mode 100644 index d808cb4..0000000 --- a/content/docs/ossm/build/motorhead-middle.mdx +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: "6. Motorhead Middle" -description: "Install the standard motorhead middle section." ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-7.0_ossm_motor_head_middle */} - -## Parts and tools - -| Item | Quantity | -| --- | ---: | -| Standard motorhead middle | 1 | -| M5 × 35 mm bolts | 4 | -| M5 nuts | 4 | -| 4 mm hex key | 1 | -| Small flat-blade screwdriver | 1 | - -## Install the middle section - -1. Remove any temporary bolts holding the motor to the bottom plate while keeping the motor and pulley aligned. -2. Place the standard middle section between the motor and bottom plate. -3. Insert the four M5 × 35 mm bolts from the motor side through the middle section. -4. Fit the M5 nuts at the back of the motor. -5. Tighten the bolts gradually in a cross pattern so the middle section seats evenly. -6. Confirm the pulley and belt remain aligned and rotate freely by hand. - - - All four fasteners are secure, the housing sits square, and the belt tracks without rubbing the printed body. - - -[← Pulley](/ossm/build/pulley) · [Next: Motor cover →](/ossm/build/motor-cover) diff --git a/content/docs/ossm/build/motorhead-middle.nl.mdx b/content/docs/ossm/build/motorhead-middle.nl.mdx deleted file mode 100644 index 70351c2..0000000 --- a/content/docs/ossm/build/motorhead-middle.nl.mdx +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: "6. Middendeel van de Motorhead" -description: "Installeer het middelste deel van de standaard-Motorhead." ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-7.0_ossm_motor_head_middle */} - -## Onderdelen en gereedschappen - -| Onderdeel | Aantal | -| --- | ---: | -| Middelste deel van de standaard-Motorhead | 1 | -| M5 × 35 mm-bouten | 4 | -| M5-moeren | 4 | -| Inbussleutel van 4 mm | 1 | -| Kleine platte schroevendraaier | 1 | - -## Middengedeelte installeren - -1. Verwijder eventuele tijdelijke bouten waarmee de motor aan de bodemplaat is bevestigd, terwijl u de motor en de poelie uitgelijnd houdt. -2. Plaats het middelste deel van de standaard-Motorhead tussen de motor en de bodemplaat. -3. Steek de vier M5 × 35 mm-bouten vanaf de motorzijde door het middelste deel. -4. Plaats de M5-moeren aan de achterkant van de motor. -5. Draai de bouten geleidelijk kruislings aan, zodat het middelste deel gelijkmatig aansluit. -6. Controleer of de poelie en de riem uitgelijnd blijven en met de hand vrij kunnen draaien. - - - Alle vier de bevestigingsmiddelen zitten stevig vast, de behuizing zit haaks en de riem loopt zonder tegen de geprinte behuizing te schuren. - - -[← Poelie](/ossm/build/pulley) · [Volgende: Motorafdekking →](/ossm/build/motor-cover) diff --git a/content/docs/ossm/build/motorhead.de.mdx b/content/docs/ossm/build/motorhead.de.mdx deleted file mode 100644 index 65dc6a1..0000000 --- a/content/docs/ossm/build/motorhead.de.mdx +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: "4. OSSM Motorhead" -description: "Installieren Sie die Lager und befestigen Sie die OSSM-Motorkopf-Bodenplatte an der Linearschiene" ---- - -Die Bodenplatte des OSSM-Motorkopfs dient als Grundlage für die Motorbaugruppe und bietet Befestigungspunkte für die Lager, die den Riemen führen. Dieser Schritt umfasst das Vorformen der Gewinde in den Befestigungslöchern, das Stapeln und Befestigen der Lager sowie das Anbringen des Motorkopfs an der Linearschiene. - -## Erforderliche Komponenten und Werkzeuge - -### Komponenten - -| Komponente | Anzahl | Spezifikation / Hinweise | -|-----------|-------|----------------------| -| OSSM Motorhead-Bodenplatte | 1 | Bodenplatte für die Motorkopfbaugruppe | -| Lager | 3 | Auf einer der M5-Schrauben gestapelt | -| M5-Schrauben, 20 mm | 2 | Zur Befestigung der Lager an der Motorkopf-Bodenplatte | -| Linearschiene | 1 | Mit zuvor angebrachten Komponenten | -| M3-Schrauben, 8 mm | 4 | Zur Befestigung des Motorkopfs an der Linearschiene | - -### Werkzeuge - -| Werkzeug | Anzahl | Spezifikation / Hinweise | -|------|-------|----------------------| -| 4-mm-Inbusschlüssel | 1 | Für die M5-Schrauben | -| 2,5-mm-Inbusschlüssel | 1 | Für die M3-Schrauben | - - -Der Riemen, die Spanner und der Endeffektor sollten an der Linearschiene bereits in den vorherigen Montageschritten installiert worden sein. - - -## Schritt-für-Schritt-Montage - - - -Verwenden Sie eine der 20-mm-M5-Schrauben, um die Gewinde in den beiden M5-Löchern der OSSM-Motorhead-Bodenplatte leicht vorzuformen. - -Drehen Sie die Schraube gerade so weit hinein, dass sie richtig sitzt und senkrecht zur Oberfläche steht. Mit diesem Schritt können Sie überprüfen, ob die Gewinde sauber und richtig ausgerichtet sind. - - -Die M5-Schraube sollte sich reibungslos eindrehen lassen, ohne zu klemmen oder übermäßige Kraft zu erfordern. - - - - -Stapeln Sie alle drei Lager auf einer der 20-mm-M5-Schrauben. - -Schrauben Sie diese Schraube bis zum Anschlag in die Motorkopf-Bodenplatte, aber ziehen Sie sie nicht zu fest an. - - -Die Lager sollten sauber auf der Schraube gestapelt sein. Stellen Sie sicher, dass sie richtig ausgerichtet sind, bevor Sie die Schraube in die Platte einschrauben. - - - -Ziehen Sie die Schraube nicht zu fest an. Die Lager müssen sich frei drehen können, und ein zu hohes Drehmoment kann das Gewinde beschädigen oder die ordnungsgemäße Bewegung der Lager verhindern. - - - - -Schrauben Sie die zweite 20-mm-M5-Schraube in das verbleibende Loch in der Bodenplatte des Motorkopfs. - -Für diese Schraube müssen keine Lager gestapelt werden – alle drei Lager befinden sich auf der ersten Schraube. - - -Beide M5-Schrauben sollten fest in die Bodenplatte des Motorkopfs eingeschraubt sein. - - - - -Stellen Sie sicher, dass sich alle drei Lager auf der ersten M5-Schraube frei drehen. - -Jedes Lager sollte sich unabhängig drehen, ohne zu klemmen oder übermäßige Reibung zu verursachen. - - -Alle drei Lager drehen sich reibungslos und unabhängig voneinander. Wenn ein Lager festsitzt oder sich nur schwer drehen lässt, überprüfen Sie die korrekte Ausrichtung und stellen Sie sicher, dass die Schraube nicht zu fest angezogen ist. - - - - -Richten Sie die Baugruppe der Motorkopf-Bodenplatte an der Linearschiene aus. - -Stecken Sie die vier 8-mm-M3-Schrauben in die Löcher, mit denen der Motorkopf an der Schiene befestigt wird. - - -Die Bodenplatte des Motorkopfs sollte mit den Befestigungslöchern der Linearschiene ausgerichtet sein. Prüfen Sie nach dem Ausrichten der Löcher noch einmal die korrekte Orientierung, bevor Sie die Schrauben einsetzen. - - - - -Ziehen Sie die vier M3-Schrauben in einem X-Muster an, um eine gleichmäßige Druckverteilung zu gewährleisten. - -Ziehen Sie zunächst alle vier Schrauben leicht an und ziehen Sie sie dann in einem zweiten Durchgang vollständig fest. - - -Dies ist eine kritische Verbindung, die handfest angezogen werden muss. Verwenden Sie eine X-förmige Anzugsreihenfolge (oben links, unten rechts, oben rechts, unten links), um eine gleichmäßige Klemmkraft sicherzustellen und Verformungen oder Fehlausrichtungen zu verhindern. - - - -Alle vier M3-Schrauben sind in einem X-Muster fest angezogen. Die Bodenplatte des Motorkopfs sollte fest und ohne Spiel oder Bewegung an der Linearschiene befestigt sein. - - - - -Verlegen Sie das lose Ende des Riemens so, dass es über den drei gestapelten Lagern verläuft. - -Der Riemen sollte einen gleichmäßigen Verlauf über die Lager haben, ohne Knicke oder Verdrehungen. - - -Der Riemen sollte die Oberseite der gestapelten Lager berühren. Dies gewährleistet eine ordnungsgemäße Riemenführung und verringert die Reibung während des Betriebs. - - - -Der Riemen wird über die drei gestapelten Lager geführt und folgt einem glatten, ungehinderten Weg. - - - - -## Nächste Schritte - -Nachdem die Lager installiert und die Motorkopf-Bodenplatte an der Linearschiene befestigt sind, können Sie im nächsten Abschnitt der Bauanleitung mit der Installation der Motor- und Riemenscheibenbaugruppe fortfahren. - - -[← Vorderer Spanner](/ossm/build/front-tensioner) · [Weiter: Riemenscheibe →](/ossm/build/pulley) diff --git a/content/docs/ossm/build/motorhead.fr.mdx b/content/docs/ossm/build/motorhead.fr.mdx deleted file mode 100644 index a203f78..0000000 --- a/content/docs/ossm/build/motorhead.fr.mdx +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: "4. OSSM Motorhead" -description: "Installez les roulements et fixez la plaque inférieure de la tête du moteur OSSM au rail linéaire" ---- - -La plaque inférieure de la tête de moteur OSSM sert de base à l’ensemble moteur et fournit des points de montage pour les roulements qui guident la courroie. Cette étape consiste à pré-fileter les trous de montage, à empiler et à fixer les roulements, ainsi qu’à fixer la tête du moteur au rail linéaire. - -## Composants et outils requis - -### Composants - -| Composant | Quantité | Spécifications / remarques | -|-----------|-------|----------------------| -| Plaque inférieure OSSM Motorhead | 1 | Plaque inférieure de l’ensemble tête de moteur | -| Roulements | 3 | Empilés sur l’un des boulons M5 | -| Boulons M5 de 20 mm | 2 | Utilisés pour fixer les roulements à la plaque inférieure de la tête du moteur | -| Rail linéaire | 1 | Avec les composants précédemment installés | -| Boulons M3 de 8 mm | 4 | Utilisés pour fixer la tête du moteur au rail linéaire | - -### Outils - -| Outil | Quantité | Spécifications / remarques | -|------|-------|----------------------| -| Clé hexagonale de 4 mm | 1 | Pour les boulons M5 | -| Clé hexagonale de 2,5 mm | 1 | Pour les boulons M3 | - - -La courroie, les tendeurs et l’effecteur final doivent déjà être installés sur le rail linéaire à la suite des étapes d’assemblage précédentes. - - -## Assemblage étape par étape - - - -Utilisez l’un des boulons M5 de 20 mm pour pré-fileter légèrement les deux trous M5 de la plaque inférieure OSSM Motorhead. - -Vissez le boulon juste assez pour vous assurer qu’il s’ajuste correctement et qu’il est perpendiculaire à la surface. Cette étape permet de vérifier que les filetages sont propres et correctement alignés. - - -Le boulon M5 doit se visser sans à-coups, sans se coincer ni nécessiter une force excessive. - - - - -Empilez les trois roulements sur l’un des boulons M5 de 20 mm. - -Vissez ce boulon dans la plaque inférieure de la tête du moteur jusqu’en butée, mais ne le serrez pas trop. - - -Les roulements doivent être empilés proprement sur le boulon. Assurez-vous qu’ils sont correctement alignés avant de visser le boulon dans la plaque. - - - -Ne serrez pas trop le boulon. Les roulements doivent pouvoir tourner librement et un couple excessif peut endommager les filetages ou empêcher la libre rotation des roulements. - - - - -Vissez le deuxième boulon M5 de 20 mm dans le trou restant de la plaque inférieure de la tête du moteur. - -Il n’est pas nécessaire d’empiler des roulements sur ce boulon : les trois roulements se trouvent sur le premier boulon. - - -Les deux boulons M5 doivent être solidement vissés dans la plaque inférieure de la tête du moteur. - - - - -Vérifiez que les trois roulements tournent librement sur le premier boulon M5. - -Chaque roulement doit tourner indépendamment sans grippage ni frottement excessif. - - -Les trois roulements tournent de manière fluide et indépendante. Si un roulement est coincé ou difficile à faire tourner, vérifiez le bon alignement et assurez-vous que le boulon n’est pas trop serré. - - - - -Alignez l’ensemble formé par la plaque inférieure de la tête du moteur avec le rail linéaire. - -Insérez les quatre boulons M3 de 8 mm dans les trous de montage qui relient la tête du moteur au rail. - - -La plaque inférieure de la tête du moteur doit être alignée avec les trous de montage du rail linéaire. Vérifiez l’orientation avant d’insérer les boulons. - - - - -Serrez les quatre boulons M3 selon un motif en X pour assurer une répartition uniforme de la pression. - -Tout d’abord, serrez légèrement les quatre boulons, puis faites un second passage pour les serrer complètement. - - -Il s’agit d’une liaison critique qui doit être serrée à la main. Utilisez une séquence de serrage en X (en haut à gauche, en bas à droite, en haut à droite, en bas à gauche) pour garantir une force de serrage uniforme et éviter toute déformation ou désalignement. - - - -Les quatre boulons M3 sont solidement serrés selon un motif en X. La plaque inférieure de la tête du moteur doit être fermement fixée au rail linéaire, sans jeu ni mouvement. - - - - -Acheminez l’extrémité libre de la courroie de manière à ce qu’elle passe au-dessus des trois roulements empilés. - -La courroie doit suivre un cheminement régulier au-dessus des roulements, sans plis ni torsions. - - -La courroie doit entrer en contact avec le haut des roulements empilés. Cela garantit un bon guidage de la courroie et réduit les frottements pendant le fonctionnement. - - - -La courroie est acheminée au-dessus des trois roulements empilés et suit un cheminement régulier et dégagé. - - - - -## Prochaines étapes - -Une fois les roulements installés et la plaque inférieure de la tête du moteur fixée au rail linéaire, vous pouvez procéder à l’installation de l’ensemble moteur et poulie dans la section suivante du guide de construction. - - -[← Tendeur avant](/ossm/build/front-tensioner) · [Suivant : Poulie →](/ossm/build/pulley) diff --git a/content/docs/ossm/build/motorhead.mdx b/content/docs/ossm/build/motorhead.mdx deleted file mode 100644 index ec05c64..0000000 --- a/content/docs/ossm/build/motorhead.mdx +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: "4. OSSM Motorhead" -description: "Install bearings and attach the OSSM motorhead bottom plate to the linear rail" ---- - -The OSSM motorhead bottom plate serves as the foundation for the motor assembly and provides mounting points for the bearings that guide the belt. This step involves pre-threading the mounting holes, stacking and securing the bearings, and attaching the motorhead to the linear rail. - -## Required Components and Tools - -### Components - -| Component | Count | Specification / Notes | -|-----------|-------|----------------------| -| OSSM Motorhead Bottom plate | 1 | Bottom plate for the motor head assembly | -| Bearings | 3 | Stacked onto one of the M5 bolts | -| M5 20 mm Bolts | 2 | Used to secure the bearings to the motorhead bottom plate | -| Linear Rail | 1 | With previous components attached | -| M3 8 mm Bolts | 4 | Used to attach the motorhead to the linear rail | - -### Tools - -| Tool | Count | Specification / Notes | -|------|-------|----------------------| -| 4 mm Hex | 1 | To fit the M5 bolts | -| 2.5 mm Hex | 1 | To fit the M3 bolts | - - -The linear rail should already have the belt, tensioners, and end effector installed from previous assembly steps. - - -## Step-by-Step Assembly - - - -Use one of the M5 20 mm bolts to lightly pre-thread the two M5 holes on the OSSM Motorhead Bottom plate. - -Thread the bolt in just enough to ensure it fits correctly and is perpendicular to the surface. This step helps verify the threads are clean and properly aligned. - - -The M5 bolt should thread in smoothly without binding or requiring excessive force. - - - - -Stack all three bearings onto one of the M5 20 mm bolts. - -Thread this bolt into the motorhead bottom plate until it bottoms out, but do not overtighten. - - -The bearings should stack neatly on the bolt. Ensure they are properly aligned before threading the bolt into the plate. - - - -Do not overtighten the bolt. The bearings need to spin freely, and excessive torque can damage the threads or prevent proper bearing movement. - - - - -Thread the second M5 20 mm bolt into the remaining hole in the motorhead bottom plate. - -This bolt does not need any bearings stacked on it—all three bearings are on the first bolt. - - -Both M5 bolts should be securely threaded into the motorhead bottom plate. - - - - -Verify that all three bearings spin freely on the first M5 bolt. - -Each bearing should rotate independently without binding or excessive friction. - - -All three bearings rotate smoothly and independently. If any bearing is stuck or difficult to rotate, check for proper alignment and ensure the bolt is not overtightened. - - - - -Align the motorhead bottom plate assembly with the linear rail. - -Insert the four M3 8 mm bolts into the holes that attach the motorhead to the rail. - - -The motorhead bottom plate should align with the mounting holes on the linear rail. Ensure proper orientation before inserting the bolts. - - - - -Tighten the four M3 bolts in an X-pattern to ensure even pressure distribution. - -First, lightly secure all four bolts, then go around again to tighten them fully. - - -This is a critical connection that must be hand-tight. Use an X-pattern tightening sequence (top-left, bottom-right, top-right, bottom-left) to ensure even clamping force and prevent warping or misalignment. - - - -All four M3 bolts are securely tightened in an X-pattern. The motorhead bottom plate should be firmly attached to the linear rail with no play or movement. - - - - -Route the loose end of the belt so that it passes above the three stacked bearings. - -The belt should follow a smooth path over the bearings without kinks or twists. - - -The belt should make contact with the top of the stacked bearings. This ensures proper belt guidance and reduces friction during operation. - - - -The belt is routed above the three stacked bearings and follows a smooth, unobstructed path. - - - - -## Next Steps - -With the bearings installed and the motorhead bottom plate attached to the linear rail, you're ready to proceed with installing the motor and pulley assembly in the next section of the build guide. - - -[← Front tensioner](/ossm/build/front-tensioner) · [Next: Pulley →](/ossm/build/pulley) diff --git a/content/docs/ossm/build/motorhead.nl.mdx b/content/docs/ossm/build/motorhead.nl.mdx deleted file mode 100644 index 3af1a3e..0000000 --- a/content/docs/ossm/build/motorhead.nl.mdx +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: "4. OSSM Motorhead" -description: "Installeer de lagers en bevestig de bodemplaat van de OSSM-motorkop aan de lineaire rail" ---- - -De bodemplaat van de OSSM-motorkop dient als basis voor de motorconstructie en biedt bevestigingspunten voor de lagers die de riem geleiden. Deze stap omvat het vooraf indraaien van de M5-bout in de montagegaten, het stapelen en vastzetten van de lagers en het bevestigen van de motorkop aan de lineaire rail. - -## Vereiste componenten en gereedschappen - -### Componenten - -| Onderdeel | Aantal | Specificatie / opmerkingen | -|-----------|-------|----------------------| -| OSSM Motorhead-bodemplaat | 1 | Bodemplaat voor de motorkopmontage | -| Lagers | 3 | Gestapeld op een van de M5-bouten | -| M5-bouten van 20 mm | 2 | Worden gebruikt om de lagers aan de bodemplaat van de motorkop te bevestigen | -| Lineaire rail | 1 | Met eerder bevestigde onderdelen | -| M3-bouten van 8 mm | 4 | Worden gebruikt om de motorkop aan de lineaire rail te bevestigen | - -### Gereedschappen - -| Gereedschap | Aantal | Specificatie / opmerkingen | -|------|-------|----------------------| -| 4 mm inbussleutel | 1 | Voor de M5-bouten | -| 2,5 mm inbussleutel | 1 | Voor de M3-bouten | - - -De riem, spanners en eindeffector moeten al op de lineaire rail zijn geïnstalleerd tijdens eerdere montagestappen. - - -## Stapsgewijze montage - - - -Gebruik een van de M5-bouten van 20 mm om deze vooraf licht in de twee M5-gaten van de OSSM Motorhead-bodemplaat te draaien. - -Draai de bout er net ver genoeg in om ervoor te zorgen dat deze goed past en loodrecht op het oppervlak staat. Met deze stap kunt u controleren of de schroefdraad schoon is en goed is uitgelijnd. - - -De M5-bout moet soepel indraaien zonder vast te lopen of overmatige kracht te vereisen. - - - - -Stapel alle drie de lagers op een van de M5-bouten van 20 mm. - -Draai deze bout in de bodemplaat van de motorkop tot hij niet verder kan, maar draai hem niet te vast aan. - - -De lagers moeten netjes op de bout worden gestapeld. Zorg ervoor dat ze goed zijn uitgelijnd voordat u de bout in de plaat draait. - - - -Draai de bout niet te vast. De lagers moeten vrij kunnen draaien, en een te hoog koppel kan de schroefdraad beschadigen of de vrije beweging van de lagers verhinderen. - - - - -Draai de tweede M5-bout van 20 mm in het resterende gat in de bodemplaat van de motorkop. - -Deze bout hoeft niet van lagers te zijn voorzien; alle drie de lagers bevinden zich op de eerste bout. - - -Beide M5-bouten moeten stevig in de bodemplaat van de motorkop worden gedraaid. - - - - -Controleer of alle drie de lagers vrij ronddraaien op de eerste M5-bout. - -Elk lager moet onafhankelijk draaien zonder aan te lopen of overmatige wrijving te veroorzaken. - - -Alle drie de lagers draaien soepel en onafhankelijk. Als een lager vastzit of moeilijk draait, controleer dan of de uitlijning goed is en zorg ervoor dat de bout niet te strak is aangedraaid. - - - - -Lijn de volledige bodemplaatassemblage van de OSSM Motorhead uit met de lineaire rail. - -Steek de vier M3-bouten van 8 mm in de gaten waarmee de motorkop aan de rail wordt bevestigd. - - -De bodemplaat van de motorkop moet uitgelijnd zijn met de montagegaten van de lineaire rail. Zorg voor de juiste oriëntatie voordat u de bouten erin steekt. - - - - -Draai de vier M3-bouten in een X-patroon vast om een gelijkmatige drukverdeling te garanderen. - -Draai eerst alle vier de bouten lichtjes vast en draai ze vervolgens in een tweede ronde volledig vast. - - -Dit is een kritische verbinding die handvast moet zijn. Gebruik een X-vormige aanhaalvolgorde (linksboven, rechtsonder, rechtsboven, linksonder) om een gelijkmatige klemkracht te garanderen en kromtrekken of verkeerde uitlijning te voorkomen. - - - -Alle vier de M3-bouten zijn in een X-patroon stevig vastgedraaid. De bodemplaat van de motorkop moet stevig aan de lineaire rail zijn bevestigd, zonder speling of beweging. - - - - -Voer het losse uiteinde van de riem zo dat het boven de drie gestapelde lagers doorloopt. - -De riem moet een soepel traject over de lagers volgen, zonder knikken of verdraaiingen. - - -De riem moet contact maken met de bovenkant van de gestapelde lagers. Dit zorgt voor een goede riemgeleiding en vermindert de wrijving tijdens het gebruik. - - - -De riem wordt boven de drie gestapelde lagers geleid en volgt een soepel, onbelemmerd pad. - - - - -## Volgende stappen - -Nu de lagers zijn geïnstalleerd en de bodemplaat van de motorkop aan de lineaire rail is bevestigd, kunt u in het volgende gedeelte van de bouwhandleiding verdergaan met de installatie van de motor- en poelieconstructie. - - -[← Voorste spanner](/ossm/build/front-tensioner) · [Volgende: Poelie →](/ossm/build/pulley) diff --git a/content/docs/ossm/build/printed-parts.de.mdx b/content/docs/ossm/build/printed-parts.de.mdx deleted file mode 100644 index 4a1e251..0000000 --- a/content/docs/ossm/build/printed-parts.de.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Standard-Druckteile -description: Drucken und prüfen Sie die Teile für den offiziellen OSSM-Aufbau. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-1.2_3d-printing-parts */} - -## Druckeinstellungen - -Verwenden Sie PETG oder ABS, eine Schichthöhe von 0,2–0,28 mm, 4–5 Perimeter und eine Füllung von 40–60 %. Verwenden Sie eine Düse von 0,4–0,6 mm. Richten Sie tragende Teile so aus, dass die Schichtlinien quer zur erwarteten Kraftrichtung verlaufen. - -## Checkliste für Standardteile - -Drucken Sie jeweils eines aus, es sei denn, es wird eine andere Menge angezeigt: - -- Gehäusebasis -- Gehäusemittelteil – Standardversion -- Motorhead-Abdeckung -- PCB-Montagegehäuse und -deckel -- Riemenklemme: am Spannerende -- Riemenklemme: oben -- Riemenklemme: unten -- PitClamp 57AIM-Ring, unteres Standardteil, Oberteil und Griff, sechseckiger Dogbone und runder Dogbone -- Spielzeughalterung für die Schiene mit 24-mm-Gewinde -- 24-mm-Kontermutter -- Vac-u-lock-Adapter -- Gehäuse und obere Abdeckung der kabelgebundenen Fernbedienung -- Drehknöpfe der kabelgebundenen Fernbedienung ×2 - - - ![OSSM-Gehäusebasis](./assets/legacy/legacy_assembly_instructions_body_base.webp) - - -## Jeden Druck prüfen - -Entfernen Sie Stützstrukturen und loses Material. Weisen Sie Teile mit Rissen, Schichtablösungen, verformten Befestigungslöchern oder schlechter Passung an einer tragenden Fläche zurück. Montieren Sie das PCB-Gehäuse probeweise und prüfen Sie, ob sich die Kontermutter leicht auf den 24-mm-Adapter schrauben lässt. - - - Fahren Sie nur fort, wenn alle Standardteile vorhanden, sauber und unbeschädigt sind und mit der für diesen Aufbau aufgeführten Hardware übereinstimmen. - - -[← Stückliste](/ossm/build/bill-of-materials) · [Weiter: Hinterer Spanner →](/ossm/build/rear-tensioner) diff --git a/content/docs/ossm/build/printed-parts.fr.mdx b/content/docs/ossm/build/printed-parts.fr.mdx deleted file mode 100644 index 6da4ed7..0000000 --- a/content/docs/ossm/build/printed-parts.fr.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Pièces imprimées standard -description: Imprimez et inspectez les pièces de l’assemblage OSSM officiel. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-1.2_3d-printing-parts */} - -## Paramètres d’impression - -Utilisez du PETG ou de l’ABS, une hauteur de couche de 0,2 à 0,28 mm, 4 à 5 périmètres et un remplissage de 40 à 60 %. Utilisez une buse de 0,4 à 0,6 mm. Orientez les pièces porteuses de manière à ce que les lignes de couche soient perpendiculaires à la direction de la force attendue. - -## Liste de contrôle des pièces standard - -Imprimez un exemplaire de chaque pièce, sauf si une quantité différente est indiquée : - -- Base du boîtier -- Section centrale du boîtier — version standard -- Couvercle du Motorhead -- Boîtier et couvercle de montage du PCB -- Pince de courroie : extrémité du tendeur -- Pince de courroie : partie supérieure -- Pince de courroie : partie inférieure -- Bague PitClamp 57AIM, pièce standard inférieure, pièce supérieure et poignée, dogbone hexagonal et dogbone rond -- Support de jouet pour rail avec filetage de 24 mm -- Contre-écrou de 24 mm -- Adaptateur Vac-u-lock -- Boîtier et capot supérieur de la télécommande filaire -- Boutons rotatifs de la télécommande filaire ×2 - - - ![Base du boîtier OSSM](./assets/legacy/legacy_assembly_instructions_body_base.webp) - - -## Inspecter chaque pièce imprimée - -Retirez les supports et les matériaux détachés. Mettez au rebut toute pièce présentant des fissures, un délaminage, des trous de fixation déformés ou un mauvais ajustement sur une surface porteuse. Montez à blanc le boîtier du PCB et vérifiez que le contre-écrou se visse facilement sur l’adaptateur de 24 mm. - - - Continuez uniquement lorsque chaque pièce standard est présente, propre, intacte et conforme au matériel répertorié pour cet assemblage. - - -[← Nomenclature](/ossm/build/bill-of-materials) · [Suivant : Tendeur arrière →](/ossm/build/rear-tensioner) diff --git a/content/docs/ossm/build/printed-parts.mdx b/content/docs/ossm/build/printed-parts.mdx deleted file mode 100644 index 840ea5f..0000000 --- a/content/docs/ossm/build/printed-parts.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Standard Printed Parts -description: Print and inspect the parts used by the official OSSM build. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-1.2_3d-printing-parts */} - -## Print settings - -Use PETG or ABS, a 0.2–0.28 mm layer height, 4–5 perimeters, and 40–60% infill. Use a 0.4–0.6 mm nozzle. Orient load-bearing parts so layer lines run across the expected force. - -## Standard parts checklist - -Print one of each unless a different quantity is shown: - -- Body base -- Body middle — standard version -- Motorhead cover -- PCB mount box and lid -- Belt clamp: tensioner end -- Belt clamp: top -- Belt clamp: bottom -- PitClamp 57AIM ring, lower standard, upper and handle, hex dogbone, and round dogbone -- Rail-to-24 mm thread toy mount -- 24 mm jam nut -- Vac-u-lock adapter -- Wired remote body and top cover -- Wired remote knobs ×2 - - - ![OSSM body base](./assets/legacy/legacy_assembly_instructions_body_base.webp) - - -## Inspect every print - -Remove supports and loose material. Reject a part with cracks, layer separation, distorted fastener holes, or poor fit at a load-bearing surface. Dry-fit the PCB enclosure and check that the jam nut threads smoothly onto the 24 mm adapter. - - - Continue only when every standard part is present, clean, undamaged, and matches the hardware listed for this build. - - -[← Bill of materials](/ossm/build/bill-of-materials) · [Next: Rear tensioner →](/ossm/build/rear-tensioner) diff --git a/content/docs/ossm/build/printed-parts.nl.mdx b/content/docs/ossm/build/printed-parts.nl.mdx deleted file mode 100644 index 62757f9..0000000 --- a/content/docs/ossm/build/printed-parts.nl.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Standaard geprinte onderdelen -description: Print en inspecteer de onderdelen voor de officiële OSSM-bouw. ---- -{/* Migrated from: https://docs.researchanddesire.com/ossm/guides/getting-started/build-guide/step-1.2_3d-printing-parts */} - -## Afdrukinstellingen - -Gebruik PETG of ABS, een laaghoogte van 0,2–0,28 mm, 4–5 perimeters en een vulling van 40–60 %. Gebruik een nozzle van 0,4–0,6 mm. Oriënteer dragende onderdelen zo dat de laaglijnen dwars op de verwachte krachtrichting lopen. - -## Checklist voor standaardonderdelen - -Print er één van elk, tenzij er een ander aantal wordt weergegeven: - -- Basis van de behuizing -- Middendeel van de behuizing – standaardversie -- Motorhead-afdekking -- PCB-montagebehuizing en deksel -- Riemklem: uiteinde van de spanner -- Riemklem: bovenkant -- Riemklem: onderkant -- PitClamp 57AIM-ring, onderste standaarddeel, bovenstuk en handgreep, zeskantige dogbone en ronde dogbone -- Speelgoedhouder voor rail met 24 mm-schroefdraad -- Contramoer van 24 mm -- Vac-u-lock-adapter -- Behuizing en bovenklep van de bedrade afstandsbediening -- Draaiknoppen van de bedrade afstandsbediening ×2 - - - ![Basis van de OSSM-behuizing](./assets/legacy/legacy_assembly_instructions_body_base.webp) - - -## Elke print inspecteren - -Verwijder supports en los materiaal. Keur onderdelen met scheuren, losgeraakte lagen, vervormde bevestigingsgaten of een slechte pasvorm op een dragend oppervlak af. Pas de PCB-behuizing eerst zonder bevestiging en controleer of de contramoer soepel op de 24 mm-adapter schroeft. - - - Ga alleen verder als elk standaardonderdeel aanwezig, schoon en onbeschadigd is en overeenkomt met de hardware die voor deze bouw is vermeld. - - -[← Stuklijst](/ossm/build/bill-of-materials) · [Volgende: Achterste spanner →](/ossm/build/rear-tensioner) diff --git a/content/docs/ossm/build/pulley.de.mdx b/content/docs/ossm/build/pulley.de.mdx deleted file mode 100644 index fdda2c8..0000000 --- a/content/docs/ossm/build/pulley.de.mdx +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: "5. Riemenscheibe am Motor" -description: "Montieren Sie die Riemenscheibe auf der Motorwelle und richten Sie sie für die korrekte Spannung am Riemen aus" ---- - -Die Riemenscheibe überträgt die Kraft vom Motor auf den Riemen und treibt so den Linearantrieb an. Die ordnungsgemäße Installation und Ausrichtung der Riemenscheibe auf der Motorwelle ist entscheidend für einen reibungslosen Betrieb und eine optimale Riemenspannung. - -## Erforderliche Komponenten und Werkzeuge - -### Komponenten - -| Komponente | Anzahl | Spezifikation / Hinweise | -|-----------|-------|----------------------| -| Motor | 1 | Mit einer Abflachung an der Welle | -| Riemenscheibe | 1 | Zur Montage auf der Motorwelle | -| Madenschrauben | 2 | Zur Befestigung der Riemenscheibe an der Motorwelle | -| Riemen | 1 | Verbleibendes loses Ende aus vorherigen Montageschritten | - -### Werkzeuge - -| Werkzeug | Anzahl | Spezifikation / Hinweise | -|------|-------|----------------------| -| 2-mm-Sechskantschlüssel | 1 | Passend für die Madenschrauben (auch „Small Allen“ genannt) | - - -Die Motorwelle muss eine eingearbeitete Abflachung aufweisen. Diese Abflachung bietet eine sichere Auflagefläche für die Madenschrauben und verhindert, dass die Riemenscheibe während des Betriebs verrutscht. - - -## Schritt-für-Schritt-Montage - - - -Schieben Sie die Riemenscheibe auf die Motorwelle. Richten Sie eine der Madenschrauben der Riemenscheibe an der Abflachung der Motorwelle aus. - - -Wenn sich die Bohrung der Riemenscheibe zu eng anfühlt, um sie auf die Motorwelle zu schieben, können sich darin Grate oder Rückstände aus der Fertigung befinden. Bevor Sie einen Ersatz anfordern: - -1. **Überprüfen Sie die Madenschrauben** – Stellen Sie sicher, dass sie vollständig zurückgedreht sind und nicht in die Bohrung hineinragen -2. **Inspizieren Sie die Bohrung** – Suchen Sie nach sichtbaren Graten, rauen Stellen oder Fremdkörpern in der Riemenscheibenbohrung -3. **Grate entfernen** – Schleifen Sie das Innere der Bohrung leicht mit feinkörnigem Schleifpapier (Körnung 320 oder höher) ab, um etwaige Herstellungsgrate zu entfernen -4. **Reinigen und erneut versuchen** – Wischen Sie alle Rückstände ab und versuchen Sie erneut, die Riemenscheibe auf die Welle zu schieben - -Dies behebt in der Regel das Problem eng sitzender Riemenscheiben. Wenn die Riemenscheibe nach dem Entfernen der Grate immer noch nicht passt, wenden Sie sich für einen Ersatz an den Support. - - -Ziehen Sie die erste Madenschraube mit dem 2-mm-Sechskantschlüssel leicht an. Die Riemenscheibe sollte sich nicht frei drehen, aber sich zur Einstellung noch leicht auf der Welle auf und ab verschieben lassen. - - -Durch leichtes Anziehen können Sie die vertikale Position der Riemenscheibe anpassen und gleichzeitig genügend Halt beibehalten, um eine Drehung zu verhindern. Dies ist wichtig, um im nächsten Schritt eine korrekte Riemenausrichtung zu erreichen. - - - -Die Riemenscheibe sollte fest genug sein, dass sie sich nicht dreht, aber locker genug, dass Sie sie mit leichtem Druck immer noch vertikal entlang der Welle bewegen können. - - - - -Führen Sie den Riemen über die Riemenscheibe und ziehen Sie ihn vorsichtig etwas an. Die Spannung sollte die Riemenscheibe auf der Motorwelle in die korrekte vertikale Ausrichtung ziehen. - - -Üben Sie zu diesem Zeitpunkt keine übermäßige Spannung aus. Sie verwenden die Riemenspannung in erster Linie, um die Riemenscheibe vertikal auszurichten, und nicht, um die endgültige Riemenspannung festzulegen. - - - -Die Riemenscheibe sollte vertikal korrekt am Riemenverlauf ausgerichtet sein. Der Riemen sollte ohne Klemmen oder Fehlstellung richtig in den Rillen der Riemenscheibe sitzen. - - - - -Ziehen Sie die erste Madenschraube, die Sie zunächst leicht angezogen haben, vollständig an. Stellen Sie sicher, dass sie fest an der Abflachung der Motorwelle anliegt. - -Drehen Sie die Riemenscheibe, um an die zweite Madenschraube zu gelangen. Richten Sie diese zweite Madenschraube an der Abflachung der Motorwelle aus und ziehen Sie sie vollständig fest. - - -Beide Madenschrauben müssen fest gegen die Abflachung der Motorwelle angezogen werden. Wenn eine der Madenschrauben nicht richtig mit der Abflachung ausgerichtet ist, kann die Riemenscheibe während des Betriebs durchrutschen, was zu Schäden oder schlechter Leistung führen kann. - - - -Beide Madenschrauben sollten vollständig angezogen sein und fest an der Abflachung der Motorwelle anliegen. Die Riemenscheibe darf sich weder drehen noch auf der Welle verschieben lassen. - - - - -Spannen Sie den Riemen auf der offenen Seite leicht an, um die Ausrichtung der Riemenscheibe beizubehalten. Dies sorgt für eine Vorspannung, um die Position der Riemenscheibe beizubehalten. - - -Dies ist eine anfängliche Spannungseinstellung, um die Ausrichtung aufrechtzuerhalten. Die endgültige Riemenspannung wird in einem späteren Schritt eingestellt, nachdem alle Komponenten vollständig zusammengebaut sind. - - - -Der Riemen sollte eine leichte Spannung haben, die die Riemenscheibe in ihrer ausgerichteten Position hält, ohne zu fest zu sein. - - - - -## Nächste Schritte - -Wenn die Riemenscheibe sicher auf der Motorwelle montiert und der Riemen zunächst gespannt ist, fahren Sie mit dem nächsten Abschnitt der Motorkopfmontage fort. - - -[← Motorhead](/ossm/build/motorhead) · [Weiter: Motorhead-Mittelteil →](/ossm/build/motorhead-middle) diff --git a/content/docs/ossm/build/pulley.fr.mdx b/content/docs/ossm/build/pulley.fr.mdx deleted file mode 100644 index 606d709..0000000 --- a/content/docs/ossm/build/pulley.fr.mdx +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: "5. Poulie sur le moteur" -description: "Montez la poulie sur l’arbre du moteur et alignez-la avec la courroie pour obtenir la tension appropriée" ---- - -La poulie transfère la puissance du moteur à la courroie, entraînant l'actionneur linéaire. Une installation et un alignement corrects de la poulie sur l'arbre du moteur sont essentiels pour un fonctionnement fluide et une tension optimale de la courroie. - -## Composants et outils requis - -### Composants - -| Composant | Quantité | Spécifications / remarques | -|-----------|-------|----------------------| -| Moteur | 1 | Avec un méplat sur l'arbre | -| Poulie | 1 | À monter sur l’arbre du moteur | -| Vis sans tête | 2 | Pour fixer la poulie à l’arbre du moteur | -| Courroie | 1 | Extrémité libre restante des étapes d’assemblage précédentes | - -### Outils - -| Outil | Quantité | Spécifications / remarques | -|------|-------|----------------------| -| Clé hexagonale de 2 mm | 1 | Convient aux vis sans tête (également appelées « Small Allen ») | - - -L’arbre du moteur doit comporter un méplat usiné. Ce méplat fournit une surface d’appui sûre pour les vis sans tête et empêche la poulie de glisser pendant le fonctionnement. - - -## Assemblage étape par étape - - - -Faites glisser la poulie sur l’arbre du moteur. Alignez l’une de ses vis sans tête avec le méplat de l’arbre du moteur. - - -Si l’alésage de la poulie semble trop serré pour glisser sur l’arbre du moteur, il peut contenir des bavures ou des débris de fabrication. Avant de demander un remplacement : - -1. **Vérifiez les vis sans tête** — Assurez-vous qu’elles sont complètement dévissées et qu’elles ne dépassent pas dans l’alésage. -2. **Inspectez l'alésage** — Recherchez des bavures visibles, des zones rugueuses ou des débris à l'intérieur de l'alésage de la poulie. -3. **Enlever les bavures** — Poncez légèrement l'intérieur de l'alésage avec du papier de verre à grain fin (grain 320 ou plus) pour éliminer toutes les bavures de fabrication. -4. **Nettoyer et réessayer** — Essuyez tous les débris et essayez à nouveau de faire glisser la poulie sur l'arbre. - -Cela résout généralement le problème des poulies dont l’alésage est trop serré. Si la poulie ne s’emboîte toujours pas après le retrait des bavures, contactez l’assistance pour obtenir un remplacement. - - -Utilisez la clé hexagonale de 2 mm pour serrer légèrement la première vis sans tête. La poulie ne doit pas tourner librement, mais doit encore pouvoir coulisser légèrement de haut en bas sur l’arbre pour le réglage. - - -Un léger serrage permet d’ajuster la position verticale de la poulie tout en conservant un maintien suffisant pour empêcher la rotation. Cela est important pour obtenir un alignement correct de la courroie à l’étape suivante. - - - -La poulie doit être suffisamment serrée pour ne pas tourner, mais suffisamment desserrée pour pouvoir être déplacée verticalement le long de l’arbre avec une légère pression. - - - - -Faites passer la courroie sur la poulie et tirez-la doucement pour la tendre. La tension doit amener la poulie dans son alignement vertical correct sur l’arbre du moteur. - - -N'appliquez pas de tension excessive à ce stade. Vous utilisez la tension de la courroie principalement pour aligner la poulie verticalement, et non pour régler la tension finale de la courroie. - - - -La poulie doit être correctement alignée verticalement avec le chemin de la courroie. La courroie doit être correctement placée dans les rainures de la poulie, sans coincement ni désalignement. - - - - -Serrez complètement la première vis sans tête que vous avez d’abord légèrement serrée. Assurez-vous qu’elle appuie fermement contre le méplat de l’arbre du moteur. - -Faites tourner la poulie pour accéder à la deuxième vis sans tête. Alignez cette deuxième vis sans tête avec le méplat de l’arbre du moteur et serrez-la complètement. - - -Les deux vis sans tête doivent être fermement serrées contre le méplat de l’arbre du moteur. Si l’une des vis sans tête n’est pas correctement alignée avec le méplat, la poulie peut glisser pendant le fonctionnement, provoquant des dommages ou de mauvaises performances. - - - -Les deux vis sans tête doivent être complètement serrées et fermement appuyées contre le méplat de l’arbre du moteur. La poulie ne doit pas pouvoir tourner ni glisser sur l’arbre. - - - - -Tendez légèrement la courroie du côté ouvert pour maintenir l’alignement de la poulie. Cela fournit une tension initiale pour maintenir la position de la poulie. - - -Il s’agit d’un réglage initial de la tension pour maintenir l’alignement. Le réglage final de la tension de la courroie sera effectué dans une étape ultérieure, une fois tous les composants entièrement assemblés. - - - -La courroie doit avoir une légère tension qui maintient la poulie dans sa position alignée sans être trop tendue. - - - - -## Prochaines étapes - -Une fois la poulie solidement montée sur l’arbre du moteur et la courroie initialement tendue, passez à la section suivante pour poursuivre l’assemblage de la tête du moteur. - - -[← Motorhead](/ossm/build/motorhead) · [Suivant : Section centrale du Motorhead →](/ossm/build/motorhead-middle) diff --git a/content/docs/ossm/build/pulley.mdx b/content/docs/ossm/build/pulley.mdx deleted file mode 100644 index d24347e..0000000 --- a/content/docs/ossm/build/pulley.mdx +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: "5. Pulley on Motor" -description: "Mount the pulley to the motor shaft and align it with the belt for proper tension" ---- - -The pulley transfers power from the motor to the belt, driving the linear actuator. Proper installation and alignment of the pulley on the motor shaft is critical for smooth operation and optimal belt tension. - -## Required Components and Tools - -### Components - -| Component | Count | Specification / Notes | -|-----------|-------|----------------------| -| Motor | 1 | With a flat spot on the shaft | -| Pulley | 1 | To be mounted on the motor shaft | -| Grub Screws | 2 | Used to secure the pulley to the motor shaft | -| Belt | 1 | Remaining loose end from previous assembly steps | - -### Tools - -| Tool | Count | Specification / Notes | -|------|-------|----------------------| -| 2 mm Hex | 1 | Fits the grub screws (also called "Small Allen") | - - -The motor shaft must have a flat spot machined on it. This flat spot provides a secure surface for the grub screws to grip, preventing the pulley from slipping during operation. - - -## Step-by-Step Assembly - - - -Slide the pulley onto the motor shaft. Align one of the pulley's grub screws with the flat spot on the motor shaft. - - -If the pulley bore feels too tight to slide onto the motor shaft, the bore may have burrs or debris from manufacturing. Before requesting a replacement: - -1. **Check the grub screws** — Ensure they are fully backed out and not protruding into the bore -2. **Inspect the bore** — Look for visible burrs, rough spots, or debris inside the pulley bore -3. **Remove burrs** — Lightly sand the interior of the bore with fine-grit sandpaper (320 grit or higher) to remove any manufacturing burrs -4. **Clean and retry** — Wipe out any debris and try sliding the pulley onto the shaft again - -This usually resolves tight-fitting pulleys. If the pulley still doesn't fit after removing burrs, contact support for a replacement. - - -Use the 2 mm hex tool to lightly tighten the first grub screw. The pulley should not spin freely, but it should still be able to slide slightly up and down the shaft for adjustment. - - -Light tightening allows you to adjust the pulley's vertical position while maintaining enough grip to prevent rotation. This is important for achieving proper belt alignment in the next step. - - - -The pulley should be secure enough that it doesn't rotate, but loose enough that you can still move it vertically along the shaft with gentle pressure. - - - - -Route the belt over the pulley and gently pull some tension on the belt. The tension should pull the pulley into its correct vertical alignment on the motor shaft. - - -Do not apply excessive tension at this stage. You're using the belt tension primarily to align the pulley vertically, not to set the final belt tension. - - - -The pulley should be properly aligned vertically with the belt path. The belt should sit correctly in the pulley grooves without binding or misalignment. - - - - -Fully tighten the first grub screw that you initially set. Ensure it is firmly against the flat spot on the motor shaft. - -Rotate the pulley to access the second grub screw. Align this second grub screw with the flat spot on the motor shaft and tighten it completely. - - -Both grub screws must be firmly tightened against the flat spot on the motor shaft. If either grub screw is not properly aligned with the flat spot, the pulley may slip during operation, causing damage or poor performance. - - - -Both grub screws should be fully tightened and firmly seated against the flat spot on the motor shaft. The pulley should not be able to rotate or slide on the shaft. - - - - -Tighten the belt just a little on the open side to hold the pulley's alignment. This provides initial tension to maintain the pulley's position. - - -This is an initial tension setting to maintain alignment. Final belt tensioning will occur in a later step after all components are fully assembled. - - - -The belt should have light tension that holds the pulley in its aligned position without being overly tight. - - - - -## Next Steps - -With the pulley securely mounted on the motor shaft and the belt initially tensioned, proceed to the next section to continue the motor head assembly. - - -[← Motorhead](/ossm/build/motorhead) · [Next: Motorhead middle →](/ossm/build/motorhead-middle) diff --git a/content/docs/ossm/build/pulley.nl.mdx b/content/docs/ossm/build/pulley.nl.mdx deleted file mode 100644 index e254884..0000000 --- a/content/docs/ossm/build/pulley.nl.mdx +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: "5. Poelie op de motor" -description: "Monteer de poelie op de motoras en lijn deze uit met de riem voor de juiste spanning" ---- - -De poelie brengt het vermogen over van de motor naar de riem en drijft de lineaire actuator aan. Een juiste installatie en uitlijning van de poelie op de motoras is van cruciaal belang voor een soepele werking en optimale riemspanning. - -## Vereiste onderdelen en gereedschappen - -### Componenten - -| Onderdeel | Aantal | Specificatie / opmerkingen | -|-----------|-------|----------------------| -| Motor | 1 | Met een afvlakking op de as | -| Poelie | 1 | Wordt op de motoras gemonteerd | -| Stelschroeven | 2 | Om de poelie aan de motoras te bevestigen | -| Riem | 1 | Resterend los uiteinde uit eerdere montagestappen | - -### Gereedschappen - -| Gereedschap | Aantal | Specificatie / opmerkingen | -|------|-------|----------------------| -| Inbussleutel van 2 mm | 1 | Past op de stelschroeven (ook wel "Small Allen" genoemd) | - - -Op de motoras moet een afvlakking zijn aangebracht. Deze afvlakking biedt een veilig aangrijpingsvlak voor de stelschroeven en voorkomt dat de poelie tijdens gebruik wegglijdt. - - -## Stapsgewijze montage - - - -Schuif de poelie op de motoras. Lijn een van de stelschroeven van de poelie uit met de afvlakking op de motoras. - - -Als de boring van de poelie te strak aanvoelt om deze op de motoras te schuiven, kunnen er productiebraampjes of vuil in zitten. Voordat u een vervanging aanvraagt: - -1. **Controleer de stelschroeven** — Zorg ervoor dat ze volledig naar buiten zijn gedraaid en niet in de boring uitsteken -2. **Inspecteer de boring** — Zoek naar zichtbare bramen, ruwe plekken of vuil in de poelieboring -3. **Verwijder bramen** — Schuur de binnenkant van de boring lichtjes met fijn schuurpapier (korrel 320 of hoger) om eventuele fabricagebramen te verwijderen -4. **Reinigen en opnieuw proberen** — Veeg eventueel vuil weg en probeer de poelie opnieuw op de as te schuiven - -Dit verhelpt meestal het probleem van een poelie met een te strakke boring. Als de poelie na het verwijderen van de bramen nog steeds niet past, neem dan contact op met de klantenservice voor een vervanging. - - -Gebruik de inbussleutel van 2 mm om de eerste stelschroef licht aan te draaien. De poelie mag niet vrij ronddraaien, maar moet voor afstelling nog licht op en neer over de as kunnen schuiven. - - -Door licht aan te draaien kunt u de verticale positie van de poelie aanpassen en toch voldoende grip behouden om draaien te voorkomen. Dit is belangrijk voor een goede uitlijning van de riem in de volgende stap. - - - -De poelie moet stevig genoeg vastzitten om niet te draaien, maar los genoeg om hem met lichte druk verticaal langs de as te kunnen bewegen. - - - - -Leid de riem over de poelie en breng voorzichtig wat spanning op de riem. De spanning moet de poelie op de motoras naar de juiste verticale uitlijning trekken. - - -Oefen in dit stadium geen overmatige spanning uit. U gebruikt de riemspanning voornamelijk om de poelie verticaal uit te lijnen, niet om de uiteindelijke riemspanning in te stellen. - - - -De poelie moet verticaal goed met het riempad zijn uitgelijnd. De riem moet correct in de groeven van de poelie liggen, zonder te klemmen of verkeerd uitgelijnd te zijn. - - - - -Draai de eerste stelschroef die u eerder licht hebt aangedraaid volledig vast. Zorg ervoor dat deze stevig tegen de afvlakking op de motoras rust. - -Draai de poelie om toegang te krijgen tot de tweede stelschroef. Lijn deze tweede stelschroef uit met de afvlakking op de motoras en draai hem volledig vast. - - -Beide stelschroeven moeten stevig tegen de afvlakking op de motoras worden aangedraaid. Als een van de stelschroeven niet goed is uitgelijnd met de afvlakking, kan de poelie tijdens bedrijf gaan slippen, wat schade of slechte prestaties kan veroorzaken. - - - -Beide stelschroeven moeten volledig worden vastgedraaid en stevig tegen de afvlakking op de motoras zitten. De poelie mag niet kunnen draaien of over de as schuiven. - - - - -Span de riem aan de open kant een klein beetje aan om de poelie in lijn te houden. Dit zorgt voor initiële spanning om de positie van de poelie te behouden. - - -Dit is een initiële spanningsinstelling om de uitlijning te behouden. De definitieve riemspanning wordt in een latere stap ingesteld nadat alle componenten volledig zijn gemonteerd. - - - -De riem moet een lichte spanning hebben die de poelie in de uitgelijnde positie houdt zonder te strak te staan. - - - - -## Volgende stappen - -Nu de poelie stevig op de motoras is gemonteerd en de riem aanvankelijk is gespannen, gaat u verder met het volgende gedeelte van de motorkopmontage. - - -[← Motorhead](/ossm/build/motorhead) · [Volgende: Motorhead-middendeel →](/ossm/build/motorhead-middle) diff --git a/content/docs/ossm/build/rear-tensioner.de.mdx b/content/docs/ossm/build/rear-tensioner.de.mdx deleted file mode 100644 index 0d18487..0000000 --- a/content/docs/ossm/build/rear-tensioner.de.mdx +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: "1. Hinterer Spanner" -description: "Installieren Sie den hinteren Spanner und fädeln Sie den Riemen ein, um die Linearschienenbaugruppe vorzubereiten" ---- - -Der hintere Spanner ist die erste Komponente, die Sie an der Linearschiene installieren. Er stellt den Mechanismus zum Einstellen der Riemenspannung bereit und sichert ein Ende des Riemens an der Schienenbaugruppe. - -## Erforderliche Komponenten und Werkzeuge - -### Komponenten - -| Komponente | Anzahl | Spezifikation / Hinweise | -|-----------|-------|----------------------| -| Linearschiene | 1 | Mit montierten Endanschlägen | -| Riemen | 1 | Hauptriemen mit Rillen | -| Hinteres Spannstück | 1 | Hauptspannerkomponente | -| M3-Schraube | 1 | 20 mm (für Spannbrücke) | -| M3-Mutter | 1 | Für die 20-mm-M3-Schraube | -| M5-Mutter | 1 | Gleitet in die Öffnung des Spanners | -| M5-Schraube | 1 | Ungefähr 20 mm (zur anfänglichen Spannungseinstellung) | - -### Werkzeuge - -| Werkzeug | Anzahl | Spezifikation / Hinweise | -|------|-------|----------------------| -| 2,5-mm-Inbusschlüssel | 1 | Für die M3-Schraube | -| 4-mm-Inbusschlüssel | 1 | Für die M5-Schraube | -| Kleiner Schlitzschraubendreher | 1 | Oder ein gleichwertiges Werkzeug, um die Muttern an Ort und Stelle zu halten | - - -Die Installation des hinteren Spanners umfasst das anfängliche Einfädeln des Riemens. Die endgültige Riemenspannung stellen Sie später im Bauprozess ein, nachdem alle Komponenten zusammengebaut sind. - - -## Schritt-für-Schritt-Montage - - - -Richten Sie den Riemen so aus, dass die Rillen zur Unterseite der Linearschiene zeigen. Biegen Sie den Riemen und führen Sie ihn durch die erste Öffnung des hinteren Spannteils. - -Schlingen Sie den Riemen unter sich selbst zurück, sodass die Rillen des auslaufenden Riemens die Rillen des einlaufenden Riemens berühren. Ziehen Sie den Riemen gerade so weit heraus, dass etwa vier Zähne sichtbar sind. - - -Der Riemen sollte eine Schlaufe durch den Spanner bilden, wobei am losen Ende etwa vier Zähne sichtbar sind. - - - - -Entfernen Sie einen der kleinen Gummi-Endanschläge von der Linearschiene. - -Schieben Sie das hintere Spannstück auf die Linearschiene. Bewegen Sie es vorsichtig hin und her, um sicherzustellen, dass die inneren Lager der Schiene an Ort und Stelle bleiben. - -Ziehen Sie am losen Ende des Riemens, bis der Riemen fest an der Baugruppe anliegt. - - -Durch vorsichtiges Hin- und Herbewegen gleitet der Spanner reibungslos auf die Schiene, ohne dass sich die inneren Lager lösen. Wenn Sie einen Widerstand spüren, überprüfen Sie, ob die Schiene sauber und der Spanner richtig ausgerichtet ist. - - - - -Stecken Sie die 20-mm-M3-Schraube durch das Spannstück und befestigen Sie sie mit einer M3-Mutter. - -Ziehen Sie diese Schraube nur so fest an, dass die Brücke des Spannstücks verstärkt wird. - - -Ziehen Sie die M3-Schraube nicht zu fest an. Sie sollte fest genug sitzen, um die Brücke zu verstärken, aber übermäßige Krafteinwirkung könnte das Spannstück beschädigen. - - - - -Schieben Sie die M5-Mutter in ihre rechteckige Öffnung am Spannstück. - -Schrauben Sie die M5-Schraube in die M5-Mutter. - -Ziehen Sie diese Schraube fest, bis Sie spüren, dass sie die Linearschiene leicht berührt. Ziehen Sie sie nicht zu fest an; lassen Sie eine Lücke, damit der Riemen später im Bauprozess endgültig gespannt werden kann. - - -Die M5-Schraube ermöglicht die anfängliche Spannungseinstellung. Die endgültige Riemenspannung stellen Sie in einem späteren Schritt ein, nachdem alle Aktuatorkomponenten zusammengebaut sind. - - - -Die M5-Schraube sollte leichten Kontakt mit der Schiene haben, es sollte jedoch noch ein kleiner Spalt vorhanden sein, um die endgültige Spannungseinstellung zu ermöglichen. - - - - -## Nächste Schritte - -Nachdem der hintere Spanner installiert und der Riemen zunächst eingefädelt ist, fahren Sie mit der Installation des Endeffektors am gegenüberliegenden Ende der Linearschiene fort. - -[← Gedruckte Teile](/ossm/build/printed-parts) · [Weiter: Endeffektor →](/ossm/build/end-effector) diff --git a/content/docs/ossm/build/rear-tensioner.fr.mdx b/content/docs/ossm/build/rear-tensioner.fr.mdx deleted file mode 100644 index b3d5e73..0000000 --- a/content/docs/ossm/build/rear-tensioner.fr.mdx +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: "1. Tendeur arrière" -description: "Installez le tendeur arrière et enfilez la courroie pour préparer l'ensemble du rail linéaire" ---- - -Le tendeur arrière est le premier composant que vous installerez sur le rail linéaire. Il fournit le mécanisme permettant de régler la tension de la courroie et fixe une extrémité de la courroie à l'ensemble de rail. - -## Composants et outils requis - -### Composants - -| Composant | Quantité | Spécifications / remarques | -|-----------|-------|----------------------| -| Rail linéaire | 1 | Avec butées d’extrémité installées | -| Courroie | 1 | Courroie principale avec rainures | -| Pièce du tendeur arrière | 1 | Composant principal du tendeur | -| Boulon M3 | 1 | 20 mm (pour le pont du tendeur) | -| Écrou M3 | 1 | Pour le boulon M3 de 20 mm | -| Écrou M5 | 1 | Se glisse dans l’ouverture du tendeur | -| Boulon M5 | 1 | Environ 20 mm (pour le réglage initial de la tension) | - -### Outils - -| Outil | Quantité | Spécifications / remarques | -|------|-------|----------------------| -| Clé hexagonale de 2,5 mm | 1 | Pour le boulon M3 | -| Clé hexagonale de 4 mm | 1 | Pour le boulon M5 | -| Petit tournevis plat | 1 | Ou outil équivalent pour aider à maintenir les écrous en place | - - -L’installation du tendeur arrière comprend l’enfilage initial de la courroie. Vous réglerez la tension finale de la courroie plus tard dans le processus de construction, une fois tous les composants assemblés. - - -## Assemblage étape par étape - - - -Orientez la courroie de manière à ce que les rainures soient orientées vers le dessous du rail linéaire. Courbez la courroie et passez-la dans la première ouverture du tendeur arrière. - -Repliez la courroie sous elle-même de manière à ce que les rainures de la courroie sortante touchent celles de la courroie entrante. Tirez la courroie juste assez pour qu’environ quatre dents soient visibles. - - -La courroie doit former une boucle à travers le tendeur avec environ quatre dents visibles sur l'extrémité libre. - - - - -Retirez l’une des petites butées d’extrémité en caoutchouc du rail linéaire. - -Faites glisser la pièce du tendeur arrière sur le rail linéaire. Faites-la bouger doucement d’avant en arrière pour vous assurer que les roulements internes du rail restent en place. - -Tirez sur l’extrémité libre de la courroie jusqu’à ce qu’elle soit tendue contre l’ensemble. - - -Un léger mouvement de va-et-vient permet au tendeur de glisser en douceur sur le rail sans déloger les roulements internes. Si vous ressentez une résistance, vérifiez que le rail est propre et que le tendeur est bien aligné. - - - - -Insérez le boulon M3 de 20 mm à travers la pièce du tendeur et fixez-le avec un écrou M3. - -Serrez ce boulon juste assez pour renforcer le pont de la pièce du tendeur. - - -Ne serrez pas trop le boulon M3. Il doit être suffisamment serré pour renforcer le pont, mais une force excessive pourrait endommager la pièce du tendeur. - - - - -Faites glisser l’écrou M5 dans son ouverture rectangulaire sur la pièce du tendeur. - -Vissez le boulon M5 dans l’écrou M5. - -Serrez ce boulon jusqu’à ce que vous sentiez qu’il touche légèrement le rail linéaire. Ne serrez pas trop ; laissez un espace pour permettre le réglage final de la tension de la courroie plus tard dans le processus de construction. - - -Le boulon M5 permet le réglage initial de la tension. Vous réglerez la tension finale de la courroie dans une étape ultérieure, une fois tous les composants de l’actionneur assemblés. - - - -Le boulon M5 doit entrer légèrement en contact avec le rail, mais il doit toujours y avoir un petit espace pour permettre le réglage final de la tension. - - - - -## Prochaines étapes - -Une fois le tendeur arrière installé et la courroie initialement enfilée, procédez à l’installation de l’effecteur final à l’extrémité opposée du rail linéaire. - -[← Pièces imprimées](/ossm/build/printed-parts) · [Suivant : Effecteur final →](/ossm/build/end-effector) diff --git a/content/docs/ossm/build/rear-tensioner.mdx b/content/docs/ossm/build/rear-tensioner.mdx deleted file mode 100644 index 2b8202a..0000000 --- a/content/docs/ossm/build/rear-tensioner.mdx +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: "1. Rear Tensioner" -description: "Install the rear tensioner and thread the belt to prepare the linear rail assembly" ---- - -The rear tensioner is the first component you'll install on the linear rail. It provides the mechanism for adjusting belt tension and secures one end of the belt to the rail assembly. - -## Required Components and Tools - -### Components - -| Component | Count | Specification / Notes | -|-----------|-------|----------------------| -| Linear Rail | 1 | With end stops installed | -| Belt | 1 | Main belt with grooves | -| Rear Tensioner Piece | 1 | Main tensioner component | -| M3 Bolt | 1 | 20 mm (for tensioner bridge) | -| M3 Nut | 1 | For the M3 20 mm bolt | -| M5 Nut | 1 | Slides into tensioner opening | -| M5 Bolt | 1 | Approximately 20 mm (for initial tension adjustment) | - -### Tools - -| Tool | Count | Specification / Notes | -|------|-------|----------------------| -| 2.5 mm Hex | 1 | To fit the M3 bolt | -| 4 mm Hex | 1 | To fit the M5 bolt | -| Small Flathead Screwdriver | 1 | Or equivalent tool to help hold nuts in place | - - -The rear tensioner installation includes initial belt threading. You'll perform final belt tensioning later in the overall build process after all components are assembled. - - -## Step-by-Step Assembly - - - -Orient the belt so the grooves face the bottom of the linear rail. Curve the belt and thread it through the rear tensioner piece's first opening. - -Loop the belt back under itself so the grooves of the exiting belt touch the grooves of the incoming belt. Pull the belt out just enough so roughly four teeth are showing. - - -The belt should form a loop through the tensioner with approximately four teeth visible on the loose end. - - - - -Remove one of the small rubber end stops from the linear rail. - -Slide the rear tensioner piece onto the linear rail. Wiggle it gently to ensure the rail's internal bearings stay in place. - -Pull the loose end of the belt until the belt tightens up against the assembly. - - -Gentle wiggling helps ensure the tensioner slides smoothly onto the rail without dislodging the internal bearings. If you feel resistance, check that the rail is clean and the tensioner is properly aligned. - - - - -Insert the M3 20 mm bolt through the tensioner piece and secure it with an M3 nut. - -Tighten this bolt just enough to reinforce the bridge of the tensioner piece. - - -Do not overtighten the M3 bolt. It should be snug enough to reinforce the bridge, but excessive force could damage the tensioner piece. - - - - -Slide the M5 nut into its rectangular opening on the tensioner piece. - -Thread the M5 bolt into the M5 nut. - -Tighten this bolt until you feel it lightly touch the linear rail. Do not overtighten; leave a gap to allow for final belt tensioning later in the overall build process. - - -The M5 bolt provides initial tension adjustment. You'll perform final belt tensioning in a later step after all actuator components are assembled. - - - -The M5 bolt should make light contact with the rail, but there should still be a small gap to allow for final tension adjustment. - - - - -## Next Steps - -With the rear tensioner installed and the belt initially threaded, proceed to install the end effector on the opposite end of the linear rail. - -[← Printed parts](/ossm/build/printed-parts) · [Next: End effector →](/ossm/build/end-effector) diff --git a/content/docs/ossm/build/rear-tensioner.nl.mdx b/content/docs/ossm/build/rear-tensioner.nl.mdx deleted file mode 100644 index dcc8804..0000000 --- a/content/docs/ossm/build/rear-tensioner.nl.mdx +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: "1. Achterspanner" -description: "Installeer de achterste spanner en rijg de riem in om de constructie van de lineaire rail voor te bereiden" ---- - -De achterste spanner is het eerste onderdeel dat u op de lineaire rail installeert. Deze biedt het mechanisme voor het aanpassen van de riemspanning en bevestigt het ene uiteinde van de riem aan de railconstructie. - -## Vereiste componenten en gereedschappen - -### Componenten - -| Onderdeel | Aantal | Specificatie / opmerkingen | -|-----------|-------|----------------------| -| Lineaire rail | 1 | Met geïnstalleerde eindstops | -| Riem | 1 | Hoofdriem met groeven | -| Achterste spanstuk | 1 | Belangrijkste onderdeel van de spanner | -| M3-bout | 1 | 20 mm (voor spanbrug) | -| M3-moer | 1 | Voor de M3-bout van 20 mm | -| M5-moer | 1 | Schuift in de opening van de spanner | -| M5-bout | 1 | Ongeveer 20 mm (voor aanpassing van de initiële spanning) | - -### Gereedschappen - -| Gereedschap | Aantal | Specificatie / opmerkingen | -|------|-------|----------------------| -| 2,5 mm inbussleutel | 1 | Voor de M3-bout | -| 4 mm inbussleutel | 1 | Voor de M5-bout | -| Kleine platte schroevendraaier | 1 | Of een gelijkwaardig hulpmiddel om moeren op hun plaats te houden | - - -De installatie van de achterste spanner omvat het aanvankelijk inrijgen van de riem. U stelt de definitieve riemspanning later in het bouwproces af, nadat alle componenten zijn gemonteerd. - - -## Stapsgewijze montage - - - -Leg de riem zo dat de groeven naar de onderkant van de lineaire rail wijzen. Buig de riem en voer hem door de eerste opening van het achterste spanstuk. - -Vouw de riem terug onder zichzelf, zodat de groeven van het uitgaande deel de groeven van het inkomende deel raken. Trek de riem net zo ver uit dat ongeveer vier tanden zichtbaar zijn. - - -De riem moet een lus vormen door de spanner, waarbij ongeveer vier tanden zichtbaar zijn aan het losse uiteinde. - - - - -Verwijder een van de kleine rubberen eindstoppen van de lineaire rail. - -Schuif het achterste spanstuk op de lineaire rail. Beweeg het voorzichtig heen en weer om ervoor te zorgen dat de interne lagers van de rail op hun plaats blijven. - -Trek aan het losse uiteinde van de riem totdat de riem strak tegen het geheel zit. - - -Door het spanstuk voorzichtig heen en weer te bewegen, glijdt de spanner soepel op de rail zonder de interne lagers los te maken. Als u weerstand voelt, controleer dan of de rail schoon is en of de spanner goed is uitgelijnd. - - - - -Steek de M3-bout van 20 mm door het spanstuk en zet deze vast met een M3-moer. - -Draai deze bout slechts zo vast dat de brug van het spanstuk wordt verstevigd. - - -Draai de M3-bout niet te vast. De bout moet voldoende vastzitten om de brug te verstevigen, maar overmatige kracht kan het spanstuk beschadigen. - - - - -Schuif de M5-moer in de rechthoekige opening van het spanstuk. - -Draai de M5-bout in de M5-moer. - -Draai deze bout vast totdat u voelt dat deze de lineaire rail licht raakt. Draai de bout niet te vast; laat een opening vrij zodat de riem later in het bouwproces definitief kan worden gespannen. - - -De M5-bout dient voor het aanpassen van de initiële spanning. In een latere stap stelt u de definitieve riemspanning af nadat alle actuatorcomponenten zijn gemonteerd. - - - -De M5-bout moet licht contact maken met de rail, maar er moet nog steeds een kleine opening zijn om de uiteindelijke spanning af te kunnen stellen. - - - - -## Volgende stappen - -Nadat de achterste spanner is geïnstalleerd en de riem voorlopig is ingeregen, gaat u verder met het installeren van de eindeffector aan het andere uiteinde van de lineaire rail. - -[← Gedrukte onderdelen](/ossm/build/printed-parts) · [Volgende: Eindeffector →](/ossm/build/end-effector) diff --git a/content/docs/ossm/build/tools-and-parts.de.mdx b/content/docs/ossm/build/tools-and-parts.de.mdx deleted file mode 100644 index d9216dd..0000000 --- a/content/docs/ossm/build/tools-and-parts.de.mdx +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: "Erforderliche Werkzeuge und Teile" -description: "Vollständige Liste der Werkzeuge und Komponenten für den Bau Ihres OSSM-Aktuators" ---- - -Bevor Sie mit der Montage beginnen, legen Sie alle erforderlichen Werkzeuge und Teile bereit. Wenn alles vorbereitet ist, verläuft der Bauprozess reibungsloser und effizienter. - -## Erforderliche Werkzeuge - -Zur Fertigstellung der OSSM-Aktuatormontage benötigen Sie folgende Werkzeuge: - -| Werkzeug | Anzahl | Spezifikation / Hinweis | -|------|-------|----------------------| -| 2-mm-Sechskantschlüssel | 1 | Passend für eine 2,5-mm-Madenschraube | -| 2,5-mm-Sechskantschlüssel | 1 | Passend für eine M3-Schraube | -| 4-mm-Sechskantschlüssel | 1 | Passend für eine M5-Schraube | -| Kleiner Schlitzschraubendreher | 1 | Für die Verdrahtungsklemmen | -| Inbusschlüssel | 1 Satz | Kann anstelle einzelner Sechskantschlüssel verwendet werden | -| Kleiner Schraubendreher | 1 | Zur Beschleunigung des Montageprozesses | - - -Ein Satz Sechskantschraubendreher kann einzelne Inbusschlüssel ersetzen und die Montage beschleunigen. Wenn Sie einzelne Inbusschlüssel verwenden, sollten Sie mehrere Größen bereithalten, um häufiges Wechseln der Werkzeuge zu vermeiden. - - -## Komponentenliste - -### Aktuatorkomponenten - -| Komponente / Befestigungselement | Anzahl | Spezifikation / Hinweise | -|----------------------|-------|------------------------| -| Linearschiene | 1 | 350-mm-Schiene | -| Riemen | 1 | Hauptriemen mit Rillen | -| Endanschläge | 2 | Kleine Anschläge am Riemen/an der Schiene (zwei Endanschläge sind zum Entfernen vorgesehen) | -| Hinterer Spanner | 1 | Hauptspannstück für das hintere Ende | -| Vorderer Spanner | 1 | Teil zur Einstellung der festen Hubbegrenzung | -| Endeffektor | 1 | Das Gewinde-Endstück für die Schiene | - -### Befestigungselemente für die Aktuatorbaugruppe - -| Komponente / Befestigungselement | Anzahl | Spezifikation / Hinweise | -|----------------------|-------|------------------------| -| M3-Schraube | 1 | 20 mm (für die Spannbrücke des hinteren Spanners) | -| Mutter (für M3-Schraube, 20 mm) | 1 | Für die M3-Schraube, 20 mm | -| M5-Mutter | 1 | Wird in die Öffnung des hinteren Spanners geschoben | -| M5-Schraube | 1 | 20 mm (zur Einstellung der anfänglichen Spannung am hinteren Spanner) | -| M3-Schrauben, 8 mm | 2 | Zur Befestigung des Endeffektors | -| Muttern (für M3-Schrauben, 8 mm) | 2 | Für die M3-Schrauben, 8 mm, am Endeffektor | -| M3-Schraube (vorderer Spanner) | 1 | Legt die feste Hubbegrenzung fest | -| M3-Mutter (vorderer Spanner) | 1 | Für die Schraube des vorderen Spanners | - -### Motorkopfkomponenten - -| Komponente / Befestigungselement | Anzahl | Spezifikation / Hinweise | -|----------------------|-------|------------------------| -| OSSM Motorhead-Unterteil | 1 | Bodenplatte für den Motorkopf | -| Lager | 3 | Auf die Schrauben der Motorkopf-Bodenplatte gestapelt | -| M5-Schrauben, 20 mm (Lager) | 2 | Zur Befestigung der drei gestapelten Lager | -| M3-Schrauben, 8 mm (Schienenbefestigung) | 4 | Im Kreuzmuster zur Befestigung der Linearschiene am Motorkopf-Unterteil | -| Motor | 1 | Schrittmotor mit einer Abflachung an der Welle | -| Riemenscheibe | 1 | An der Motorwelle befestigt | -| Madenschrauben | 2 | Zur Befestigung der Riemenscheibe an der Abflachung der Motorwelle | -| OSSM Motorhead-Mittelteil | 1 | Standard-Mittelteil | -| M5-Schrauben, 35 mm | 4 | Im X-Muster zum Zusammenbau des Motorhead-Mittelteils | -| Muttern (für Motorhead-Mittelteil) | 4 | Für die M5-Schrauben, 35 mm | -| Abdeckung (Motorkopf) | 1 | Abdeckung für die Hauptmotorbaugruppe | -| M3-Schrauben, 8 mm (Abdeckung) | 4 | Zur Befestigung der Motorkopf-Abdeckung (zwei oben, zwei unten) | - -### Elektronische Komponenten - -| Komponente / Befestigungselement | Anzahl | Spezifikation / Hinweise | -|----------------------|-------|------------------------| -| OSSM-Steuerplatine | 1 | Die Elektronikplatine | -| PCB-Halterung für den Profilrahmen | 1 | Halterung für die Steuerplatine | -| M3-Schrauben (Platinenhalterung) | 2 | Zur Befestigung der Steuerplatine an ihrer Halterung | -| Abdeckung (Elektronikplatine) | 1 | Abdeckung für die Elektronikplatine | -| M3-Schrauben (Elektronikabdeckung) | 4 | Zur Befestigung der Elektronikplatinenabdeckung | -| Kurzer Drahtsatz | 1 Satz | Rote und schwarze Drähte für den Spannungseingang des Motors | -| Vierpoliges Datenkabel | 1 | Kabel für die PU- und Direction-Klemmen | - -### Zusätzliche Komponenten - -| Komponente / Befestigungselement | Anzahl | Spezifikation / Hinweise | -|----------------------|-------|------------------------| -| 24-mm-Mutter | 1 | Zur Befestigung der meisten Aufsätze am Gewinde-Ende | -| OSSM-Fernbedienung | 1 | Wird an den RJ45-Ethernet-Port angeschlossen | -| Stromquelle | 1 | Stromversorgung | - - -Alle Druckteile sollten nach den CAD-Vorgaben gefertigt werden. Stellen Sie sicher, dass alle Teile ordnungsgemäß gedruckt und fehlerfrei sind, bevor Sie mit der Montage beginnen. - - - -Überprüfen Sie noch einmal, ob alle Befestigungselemente vorhanden sind, bevor Sie mit der Montage beginnen. Das Fehlen einer einzigen Schraube oder Mutter kann den Fortschritt stoppen und eine Demontage erforderlich machen, wenn es später entdeckt wird. - - -## Nächste Schritte - -Nachdem Sie überprüft haben, dass Sie über alle erforderlichen Werkzeuge und Teile verfügen, fahren Sie mit dem nächsten Abschnitt der Bauanleitung fort, um mit der Montage zu beginnen. - - -[← Bevor Sie bauen](/ossm/build/introduction) · [Weiter: Stückliste →](/ossm/build/bill-of-materials) diff --git a/content/docs/ossm/build/tools-and-parts.fr.mdx b/content/docs/ossm/build/tools-and-parts.fr.mdx deleted file mode 100644 index c285e1d..0000000 --- a/content/docs/ossm/build/tools-and-parts.fr.mdx +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: "Outils et pièces requis" -description: "Liste complète des outils et composants nécessaires à la construction de votre actionneur OSSM" ---- - -Avant de commencer l’assemblage, rassemblez tous les outils et pièces nécessaires. Tout préparer à l’avance rendra la construction plus fluide et plus efficace. - -## Outils requis - -Vous avez besoin des outils suivants pour terminer l'assemblage de l'actionneur OSSM : - -| Outil | Quantité | Spécification / remarque | -|------|-------|----------------------| -| Clé hexagonale de 2 mm | 1 | Convient à une vis sans tête de 2,5 mm | -| Clé hexagonale de 2,5 mm | 1 | Convient à un boulon M3 | -| Clé hexagonale de 4 mm | 1 | Convient à un boulon M5 | -| Petit tournevis plat | 1 | Pour les bornes de câblage | -| Jeu de clés Allen | 1 jeu | Peut remplacer les clés hexagonales individuelles | -| Petit outil de vissage | 1 | Pour accélérer l’assemblage | - - -Un jeu de tournevis hexagonaux peut remplacer les clés hexagonales individuelles et accélérer l’assemblage. Si vous utilisez des clés hexagonales individuelles, prévoyez plusieurs tailles afin d’éviter de changer fréquemment d’outil. - - -## Liste des composants - -### Composants de l'actionneur - -| Composant / fixation | Quantité | Spécifications / remarques | -|----------------------|-------|------------------------| -| Rail linéaire | 1 | Rail de 350 mm | -| Courroie | 1 | Courroie principale avec rainures | -| Butées d’extrémité | 2 | Petites butées sur la courroie/le rail (deux butées sont prévues pour être retirées) | -| Tendeur arrière | 1 | Pièce principale du tendeur arrière | -| Tendeur avant | 1 | Pièce servant à définir la butée fixe de la course | -| Effecteur final | 1 | Embout fileté pour le rail | - -### Fixations pour l'assemblage de l'actionneur - -| Composant / fixation | Quantité | Spécifications / remarques | -|----------------------|-------|------------------------| -| Boulon M3 | 1 | 20 mm (pour le pont du tendeur arrière) | -| Écrou (pour boulon M3 de 20 mm) | 1 | Pour le boulon M3 de 20 mm | -| Écrou M5 | 1 | Se glisse dans l’ouverture du tendeur arrière | -| Boulon M5 | 1 | 20 mm (pour régler la tension initiale du tendeur arrière) | -| Boulons M3 de 8 mm | 2 | Pour fixer l’effecteur final | -| Écrous (pour boulons M3 de 8 mm) | 2 | Pour les boulons M3 de 8 mm de l’effecteur final | -| Boulon M3 (tendeur avant) | 1 | Définit la butée fixe de la course | -| Écrou M3 (tendeur avant) | 1 | Pour le boulon du tendeur avant | - -### Composants de la tête de moteur - -| Composant / fixation | Quantité | Spécifications / remarques | -|----------------------|-------|------------------------| -| Plaque inférieure du Motorhead OSSM | 1 | Plaque inférieure pour la tête du moteur | -| Roulements | 3 | Empilés sur les boulons de la plaque inférieure de la tête du moteur | -| Boulons M5 de 20 mm (roulements) | 2 | Pour fixer les trois roulements empilés | -| Boulons M3 de 8 mm (fixation du rail) | 4 | En croix pour fixer le rail linéaire à la plaque inférieure du Motorhead | -| Moteur | 1 | Moteur pas à pas avec un méplat sur l'arbre | -| Poulie | 1 | Fixée à l’arbre du moteur | -| Vis sans tête | 2 | Pour fixer la poulie au méplat de l’arbre du moteur | -| Section centrale du Motorhead OSSM | 1 | Section centrale standard | -| Boulons M5 de 35 mm | 4 | En X pour assembler la section centrale du Motorhead | -| Écrous (pour la section centrale du Motorhead) | 4 | Pour les boulons M5 de 35 mm | -| Couvercle (tête de moteur) | 1 | Couvercle pour l'ensemble moteur principal | -| Boulons M3 de 8 mm (couvercle) | 4 | Pour fixer le couvercle de la tête du moteur (deux en haut, deux en bas) | - -### Composants électroniques - -| Composant / fixation | Quantité | Spécifications / remarques | -|----------------------|-------|------------------------| -| Carte de commande OSSM | 1 | PCB électronique | -| Support de PCB pour le profilé extrudé | 1 | Support de la carte de commande | -| Boulons M3 (montage de la carte) | 2 | Pour fixer la carte de commande à son support | -| Couvercle (carte électronique) | 1 | Couvercle de la carte électronique | -| Boulons M3 (couvercle électronique) | 4 | Pour fixer le couvercle de la carte électronique | -| Petit jeu de fils | 1 ensemble | Fils rouge et noir pour l’entrée de tension du moteur | -| Câble de données à quatre broches | 1 | Câble pour les bornes PU et Direction | - -### Composants supplémentaires - -| Composant / fixation | Quantité | Spécifications / remarques | -|----------------------|-------|------------------------| -| Écrou de 24 mm | 1 | Pour fixer la plupart des accessoires à l’extrémité filetée | -| Télécommande OSSM | 1 | Se branche sur le port Ethernet RJ45 | -| Source d’alimentation | 1 | Alimentation électrique | - - -Toutes les pièces imprimées doivent être fabriquées conformément aux spécifications CAO. Assurez-vous que toutes les pièces sont correctement imprimées et exemptes de défauts avant de commencer l'assemblage. - - - -Vérifiez à nouveau que vous disposez de toutes les fixations avant de commencer l’assemblage. Un seul boulon ou écrou manquant peut interrompre votre progression et nécessiter un démontage si vous le découvrez plus tard. - - -## Prochaines étapes - -Une fois que vous avez vérifié que vous disposez de tous les outils et pièces requis, passez à la section suivante du guide de construction pour commencer l'assemblage. - - -[← Avant de construire](/ossm/build/introduction) · [Suivant : Nomenclature →](/ossm/build/bill-of-materials) diff --git a/content/docs/ossm/build/tools-and-parts.mdx b/content/docs/ossm/build/tools-and-parts.mdx deleted file mode 100644 index d571186..0000000 --- a/content/docs/ossm/build/tools-and-parts.mdx +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: "Required Tools and Parts" -description: "Complete list of tools and components needed to build your OSSM actuator" ---- - -Before you begin assembly, gather all required tools and parts. Having everything ready before you start will make the build process smoother and more efficient. - -## Required Tools - -You need the following tools to complete the OSSM actuator assembly: - -| Tool | Count | Specification / Note | -|------|-------|----------------------| -| 2 mm Hex | 1 | Fits a 2.5 mm grub screw | -| 2.5 mm Hex | 1 | Fits an M3 bolt | -| 4 mm Hex | 1 | Fits an M5 bolt | -| Small Flathead Screwdriver | 1 | Used for the wiring terminals | -| Allen Wrenches | 1 Set | May be used instead of hex drivers | -| Small Screwdriver Tool | 1 | Used to speed up the assembly process | - - -A hex driver tool set can replace individual hex wrenches and speed up assembly. If you're using individual wrenches, consider having multiple sizes available to avoid switching tools frequently. - - -## Component Parts List - -### Actuator Components - -| Component / Fastener | Count | Specification / Notes | -|----------------------|-------|------------------------| -| Linear Rail | 1 | 350 mm rail | -| Belt | 1 | Main belt with grooves | -| End Stops | 2 | Small stops on the belt/rail (two end stops are referenced for removal) | -| Rear Tensioner | 1 | Main tensioner piece for the rear | -| Front Tensioner | 1 | Piece installed to set the stroke hard limit | -| End Effector | 1 | The threaded end piece for the rail | - -### Fasteners for Actuator Assembly - -| Component / Fastener | Count | Specification / Notes | -|----------------------|-------|------------------------| -| M3 Bolt | 1 | 20 mm (for the rear tensioner bridge) | -| Nut (for M3 20mm bolt) | 1 | For the M3 20 mm bolt | -| M5 Nut | 1 | Slides into the rear tensioner opening | -| M5 Bolt | 1 | 20 mm (for adjusting initial tension on the rear tensioner) | -| M3 8 mm Bolts | 2 | Used to secure the End Effector | -| Nuts (for M3 8mm bolts) | 2 | For the M3 8 mm bolts on the End Effector | -| M3 Bolt (Front Tensioner) | 1 | Sets the hard limit for the stroke | -| M3 Nut (Front Tensioner) | 1 | For the front tensioner bolt | - -### Motor Head Components - -| Component / Fastener | Count | Specification / Notes | -|----------------------|-------|------------------------| -| OSSM Motorhead Bottom | 1 | Bottom plate for the motor head | -| Bearings | 3 | Stacked onto the motor head bottom plate bolts | -| M5 20 mm Bolts (Bearings) | 2 | Used to secure the three stacked bearings | -| M3 8 mm Bolts (Rail Attach) | 4 | Used in a cross pattern to attach the linear rail to the motor head bottom | -| Motor | 1 | Stepper motor with a flat spot on the shaft | -| Pulley | 1 | Attached to the motor shaft | -| Grub Screws | 2 | Used to secure the pulley to the motor shaft flat spot | -| OSSM Motorhead Middle | 1 | Standard middle section | -| M5 35 mm Bolts | 4 | Used in an X-pattern to assemble the motorhead middle | -| Nuts (for Motorhead Middle) | 4 | Used with the M5 35 mm bolts | -| Cover (Motor Head) | 1 | Cover for the main motor assembly | -| M3 8 mm Bolts (Cover) | 4 | Used to secure the motor head cover (two on top, two on the bottom) | - -### Electronics Components - -| Component / Fastener | Count | Specification / Notes | -|----------------------|-------|------------------------| -| OSSM Control Board | 1 | The electronics PCB | -| PCB Extrusion Frame Mount | 1 | Mount for the control board | -| M3 Bolts (Board Mount) | 2 | Used to secure the control board to its mount | -| Cover (Electronics Board) | 1 | Cover for the electronics board | -| M3 Bolts (Elec. Cover) | 4 | Used to secure the electronics board cover | -| Small Length of Wire | 1 Set | Red and black wires for voltage input to the motor | -| Four-pin Data Cable | 1 | Cable for the PU and Direction terminals | - -### Additional Components - -| Component / Fastener | Count | Specification / Notes | -|----------------------|-------|------------------------| -| 24 mm Nut | 1 | Used to secure most attachments to the threaded end | -| OSSM Remote | 1 | Attaches to the RJ45 Ethernet port | -| Power Source | 1 | Electrical supply | - - -All printed parts should be manufactured according to the CAD specifications. Ensure that all parts are properly printed and free of defects before beginning assembly. - - - -Double-check that you have all fasteners before starting assembly. Missing a single bolt or nut can halt your progress and require disassembly if discovered later in the process. - - -## Next Steps - -Once you have verified that you have all required tools and parts, proceed to the next section of the build guide to begin assembly. - - -[← Before you build](/ossm/build/introduction) · [Next: Bill of materials →](/ossm/build/bill-of-materials) diff --git a/content/docs/ossm/build/tools-and-parts.nl.mdx b/content/docs/ossm/build/tools-and-parts.nl.mdx deleted file mode 100644 index b6a7d55..0000000 --- a/content/docs/ossm/build/tools-and-parts.nl.mdx +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: "Benodigde gereedschappen en onderdelen" -description: "Volledige lijst met gereedschappen en onderdelen voor de bouw van uw OSSM-actuator" ---- - -Verzamel alle benodigde gereedschappen en onderdelen voordat u met de montage begint. Als alles klaarstaat, verloopt het bouwproces soepeler en efficiënter. - -## Vereiste gereedschappen - -U hebt het volgende gereedschap nodig om de OSSM-actuatormontage te voltooien: - -| Gereedschap | Aantal | Specificatie / opmerking | -|------|-------|----------------------| -| Inbussleutel van 2 mm | 1 | Past op een stelschroef van 2,5 mm | -| Inbussleutel van 2,5 mm | 1 | Past op een M3-bout | -| Inbussleutel van 4 mm | 1 | Past op een M5-bout | -| Kleine platte schroevendraaier | 1 | Gebruikt voor de aansluitklemmen | -| Inbussleutelset | 1 set | Kan worden gebruikt in plaats van afzonderlijke inbussleutels | -| Kleine schroevendraaier | 1 | Om het montageproces te versnellen | - - -Een set inbusschroevendraaiers kan afzonderlijke inbussleutels vervangen en de montage versnellen. Als u losse inbussleutels gebruikt, zorg dan dat u meerdere maten bij de hand hebt om veelvuldig wisselen van gereedschap te voorkomen. - - -## Onderdelenlijst - -### Actuatorcomponenten - -| Onderdeel / bevestigingsmiddel | Aantal | Specificatie / opmerkingen | -|----------------------|-------|------------------------| -| Lineaire rail | 1 | Rail van 350 mm | -| Riem | 1 | Hoofdriem met groeven | -| Eindstoppen | 2 | Kleine stoppen op de riem/rail (twee eindstoppen zijn bedoeld om te worden verwijderd) | -| Achterste spanner | 1 | Belangrijk spanonderdeel voor het achterste uiteinde | -| Voorste spanner | 1 | Onderdeel voor het instellen van de vaste slagbegrenzing | -| Eindeffector | 1 | Het schroefdraadeindstuk voor de rail | - -### Bevestigingsmiddelen voor actuatormontage - -| Onderdeel / bevestigingsmiddel | Aantal | Specificatie / opmerkingen | -|----------------------|-------|------------------------| -| M3-bout | 1 | 20 mm (voor de spanbrug van de achterste spanner) | -| Moer (voor M3-bout van 20 mm) | 1 | Voor de M3-bout van 20 mm | -| M5-moer | 1 | Schuift in de opening van de achterste spanner | -| M5-bout | 1 | 20 mm (voor het instellen van de aanvankelijke spanning op de achterste spanner) | -| M3-bouten van 8 mm | 2 | Om de eindeffector vast te zetten | -| Moeren (voor M3-bouten van 8 mm) | 2 | Voor de M3-bouten van 8 mm op de eindeffector | -| M3-bout (voorste spanner) | 1 | Stelt de vaste slagbegrenzing in | -| M3-moer (voorste spanner) | 1 | Voor de bout van de voorste spanner | - -### Onderdelen van de motorkop - -| Onderdeel / bevestigingsmiddel | Aantal | Specificatie / opmerkingen | -|----------------------|-------|------------------------| -| OSSM Motorhead-bodemplaat | 1 | Bodemplaat voor de motorkop | -| Lagers | 3 | Gestapeld op de bouten van de bodemplaat van de motorkop | -| M5-bouten van 20 mm (lagers) | 2 | Om de drie gestapelde lagers vast te zetten | -| M3-bouten van 8 mm (railbevestiging) | 4 | In een kruispatroon om de lineaire rail aan de Motorhead-bodemplaat te bevestigen | -| Motor | 1 | Stappenmotor met een afvlakking op de as | -| Poelie | 1 | Bevestigd aan de motoras | -| Stelschroeven | 2 | Om de poelie aan de afvlakking van de motoras te bevestigen | -| OSSM Motorhead-middendeel | 1 | Standaard middendeel | -| M5-bouten van 35 mm | 4 | In een X-patroon om het Motorhead-middendeel te monteren | -| Moeren (voor Motorhead-middendeel) | 4 | Voor de M5-bouten van 35 mm | -| Afdekking (motorkop) | 1 | Afdekking voor de hoofdmotorassemblage | -| M3-bouten van 8 mm (afdekking) | 4 | Om de motorkopafdekking vast te zetten (twee boven, twee onder) | - -### Elektronische componenten - -| Onderdeel / bevestigingsmiddel | Aantal | Specificatie / opmerkingen | -|----------------------|-------|------------------------| -| OSSM-besturingskaart | 1 | De elektronicaprintplaat | -| PCB-houder voor het extrusieframe | 1 | Houder voor de besturingskaart | -| M3-bouten (kaartmontage) | 2 | Om de besturingskaart aan de houder te bevestigen | -| Afdekking (elektronicakaart) | 1 | Afdekking voor de elektronicakaart | -| M3-bouten (elektronica-afdekking) | 4 | Om de afdekking van de elektronicakaart vast te zetten | -| Korte draadset | 1 set | Rode en zwarte draden voor de spanningsingang van de motor | -| Vierpolige datakabel | 1 | Kabel voor de PU- en Direction-klemmen | - -### Extra componenten - -| Onderdeel / bevestigingsmiddel | Aantal | Specificatie / opmerkingen | -|----------------------|-------|------------------------| -| Moer van 24 mm | 1 | Om de meeste hulpstukken aan het uiteinde met schroefdraad te bevestigen | -| OSSM-afstandsbediening | 1 | Wordt aangesloten op de RJ45-Ethernetpoort | -| Stroombron | 1 | Elektrische voeding | - - -Alle 3D-geprinte onderdelen moeten worden vervaardigd volgens de CAD-specificaties. Zorg ervoor dat alle onderdelen correct zijn geprint en vrij zijn van defecten voordat u met de montage begint. - - - -Controleer nogmaals of u alle bevestigingsmiddelen hebt voordat u met de montage begint. Het ontbreken van één bout of moer kan de voortgang stoppen en demontage vereisen als u dit pas later ontdekt. - - -## Volgende stappen - -Zodra u hebt gecontroleerd of u over alle benodigde gereedschappen en onderdelen beschikt, gaat u naar het volgende gedeelte van de bouwhandleiding om met de montage te beginnen. - - -[← Voordat u gaat bouwen](/ossm/build/introduction) · [Volgende: Stuklijst →](/ossm/build/bill-of-materials) diff --git a/content/docs/ossm/build/wiring.de.mdx b/content/docs/ossm/build/wiring.de.mdx deleted file mode 100644 index 91b735a..0000000 --- a/content/docs/ossm/build/wiring.de.mdx +++ /dev/null @@ -1,156 +0,0 @@ ---- -title: "10. Verkabelung" -description: "Schließen Sie Spannungseingangs- und Datenkabel zwischen der OSSM-Steuerplatine und dem Motor an" ---- - -Die Verkabelung verbindet die OSSM-Steuerplatine mit dem Motor und stellt sowohl die Stromversorgung als auch die Steuersignale bereit. Dieser Schritt stellt die elektrische Verbindung her, die es dem Motor ermöglicht, Befehle zu empfangen und ordnungsgemäß zu funktionieren. - -## Erforderliche Komponenten und Werkzeuge - -### Komponenten - -| Komponente | Anzahl | Spezifikation / Hinweise | -|-----------|-------|----------------------| -| Kurzer Drahtsatz | 1 Satz | Rote und schwarze Drähte für den Spannungseingang | -| Vierpoliges Datenkabel | 1 | Kabel für die Klemmen PU und Direction | -| OSSM-Steuerplatine | 1 | Im vorherigen Schritt zusammengebaut | -| Motor | 1 | In den vorherigen Schritten zusammengebaut | - -### Werkzeuge - -| Werkzeug | Anzahl | Spezifikation / Hinweise | -|------|-------|----------------------| -| Kleiner Schlitzschraubendreher | 1 | Für Verdrahtungsklemmen | -| Abisolierzange | 1 | Wenn die Drähte nicht vorabisoliert sind | - - -Die Spannungseingangsdrähte sollten lang genug sein, um ohne übermäßigen Durchhang oder Zug von den Motorklemmen bis zu den Klemmen der Steuerplatine zu reichen. Normalerweise reichen 15–30 cm (6–12 Zoll) aus. - - -## Schritt-für-Schritt-Montage: Verkabelung - - - -Nehmen Sie den kurzen roten und den kurzen schwarzen Draht zur Hand. Wenn die Enden nicht abisoliert sind, legen Sie mit einer Abisolierzange etwa 3–5 mm Draht frei. - -Drehen Sie die freiliegenden Litzen leicht zusammen, um ein Ausfransen zu verhindern und eine saubere Verbindung zu gewährleisten. - - -Wenn Sie sich über die richtige Abisolierlänge nicht sicher sind, entscheiden Sie sich für etwas mehr freiliegenden Draht. Überschüssigen Draht können Sie jederzeit abschneiden, aber zu wenig freiliegender Draht stellt möglicherweise keinen ordnungsgemäßen Kontakt in der Klemme her. - - - - -Identifizieren Sie auf dem Motorschild die Klemme „Voltage Plus“ (rechts) sowie die Klemme „Ground“. - -Lösen Sie die Klemmschrauben mit dem kleinen Schlitzschraubendreher. - -Führen Sie den roten Draht in die Klemme „Voltage Plus“ ein. - -Führen Sie den schwarzen Draht in die Klemme „Ground“ ein. - -Ziehen Sie die Schrauben an, um den blanken Leiter festzuklemmen. - - -Stellen Sie vor dem Festziehen sicher, dass die Drahtlitzen vollständig in die Klemme eingeführt sind. Lose Verbindungen können Lichtbögen, Überhitzung oder einen intermittierenden Betrieb verursachen. - - -Ziehen Sie leicht an den Drähten, um sicherzustellen, dass sie fest sitzen, und prüfen Sie, ob abstehende Litzen vorhanden sind, die einen Kurzschluss verursachen könnten. - - -Beide Drähte sind fest mit den Motorklemmen verbunden. Der rote Draht steckt in der Klemme „Voltage Plus“ und der schwarze Draht in der Klemme „Ground“. Es sind keine abstehenden Litzen sichtbar. - - - - -Identifizieren Sie die entsprechenden Klemmen „Plus“ und „Minus“ für den Spannungseingang auf der Steuerplatine. - -Führen Sie das andere Ende des roten Drahts in die Klemme „Plus“ auf der Platine ein. - -Führen Sie das andere Ende des schwarzen Drahts in die Klemme „Minus“ auf der Platine ein. - -Ziehen Sie die Klemmschrauben mit dem kleinen Schlitzschraubendreher an. - - -Überprüfen Sie vor dem Anziehen noch einmal die Polarität. Eine Verpolung der Spannung kann zu Schäden am Motor und der Steuerplatine führen. Rot muss immer an Klemmen mit der Bezeichnung Plus/Positive angeschlossen werden und Schwarz an Klemmen mit der Bezeichnung Minus/Negative/Ground. - - -Führen Sie einen abschließenden Zugtest durch, um sicherzustellen, dass beide Verbindungen sicher sitzen. - - -Beide Spannungsleitungen sind fest mit der Steuerplatine verbunden. Der rote Draht steckt in der Klemme „Plus“ und der schwarze Draht in der Klemme „Minus“. Alle Verbindungen bestehen den Zugtest. - - - - -Nehmen Sie das vierpolige Datenkabel und suchen Sie den entsprechenden Anschluss auf der OSSM-Steuerplatine. - -Stecken Sie den vierpoligen Datenkabelstecker in den entsprechenden Anschluss auf der OSSM-Steuerplatine, bis Sie ein deutliches Klicken hören. - - -Das Datenkabel überträgt Impuls- (PU) und Direction-Signale von der Steuerplatine zum Motor. Diese Signale steuern die Bewegung und Richtung des Motors. - - - -Der Stecker des Datenkabels sitzt vollständig im Anschluss der Steuerplatine. Sie sollten ein Klicken hören oder fühlen, wenn er richtig angeschlossen ist. - - - - -Ordnen Sie die Drähte des Datenkabels den beschrifteten Klemmen am Motor zu, die (von rechts nach links) lauten: PU plus, PU minus, Direction plus und Direction minus. - -Verbinden Sie die zum Anschluss PU+ gehörende Ader des Kabels mit der Klemme PU plus am Motor. - -Verbinden Sie die zum Anschluss PU- gehörende Ader des Kabels mit der Klemme PU minus am Motor. - -Verbinden Sie die zu Direction+ gehörende Ader des Kabels mit der Klemme Direction plus am Motor. - -Verbinden Sie die zu Direction- gehörende Ader des Kabels mit der Klemme Direction minus am Motor. - - -Wenn Sie nicht sicher sind, welche Ader welchem Signal entspricht, schauen Sie in der Kabeldokumentation nach oder verwenden Sie ein Multimeter, um den Durchgang zu überprüfen. Das Kabel sollte entsprechend der Klemmenbeschriftung beschriftet oder farblich gekennzeichnet sein. - - - -Ein falscher Anschluss der Datenleitungen kann dazu führen, dass der Motor in die falsche Richtung läuft oder nicht auf Befehle reagiert. Überprüfen Sie jeden Anschluss vor dem Festziehen anhand der Beschriftung der Motorklemmen. - - - - -Ziehen Sie die Klemmschrauben aller vier Datenadern mit dem kleinen Schlitzschraubendreher an. - -Führen Sie einen abschließenden leichten Zugtest an allen vier Verbindungen durch, um sicherzustellen, dass sie sicher sitzen. - -Überprüfen Sie alle Verbindungen auf abstehende Litzen oder lose Verbindungen. - - -Alle vier Datenadern sind fest mit den entsprechenden Motorklemmen verbunden: -- PU+ mit der Klemme PU plus -- PU- mit der Klemme PU minus -- Direction+ mit der Klemme Direction plus -- Direction- mit der Klemme Direction minus - -Alle Verbindungen bestehen den Zugtest und es sind keine abstehenden Litzen sichtbar. - - - - -## Überprüfung - -Bevor Sie fortfahren, überprüfen Sie, ob alle Verbindungen korrekt sind: - -- **Spannungseingang**: Roter Draht verbindet Plus mit Plus, schwarzer Draht verbindet Ground mit Minus -- **Datenkabel**: Der vierpolige Stecker sitzt vollständig in der Steuerplatine -- **Motorklemmen**: Alle vier Datenadern sind an die richtigen Klemmen angeschlossen (PU+, PU-, Direction+, Direction-) -- **Fester Sitz**: Alle Klemmschrauben sind angezogen und alle Verbindungen bestehen den Zugtest - - -Schalten Sie das System erst dann ein, wenn Sie überprüft haben, dass alle Verbindungen korrekt und sicher sind. Eine falsche Verkabelung kann zu dauerhaften Schäden am Motor und der Steuerplatine führen. - - -## Nächste Schritte - -Nachdem die gesamte Verkabelung abgeschlossen und überprüft ist, können Sie mit dem ersten Testabschnitt fortfahren, um zu überprüfen, ob der Motor korrekt auf Steuersignale reagiert. - - -[← Elektronik](/ossm/build/electronics) · [Weiter: Erster Test →](/ossm/build/first-test) diff --git a/content/docs/ossm/build/wiring.fr.mdx b/content/docs/ossm/build/wiring.fr.mdx deleted file mode 100644 index 0e1e769..0000000 --- a/content/docs/ossm/build/wiring.fr.mdx +++ /dev/null @@ -1,156 +0,0 @@ ---- -title: "10. Câblage" -description: "Connectez les câbles d’entrée de tension et de données entre la carte de commande OSSM et le moteur" ---- - -Le câblage relie la carte de commande OSSM au moteur, en fournissant à la fois l’alimentation électrique et les signaux de commande. Cette étape établit la connexion électrique qui permet au moteur de recevoir les commandes et de fonctionner correctement. - -## Composants et outils requis - -### Composants - -| Composant | Quantité | Spécifications / remarques | -|-----------|-------|----------------------| -| Petit jeu de fils | 1 jeu | Fils rouge et noir pour l’entrée de tension | -| Câble de données à quatre broches | 1 | Câble pour les bornes PU et Direction | -| Carte de commande OSSM | 1 | Assemblée à l’étape précédente | -| Moteur | 1 | Assemblé lors des étapes précédentes | - -### Outils - -| Outil | Quantité | Spécifications / remarques | -|------|-------|----------------------| -| Petit tournevis plat | 1 | Pour les bornes de câblage | -| Pince à dénuder | 1 | Si les fils ne sont pas pré-dénudés | - - -Les fils d’entrée de tension doivent être suffisamment longs pour aller des bornes du moteur jusqu’aux bornes de la carte de commande sans mou excessif ni tension excessive. En règle générale, 6 à 12 pouces (15 à 30 cm) suffisent. - - -## Assemblage étape par étape : câblage - - - -Prenez les courts fils rouge et noir. Si les extrémités ne sont pas dénudées, utilisez une pince à dénuder pour exposer environ 3 à 5 mm de fil. - -Torsadez légèrement les brins exposés ensemble pour éviter l’effilochage et assurer une connexion propre. - - -Si vous n’êtes pas sûr de la longueur de dénudage appropriée, optez pour un fil exposé légèrement plus long. Vous pouvez toujours couper l’excédent, mais trop peu de fil exposé risque de ne pas établir un bon contact dans la borne. - - - - -Sur l’étiquette du moteur, identifiez la borne "Voltage Plus" (à droite) et la borne "Ground". - -Utilisez le petit tournevis plat pour desserrer les vis de ces bornes. - -Insérez le fil rouge dans la borne "Voltage Plus". - -Insérez le fil noir dans la borne "Ground". - -Serrez les vis pour maintenir le conducteur dénudé en place. - - -Assurez-vous que les brins de fil sont complètement insérés dans la borne avant de serrer. Des connexions desserrées peuvent provoquer des arcs électriques, une surchauffe ou un fonctionnement intermittent. - - -Tirez légèrement sur les fils pour vous assurer qu’ils sont bien fixés et vérifiez qu’aucun brin susceptible de provoquer un court-circuit ne dépasse. - - -Les deux fils sont solidement connectés aux bornes du moteur. Le fil rouge se trouve dans la borne "Voltage Plus" et le fil noir dans la borne "Ground". Aucun brin ne dépasse. - - - - -Identifiez les bornes "Plus" et "Minus" correspondantes pour l’entrée de tension sur la carte de commande. - -Insérez l’autre extrémité du fil rouge dans la borne "Plus" de la carte. - -Insérez l’autre extrémité du fil noir dans la borne "Minus" de la carte. - -Serrez les vis à l’aide du petit tournevis plat. - - -Vérifiez à nouveau la polarité avant de serrer. Inverser la polarité de la tension peut endommager le moteur et la carte de commande. Le rouge doit toujours être connecté aux bornes portant la désignation Plus/Positive, et le noir aux bornes portant la désignation Minus/Negative/Ground. - - -Effectuez un dernier test de traction pour vous assurer que les deux connexions sont bien fixées. - - -Les deux fils de tension sont solidement connectés à la carte de commande. Le fil rouge est dans la borne "Plus" et le fil noir dans la borne "Minus". Toutes les connexions résistent au test de traction. - - - - -Prenez le câble de données à quatre broches et localisez le port correspondant sur la carte de commande OSSM. - -Connectez la fiche du câble de données à quatre broches au port correspondant de la carte de commande OSSM jusqu’à ce que vous entendiez un clic net. - - -Le câble de données transporte les signaux d’impulsion (PU) et de direction de la carte de commande au moteur. Ces signaux contrôlent le mouvement et la direction du moteur. - - - -La fiche du câble de données est entièrement insérée dans le port de la carte de commande. Vous devriez entendre ou ressentir un clic lorsqu’elle est correctement connectée. - - - - -Faites correspondre les fils du câble de données aux bornes étiquetées sur le moteur, qui sont (de droite à gauche) : PU plus, PU minus, Direction plus et Direction minus. - -Connectez le fil correspondant à PU+ du câble à la borne PU plus du moteur. - -Connectez le fil correspondant à PU- sur le câble à la borne PU minus du moteur. - -Connectez le fil correspondant à Direction+ sur le câble à la borne Direction plus sur le moteur. - -Connectez le fil correspondant à Direction- sur le câble à la borne Direction minus du moteur. - - -Si vous ne savez pas quel fil correspond à quel signal, consultez la documentation du câble ou utilisez un multimètre pour vérifier la continuité. Le câble doit être étiqueté ou codé par couleur pour correspondre aux étiquettes des bornes. - - - -Une connexion incorrecte des fils de données peut entraîner un fonctionnement du moteur dans le mauvais sens ou empêcher le moteur de répondre aux commandes. Vérifiez à nouveau chaque connexion par rapport aux étiquettes des bornes du moteur avant de serrer. - - - - -Serrez les vis des bornes des quatre fils de données à l’aide du petit tournevis plat. - -Effectuez un dernier test de traction léger sur les quatre connexions pour vous assurer qu’elles sont bien fixées. - -Inspectez toutes les connexions pour déceler des brins qui dépassent ou toute connexion desserrée. - - -Les quatre fils du câble de données sont solidement connectés aux bornes correspondantes du moteur : -- PU+ vers la borne PU plus -- PU- vers la borne PU minus -- Direction+ vers la borne Direction plus -- Direction- vers la borne Direction minus - -Toutes les connexions résistent au test de traction et aucun brin qui dépasse n’est visible. - - - - -## Vérification - -Avant de continuer, vérifiez que toutes les connexions sont correctes : - -- **Entrée de tension** : le fil rouge connecte Plus à Plus, le fil noir connecte Ground à Minus -- **Câble de données** : la fiche à quatre broches est entièrement insérée dans la carte de commande -- **Bornes du moteur** : les quatre fils de données sont connectés aux bornes appropriées (PU+, PU-, Direction+, Direction-). -- **Fixation** : toutes les vis des bornes sont serrées et toutes les connexions résistent au test de traction - - -Ne mettez pas le système sous tension avant d’avoir vérifié que toutes les connexions sont correctes et sécurisées. Un câblage incorrect peut causer des dommages permanents au moteur et à la carte de commande. - - -## Prochaines étapes - -Une fois tout le câblage terminé et vérifié, vous êtes prêt à passer à la section de test initiale pour vérifier que le moteur répond correctement aux signaux de commande. - - -[← Électronique](/ossm/build/electronics) · [Suivant : Premier test →](/ossm/build/first-test) diff --git a/content/docs/ossm/build/wiring.mdx b/content/docs/ossm/build/wiring.mdx deleted file mode 100644 index 528d078..0000000 --- a/content/docs/ossm/build/wiring.mdx +++ /dev/null @@ -1,156 +0,0 @@ ---- -title: "10. Wiring" -description: "Connect voltage input and data cables between the OSSM control board and motor" ---- - -Wiring connects the OSSM Control Board to the motor, providing both power and control signals. This step establishes the electrical connection that enables the motor to receive commands and operate properly. - -## Required Components and Tools - -### Components - -| Component | Count | Specification / Notes | -|-----------|-------|----------------------| -| Small Length of Wire | 1 Set | Red and black wires for voltage input | -| Four-pin Data Cable | 1 | Cable for PU and Direction terminals | -| OSSM Control Board | 1 | Assembled in the previous step | -| Motor | 1 | Assembled in previous steps | - -### Tools - -| Tool | Count | Specification / Notes | -|------|-------|----------------------| -| Small Flathead Screwdriver | 1 | For wiring terminals | -| Wire Strippers | 1 | If wires are not pre-stripped | - - -The voltage input wires should be long enough to reach from the motor terminals to the control board terminals without excessive slack or tension. Typically, 6-12 inches (15-30 cm) is sufficient. - - -## Step-by-Step Assembly: Wiring - - - -Take the small length of red and black wire. If the ends are not stripped, use wire strippers to expose about 3-5mm of wire. - -Lightly twist the exposed strands together to prevent fraying and ensure a clean connection. - - -If you're unsure about the proper stripping length, err on the side of slightly longer exposed wire. You can always trim excess, but too little exposed wire may not make proper contact in the terminal. - - - - -On the motor label, identify the "Voltage Plus" terminal (on the right) and the "Ground" terminal. - -Use the small flathead screwdriver to loosen the screws on these terminals. - -Insert the red wire into the Voltage Plus terminal. - -Insert the black wire into the Ground terminal. - -Tighten the screws to clamp down on the metal wire. - - -Ensure the wire strands are fully inserted into the terminal before tightening. Loose connections can cause arcing, overheating, or intermittent operation. - - -Give the wires a light tug to ensure they are secure, and inspect for any stray wire strands that could cause a short circuit. - - -Both wires are securely connected to the motor terminals. The red wire is in the Voltage Plus terminal, and the black wire is in the Ground terminal. No stray wire strands are visible. - - - - -Identify the corresponding "Plus" and "Minus" terminals for the voltage input on the control board. - -Insert the other end of the red wire into the Plus terminal on the board. - -Insert the other end of the black wire into the Minus terminal on the board. - -Tighten the screws using the small flathead screwdriver. - - -Double-check the polarity before tightening. Reversing the voltage polarity can damage the motor and control board. Red should always connect to Plus/Positive terminals, and black should always connect to Minus/Negative/Ground terminals. - - -Perform a final tug test to ensure both connections are secure. - - -Both voltage wires are securely connected to the control board. The red wire is in the Plus terminal, and the black wire is in the Minus terminal. All connections pass the tug test. - - - - -Take the four-pin data cable and locate the corresponding port on the OSSM Control Board. - -Connect the four-pin data cable plug into the corresponding port on the OSSM Control Board until you hear a nice click. - - -The data cable carries pulse (PU) and direction signals from the control board to the motor. These signals control the motor's movement and direction. - - - -The data cable plug is fully seated in the control board port. You should hear or feel a click when it's properly connected. - - - - -Match the wires from the data cable to the labeled terminals on the motor, which are (from right to left): PU plus, PU minus, Direction plus, and Direction minus. - -Connect the wire corresponding to PU+ on the cable to the PU plus terminal on the motor. - -Connect the wire corresponding to PU- on the cable to the PU minus terminal on the motor. - -Connect the wire corresponding to Direction+ on the cable to the Direction plus terminal on the motor. - -Connect the wire corresponding to Direction- on the cable to the Direction minus terminal on the motor. - - -If you're unsure which wire corresponds to which signal, check the cable documentation or use a multimeter to verify continuity. The cable should be labeled or color-coded to match the terminal labels. - - - -Incorrectly connecting the data wires can cause the motor to operate in the wrong direction or not respond to commands. Double-check each connection against the motor terminal labels before tightening. - - - - -Tighten the terminal screws for all four data wires using the small flathead screwdriver. - -Perform a final light tug test on all four connections to ensure they are secure. - -Inspect all connections for any stray wire strands or loose connections. - - -All four data cable wires are securely connected to their corresponding motor terminals: -- PU+ to PU plus terminal -- PU- to PU minus terminal -- Direction+ to Direction plus terminal -- Direction- to Direction minus terminal - -All connections pass the tug test, and no stray wire strands are visible. - - - - -## Verification - -Before proceeding, verify that all connections are correct: - -- **Voltage Input**: Red wire connects Plus to Plus, black wire connects Ground to Minus -- **Data Cable**: Four-pin plug is fully seated in the control board -- **Motor Terminals**: All four data wires are connected to the correct terminals (PU+, PU-, Direction+, Direction-) -- **Security**: All terminal screws are tightened, and all connections pass the tug test - - -Do not apply power to the system until you have verified all connections are correct and secure. Incorrect wiring can cause permanent damage to the motor and control board. - - -## Next Steps - -With all wiring complete and verified, you're ready to proceed to the initial test section to verify that the motor responds correctly to control signals. - - -[← Electronics](/ossm/build/electronics) · [Next: First test →](/ossm/build/first-test) diff --git a/content/docs/ossm/build/wiring.nl.mdx b/content/docs/ossm/build/wiring.nl.mdx deleted file mode 100644 index 4721adc..0000000 --- a/content/docs/ossm/build/wiring.nl.mdx +++ /dev/null @@ -1,156 +0,0 @@ ---- -title: "10. Bedrading" -description: "Sluit de spanningsingangsdraden en de datakabel aan tussen de OSSM-besturingskaart en de motor" ---- - -Bedrading verbindt de OSSM-besturingskaart met de motor en levert zowel de voeding als besturingssignalen. Met deze stap wordt de elektrische verbinding tot stand gebracht waardoor de motor opdrachten kan ontvangen en goed kan werken. - -## Vereiste componenten en gereedschappen - -### Componenten - -| Onderdeel | Aantal | Specificatie / opmerkingen | -|-----------|-------|----------------------| -| Korte draadset | 1 set | Rode en zwarte draden voor de spanningsingang | -| Vierpolige datakabel | 1 | Kabel voor PU- en Direction-klemmen | -| OSSM-besturingskaart | 1 | Geassembleerd in de vorige stap | -| Motor | 1 | Samengesteld in voorgaande stappen | - -### Gereedschappen - -| Gereedschap | Aantal | Specificatie / opmerkingen | -|------|-------|----------------------| -| Kleine platte schroevendraaier | 1 | Voor aansluitklemmen | -| Striptang | 1 | Als de draden niet vooraf zijn gestript | - - -De spanningsingangsdraden moeten lang genoeg zijn om zonder overmatige speling of spanning van de motorklemmen naar de klemmen van de besturingskaart te reiken. Meestal is 15–30 cm (6–12 inch) voldoende. - - -## Stapsgewijze montage: bedrading - - - -Neem de korte rode en de korte zwarte draad. Als de uiteinden niet zijn gestript, gebruik dan een striptang om ongeveer 3–5 mm draad bloot te leggen. - -Draai de blootliggende draadstrengen lichtjes in elkaar om rafelen te voorkomen en een goede verbinding te garanderen. - - -Als u niet zeker weet wat de juiste striplengte is, kies dan voor iets meer blootliggende draad. U kunt overtollige draad altijd afknippen, maar te weinig blootliggende draad maakt mogelijk geen goed contact in de klem. - - - - -Identificeer op het motorlabel de aansluiting "Voltage Plus" (aan de rechterkant) en de aansluiting "Ground". - -Gebruik de kleine platte schroevendraaier om de klemschroeven los te draaien. - -Steek de rode draad in de aansluiting "Voltage Plus". - -Steek de zwarte draad in de aansluiting "Ground". - -Draai de schroeven vast om de blootliggende ader vast te klemmen. - - -Zorg ervoor dat de draadstrengen volledig in de klem zijn gestoken voordat u deze vastdraait. Losse verbindingen kunnen vlamboogvorming, oververhitting of onderbroken werking veroorzaken. - - -Trek licht aan de draden om er zeker van te zijn dat ze goed vastzitten en controleer op uitstekende draadstrengen die kortsluiting kunnen veroorzaken. - - -Beide draden zijn stevig aangesloten op de motorklemmen. De rode draad bevindt zich in de aansluiting "Voltage Plus" en de zwarte draad in de aansluiting "Ground". Er zijn geen uitstekende draadstrengen zichtbaar. - - - - -Identificeer de overeenkomstige aansluitingen "Plus" en "Minus" voor de spanningsingang op de besturingskaart. - -Steek het andere uiteinde van de rode draad in de aansluiting "Plus" op de kaart. - -Steek het andere uiteinde van de zwarte draad in de aansluiting "Minus" op de kaart. - -Draai de klemschroeven vast met de kleine platte schroevendraaier. - - -Controleer nogmaals de polariteit voordat u de schroeven vastdraait. Het omkeren van de spanningspolariteit kan de motor en de besturingskaart beschadigen. Rood moet altijd worden aangesloten op aansluitingen met de aanduiding Plus/Positive, en zwart op aansluitingen met de aanduiding Minus/Negative/Ground. - - -Voer een laatste trekproef uit om er zeker van te zijn dat beide verbindingen goed vastzitten. - - -Beide spanningsdraden zijn stevig aangesloten op de besturingskaart. De rode draad bevindt zich in de aansluiting "Plus" en de zwarte draad in de aansluiting "Minus". Alle verbindingen doorstaan de trekproef. - - - - -Neem de vierpolige datakabel en zoek de overeenkomstige poort op de OSSM-besturingskaart. - -Sluit de vierpolige datakabelstekker aan op de overeenkomstige poort op de OSSM-besturingskaart totdat u een duidelijke klik hoort. - - -De datakabel transporteert puls- (PU) en Direction-signalen van de besturingskaart naar de motor. Deze signalen regelen de beweging en richting van de motor. - - - -De datakabelconnector zit volledig in de poort van de besturingskaart. Als deze goed is aangesloten, moet u een klik horen of voelen. - - - - -Zorg ervoor dat de draden van de datakabel overeenkomen met de gelabelde klemmen op de motor, namelijk (van rechts naar links): PU plus, PU minus, Direction plus en Direction minus. - -Sluit de draad die overeenkomt met PU+ op de kabel aan op de PU plus-aansluiting op de motor. - -Sluit de draad die overeenkomt met PU- op de kabel aan op de PU minus-aansluiting op de motor. - -Sluit de draad die overeenkomt met Direction+ op de kabel aan op de Direction plus-aansluiting op de motor. - -Sluit de draad die overeenkomt met Direction- op de kabel aan op de Direction minus-aansluiting op de motor. - - -Als u niet zeker weet welke draad overeenkomt met welk signaal, raadpleeg dan de kabeldocumentatie of gebruik een multimeter om de continuïteit te verifiëren. De kabel moet van een label of kleurcode zijn voorzien die overeenkomt met de labels van de klemmen. - - - -Het verkeerd aansluiten van de datadraden kan ertoe leiden dat de motor in de verkeerde richting draait of niet op opdrachten reageert. Controleer elke aansluiting nogmaals aan de hand van de labels op de motorklemmen voordat u de klemschroeven vastdraait. - - - - -Draai de klemschroeven voor alle vier de datadraden vast met de kleine platte schroevendraaier. - -Voer een laatste lichte trekproef uit op alle vier de verbindingen om er zeker van te zijn dat ze goed vastzitten. - -Inspecteer alle verbindingen op uitstekende draadstrengen of losse aansluitingen. - - -Alle vier de aders van de datakabel zijn stevig aangesloten op de bijbehorende motorklemmen: -- PU+ naar de PU plus-aansluiting -- PU- naar de PU minus-aansluiting -- Direction+ naar de Direction plus-aansluiting -- Direction- naar de Direction minus-aansluiting - -Alle verbindingen doorstaan de trekproef en er zijn geen uitstekende draadstrengen zichtbaar. - - - - -## Verificatie - -Controleer voordat u verdergaat of alle aansluitingen correct zijn: - -- **Spanningsingang**: Rode draad verbindt Plus met Plus, zwarte draad verbindt Ground met Minus -- **Datakabel**: De vierpolige stekker zit volledig in de besturingskaart -- **Motorklemmen**: Alle vier datadraden zijn aangesloten op de juiste klemmen (PU+, PU-, Direction+, Direction-) -- **Bevestiging**: Alle klemschroeven zijn vastgedraaid en alle verbindingen hebben de trekproef doorstaan - - -Schakel het systeem pas in nadat u hebt gecontroleerd of alle aansluitingen correct en veilig zijn. Onjuiste bedrading kan permanente schade aan de motor en de besturingskaart veroorzaken. - - -## Volgende stappen - -Nadat alle bedrading is voltooid en geverifieerd, kunt u doorgaan naar het eerste testgedeelte om te controleren of de motor correct reageert op besturingssignalen. - - -[← Elektronica](/ossm/build/electronics) · [Volgende: Eerste test →](/ossm/build/first-test) diff --git a/content/docs/ossm/cable-harnesses.de.mdx b/content/docs/ossm/cable-harnesses.de.mdx deleted file mode 100644 index 6a45a2f..0000000 --- a/content/docs/ossm/cable-harnesses.de.mdx +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: "Kabelbäume" -description: "Kabelbäume für OSSM." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -Die Quellen der OSSM-Kabelbäume befinden sich unter [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables). -Wireviz erzeugt aus jeder Kabelbaumquelle Diagrammartefakte und eine detaillierte untergeordnete -Stückliste. Die [Stückliste](product-bom) auf Produktebene sollte jeden Kabelbaum als Baugruppe der obersten Ebene aufführen -und mit der Wireviz-Quelle verknüpfen. - -## Motorsteuerungskabelbaum - -| Ressource | Speicherort | -| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | -| Wireviz-Quelle | [`OSSM-Motor-Control-Harness.yml`](https://github.com/researchanddesire/ossm/blob/main/hardware/cables/OSSM-Motor-Control-Harness.yml) | -| Quellenhinweise | [`hardware/cables/README.md`](https://github.com/researchanddesire/ossm/blob/main/hardware/cables/README.md) | -| Generierte Release-Dateien | [Neueste OSSM-Version](https://github.com/researchanddesire/ossm/releases/latest) | - -Der Kabelexport-Workflow veröffentlicht die generierten Dateien aus `cable-export/`, -darunter: - -- `OSSM-Motor-Control-Harness.pdf` -- `OSSM-Motor-Control-Harness.png` -- `OSSM-Motor-Control-Harness.bom.tsv` diff --git a/content/docs/ossm/cable-harnesses.en.mdx b/content/docs/ossm/cable-harnesses.en.mdx new file mode 100644 index 0000000..cb12444 --- /dev/null +++ b/content/docs/ossm/cable-harnesses.en.mdx @@ -0,0 +1,23 @@ +--- +title: Cable Harnesses +--- + +OSSM cable harness sources live under `hardware/cables/`. +Wireviz renders each harness source into diagram artifacts and a detailed child +BOM. The product-level [Bill of Materials](/ossm/bom) should list each harness as a +top-level assembly and link to the Wireviz source. + +## Motor Control Harness + +| Asset | Location | +| --- | --- | +| Wireviz source | `OSSM-Motor-Control-Harness.yml` | +| Source notes | `hardware/cables/README.md` | +| Generated release assets | [Latest OSSM release](https://github.com/researchanddesire/ossm/releases/latest) | + +The cable export workflow publishes generated assets from `cable-export/`, +including: + +- `OSSM-Motor-Control-Harness.pdf` +- `OSSM-Motor-Control-Harness.png` +- `OSSM-Motor-Control-Harness.bom.tsv` diff --git a/content/docs/ossm/cable-harnesses.fr.mdx b/content/docs/ossm/cable-harnesses.fr.mdx deleted file mode 100644 index 895d73c..0000000 --- a/content/docs/ossm/cable-harnesses.fr.mdx +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: "Faisceaux de câbles" -description: "Faisceaux de câbles pour OSSM." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -Les sources des faisceaux de câbles OSSM se trouvent dans [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables). -Wireviz génère pour chaque source de faisceau des diagrammes et une nomenclature détaillée -des sous-composants. La [nomenclature](product-bom) au niveau du produit doit répertorier chaque faisceau comme un assemblage de niveau supérieur -et contenir un lien vers la source Wireviz. - -## Faisceau de commande du moteur - -| Ressource | Emplacement | -| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | -| Source Wireviz | [`OSSM-Motor-Control-Harness.yml`](https://github.com/researchanddesire/ossm/blob/main/hardware/cables/OSSM-Motor-Control-Harness.yml) | -| Notes sur la source | [`hardware/cables/README.md`](https://github.com/researchanddesire/ossm/blob/main/hardware/cables/README.md) | -| Fichiers de version générés | [Dernière version d’OSSM](https://github.com/researchanddesire/ossm/releases/latest) | - -Le workflow d’export des câbles publie les fichiers générés à partir de `cable-export/`, -notamment : - -- `OSSM-Motor-Control-Harness.pdf` -- `OSSM-Motor-Control-Harness.png` -- `OSSM-Motor-Control-Harness.bom.tsv` diff --git a/content/docs/ossm/cable-harnesses.mdx b/content/docs/ossm/cable-harnesses.mdx deleted file mode 100644 index 9b02f1d..0000000 --- a/content/docs/ossm/cable-harnesses.mdx +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: "Cable Harnesses" -description: "Cable Harnesses for OSSM." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -OSSM cable harness sources live under [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables). -Wireviz renders each harness source into diagram artifacts and a detailed child -BOM. The product-level [Bill of Materials](product-bom) should list each harness as a -top-level assembly and link to the Wireviz source. - -## Motor Control Harness - -| Asset | Location | -| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | -| Wireviz source | [`OSSM-Motor-Control-Harness.yml`](https://github.com/researchanddesire/ossm/blob/main/hardware/cables/OSSM-Motor-Control-Harness.yml) | -| Source notes | [`hardware/cables/README.md`](https://github.com/researchanddesire/ossm/blob/main/hardware/cables/README.md) | -| Generated release assets | [Latest OSSM release](https://github.com/researchanddesire/ossm/releases/latest) | - -The cable export workflow publishes generated assets from `cable-export/`, -including: - -- `OSSM-Motor-Control-Harness.pdf` -- `OSSM-Motor-Control-Harness.png` -- `OSSM-Motor-Control-Harness.bom.tsv` diff --git a/content/docs/ossm/cable-harnesses.nl.mdx b/content/docs/ossm/cable-harnesses.nl.mdx deleted file mode 100644 index 71152e5..0000000 --- a/content/docs/ossm/cable-harnesses.nl.mdx +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: "Kabelbomen" -description: "Kabelbomen voor OSSM." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -De bronnen van de OSSM-kabelbomen staan onder [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables). -Wireviz zet elke kabelboombron om in diagramartefacten en een gedetailleerde onderliggende -stuklijst. De [stuklijst](product-bom) op productniveau moet elke kabelboom als hoofdassemblage -opnemen en naar de Wireviz-bron linken. - -## Kabelboom voor motorbesturing - -| Item | Locatie | -| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | -| Wireviz-bron | [`OSSM-Motor-Control-Harness.yml`](https://github.com/researchanddesire/ossm/blob/main/hardware/cables/OSSM-Motor-Control-Harness.yml) | -| Bronnotities | [`hardware/cables/README.md`](https://github.com/researchanddesire/ossm/blob/main/hardware/cables/README.md) | -| Gegenereerde releasebestanden | [Laatste OSSM-release](https://github.com/researchanddesire/ossm/releases/latest) | - -De kabelexportworkflow publiceert de gegenereerde bestanden uit `cable-export/`, -waaronder: - -- `OSSM-Motor-Control-Harness.pdf` -- `OSSM-Motor-Control-Harness.png` -- `OSSM-Motor-Control-Harness.bom.tsv` diff --git a/content/docs/ossm/hardware-package.de.mdx b/content/docs/ossm/hardware-package.de.mdx deleted file mode 100644 index fffd9af..0000000 --- a/content/docs/ossm/hardware-package.de.mdx +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: "OSSM-Montagedokumentation" -description: "Montagedokumentation für OSSM." ---- - -{/* Ported from MkDocs: index.md */} - -Die OSSM-Montagedokumentation wird aus den aktuellen operativen Hardwarequellen in -dieses Repository migriert. Dieses Paket veröffentlicht den assembly-docs-Bereich für Ohai, -während die vollständige Bausequenz und die Release-Assets noch ergänzt -werden. - -## Quellenübersicht - -| Bereich | Quelle | -| ----------------------------------- | ------------------------------------------------------------------------------------------ | -| Stückliste auf Produktebene | [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) | -| CAD-Release-Exporte | [`hardware/cad/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cad) | -| Hinweise zur PCB-Quelle | [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb) | -| Kabelbaumquellen | [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables) | -| Aktuelle Upstream-Hardware-Referenz | [KinkyMakers/OSSM-hardware](https://github.com/KinkyMakers/OSSM-hardware) | - -## Montageunterlagen - -- [PCB-Übersicht](pcb-overview) -- [Kabelbäume](cable-harnesses) -- [Stückliste](product-bom) -- [Montageanleitung](release-status) diff --git a/content/docs/ossm/hardware-package.fr.mdx b/content/docs/ossm/hardware-package.fr.mdx deleted file mode 100644 index c40f755..0000000 --- a/content/docs/ossm/hardware-package.fr.mdx +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: "Documentation d’assemblage OSSM" -description: "Documentation d’assemblage pour OSSM." ---- - -{/* Ported from MkDocs: index.md */} - -Cet ensemble documentaire OSSM est en cours de migration vers ce dépôt depuis les -sources matérielles opérationnelles actuelles. Il publie la section assembly-docs -pour Ohai, tandis que la séquence complète de build et les artefacts de release sont -encore en cours d’ajout. - -## Carte des sources - -| Zone | Source | -| -------------------------------------- | ------------------------------------------------------------------------------------------ | -| Nomenclature au niveau du produit | [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) | -| Fichiers CAO de release exportés | [`hardware/cad/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cad) | -| Notes sur les sources de PCB | [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb) | -| Sources de faisceaux de câbles | [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables) | -| Référence actuelle du matériel en amont | [KinkyMakers/OSSM-hardware](https://github.com/KinkyMakers/OSSM-hardware) | - -## Dossier d’assemblage - -- [Aperçu du PCB](pcb-overview) -- [Faisceaux de câbles](cable-harnesses) -- [Nomenclature](product-bom) -- [Guide d’assemblage](release-status) diff --git a/content/docs/ossm/hardware-package.mdx b/content/docs/ossm/hardware-package.mdx deleted file mode 100644 index 3f56f03..0000000 --- a/content/docs/ossm/hardware-package.mdx +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: "OSSM Assembly Docs" -description: "OSSM Assembly Docs for OSSM." ---- - -{/* Ported from MkDocs: index.md */} - -OSSM assembly documentation is being migrated into this repository from the -current operational hardware sources. This package publishes the assembly-docs -surface for Ohai while the complete build sequence and release assets are -filled in. - -## Source Map - -| Area | Source | -| ----------------------------------- | ------------------------------------------------------------------------------------------ | -| Product-level BOM | [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) | -| CAD release exports | [`hardware/cad/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cad) | -| PCB source notes | [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb) | -| Cable harness sources | [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables) | -| Current upstream hardware reference | [KinkyMakers/OSSM-hardware](https://github.com/KinkyMakers/OSSM-hardware) | - -## Assembly Package - -- [PCB Overview](pcb-overview) -- [Cable Harnesses](cable-harnesses) -- [Bill of Materials](product-bom) -- [Assembly Guide](release-status) diff --git a/content/docs/ossm/hardware-package.nl.mdx b/content/docs/ossm/hardware-package.nl.mdx deleted file mode 100644 index f4485e9..0000000 --- a/content/docs/ossm/hardware-package.nl.mdx +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: "OSSM-montagedocumentatie" -description: "Montagedocumentatie voor OSSM." ---- - -{/* Ported from MkDocs: index.md */} - -De OSSM-montagedocumentatie wordt vanuit de huidige operationele hardwarebronnen naar -deze repository gemigreerd. Dit pakket publiceert de assembly-docs-sectie voor Ohai, -terwijl de volledige bouwvolgorde en release-artefacten nog worden -ingevuld. - -## Bronoverzicht - -| Gebied | Bron | -| ----------------------------------- | ------------------------------------------------------------------------------------------ | -| Stuklijst op productniveau | [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) | -| CAD-release-exports | [`hardware/cad/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cad) | -| PCB-bronnotities | [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb) | -| Kabelboombronnen | [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables) | -| Huidige upstreamreferentie voor hardware | [KinkyMakers/OSSM-hardware](https://github.com/KinkyMakers/OSSM-hardware) | - -## Montagedocumentatie - -- [PCB-overzicht](pcb-overview) -- [Kabelbomen](cable-harnesses) -- [Stuklijst](product-bom) -- [Montagehandleiding](release-status) diff --git a/content/docs/ossm/index.de.mdx b/content/docs/ossm/index.de.mdx deleted file mode 100644 index f61280a..0000000 --- a/content/docs/ossm/index.de.mdx +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Ein OSSM bauen -description: Montieren und testen Sie die offizielle Standardkonfiguration des OSSM. ---- - -## OSSM-Montage - -Beginnen Sie mit [Vor dem Bau](/ossm/build/introduction) und folgen Sie dann den Schritten der Reihe nach. Legen Sie erst dann Strom an, wenn die Baugruppe befestigt ist und die Anweisungen für den ersten Test dies vorschreiben. - -Der Leitfaden umfasst: - -- die Stückliste und die Standard-Druckteile; -- die Montage von Schiene, Riemen, Spanner, Endeffektor und Motorkopf; -- Montage der Steuerplatine und offizielle Verkabelung; -- Referenzfahrt und erster Test bei niedriger Geschwindigkeit. - -Einzelheiten zu PCB, Protokoll, Firmware und Integration finden Sie in der [Entwicklerdokumentation](https://dev.researchanddesire.com/ossm). diff --git a/content/docs/ossm/index.en.mdx b/content/docs/ossm/index.en.mdx new file mode 100644 index 0000000..dd70c94 --- /dev/null +++ b/content/docs/ossm/index.en.mdx @@ -0,0 +1,26 @@ +--- +title: OSSM Assembly Docs +license: CERN-OHL-S v2 +--- + +OSSM assembly documentation is being migrated into this repository from the +current operational hardware sources. This package publishes the assembly-docs +surface for Ohai while the complete build sequence and release assets are +filled in. + +## Source Map + +| Area | Source | +| --- | --- | +| Product-level BOM | `hardware/bom.csv` | +| CAD release exports | `hardware/cad/` | +| PCB source notes | `hardware/pcb/` | +| Cable harness sources | `hardware/cables/` | +| Current upstream hardware reference | [KinkyMakers/OSSM-hardware](https://github.com/KinkyMakers/OSSM-hardware) | + +## Assembly Package + +- [PCB Overview](/ossm/pcb-overview) +- [Cable Harnesses](/ossm/cable-harnesses) +- [Bill of Materials](/ossm/bom) +- [Assembly Guide](/ossm/assembly-guide) diff --git a/content/docs/ossm/index.fr.mdx b/content/docs/ossm/index.fr.mdx deleted file mode 100644 index 9f6d48c..0000000 --- a/content/docs/ossm/index.fr.mdx +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Construire un OSSM -description: Assemblez et testez la configuration OSSM standard officielle. ---- - -## Assemblage d’un OSSM - -Commencez par [Avant de construire](/ossm/build/introduction), puis suivez les étapes dans l'ordre. Ne mettez pas sous tension avant que l'assemblage soit solidement fixé et que les instructions du premier test vous indiquent de le faire. - -Le guide couvre : - -- la nomenclature et les pièces standard imprimées ; -- l’assemblage des rails, de la courroie, du tendeur, de l’effecteur final et de la tête de moteur ; -- le montage de la carte de commande et le câblage officiel ; -- le référencement et un premier test à basse vitesse. - -Pour plus de détails sur le PCB, le protocole, le micrologiciel et l’intégration, consultez la [documentation développeur](https://dev.researchanddesire.com/ossm). diff --git a/content/docs/ossm/index.mdx b/content/docs/ossm/index.mdx deleted file mode 100644 index 6f8ba04..0000000 --- a/content/docs/ossm/index.mdx +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Build an OSSM -description: Assemble and test the official standard OSSM configuration. ---- - -## OSSM assembly - -Start with [Before You Build](/ossm/build/introduction), then follow the stages in order. Do not apply power until the assembly is secured and the first-test instructions tell you to do so. - -The guide covers: - -- the bill of materials and standard printed parts; -- rail, belt, tensioner, end-effector, and motorhead assembly; -- control-board mounting and official wiring; -- homing and a low-speed first test. - -For PCB, protocol, firmware, and integration details, visit [Developer Docs](https://dev.researchanddesire.com/ossm). diff --git a/content/docs/ossm/index.nl.mdx b/content/docs/ossm/index.nl.mdx deleted file mode 100644 index 26d6425..0000000 --- a/content/docs/ossm/index.nl.mdx +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Een OSSM bouwen -description: Monteer en test de officiële standaardconfiguratie van de OSSM. ---- - -## OSSM-assemblage - -Begin met [Voordat u bouwt](/ossm/build/introduction) en volg vervolgens de fasen in de juiste volgorde. Schakel de voeding pas in als de constructie stevig is vastgezet en de instructies voor de eerste test aangeven dat u dit moet doen. - -De gids behandelt: - -- de stuklijst en standaard geprinte onderdelen; -- assemblage van rails, riem, spanner, eindeffector en motorkop; -- montage van de besturingsprint en officiële bedrading; -- homing en een eerste test op lage snelheid. - -Ga voor details over PCB, protocol, firmware en integratie naar de [ontwikkelaarsdocumentatie](https://dev.researchanddesire.com/ossm). diff --git a/content/docs/ossm/meta.de.json b/content/docs/ossm/meta.de.json deleted file mode 100644 index a829f26..0000000 --- a/content/docs/ossm/meta.de.json +++ /dev/null @@ -1,14 +0,0 @@ -{ - "title": "OSSM", - "root": true, - "pages": [ - "index", - "build", - "assembly-troubleshooting", - "hardware-package", - "release-status", - "product-bom", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/ossm/meta.en.json b/content/docs/ossm/meta.en.json new file mode 100644 index 0000000..9ea15a8 --- /dev/null +++ b/content/docs/ossm/meta.en.json @@ -0,0 +1,11 @@ +{ + "title": "OSSM Assembly Docs", + "pages": [ + "index", + "pcb-overview", + "cable-harnesses", + "bom", + "assembly-guide", + "..." + ] +} diff --git a/content/docs/ossm/meta.fr.json b/content/docs/ossm/meta.fr.json deleted file mode 100644 index a829f26..0000000 --- a/content/docs/ossm/meta.fr.json +++ /dev/null @@ -1,14 +0,0 @@ -{ - "title": "OSSM", - "root": true, - "pages": [ - "index", - "build", - "assembly-troubleshooting", - "hardware-package", - "release-status", - "product-bom", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/ossm/meta.json b/content/docs/ossm/meta.json deleted file mode 100644 index a829f26..0000000 --- a/content/docs/ossm/meta.json +++ /dev/null @@ -1,14 +0,0 @@ -{ - "title": "OSSM", - "root": true, - "pages": [ - "index", - "build", - "assembly-troubleshooting", - "hardware-package", - "release-status", - "product-bom", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/ossm/meta.nl.json b/content/docs/ossm/meta.nl.json deleted file mode 100644 index a829f26..0000000 --- a/content/docs/ossm/meta.nl.json +++ /dev/null @@ -1,14 +0,0 @@ -{ - "title": "OSSM", - "root": true, - "pages": [ - "index", - "build", - "assembly-troubleshooting", - "hardware-package", - "release-status", - "product-bom", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/ossm/pcb-overview.de.mdx b/content/docs/ossm/pcb-overview.de.mdx deleted file mode 100644 index 89a41bf..0000000 --- a/content/docs/ossm/pcb-overview.de.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "PCB-Übersicht" -description: "PCB-Übersicht für OSSM." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -Die Migration der OSSM-PCB-Quelle ist im Gange. Der lokale PCB-Ordner definiert derzeit -die Veröffentlichungsgrenze und verweist auf die Upstream-Referenzquelle, bis die -Release-PCB-Dateien migriert wurden. - -| Asset | Speicherort | Hinweise | -| -------------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------- | -| PCB-Quellordner | [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb) | Lokale Veröffentlichungsgrenze der OSSM-PCB-Quelle. | -| Hinweise zur PCB-Migration | [`hardware/pcb/README.md`](https://github.com/researchanddesire/ossm/blob/main/hardware/pcb/README.md) | Aktueller Status und Upstream-Referenz. | -| Upstream-PCB-Dateien | [KinkyMakers/OSSM-hardware](https://github.com/KinkyMakers/OSSM-hardware/tree/main/Hardware/PCB%20Files) | Referenz bis zum Abschluss der Migration. | - -In `hardware/pcb/` ist noch keine KiCad-Board-Datei vorhanden; daher rendert Ohai keine -KiCanvas-Vorschau für OSSM. diff --git a/content/docs/ossm/pcb-overview.en.mdx b/content/docs/ossm/pcb-overview.en.mdx new file mode 100644 index 0000000..934100c --- /dev/null +++ b/content/docs/ossm/pcb-overview.en.mdx @@ -0,0 +1,16 @@ +--- +title: PCB Overview +--- + +OSSM PCB source migration is in progress. The local PCB folder currently carries +the publication boundary and points to the upstream reference source until the +release PCB files are migrated. + +| Asset | Location | Notes | +| --- | --- | --- | +| PCB source folder | `hardware/pcb/` | Local OSSM PCB source boundary. | +| PCB migration notes | `hardware/pcb/README.md` | Current status and upstream reference. | +| Upstream PCB files | [KinkyMakers/OSSM-hardware](https://github.com/KinkyMakers/OSSM-hardware/tree/main/Hardware/PCB%20Files) | Reference until migration completes. | + +No KiCad board file is present in `hardware/pcb/` yet, so Ohai does not render a +KiCanvas preview for OSSM. diff --git a/content/docs/ossm/pcb-overview.fr.mdx b/content/docs/ossm/pcb-overview.fr.mdx deleted file mode 100644 index d826bf6..0000000 --- a/content/docs/ossm/pcb-overview.fr.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Aperçu du PCB" -description: "Aperçu du PCB pour OSSM." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -La migration de la source PCB OSSM est en cours. Le dossier PCB local définit actuellement -la limite de publication et pointe vers la source de référence en amont jusqu’à ce que les -fichiers PCB de publication soient migrés. - -| Ressource | Localisation | Remarques | -| -------------------------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | -| Dossier source du PCB | [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb) | Limite de publication locale de la source PCB OSSM. | -| Notes de migration du PCB | [`hardware/pcb/README.md`](https://github.com/researchanddesire/ossm/blob/main/hardware/pcb/README.md) | État actuel et référence en amont. | -| Fichiers PCB en amont | [KinkyMakers/OSSM-hardware](https://github.com/KinkyMakers/OSSM-hardware/tree/main/Hardware/PCB%20Files) | Référence jusqu’à la fin de la migration. | - -Aucun fichier de carte KiCad n’est encore présent dans `hardware/pcb/` ; Ohai ne rend donc pas -d’aperçu KiCanvas pour OSSM. diff --git a/content/docs/ossm/pcb-overview.mdx b/content/docs/ossm/pcb-overview.mdx deleted file mode 100644 index 27f69d0..0000000 --- a/content/docs/ossm/pcb-overview.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "PCB Overview" -description: "PCB Overview for OSSM." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -OSSM PCB source migration is in progress. The local PCB folder currently carries -the publication boundary and points to the upstream reference source until the -release PCB files are migrated. - -| Asset | Location | Notes | -| ------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------- | -| PCB source folder | [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb) | Local OSSM PCB source boundary. | -| PCB migration notes | [`hardware/pcb/README.md`](https://github.com/researchanddesire/ossm/blob/main/hardware/pcb/README.md) | Current status and upstream reference. | -| Upstream PCB files | [KinkyMakers/OSSM-hardware](https://github.com/KinkyMakers/OSSM-hardware/tree/main/Hardware/PCB%20Files) | Reference until migration completes. | - -No KiCad board file is present in `hardware/pcb/` yet, so Ohai does not render a -KiCanvas preview for OSSM. diff --git a/content/docs/ossm/pcb-overview.nl.mdx b/content/docs/ossm/pcb-overview.nl.mdx deleted file mode 100644 index 35cd08e..0000000 --- a/content/docs/ossm/pcb-overview.nl.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "PCB-overzicht" -description: "PCB-overzicht voor OSSM." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -De migratie van de OSSM-PCB-bron is gaande. De lokale PCB-map vormt momenteel -de publicatiegrens en verwijst naar de upstream-referentiebron totdat de -release-PCB-bestanden zijn gemigreerd. - -| Asset | Locatie | Opmerkingen | -| ----------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------ | -| PCB-bronmap | [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb) | Lokale publicatiegrens van de OSSM-PCB-bron. | -| Opmerkingen over PCB-migratie | [`hardware/pcb/README.md`](https://github.com/researchanddesire/ossm/blob/main/hardware/pcb/README.md) | Huidige status en upstream-referentie. | -| Upstream-PCB-bestanden | [KinkyMakers/OSSM-hardware](https://github.com/KinkyMakers/OSSM-hardware/tree/main/Hardware/PCB%20Files) | Referentie totdat de migratie is voltooid. | - -Er is nog geen KiCad-boardbestand aanwezig in `hardware/pcb/`, dus Ohai rendert geen -KiCanvas-preview voor OSSM. diff --git a/content/docs/ossm/product-bom.de.mdx b/content/docs/ossm/product-bom.de.mdx deleted file mode 100644 index 1ec6270..0000000 --- a/content/docs/ossm/product-bom.de.mdx +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: "Stückliste" -description: "Stückliste für OSSM." ---- - -{/* Ported from MkDocs: bom.md */} - -Die OSSM-Stückliste auf Produktebene wird aus [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) -während des Builds von assembly-docs generiert. Aktualisieren Sie die CSV-Datei, -anstatt den generierten Block von Hand zu bearbeiten. - -Die Stückliste dient derzeit als Platzhalter für die Migration und enthält nur eine Kopfzeile. Bis Produktzeilen -hinzugefügt werden, lässt Ohai den Text dieser Seite unverändert. - -{/* BEGIN GENERATED BOM */} -{/* END GENERATED BOM */} diff --git a/content/docs/ossm/product-bom.fr.mdx b/content/docs/ossm/product-bom.fr.mdx deleted file mode 100644 index b0476e7..0000000 --- a/content/docs/ossm/product-bom.fr.mdx +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: "Nomenclature" -description: "Nomenclature pour OSSM." ---- - -{/* Ported from MkDocs: bom.md */} - -La nomenclature OSSM au niveau du produit est générée à partir de [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) -pendant le build d’assembly-docs. Mettez à jour le CSV au lieu de modifier le bloc -généré à la main. - -La nomenclature est actuellement un espace réservé à la migration qui ne contient qu’un en-tête. Tant que les lignes de produits ne sont pas -ajoutées, Ohai laisse le texte de cette page inchangé. - -{/* BEGIN GENERATED BOM */} -{/* END GENERATED BOM */} diff --git a/content/docs/ossm/product-bom.mdx b/content/docs/ossm/product-bom.mdx deleted file mode 100644 index d9cd04e..0000000 --- a/content/docs/ossm/product-bom.mdx +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: "Bill of Materials" -description: "Bill of Materials for OSSM." ---- - -{/* Ported from MkDocs: bom.md */} - -The OSSM product-level BOM is generated from [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) -during the assembly-docs build. Update the CSV instead of editing the generated -block by hand. - -The BOM is currently a header-only migration placeholder. Until product rows are -added, Ohai leaves this page text intact. - -{/* BEGIN GENERATED BOM */} -{/* END GENERATED BOM */} diff --git a/content/docs/ossm/product-bom.nl.mdx b/content/docs/ossm/product-bom.nl.mdx deleted file mode 100644 index 4b47a6a..0000000 --- a/content/docs/ossm/product-bom.nl.mdx +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: "Stuklijst" -description: "Stuklijst voor OSSM." ---- - -{/* Ported from MkDocs: bom.md */} - -De OSSM-stuklijst op productniveau wordt gegenereerd op basis van [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) -tijdens het bouwen van assembly-docs. Werk de CSV bij in plaats van het gegenereerde blok -met de hand te bewerken. - -De stuklijst dient momenteel als tijdelijke aanduiding voor de migratie en bevat alleen een koptekst. Tot er productrijen zijn -toegevoegd, laat Ohai de tekst van deze pagina ongewijzigd. - -{/* BEGIN GENERATED BOM */} -{/* END GENERATED BOM */} diff --git a/content/docs/ossm/release-status.de.mdx b/content/docs/ossm/release-status.de.mdx deleted file mode 100644 index 79e74a1..0000000 --- a/content/docs/ossm/release-status.de.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Montageanleitung" -description: "Montageanleitung für OSSM." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -Die OSSM-Montageanleitung wartet auf die Migration aus den aktuellen operativen -Hardwarequellen. - -## Migrationscheckliste - -- Bestätigen Sie die CAD-Release-Exporte in [`hardware/cad/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cad). -- Bestätigen Sie den Migrationsstatus der PCB-Quelle in [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb). -- Bestätigen Sie die Wireviz-Kabelbaumausgabe aus [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables). -- Füllen Sie [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) mit Positionen auf Produktebene. -- Ersetzen Sie diese Checkliste durch die geordnete Bauabfolge und Montagefotos. - -Erfinden Sie keine Montageschritte, bevor das Release-Quellpaket vollständig ist. diff --git a/content/docs/ossm/release-status.fr.mdx b/content/docs/ossm/release-status.fr.mdx deleted file mode 100644 index 7784e2e..0000000 --- a/content/docs/ossm/release-status.fr.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Guide d’assemblage" -description: "Guide d’assemblage pour OSSM." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -Le guide d’assemblage OSSM attend sa migration depuis les sources matérielles -opérationnelles actuelles. - -## Liste de contrôle de migration - -- Confirmez les fichiers CAO de release exportés dans [`hardware/cad/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cad). -- Vérifiez l’état de migration de la source du PCB dans [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb). -- Confirmez la sortie du faisceau générée par Wireviz dans [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables). -- Renseignez [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) avec les postes au niveau du produit. -- Remplacez cette liste de contrôle par la séquence de construction ordonnée et les photos d’assemblage. - -N’inventez pas d’étapes d’assemblage avant que le paquet source de la release ne soit complet. diff --git a/content/docs/ossm/release-status.mdx b/content/docs/ossm/release-status.mdx deleted file mode 100644 index cc64c29..0000000 --- a/content/docs/ossm/release-status.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Assembly Guide" -description: "Assembly Guide for OSSM." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -The OSSM assembly guide is awaiting migration from the current operational -hardware sources. - -## Migration Checklist - -- Confirm the release CAD exports in [`hardware/cad/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cad). -- Confirm PCB source migration status in [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb). -- Confirm Wireviz harness output from [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables). -- Populate [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) with product-level line items. -- Replace this checklist with the ordered build sequence and assembly photos. - -Do not invent assembly steps before the release source package is complete. diff --git a/content/docs/ossm/release-status.nl.mdx b/content/docs/ossm/release-status.nl.mdx deleted file mode 100644 index fa2a80f..0000000 --- a/content/docs/ossm/release-status.nl.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Montagehandleiding" -description: "Montagehandleiding voor OSSM." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -De OSSM-montagehandleiding wacht op migratie vanuit de huidige operationele -hardwarebronnen. - -## Migratiechecklist - -- Controleer de CAD-release-exports in [`hardware/cad/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cad). -- Controleer de migratiestatus van de PCB-bron in [`hardware/pcb/`](https://github.com/researchanddesire/ossm/tree/main/hardware/pcb). -- Controleer de Wireviz-kabelboomuitvoer uit [`hardware/cables/`](https://github.com/researchanddesire/ossm/tree/main/hardware/cables). -- Vul [`hardware/bom.csv`](https://github.com/researchanddesire/ossm/blob/main/hardware/bom.csv) in met stuklijstposten op productniveau. -- Vervang deze checklist door de geordende bouwvolgorde en montagefoto's. - -Verzin geen montagestappen voordat het releasebronpakket compleet is. diff --git a/content/docs/radr/_bom/bom.csv b/content/docs/radr/_bom/bom.csv new file mode 100644 index 0000000..0b92bc2 --- /dev/null +++ b/content/docs/radr/_bom/bom.csv @@ -0,0 +1,15 @@ +#,Part Name,Category,Description,Qty,UOM,Manufacturer,MFG PN,Vendor,Vendor PN,Source,Notes +1,Tri-lobe screw,FST,Thread-forming tri-lobe screw for RADR enclosure assembly,5,each,–,–,Shorpioen,BC-0408LTFB,–,– +2,Screen,ASM,"IPS 2.0 inch 14-pin SPI LCD display, ST7789, 240 x 320 RGB",1,each,–,–,Aliexpress,ST7789/Screen No Touch,–,– +3,Battery,BTY,"3.7 V 800 mAh LiPo battery, 802735 format",1,each,–,–,Aliexpress,802735,–,– +4,RADR PCB assembly,PCA,RADR PCB v0.4 populated circuit-board assembly,1,each,–,RADR-PCB-V0.4,JLCPCB,–,pcb/RADR - PCB Design Files v0.4/PCB - OSSM Wireless v0.4.pcbdoc,Top-level PCB assembly line item; detailed PCB EBOM remains in pcb/RADR BOM - OSSM Wireless - v0.4 - S3.xlsx. +5,Front housing,FDM,FDM-printed RADR front/top housing,1,each,–,–,–,–,Print Files/Remote - Top V1.01.step,– +6,Back housing,FDM,FDM-printed RADR back/bottom housing,1,each,–,–,–,–,Print Files/Remote - Bottom.step,– +7,Battery flap,FDM,FDM-printed battery flap,1,each,–,–,–,–,Print Files/Remote - Bottom.step,– +8,Side button,FDM,FDM-printed side button,2,each,–,–,–,–,Print Files/Buttons.step,– +9,Middle button,FDM,FDM-printed middle button,1,each,–,–,–,–,Print Files/Buttons.step,– +10,Power slider button,FDM,FDM-printed power slider button,1,each,–,–,–,–,Print Files/Power Switch.step,– +11,Knob,FDM,FDM-printed rotary knob,2,each,–,–,–,–,Print Files/Remote - Knob.step,– +12,Resealable bag,PKG,"6 x 8 inch, 1.5 mil resealable bag",1,each,–,–,ULINE,S-5065,–,– +13,USB A to C cable,CBL,25 cm USB-A to USB-C power cable,1,each,–,–,Aliexpress,0.25m,–,– +14,Weather stripping,INS,"1 x 1/8 inch weather stripping, cut from 33 ft roll",0.5,in,–,–,Amazon,"1x1/8""",–,– diff --git a/content/docs/radr/_bom/bom.json b/content/docs/radr/_bom/bom.json new file mode 100644 index 0000000..a5d07ed --- /dev/null +++ b/content/docs/radr/_bom/bom.json @@ -0,0 +1,216 @@ +{ + "repo": "RADR-OSS", + "commit": "05ed5fa75e172a342c3d2c53a61a9ffa8155eb36", + "columns": [ + "#", + "Part Name", + "Category", + "Description", + "Qty", + "UOM", + "Manufacturer", + "MFG PN", + "Vendor", + "Vendor PN", + "Source", + "Notes" + ], + "rows": [ + [ + "1", + "Tri-lobe screw", + "FST", + "Thread-forming tri-lobe screw for RADR enclosure assembly", + "5", + "each", + "–", + "–", + "Shorpioen", + "BC-0408LTFB", + "–", + "–" + ], + [ + "2", + "Screen", + "ASM", + "IPS 2.0 inch 14-pin SPI LCD display, ST7789, 240 x 320 RGB", + "1", + "each", + "–", + "–", + "Aliexpress", + "ST7789/Screen No Touch", + "–", + "–" + ], + [ + "3", + "Battery", + "BTY", + "3.7 V 800 mAh LiPo battery, 802735 format", + "1", + "each", + "–", + "–", + "Aliexpress", + "802735", + "–", + "–" + ], + [ + "4", + "RADR PCB assembly", + "PCA", + "RADR PCB v0.4 populated circuit-board assembly", + "1", + "each", + "–", + "RADR-PCB-V0.4", + "JLCPCB", + "–", + "pcb/RADR - PCB Design Files v0.4/PCB - OSSM Wireless v0.4.pcbdoc", + "Top-level PCB assembly line item; detailed PCB EBOM remains in pcb/RADR BOM - OSSM Wireless - v0.4 - S3.xlsx." + ], + [ + "5", + "Front housing", + "FDM", + "FDM-printed RADR front/top housing", + "1", + "each", + "–", + "–", + "–", + "–", + "Print Files/Remote - Top V1.01.step", + "–" + ], + [ + "6", + "Back housing", + "FDM", + "FDM-printed RADR back/bottom housing", + "1", + "each", + "–", + "–", + "–", + "–", + "Print Files/Remote - Bottom.step", + "–" + ], + [ + "7", + "Battery flap", + "FDM", + "FDM-printed battery flap", + "1", + "each", + "–", + "–", + "–", + "–", + "Print Files/Remote - Bottom.step", + "–" + ], + [ + "8", + "Side button", + "FDM", + "FDM-printed side button", + "2", + "each", + "–", + "–", + "–", + "–", + "Print Files/Buttons.step", + "–" + ], + [ + "9", + "Middle button", + "FDM", + "FDM-printed middle button", + "1", + "each", + "–", + "–", + "–", + "–", + "Print Files/Buttons.step", + "–" + ], + [ + "10", + "Power slider button", + "FDM", + "FDM-printed power slider button", + "1", + "each", + "–", + "–", + "–", + "–", + "Print Files/Power Switch.step", + "–" + ], + [ + "11", + "Knob", + "FDM", + "FDM-printed rotary knob", + "2", + "each", + "–", + "–", + "–", + "–", + "Print Files/Remote - Knob.step", + "–" + ], + [ + "12", + "Resealable bag", + "PKG", + "6 x 8 inch, 1.5 mil resealable bag", + "1", + "each", + "–", + "–", + "ULINE", + "S-5065", + "–", + "–" + ], + [ + "13", + "USB A to C cable", + "CBL", + "25 cm USB-A to USB-C power cable", + "1", + "each", + "–", + "–", + "Aliexpress", + "0.25m", + "–", + "–" + ], + [ + "14", + "Weather stripping", + "INS", + "1 x 1/8 inch weather stripping, cut from 33 ft roll", + "0.5", + "in", + "–", + "–", + "Amazon", + "1x1/8\"", + "–", + "–" + ] + ] +} diff --git a/content/docs/radr/_bom/source.json b/content/docs/radr/_bom/source.json new file mode 100644 index 0000000..d5f21ff --- /dev/null +++ b/content/docs/radr/_bom/source.json @@ -0,0 +1,4 @@ +{ + "repo": "RADR-OSS", + "commit": "05ed5fa75e172a342c3d2c53a61a9ffa8155eb36" +} diff --git a/content/docs/radr/assembly-guide.de.mdx b/content/docs/radr/assembly-guide.de.mdx deleted file mode 100644 index 171560d..0000000 --- a/content/docs/radr/assembly-guide.de.mdx +++ /dev/null @@ -1,265 +0,0 @@ ---- -title: "Montageanleitung für die drahtlose RADR-Fernbedienung" -description: "Montageanleitung für die drahtlose RADR-Fernbedienung." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## Zweck - -Diese Arbeitsanweisung dokumentiert den aktuellen Montageprozess der drahtlosen RADR-Fernbedienung – von der vorbereiteten Leiterplattenbaugruppe und den gedruckten Teilen bis zum abschließenden Gerätetest. - -Verwenden Sie diese Anleitung zusammen mit den aktuell freigegebenen Versionen der Leiterplattenbaugruppe, der gedruckten Teile und der Stückliste. - -## Erforderliche Teile und Verbrauchsmaterialien - -1. Stellen Sie vor Beginn der Montage alle erforderlichen Teile bereit. - -2. Bestätigen Sie, dass das Montageset Folgendes enthält: - - `RADR-PCB-assembly` - - `screen` - - `battery` - - `front-housing` - - `back-housing` - - `battery-flap` - - 2x `side-button` - - `middle-button` - - `power-slider-button` - - `knob` - - `weather-stripping` - - 5x `BC-0408LTFB` tri-lobe-Schrauben - - `hot-glue` - -3. Wenn alle erforderlichen Teile vorhanden sind, fahren Sie mit dem nächsten Schritt fort. - -## Werkzeuge - -- Raspel -- T8-Bit für tri-lobe-Schrauben -- Elektrischer Schrauber oder Handschrauber -- Isopropylalkohol -- Mikrofasertuch -- Rasierklinge -- Heißklebepistole -- Kleiner Schraubendreher - -## PCBA vorbereiten - -1. Entgraten Sie die Kanten des `RADR-PCB-assembly` mit einer Raspel, bis die Platinenkante glatt ist. - - ![RADR-Leiterplattenbaugruppe mit zum Entgraten markierten Randbereichen](assets/pcba-deburr-edges.webp) - - _Entgraten Sie die PCBA-Kanten, bis sie glatt sind._ - -2. Wischen Sie den markierten Bereich für den Dichtungsstreifen auf der PCBA mit `isopropyl-alcohol` und einem `microfiber-cloth` ab. - - ![Markierter Bereich für den Dichtungsstreifen auf der RADR-Leiterplattenbaugruppe](assets/pcba-clean-weather-strip-area.webp) - - _Reinigen Sie den markierten Bereich für den Dichtungsstreifen._ - -3. Bringen Sie ein 2,5 cm langes Stück `weather-stripping` in der Mitte des gereinigten Bereichs an. - - ![Dichtungsstreifen auf der RADR-Leiterplattenbaugruppe angebracht](assets/weather-strip-installed.webp) - - _Dichtungsstreifen auf der PCBA angebracht._ - -4. Bringen Sie den gedruckten `power-slider-button` über dem Ein-/Ausschalter der PCBA an. - - ![Gedruckte Abdeckung des Netzschalters über dem Ein-/Ausschalter der PCBA angebracht](assets/power-switch-cover-installed.webp) - - _Abdeckung des Netzschalters angebracht._ - -5. Schließen Sie die 800-mAh-LiPo-`battery` an die PCBA an. - - Lassen Sie die PCBA nach dem Anschließen der Batterie ausgeschaltet. Im eingeschalteten Zustand leuchtet an der PCBA ein grünes Licht; im ausgeschalteten Zustand leuchtet es nicht. - - ![LiPo-Batterie an die RADR-Leiterplattenbaugruppe angeschlossen](assets/battery-connected-to-pcba.webp) - - _Batterie an der PCBA angeschlossen._ - -6. Stellen Sie sicher, dass die PCBA entgratet und gepolstert ist, die Abdeckung des Netzschalters angebracht ist, die Batterie angeschlossen ist und die PCBA ausgeschaltet ist, bevor Sie fortfahren. - -## Vorderes Gehäuse vorbereiten - -1. Schneiden Sie mit einer `razor-blade` ein kleines Dreieck von beiden Bumpern am `front-housing` ab. - - Diese Einschnitte verhindern, dass die Bumper während der Installation an der PCBA hängen bleiben. - - - - ![Bumper-Elemente des vorderen Gehäuses zum Zuschneiden markiert](assets/front-housing-bumper-cut-lines.webp) - - - ![Bumper des vorderen Gehäuses nach dem Zuschneiden](assets/front-housing-bumper-trimmed.webp) - - - -2. Entfernen Sie die Schutzfolie vom `screen`. - - ![Schutzfolie wird vom RADR-Display entfernt](assets/screen-protective-film-removal.webp) - - _Entfernen Sie die Displayfolie._ - -3. Setzen Sie den `screen` in das `front-housing` ein. - - Setzen Sie den Bildschirm zuerst in die untere Lippe an der Innenseite des Vordergehäuses ein. Biegen Sie das Gehäuse vorsichtig nach außen, während Sie den Bildschirm in die obere Bildschirmlippe drücken. Vergewissern Sie sich, dass der Bildschirm bündig am Gehäuse anliegt. - - - - ![Display wird in die untere Lippe des RADR-Vordergehäuses eingesetzt](assets/screen-bottom-lip-insertion.webp) - - - ![Display sitzt bündig im RADR-Vordergehäuse](assets/screen-seated-flush.webp) - - - -4. Tragen Sie entlang der Bildschirmkanten eine dünne, flache Raupe aus `hot-glue` auf. - - Halten Sie die Kleberaupe sowohl an der Bildschirmkante als auch am Kunststoffgehäuse anliegend. Der Kunststoff des Gehäuses sollte leicht in den Kleber einschmelzen. - - ![Heißkleberraupe um den Rand des RADR-Displays](assets/screen-hot-glue-bead.webp) - - _Flache Kleberaupe um die Bildschirmkante._ - -5. Legen Sie die gedruckten Tasten in das `front-housing`. - - ![Gedruckte RADR-Tasten im vorderen Gehäuse angebracht](assets/buttons-installed-in-front-housing.webp) - - _Tasten im vorderen Gehäuse angebracht._ - -6. Stellen Sie sicher, dass die Bumper zugeschnitten und der Bildschirm festgeklebt sind und sich die Tasten frei bewegen lassen, bevor Sie fortfahren. - -## PCBA einsetzen - -1. Führen Sie das Bildschirm-Flachbandkabel durch die Aussparung in der PCBA und drücken Sie die PCBA anschließend bündig in das `front-housing`. - - ![RADR-Leiterplattenbaugruppe bündig im vorderen Gehäuse, Bildschirm-Flachbandkabel durch die Leiterplattenaussparung geführt](assets/pcba-seated-in-front-housing.webp) - - _PCBA sitzt im vorderen Gehäuse._ - -2. Öffnen Sie den Anschluss des Bildschirm-Flachbandkabels auf der PCBA mit einem kleinen Schraubendreher. - - ![Geöffneter Anschluss des Bildschirm-Flachbandkabels auf der RADR-Leiterplattenbaugruppe](assets/screen-connector-open.webp) - - _Öffnen Sie den Bildschirmanschluss._ - -3. Stecken Sie das Bildschirm-Flachbandkabel in den Anschluss und schließen Sie ihn. - - ![Bildschirm-Flachbandkabel in den RADR-Leiterplattenanschluss eingesteckt](assets/screen-ribbon-connected.webp) - - _Bildschirm-Flachbandkabel angeschlossen._ - -4. Verstauen Sie das Bildschirm-Flachbandkabel im Gehäuse. - - ![Bildschirm-Flachbandkabel im RADR-Gehäuse verstaut](assets/screen-ribbon-tucked.webp) - - _Bildschirm-Flachbandkabel im Gehäuse verstaut._ - -5. Stellen Sie sicher, dass die PCBA bündig sitzt, der Anschluss des Flachbandkabels geschlossen ist und das Kabel von Quetschstellen ferngehalten wird, bevor Sie fortfahren. - -## Gehäuse schließen - -1. Setzen Sie das `back-housing` auf das `front-housing`, indem Sie den Ein-/Ausschalter in seine Aussparung einsetzen. - - ![RADR-Rückgehäuse über dem vorderen Gehäuse ausgerichtet, Netzschalter wird in seine Aussparung eingesetzt](assets/bottom-housing-power-switch-alignment.webp) - - _Richten Sie den Netzschalter an der Aussparung des hinteren Gehäuses aus._ - -2. Ziehen Sie die `battery` durch den offenen Bereich im hinteren Gehäuse, der zum Batteriefach wird. - - - - ![Batterie durch die Öffnung des Batteriefachs im hinteren RADR-Gehäuse gezogen](assets/battery-pulled-through-bottom-housing.webp) - - - ![Referenz für die Batterieführung bei teilweise geschlossenen vorderen und hinteren RADR-Gehäusen](assets/battery-routing-reference.webp) - - - -3. Befestigen Sie das vordere und hintere Gehäuse mit mittlerem Drehmoment und tri-lobe-Schrauben. - - Die Schraube sitzt tief genug, wenn der Schrauber rattert. - - ![Schraubenpositionen am hinteren RADR-Gehäuse mit befestigten tri-lobe-Schrauben](assets/rear-screws-fastened.webp) - - _Befestigen Sie die Schrauben des hinteren Gehäuses._ - -4. Befestigen Sie die Schraubenlöcher des vorderen Gehäuses mit denselben tri-lobe-Schrauben. - - ![Schraubenpositionen am vorderen RADR-Gehäuse mit befestigten tri-lobe-Schrauben](assets/front-screws-fastened.webp) - - _Befestigen Sie die Schrauben des vorderen Gehäuses._ - -5. Legen Sie die `battery` in das Batteriefach. - - ![RADR-Batterie im Batteriefach platziert](assets/battery-in-compartment.webp) - - _Batterie im Batteriefach platziert._ - -6. Legen Sie die `battery-flap` über die Batterie und verschrauben Sie sie mit tri-lobe-Schrauben. - - ![RADR-Batterieabdeckung über dem Batteriefach angebracht](assets/battery-cover-installed.webp) - - _Batterieabdeckung angebracht._ - -7. Stellen Sie sicher, dass das Gehäuse vollständig geschlossen, alle Schrauben eingesetzt und die Batterieabdeckung gesichert ist, bevor Sie fortfahren. - -## Knopf einsetzen und testen - -1. Entfernen Sie mit einem kleinen Schraubendreher überschüssiges Filament aus der Innenbohrung des Knopfs. - - ![Innenbohrung des RADR-Knopfs nach dem Entfernen überschüssigen Filaments](assets/knob-interior-cleaned.webp) - - _Reinigen Sie die Knopfbohrung vor dem Einsetzen._ - -2. Richten Sie die Encoderform an der Form der Knopfbohrung aus und drücken Sie den `knob` auf den Encoder, bis er sanft einrastet. - - ![RADR-Knopf wird auf den Drehgeber gedrückt](assets/knob-installed-on-encoder.webp) - - _Drücken Sie den Knopf auf den Encoder._ - -3. Schalten Sie das Gerät ein und testen Sie es gemäß dem Protokoll. - - ![RADR-Funkfernbedienung für den Abschlusstest eingeschaltet](assets/device-test-on.webp) - - _Gerät für den Abschlusstest eingeschaltet._ - -## Endmontage - -1. Stellen Sie sicher, dass die PCBA-Kanten glatt sind und nicht am Gehäuse hängen bleiben. -2. Stellen Sie sicher, dass der Dichtungsstreifen mittig sitzt und an der PCBA haftet. -3. Stellen Sie sicher, dass die Abdeckung des Netzschalters den Ein-/Ausschalter reibungslos bewegt. -4. Stellen Sie sicher, dass die Bumper des vorderen Gehäuses zugeschnitten sind. -5. Stellen Sie sicher, dass der Bildschirm bündig sitzt und mit einer dünnen, flachen Kleberaupe befestigt ist. -6. Stellen Sie sicher, dass die Tasten eingesetzt sind und sich frei bewegen lassen. -7. Stellen Sie sicher, dass die PCBA bündig im vorderen Gehäuse sitzt. -8. Stellen Sie sicher, dass das Bildschirm-Flachbandkabel vollständig eingesteckt und der Anschluss geschlossen ist. -9. Stellen Sie sicher, dass das Bildschirm-Flachbandkabel und die Batteriekabel von Quetschstellen ferngehalten werden. -10. Stellen Sie sicher, dass die Gehäuse und die Batterieabdeckung mit tri-lobe-Schrauben befestigt sind. -11. Stellen Sie sicher, dass der Knopf auf dem Encoder sitzt. -12. Bestätigen Sie, dass das Gerät eingeschaltet wird und das aktuelle Funktionstestprotokoll besteht. - -## QC-Checkliste - -- [ ] Die PCBA-Kanten wurden glatt entgratet. -- [ ] Der Bereich für den Dichtungsstreifen wurde mit Isopropylalkohol gereinigt. -- [ ] Ein 2,5 cm langes Stück Dichtungsstreifen wurde auf der PCBA angebracht. -- [ ] Die gedruckte Abdeckung des Netzschalters wurde angebracht. -- [ ] Die Batterie wurde bei ausgeschalteter PCBA angeschlossen. -- [ ] Die Bumper des vorderen Gehäuses wurden zugeschnitten. -- [ ] Die Schutzfolie des Bildschirms wurde entfernt. -- [ ] Der Bildschirm wurde bündig in das vordere Gehäuse eingesetzt. -- [ ] Der Bildschirm wurde mit einer dünnen, flachen Heißkleberraupe befestigt. -- [ ] Die Tasten wurden in das vordere Gehäuse eingesetzt. -- [ ] Das Bildschirm-Flachbandkabel wurde durch die PCBA-Aussparung geführt. -- [ ] Die PCBA wurde bündig in das Gehäuse gedrückt. -- [ ] Der Anschluss des Bildschirm-Flachbandkabels wurde geöffnet, das Kabel eingesetzt und der Anschluss geschlossen. -- [ ] Das Bildschirm-Flachbandkabel wurde im Gehäuse verstaut. -- [ ] Das hintere Gehäuse wurde um den Ein-/Ausschalter ausgerichtet. -- [ ] Die Batterie wurde durch die Öffnung des Batteriefachs gezogen. -- [ ] Das vordere und hintere Gehäuse wurden mit tri-lobe-Schrauben befestigt. -- [ ] Die Batterie wurde in das Batteriefach gelegt. -- [ ] Die Batterieabdeckung wurde angebracht und verschraubt. -- [ ] Die Knopfbohrung wurde von überschüssigem Filament gereinigt. -- [ ] Der Knopf wurde auf den Encoder gedrückt, bis er klickte. -- [ ] Das Gerät wurde eingeschaltet und gemäß dem Protokoll getestet. diff --git a/content/docs/radr/assembly-guide.en.mdx b/content/docs/radr/assembly-guide.en.mdx new file mode 100644 index 0000000..fedb28a --- /dev/null +++ b/content/docs/radr/assembly-guide.en.mdx @@ -0,0 +1,263 @@ +--- +title: RADR Wireless Remote Assembly Guide +--- + +## Purpose + +This work instruction documents the current RADR wireless remote assembly process from prepared PCB and printed parts through final device test. + +Use these instructions with the active PCB, printed parts, and BOM release for the build. + +## Required Parts and Consumables + +1. Gather the required parts before starting assembly. + +2. Confirm the assembly set includes: + + - `RADR-PCB-assembly` + - `screen` + - `battery` + - `front-housing` + - `back-housing` + - `battery-flap` + - 2x `side-button` + - `middle-button` + - `power-slider-button` + - `knob` + - `weather-stripping` + - 5x `BC-0408LTFB` tri-lobe screws + - `hot-glue` + +3. If all required parts are present, continue onward. + +## Tools + +- Rasp +- T8 bit for tri-lobe screws +- Electric screwdriver or hand driver +- Isopropyl alcohol +- Microfiber cloth +- Razor blade +- Hot glue gun +- Small screwdriver + +## Prepare the PCBA + +1. Deburr the edges of the `RADR-PCB-assembly` with a rasp until the board edge is smooth. + + + RADR PCB assembly with edge areas marked for deburring + + +2. Wipe the marked weather-strip area on the PCBA with `isopropyl-alcohol` and a `microfiber-cloth`. + + + Marked weather-strip area on the RADR PCB assembly + + +3. Attach a 2.5 cm piece of `weather-stripping` to the center of the cleaned area. + + + Weather stripping installed on the RADR PCB assembly + + +4. Fit the printed `power-slider-button` over the PCBA on/off switch. + + + Printed power switch cover installed over the PCBA on off switch + + +5. Connect the 800 mAh LiPo `battery` to the PCBA. + + Keep the PCBA switched off after connecting the battery. The PCBA produces a green light when powered on and does not produce that light when switched off. + + + LiPo battery connected to the RADR PCB assembly + + +6. Confirm the PCBA is deburred, padded, fitted with the power switch cover, connected to the battery, and switched off before continuing. + +## Prepare the Front Housing + +1. Use a `razor-blade` to cut a small triangle off both bumpers on the `front-housing`. + + These cuts stop the bumpers from catching on the PCBA during installation. + + + + Front housing bumper features marked for trimming + + + Front housing bumper after trimming + + + +2. Remove the protective film from the `screen`. + + + Protective film being removed from the RADR display + + +3. Install the `screen` into the `front-housing`. + + Insert the screen into the bottom lip of the interior front housing first. Gently flex the housing outward while pressing the screen into the upper screen lip. Confirm the screen is flush against the housing. + + + + Display being inserted into the lower lip of the RADR front housing + + + Display seated flush in the RADR front housing + + + +4. Run a thin, low-profile bead of `hot-glue` along the screen edges. + + Keep the glue bead in contact with both the screen edge and the plastic housing. The housing plastic should melt slightly into the glue. + + + Hot glue bead around the RADR display edge + + +5. Drop the printed buttons into the `front-housing`. + + + Printed RADR buttons installed in the front housing + + +6. Confirm the bumpers are trimmed, the screen is glued in place, and the buttons move freely before continuing. + +## Install the PCBA + +1. Feed the screen ribbon through the cutout in the PCBA, then press the PCBA flush into the `front-housing`. + + + RADR PCB assembly seated in the front housing with screen ribbon routed through the PCB cutout + + +2. Open the screen ribbon connector on the PCBA with a small screwdriver. + + + Open screen ribbon connector on the RADR PCB assembly + + +3. Insert the screen ribbon into the connector and close the connector. + + + Screen ribbon inserted into the RADR PCB connector + + +4. Tuck the screen ribbon into the housing. + + + Screen ribbon tucked into the RADR housing + + +5. Confirm the PCBA sits flush, the ribbon connector is closed, and the ribbon is tucked away from pinch points before continuing. + +## Close the Housing + +1. Place the `back-housing` over the `front-housing` by inserting the on/off switch into its cutout. + + + RADR back housing aligned over the front housing with the power switch entering its cutout + + +2. Pull the `battery` through the open space in the back housing that will become the battery compartment. + + + + Battery pulled through the RADR back housing battery compartment opening + + + Battery routing reference with RADR front and back housings partially closed + + + +3. Using a medium torque setting, fasten the front and back housings together with tri-lobe screws. + + The screw is deep enough when the screwdriver ratchets. + + + RADR rear housing screw locations fastened with tri-lobe screws + + +4. Fasten the front-housing screw holes with the same tri-lobe screws. + + + RADR front housing screw locations fastened with tri-lobe screws + + +5. Place the `battery` inside the battery compartment. + + + RADR battery placed inside the battery compartment + + +6. Place the `battery-flap` over the battery and screw it shut with tri-lobe screws. + + + RADR battery cover installed over the battery compartment + + +7. Confirm the housing is fully closed, all screws are seated, and the battery cover is secured before continuing. + +## Install Knob and Test + +1. Use a small screwdriver to clean any excess filament from the interior knob circle. + + + Interior bore of the RADR knob after cleaning excess filament + + +2. Align the encoder shape with the interior knob circle shape and press the `knob` onto the encoder until it softly clicks. + + + RADR knob being pressed onto the rotary encoder + + +3. Turn on the device and test as per protocol. + + + RADR wireless remote powered on for final test + + +## Final Assembly + +1. Confirm the PCBA edges are smooth and do not catch on the housing. +2. Confirm the weather stripping is centered and adhered to the PCBA. +3. Confirm the power switch cover moves the on/off switch cleanly. +4. Confirm the front-housing bumpers are trimmed. +5. Confirm the screen is flush and glued with a low-profile bead. +6. Confirm the buttons are installed and move freely. +7. Confirm the PCBA sits flush in the front housing. +8. Confirm the screen ribbon is fully inserted and the connector is closed. +9. Confirm the screen ribbon and battery wires are routed away from pinch points. +10. Confirm the housings and battery cover are fastened with tri-lobe screws. +11. Confirm the knob is seated on the encoder. +12. Confirm the device powers on and passes the current functional test protocol. + +## QC Checklist + +- [ ] PCBA edges were deburred until smooth. +- [ ] Weather-strip area was cleaned with isopropyl alcohol. +- [ ] 2.5 cm weather-strip piece was installed on the PCBA. +- [ ] Printed power switch cover was installed. +- [ ] Battery was connected with the PCBA switched off. +- [ ] Front-housing bumpers were trimmed. +- [ ] Screen film was removed. +- [ ] Screen was installed flush in the front housing. +- [ ] Screen was secured with a thin, low-profile hot glue bead. +- [ ] Buttons were dropped into the front housing. +- [ ] Screen ribbon was fed through the PCBA cutout. +- [ ] PCBA was pressed flush into the housing. +- [ ] Screen ribbon connector was opened, seated, and closed. +- [ ] Screen ribbon was tucked into the housing. +- [ ] Back housing was aligned around the on/off switch. +- [ ] Battery was pulled through the battery compartment opening. +- [ ] Front and back housings were fastened with tri-lobe screws. +- [ ] Battery was placed inside the battery compartment. +- [ ] Battery cover was installed and screwed shut. +- [ ] Knob bore was cleaned of excess filament. +- [ ] Knob was pressed onto the encoder until it clicked. +- [ ] Device was powered on and tested as per protocol. diff --git a/content/docs/radr/assembly-guide.fr.mdx b/content/docs/radr/assembly-guide.fr.mdx deleted file mode 100644 index 1350259..0000000 --- a/content/docs/radr/assembly-guide.fr.mdx +++ /dev/null @@ -1,265 +0,0 @@ ---- -title: "Guide d’assemblage de la télécommande sans fil RADR" -description: "Guide d’assemblage de la télécommande sans fil RADR." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## Objectif - -Cette instruction de travail documente le processus actuel d’assemblage de la télécommande sans fil RADR, depuis le PCB préparé et les pièces imprimées jusqu’au test final de l’appareil. - -Utilisez ces instructions avec les versions actuellement validées du PCB, des pièces imprimées et de la nomenclature. - -## Pièces et consommables nécessaires - -1. Rassemblez les pièces nécessaires avant de commencer l’assemblage. - -2. Confirmez que le jeu de pièces comprend : - - `RADR-PCB-assembly` - - `screen` - - `battery` - - `front-housing` - - `back-housing` - - `battery-flap` - - 2x `side-button` - - `middle-button` - - `power-slider-button` - - `knob` - - `weather-stripping` - - 5x vis tri-lobe `BC-0408LTFB` - - `hot-glue` - -3. Si toutes les pièces nécessaires sont présentes, passez à la suite. - -## Outils - -- Râpe -- Embout T8 pour vis tri-lobe -- Tournevis électrique ou tournevis manuel -- Alcool isopropylique -- Chiffon en microfibre -- Lame de rasoir -- Pistolet à colle chaude -- Petit tournevis - -## Préparer le PCBA - -1. Ébavurez les bords du `RADR-PCB-assembly` avec une râpe jusqu’à ce que le bord de la carte soit lisse. - - ![Assemblage PCB RADR avec zones de bord marquées pour l’ébavurage](assets/pcba-deburr-edges.webp) - - _Ébavurez les bords du PCBA jusqu’à ce qu’ils soient lisses._ - -2. Essuyez la zone marquée de la bande d’étanchéité sur le PCBA avec de l’`isopropyl-alcohol` et un `microfiber-cloth`. - - ![Zone de bande d’étanchéité marquée sur l’assemblage PCB RADR](assets/pcba-clean-weather-strip-area.webp) - - _Nettoyez la zone marquée de la bande d’étanchéité._ - -3. Fixez un morceau de 2,5 cm de `weather-stripping` au centre de la zone nettoyée. - - ![Bande d’étanchéité installée sur l’assemblage PCB RADR](assets/weather-strip-installed.webp) - - _Bande d’étanchéité installée sur le PCBA._ - -4. Placez le `power-slider-button` imprimé sur l’interrupteur marche/arrêt du PCBA. - - ![Couvercle d’interrupteur d’alimentation imprimé installé sur l’interrupteur marche/arrêt du PCBA](assets/power-switch-cover-installed.webp) - - _Couvercle de l’interrupteur d’alimentation installé._ - -5. Connectez la `battery` LiPo de 800 mAh au PCBA. - - Laissez le PCBA éteint après avoir connecté la batterie. Un voyant vert s’allume sur le PCBA lorsqu’il est sous tension et reste éteint lorsqu’il est hors tension. - - ![Batterie LiPo connectée à l’assemblage PCB RADR](assets/battery-connected-to-pcba.webp) - - _Batterie connectée au PCBA._ - -6. Avant de continuer, vérifiez que le PCBA est ébavuré, muni de la bande d’étanchéité, que le couvercle de l’interrupteur d’alimentation est installé, que la batterie est connectée et que le PCBA est éteint. - -## Préparer le boîtier avant - -1. Utilisez une `razor-blade` pour découper un petit triangle sur les deux pare-chocs du `front-housing`. - - Ces découpes empêchent les pare-chocs de s’accrocher au PCBA pendant l’installation. - - - - ![Éléments des pare-chocs du boîtier avant marqués pour la découpe](assets/front-housing-bumper-cut-lines.webp) - - - ![Pare-chocs du boîtier avant après la découpe](assets/front-housing-bumper-trimmed.webp) - - - -2. Retirez le film protecteur du `screen`. - - ![Film protecteur retiré de l’écran RADR](assets/screen-protective-film-removal.webp) - - _Retirez le film de l’écran._ - -3. Installez le `screen` dans le `front-housing`. - - Insérez d’abord l’écran dans la lèvre inférieure à l’intérieur du boîtier avant. Fléchissez doucement le boîtier vers l’extérieur tout en appuyant sur l’écran pour l’insérer dans la lèvre supérieure. Vérifiez que l’écran affleure le boîtier. - - - - ![Écran inséré dans la lèvre inférieure du boîtier avant du RADR](assets/screen-bottom-lip-insertion.webp) - - - ![Écran installé à fleur dans le boîtier avant du RADR](assets/screen-seated-flush.webp) - - - -4. Appliquez un cordon fin et discret de `hot-glue` le long des bords de l’écran. - - Maintenez le cordon de colle en contact avec le bord de l’écran et le boîtier en plastique. Le plastique du boîtier doit fondre légèrement dans la colle. - - ![Cordon de colle chaude autour du bord de l’écran RADR](assets/screen-hot-glue-bead.webp) - - _Cordon de colle discret autour du bord de l’écran._ - -5. Déposez les boutons imprimés dans le `front-housing`. - - ![Boutons RADR imprimés installés dans le boîtier avant](assets/buttons-installed-in-front-housing.webp) - - _Boutons installés dans le boîtier avant._ - -6. Avant de continuer, vérifiez que les pare-chocs sont découpés, que l’écran est collé et que les boutons bougent librement. - -## Installer le PCBA - -1. Faites passer la nappe de l’écran par la découpe du PCBA, puis appuyez sur le PCBA pour l’installer à fleur dans le `front-housing`. - - ![Assemblage PCB RADR installé à fleur dans le boîtier avant, nappe de l’écran acheminée par la découpe du PCB](assets/pcba-seated-in-front-housing.webp) - - _PCBA installé dans le boîtier avant._ - -2. Ouvrez le connecteur de la nappe de l’écran sur le PCBA avec un petit tournevis. - - ![Connecteur de la nappe de l’écran ouvert sur l’assemblage PCB RADR](assets/screen-connector-open.webp) - - _Ouvrez le connecteur de l’écran._ - -3. Insérez la nappe de l’écran dans le connecteur et fermez le connecteur. - - ![Nappe de l’écran insérée dans le connecteur du PCB RADR](assets/screen-ribbon-connected.webp) - - _Nappe de l’écran connectée._ - -4. Rangez la nappe de l’écran dans le boîtier. - - ![Nappe de l’écran rangée dans le boîtier RADR](assets/screen-ribbon-tucked.webp) - - _Nappe de l’écran rangée dans le boîtier._ - -5. Avant de continuer, vérifiez que le PCBA affleure le boîtier, que le connecteur de la nappe est fermé et que la nappe est éloignée des points de pincement. - -## Fermer le boîtier - -1. Placez le `back-housing` sur le `front-housing` en insérant l’interrupteur marche/arrêt dans sa découpe. - - ![Boîtier arrière du RADR aligné sur le boîtier avant, interrupteur d’alimentation entrant dans sa découpe](assets/bottom-housing-power-switch-alignment.webp) - - _Alignez l’interrupteur d’alimentation avec la découpe du boîtier arrière._ - -2. Tirez la `battery` à travers l’espace ouvert du boîtier arrière qui deviendra le compartiment de la batterie. - - - - ![Batterie tirée à travers l’ouverture du compartiment de la batterie du boîtier arrière du RADR](assets/battery-pulled-through-bottom-housing.webp) - - - ![Référence du cheminement de la batterie avec les boîtiers avant et arrière du RADR partiellement fermés](assets/battery-routing-reference.webp) - - - -3. Avec un réglage de couple moyen, fixez les boîtiers avant et arrière ensemble avec des vis tri-lobe. - - La vis est suffisamment enfoncée lorsque le tournevis cliquette. - - ![Emplacements des vis du boîtier arrière du RADR fixés avec des vis tri-lobe](assets/rear-screws-fastened.webp) - - _Serrez les vis du boîtier arrière._ - -4. Fixez les trous de vis du boîtier avant avec les mêmes vis tri-lobe. - - ![Emplacements des vis du boîtier avant du RADR fixés avec des vis tri-lobe](assets/front-screws-fastened.webp) - - _Serrez les vis du boîtier avant._ - -5. Placez la `battery` dans le compartiment de la batterie. - - ![Batterie RADR placée dans le compartiment de la batterie](assets/battery-in-compartment.webp) - - _Batterie placée dans le compartiment._ - -6. Placez le `battery-flap` sur la batterie et vissez-le avec des vis tri-lobe. - - ![Couvercle de batterie RADR installé sur le compartiment de la batterie](assets/battery-cover-installed.webp) - - _Couvercle de batterie installé._ - -7. Avant de continuer, vérifiez que le boîtier est complètement fermé, que toutes les vis sont en place et que le couvercle de batterie est fixé. - -## Installer le bouton et tester - -1. Utilisez un petit tournevis pour retirer tout excès de filament de l’alésage intérieur du bouton. - - ![Alésage intérieur du bouton RADR après nettoyage de l’excès de filament](assets/knob-interior-cleaned.webp) - - _Nettoyez l’alésage du bouton avant l’installation._ - -2. Alignez la forme de l’encodeur sur celle de l’alésage intérieur du bouton et appuyez sur le `knob` pour l’enfoncer sur l’encodeur jusqu’à ce qu’il s’enclenche doucement. - - ![Bouton RADR enfoncé sur l’encodeur rotatif](assets/knob-installed-on-encoder.webp) - - _Appuyez sur le bouton pour l’installer sur l’encodeur._ - -3. Allumez l’appareil et testez-le conformément au protocole. - - ![Télécommande sans fil RADR allumée pour le test final](assets/device-test-on.webp) - - _Appareil allumé pour le test final._ - -## Assemblage final - -1. Vérifiez que les bords du PCBA sont lisses et ne s’accrochent pas au boîtier. -2. Vérifiez que la bande d’étanchéité est centrée et adhère au PCBA. -3. Vérifiez que le couvercle de l’interrupteur d’alimentation actionne correctement l’interrupteur marche/arrêt. -4. Vérifiez que les pare-chocs du boîtier avant sont découpés. -5. Vérifiez que l’écran affleure le boîtier et est fixé avec un cordon de colle fin et discret. -6. Vérifiez que les boutons sont installés et bougent librement. -7. Vérifiez que le PCBA affleure le boîtier avant. -8. Vérifiez que la nappe de l’écran est entièrement insérée et que le connecteur est fermé. -9. Vérifiez que la nappe de l’écran et les fils de la batterie sont éloignés des points de pincement. -10. Vérifiez que les boîtiers et le couvercle de batterie sont fixés avec des vis tri-lobe. -11. Vérifiez que le bouton est bien installé sur l’encodeur. -12. Confirmez que l’appareil s’allume et réussit le protocole actuel de test fonctionnel. - -## Liste de contrôle CQ - -- [ ] Les bords du PCBA ont été ébavurés jusqu’à être lisses. -- [ ] La zone de la bande d’étanchéité a été nettoyée avec de l’alcool isopropylique. -- [ ] Un morceau de bande d’étanchéité de 2,5 cm a été installé sur le PCBA. -- [ ] Le couvercle imprimé de l’interrupteur d’alimentation a été installé. -- [ ] La batterie a été connectée avec le PCBA éteint. -- [ ] Les pare-chocs du boîtier avant ont été découpés. -- [ ] Le film de l’écran a été retiré. -- [ ] L’écran a été installé à fleur dans le boîtier avant. -- [ ] L’écran a été fixé avec un cordon fin et discret de colle chaude. -- [ ] Les boutons ont été déposés dans le boîtier avant. -- [ ] La nappe de l’écran a été passée par la découpe du PCBA. -- [ ] Le PCBA a été pressé à fleur dans le boîtier. -- [ ] Le connecteur de la nappe de l’écran a été ouvert, la nappe a été insérée et le connecteur a été fermé. -- [ ] La nappe de l’écran a été rangée dans le boîtier. -- [ ] Le boîtier arrière a été aligné autour de l’interrupteur marche/arrêt. -- [ ] La batterie a été tirée à travers l’ouverture du compartiment de la batterie. -- [ ] Les boîtiers avant et arrière ont été fixés avec des vis tri-lobe. -- [ ] La batterie a été placée dans le compartiment de la batterie. -- [ ] Le couvercle de batterie a été installé et vissé. -- [ ] L’alésage du bouton a été nettoyé de l’excès de filament. -- [ ] Le bouton a été enfoncé sur l’encodeur jusqu’à ce qu’il s’enclenche. -- [ ] L’appareil a été allumé et testé conformément au protocole. diff --git a/content/docs/radr/assembly-guide.mdx b/content/docs/radr/assembly-guide.mdx deleted file mode 100644 index 51e0dcb..0000000 --- a/content/docs/radr/assembly-guide.mdx +++ /dev/null @@ -1,265 +0,0 @@ ---- -title: "RADR Wireless Remote Assembly Guide" -description: "RADR Wireless Remote Assembly Guide for RADR Wireless Remote." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## Purpose - -This work instruction documents the current RADR wireless remote assembly process from prepared PCB and printed parts through final device test. - -Use these instructions with the active PCB, printed parts, and BOM release for the build. - -## Required Parts and Consumables - -1. Gather the required parts before starting assembly. - -2. Confirm the assembly set includes: - - `RADR-PCB-assembly` - - `screen` - - `battery` - - `front-housing` - - `back-housing` - - `battery-flap` - - 2x `side-button` - - `middle-button` - - `power-slider-button` - - `knob` - - `weather-stripping` - - 5x `BC-0408LTFB` tri-lobe screws - - `hot-glue` - -3. If all required parts are present, continue onward. - -## Tools - -- Rasp -- T8 bit for tri-lobe screws -- Electric screwdriver or hand driver -- Isopropyl alcohol -- Microfiber cloth -- Razor blade -- Hot glue gun -- Small screwdriver - -## Prepare the PCBA - -1. Deburr the edges of the `RADR-PCB-assembly` with a rasp until the board edge is smooth. - - ![RADR PCB assembly with edge areas marked for deburring](assets/pcba-deburr-edges.webp) - - _Deburr the PCBA edges until smooth._ - -2. Wipe the marked weather-strip area on the PCBA with `isopropyl-alcohol` and a `microfiber-cloth`. - - ![Marked weather-strip area on the RADR PCB assembly](assets/pcba-clean-weather-strip-area.webp) - - _Clean the marked weather-strip area._ - -3. Attach a 2.5 cm piece of `weather-stripping` to the center of the cleaned area. - - ![Weather stripping installed on the RADR PCB assembly](assets/weather-strip-installed.webp) - - _Weather stripping installed on the PCBA._ - -4. Fit the printed `power-slider-button` over the PCBA on/off switch. - - ![Printed power switch cover installed over the PCBA on off switch](assets/power-switch-cover-installed.webp) - - _Power switch cover installed._ - -5. Connect the 800 mAh LiPo `battery` to the PCBA. - - Keep the PCBA switched off after connecting the battery. The PCBA produces a green light when powered on and does not produce that light when switched off. - - ![LiPo battery connected to the RADR PCB assembly](assets/battery-connected-to-pcba.webp) - - _Battery connected to the PCBA._ - -6. Confirm the PCBA is deburred, padded, fitted with the power switch cover, connected to the battery, and switched off before continuing. - -## Prepare the Front Housing - -1. Use a `razor-blade` to cut a small triangle off both bumpers on the `front-housing`. - - These cuts stop the bumpers from catching on the PCBA during installation. - - - - ![Front housing bumper features marked for trimming](assets/front-housing-bumper-cut-lines.webp) - - - ![Front housing bumper after trimming](assets/front-housing-bumper-trimmed.webp) - - - -2. Remove the protective film from the `screen`. - - ![Protective film being removed from the RADR display](assets/screen-protective-film-removal.webp) - - _Remove the display film._ - -3. Install the `screen` into the `front-housing`. - - Insert the screen into the bottom lip of the interior front housing first. Gently flex the housing outward while pressing the screen into the upper screen lip. Confirm the screen is flush against the housing. - - - - ![Display being inserted into the lower lip of the RADR front housing](assets/screen-bottom-lip-insertion.webp) - - - ![Display seated flush in the RADR front housing](assets/screen-seated-flush.webp) - - - -4. Run a thin, low-profile bead of `hot-glue` along the screen edges. - - Keep the glue bead in contact with both the screen edge and the plastic housing. The housing plastic should melt slightly into the glue. - - ![Hot glue bead around the RADR display edge](assets/screen-hot-glue-bead.webp) - - _Low-profile glue bead around the screen edge._ - -5. Drop the printed buttons into the `front-housing`. - - ![Printed RADR buttons installed in the front housing](assets/buttons-installed-in-front-housing.webp) - - _Buttons installed in the front housing._ - -6. Confirm the bumpers are trimmed, the screen is glued in place, and the buttons move freely before continuing. - -## Install the PCBA - -1. Feed the screen ribbon through the cutout in the PCBA, then press the PCBA flush into the `front-housing`. - - ![RADR PCB assembly seated in the front housing with screen ribbon routed through the PCB cutout](assets/pcba-seated-in-front-housing.webp) - - _PCBA seated in the front housing._ - -2. Open the screen ribbon connector on the PCBA with a small screwdriver. - - ![Open screen ribbon connector on the RADR PCB assembly](assets/screen-connector-open.webp) - - _Open the screen connector._ - -3. Insert the screen ribbon into the connector and close the connector. - - ![Screen ribbon inserted into the RADR PCB connector](assets/screen-ribbon-connected.webp) - - _Screen ribbon connected._ - -4. Tuck the screen ribbon into the housing. - - ![Screen ribbon tucked into the RADR housing](assets/screen-ribbon-tucked.webp) - - _Screen ribbon tucked into the housing._ - -5. Confirm the PCBA sits flush, the ribbon connector is closed, and the ribbon is tucked away from pinch points before continuing. - -## Close the Housing - -1. Place the `back-housing` over the `front-housing` by inserting the on/off switch into its cutout. - - ![RADR back housing aligned over the front housing with the power switch entering its cutout](assets/bottom-housing-power-switch-alignment.webp) - - _Align the power switch with the back-housing cutout._ - -2. Pull the `battery` through the open space in the back housing that will become the battery compartment. - - - - ![Battery pulled through the RADR back housing battery compartment opening](assets/battery-pulled-through-bottom-housing.webp) - - - ![Battery routing reference with RADR front and back housings partially closed](assets/battery-routing-reference.webp) - - - -3. Using a medium torque setting, fasten the front and back housings together with tri-lobe screws. - - The screw is deep enough when the screwdriver ratchets. - - ![RADR rear housing screw locations fastened with tri-lobe screws](assets/rear-screws-fastened.webp) - - _Fasten the rear housing screws._ - -4. Fasten the front-housing screw holes with the same tri-lobe screws. - - ![RADR front housing screw locations fastened with tri-lobe screws](assets/front-screws-fastened.webp) - - _Fasten the front housing screws._ - -5. Place the `battery` inside the battery compartment. - - ![RADR battery placed inside the battery compartment](assets/battery-in-compartment.webp) - - _Battery placed in the compartment._ - -6. Place the `battery-flap` over the battery and screw it shut with tri-lobe screws. - - ![RADR battery cover installed over the battery compartment](assets/battery-cover-installed.webp) - - _Battery cover installed._ - -7. Confirm the housing is fully closed, all screws are seated, and the battery cover is secured before continuing. - -## Install Knob and Test - -1. Use a small screwdriver to clean any excess filament from the interior knob circle. - - ![Interior bore of the RADR knob after cleaning excess filament](assets/knob-interior-cleaned.webp) - - _Clean the knob bore before installation._ - -2. Align the encoder shape with the interior knob circle shape and press the `knob` onto the encoder until it softly clicks. - - ![RADR knob being pressed onto the rotary encoder](assets/knob-installed-on-encoder.webp) - - _Press the knob onto the encoder._ - -3. Turn on the device and test as per protocol. - - ![RADR wireless remote powered on for final test](assets/device-test-on.webp) - - _Device powered on for final test._ - -## Final Assembly - -1. Confirm the PCBA edges are smooth and do not catch on the housing. -2. Confirm the weather stripping is centered and adhered to the PCBA. -3. Confirm the power switch cover moves the on/off switch cleanly. -4. Confirm the front-housing bumpers are trimmed. -5. Confirm the screen is flush and glued with a low-profile bead. -6. Confirm the buttons are installed and move freely. -7. Confirm the PCBA sits flush in the front housing. -8. Confirm the screen ribbon is fully inserted and the connector is closed. -9. Confirm the screen ribbon and battery wires are routed away from pinch points. -10. Confirm the housings and battery cover are fastened with tri-lobe screws. -11. Confirm the knob is seated on the encoder. -12. Confirm the device powers on and passes the current functional test protocol. - -## QC Checklist - -- [ ] PCBA edges were deburred until smooth. -- [ ] Weather-strip area was cleaned with isopropyl alcohol. -- [ ] 2.5 cm weather-strip piece was installed on the PCBA. -- [ ] Printed power switch cover was installed. -- [ ] Battery was connected with the PCBA switched off. -- [ ] Front-housing bumpers were trimmed. -- [ ] Screen film was removed. -- [ ] Screen was installed flush in the front housing. -- [ ] Screen was secured with a thin, low-profile hot glue bead. -- [ ] Buttons were dropped into the front housing. -- [ ] Screen ribbon was fed through the PCBA cutout. -- [ ] PCBA was pressed flush into the housing. -- [ ] Screen ribbon connector was opened, seated, and closed. -- [ ] Screen ribbon was tucked into the housing. -- [ ] Back housing was aligned around the on/off switch. -- [ ] Battery was pulled through the battery compartment opening. -- [ ] Front and back housings were fastened with tri-lobe screws. -- [ ] Battery was placed inside the battery compartment. -- [ ] Battery cover was installed and screwed shut. -- [ ] Knob bore was cleaned of excess filament. -- [ ] Knob was pressed onto the encoder until it clicked. -- [ ] Device was powered on and tested as per protocol. diff --git a/content/docs/radr/assembly-guide.nl.mdx b/content/docs/radr/assembly-guide.nl.mdx deleted file mode 100644 index 7f86bf8..0000000 --- a/content/docs/radr/assembly-guide.nl.mdx +++ /dev/null @@ -1,265 +0,0 @@ ---- -title: "Montagehandleiding voor de draadloze RADR-afstandsbediening" -description: "Montagehandleiding voor de draadloze RADR-afstandsbediening." ---- - -{/* Ported from MkDocs: assembly-guide.md */} - -## Doel - -Deze werkinstructie beschrijft het huidige assemblageproces van de draadloze RADR-afstandsbediening, van de voorbereide PCB en geprinte onderdelen tot en met de eindtest van het apparaat. - -Gebruik deze instructies met de momenteel vrijgegeven versies van de PCB, de geprinte onderdelen en de stuklijst. - -## Benodigde onderdelen en verbruiksartikelen - -1. Verzamel alle benodigde onderdelen voordat u met de montage begint. - -2. Controleer of de montageset het volgende bevat: - - `RADR-PCB-assembly` - - `screen` - - `battery` - - `front-housing` - - `back-housing` - - `battery-flap` - - 2x `side-button` - - `middle-button` - - `power-slider-button` - - `knob` - - `weather-stripping` - - 5x `BC-0408LTFB` tri-lobe-schroeven - - `hot-glue` - -3. Ga verder als alle benodigde onderdelen aanwezig zijn. - -## Gereedschap - -- Rasp -- T8-bit voor tri-lobe-schroeven -- Elektrische schroevendraaier of handschroevendraaier -- Isopropylalcohol -- Microvezeldoek -- Scheermesje -- Heetlijmpistool -- Kleine schroevendraaier - -## De PCBA voorbereiden - -1. Ontbraam de randen van de `RADR-PCB-assembly` met een rasp totdat de rand van de printplaat glad is. - - ![RADR-PCB-assemblage met gemarkeerde randgebieden voor het ontbramen](assets/pcba-deburr-edges.webp) - - _Ontbraam de randen van de PCBA totdat ze glad zijn._ - -2. Veeg het gemarkeerde gebied voor de afdichtstrip op de PCBA schoon met `isopropyl-alcohol` en een `microfiber-cloth`. - - ![Gemarkeerd gebied voor de afdichtstrip op de RADR-PCB-assemblage](assets/pcba-clean-weather-strip-area.webp) - - _Reinig het gemarkeerde gebied voor de afdichtstrip._ - -3. Bevestig een stuk `weather-stripping` van 2,5 cm in het midden van het gereinigde gebied. - - ![Afdichtstrip aangebracht op de RADR-PCB-assemblage](assets/weather-strip-installed.webp) - - _Afdichtstrip aangebracht op de PCBA._ - -4. Plaats de geprinte `power-slider-button` over de aan/uit-schakelaar van de PCBA. - - ![Geprinte afdekking van de aan/uit-schakelaar boven de aan/uit-schakelaar van de PCBA aangebracht](assets/power-switch-cover-installed.webp) - - _Afdekking van de aan/uit-schakelaar aangebracht._ - -5. Sluit de 800 mAh LiPo-`battery` aan op de PCBA. - - Houd de PCBA uitgeschakeld nadat u de batterij hebt aangesloten. Wanneer de PCBA is ingeschakeld, brandt er een groen lampje; wanneer de PCBA is uitgeschakeld, brandt het niet. - - ![LiPo-batterij aangesloten op de RADR-PCB-assemblage](assets/battery-connected-to-pcba.webp) - - _Batterij aangesloten op de PCBA._ - -6. Controleer voordat u verdergaat of de PCBA is ontbraamd, van de afdichtstrip voorzien, de afdekking van de aan/uit-schakelaar is aangebracht, de batterij is aangesloten en de PCBA is uitgeschakeld. - -## De voorbehuizing voorbereiden - -1. Gebruik een `razor-blade` om een kleine driehoek van beide bumpers op de `front-housing` af te snijden. - - Deze inkepingen voorkomen dat de bumpers tijdens de installatie aan de PCBA blijven haken. - - - - ![Bumperonderdelen van de voorbehuizing gemarkeerd om bij te snijden](assets/front-housing-bumper-cut-lines.webp) - - - ![Bumper van de voorbehuizing na het bijsnijden](assets/front-housing-bumper-trimmed.webp) - - - -2. Verwijder de beschermfolie van het `screen`. - - ![Beschermfolie wordt van het RADR-scherm verwijderd](assets/screen-protective-film-removal.webp) - - _Verwijder de displayfolie._ - -3. Plaats het `screen` in de `front-housing`. - - Plaats het scherm eerst in de onderste lip aan de binnenzijde van de voorbehuizing. Buig de behuizing voorzichtig naar buiten terwijl u het scherm in de bovenste schermlip drukt. Controleer of het scherm vlak tegen de behuizing ligt. - - - - ![Display wordt in de onderste lip van de RADR-voorbehuizing geplaatst](assets/screen-bottom-lip-insertion.webp) - - - ![Display zit vlak in de RADR-voorbehuizing](assets/screen-seated-flush.webp) - - - -4. Breng langs de schermranden een dunne, laag opstaande lijmrups van `hot-glue` aan. - - Houd de lijmrups in contact met zowel de schermrand als de kunststof behuizing. Het kunststof van de behuizing moet licht in de lijm smelten. - - ![Hete lijmrups rond de rand van het RADR-scherm](assets/screen-hot-glue-bead.webp) - - _Lage lijmrups rond de schermrand._ - -5. Plaats de geprinte knoppen in de `front-housing`. - - ![Geprinte RADR-knoppen aangebracht in de voorbehuizing](assets/buttons-installed-in-front-housing.webp) - - _Knoppen aangebracht in de voorbehuizing._ - -6. Controleer voordat u verdergaat of de bumpers zijn bijgesneden, het scherm is vastgelijmd en de knoppen vrij kunnen bewegen. - -## De PCBA installeren - -1. Voer het schermlint door de uitsparing in de PCBA en druk de PCBA vervolgens vlak in de `front-housing`. - - ![RADR-PCB-assemblage vlak in de voorbehuizing met het schermlint door de PCB-uitsparing geleid](assets/pcba-seated-in-front-housing.webp) - - _PCBA aangebracht in de voorbehuizing._ - -2. Open de schermlintconnector op de PCBA met een kleine schroevendraaier. - - ![Geopende schermlintconnector op de RADR-PCB-assemblage](assets/screen-connector-open.webp) - - _Open de schermconnector._ - -3. Steek het schermlint in de connector en sluit de connector. - - ![Schermlint in de RADR-PCB-connector gestoken](assets/screen-ribbon-connected.webp) - - _Schermlint aangesloten._ - -4. Stop het schermlint in de behuizing. - - ![Schermlint opgeborgen in de RADR-behuizing](assets/screen-ribbon-tucked.webp) - - _Schermlint opgeborgen in de behuizing._ - -5. Controleer voordat u verdergaat of de PCBA vlak ligt, de lintconnector gesloten is en het lint uit de buurt van knelpunten is opgeborgen. - -## De behuizing sluiten - -1. Plaats de `back-housing` over de `front-housing` door de aan/uit-schakelaar in de uitsparing te steken. - - ![RADR-achterbehuizing uitgelijnd boven de voorbehuizing met de aan/uit-schakelaar in de uitsparing](assets/bottom-housing-power-switch-alignment.webp) - - _Lijn de aan/uit-schakelaar uit met de uitsparing in de achterbehuizing._ - -2. Trek de `battery` door de open ruimte in de achterbehuizing die het batterijcompartiment wordt. - - - - ![Batterij door de opening van het batterijcompartiment in de achterbehuizing van de RADR getrokken](assets/battery-pulled-through-bottom-housing.webp) - - - ![Referentie voor de batterijroute met gedeeltelijk gesloten voor- en achterbehuizing van de RADR](assets/battery-routing-reference.webp) - - - -3. Zet de voor- en achterbehuizing met een gemiddeld aanhaalmoment aan elkaar vast met tri-lobe-schroeven. - - De schroef zit diep genoeg wanneer de schroevendraaier ratelt. - - ![Schroeflocaties in de achterbehuizing van de RADR vastgezet met tri-lobe-schroeven](assets/rear-screws-fastened.webp) - - _Zet de schroeven van de achterbehuizing vast._ - -4. Zet de schroefgaten van de voorbehuizing vast met dezelfde tri-lobe-schroeven. - - ![Schroeflocaties in de voorbehuizing van de RADR vastgezet met tri-lobe-schroeven](assets/front-screws-fastened.webp) - - _Zet de schroeven van de voorbehuizing vast._ - -5. Plaats de `battery` in het batterijcompartiment. - - ![RADR-batterij in het batterijcompartiment geplaatst](assets/battery-in-compartment.webp) - - _Batterij in het compartiment geplaatst._ - -6. Plaats de `battery-flap` over de batterij en schroef deze dicht met tri-lobe-schroeven. - - ![RADR-batterijklep over het batterijcompartiment aangebracht](assets/battery-cover-installed.webp) - - _Batterijklep aangebracht._ - -7. Controleer voordat u verdergaat of de behuizing volledig gesloten is, alle schroeven goed zitten en de batterijklep goed vastzit. - -## De knop installeren en testen - -1. Gebruik een kleine schroevendraaier om overtollig filament uit de binnenboring van de knop te verwijderen. - - ![Binnenboring van de RADR-knop na het verwijderen van overtollig filament](assets/knob-interior-cleaned.webp) - - _Reinig de knopboring vóór installatie._ - -2. Lijn de vorm van de encoder uit met de vorm van de knopboring en druk de `knob` op de encoder totdat deze zachtjes klikt. - - ![RADR-knop wordt op de roterende encoder gedrukt](assets/knob-installed-on-encoder.webp) - - _Druk de knop op de encoder._ - -3. Schakel het apparaat in en test het volgens het protocol. - - ![Draadloze RADR-afstandsbediening ingeschakeld voor de eindtest](assets/device-test-on.webp) - - _Apparaat ingeschakeld voor de eindtest._ - -## Eindmontage - -1. Controleer of de randen van de PCBA glad zijn en niet aan de behuizing blijven haken. -2. Controleer of de afdichtstrip gecentreerd is en aan de PCBA vastzit. -3. Controleer of de afdekking van de aan/uit-schakelaar de aan/uit-schakelaar soepel beweegt. -4. Controleer of de bumpers van de voorbehuizing zijn bijgesneden. -5. Controleer of het scherm vlak ligt en met een dunne, lage lijmrups is vastgezet. -6. Controleer of de knoppen zijn aangebracht en vrij kunnen bewegen. -7. Controleer of de PCBA vlak in de voorbehuizing ligt. -8. Controleer of het schermlint volledig is ingestoken en de connector gesloten is. -9. Controleer of het schermlint en de batterijkabels uit de buurt van knelpunten zijn geleid. -10. Controleer of de behuizingen en de batterijklep met tri-lobe-schroeven zijn vastgezet. -11. Controleer of de knop goed op de encoder zit. -12. Bevestig dat het apparaat wordt ingeschakeld en het huidige functionele testprotocol doorstaat. - -## Checklist voor kwaliteitscontrole - -- [ ] De randen van de PCBA zijn glad ontbraamd. -- [ ] Het gebied voor de afdichtstrip is schoongemaakt met isopropylalcohol. -- [ ] Een stuk afdichtstrip van 2,5 cm is op de PCBA aangebracht. -- [ ] De geprinte afdekking van de aan/uit-schakelaar is aangebracht. -- [ ] De batterij is aangesloten terwijl de PCBA was uitgeschakeld. -- [ ] De bumpers van de voorbehuizing zijn bijgesneden. -- [ ] De beschermfolie van het scherm is verwijderd. -- [ ] Het scherm is vlak in de voorbehuizing geplaatst. -- [ ] Het scherm is vastgezet met een dunne, lage lijmrups. -- [ ] De knoppen zijn in de voorbehuizing geplaatst. -- [ ] Het schermlint is door de PCBA-uitsparing geleid. -- [ ] De PCBA is vlak in de behuizing gedrukt. -- [ ] De schermlintconnector is geopend, het lint is geplaatst en de connector is gesloten. -- [ ] Het schermlint is in de behuizing opgeborgen. -- [ ] De achterbehuizing is rond de aan/uit-schakelaar uitgelijnd. -- [ ] De batterij is door de opening van het batterijcompartiment getrokken. -- [ ] De voor- en achterbehuizing zijn met tri-lobe-schroeven vastgezet. -- [ ] De batterij is in het batterijcompartiment geplaatst. -- [ ] De batterijklep is aangebracht en dichtgeschroefd. -- [ ] De knopboring is ontdaan van overtollig filament. -- [ ] De knop is op de encoder gedrukt totdat deze klikte. -- [ ] Het apparaat is ingeschakeld en volgens het protocol getest. diff --git a/content/docs/radr/assets/battery-connected-to-pcba.webp b/content/docs/radr/assets/battery-connected-to-pcba.webp index d05b6d0..99f1a51 100644 Binary files a/content/docs/radr/assets/battery-connected-to-pcba.webp and b/content/docs/radr/assets/battery-connected-to-pcba.webp differ diff --git a/content/docs/radr/assets/battery-cover-installed.webp b/content/docs/radr/assets/battery-cover-installed.webp index b13b5d3..44dbec4 100644 Binary files a/content/docs/radr/assets/battery-cover-installed.webp and b/content/docs/radr/assets/battery-cover-installed.webp differ diff --git a/content/docs/radr/assets/battery-in-compartment.webp b/content/docs/radr/assets/battery-in-compartment.webp index 136bec4..bc08087 100644 Binary files a/content/docs/radr/assets/battery-in-compartment.webp and b/content/docs/radr/assets/battery-in-compartment.webp differ diff --git a/content/docs/radr/assets/battery-pulled-through-bottom-housing.webp b/content/docs/radr/assets/battery-pulled-through-bottom-housing.webp index 7beaa6e..edb1dda 100644 Binary files a/content/docs/radr/assets/battery-pulled-through-bottom-housing.webp and b/content/docs/radr/assets/battery-pulled-through-bottom-housing.webp differ diff --git a/content/docs/radr/assets/battery-routing-reference.webp b/content/docs/radr/assets/battery-routing-reference.webp index 9063698..463cc10 100644 Binary files a/content/docs/radr/assets/battery-routing-reference.webp and b/content/docs/radr/assets/battery-routing-reference.webp differ diff --git a/content/docs/radr/assets/bottom-housing-power-switch-alignment.webp b/content/docs/radr/assets/bottom-housing-power-switch-alignment.webp index 4791d8c..d60069c 100644 Binary files a/content/docs/radr/assets/bottom-housing-power-switch-alignment.webp and b/content/docs/radr/assets/bottom-housing-power-switch-alignment.webp differ diff --git a/content/docs/radr/assets/buttons-installed-in-front-housing.webp b/content/docs/radr/assets/buttons-installed-in-front-housing.webp index d26a0bd..c21ffb3 100644 Binary files a/content/docs/radr/assets/buttons-installed-in-front-housing.webp and b/content/docs/radr/assets/buttons-installed-in-front-housing.webp differ diff --git a/content/docs/radr/assets/device-test-on.webp b/content/docs/radr/assets/device-test-on.webp index 8a6e832..ad897d3 100644 Binary files a/content/docs/radr/assets/device-test-on.webp and b/content/docs/radr/assets/device-test-on.webp differ diff --git a/content/docs/radr/assets/front-housing-bumper-cut-lines.webp b/content/docs/radr/assets/front-housing-bumper-cut-lines.webp index b2e1978..01e1cff 100644 Binary files a/content/docs/radr/assets/front-housing-bumper-cut-lines.webp and b/content/docs/radr/assets/front-housing-bumper-cut-lines.webp differ diff --git a/content/docs/radr/assets/front-housing-bumper-trimmed.webp b/content/docs/radr/assets/front-housing-bumper-trimmed.webp index 6ae90c2..d452f8d 100644 Binary files a/content/docs/radr/assets/front-housing-bumper-trimmed.webp and b/content/docs/radr/assets/front-housing-bumper-trimmed.webp differ diff --git a/content/docs/radr/assets/front-screws-fastened.webp b/content/docs/radr/assets/front-screws-fastened.webp index fcd5351..efc542e 100644 Binary files a/content/docs/radr/assets/front-screws-fastened.webp and b/content/docs/radr/assets/front-screws-fastened.webp differ diff --git a/content/docs/radr/assets/knob-installed-on-encoder.webp b/content/docs/radr/assets/knob-installed-on-encoder.webp index 2fa8914..e058913 100644 Binary files a/content/docs/radr/assets/knob-installed-on-encoder.webp and b/content/docs/radr/assets/knob-installed-on-encoder.webp differ diff --git a/content/docs/radr/assets/knob-interior-cleaned.webp b/content/docs/radr/assets/knob-interior-cleaned.webp index 28e54c5..a90b5b1 100644 Binary files a/content/docs/radr/assets/knob-interior-cleaned.webp and b/content/docs/radr/assets/knob-interior-cleaned.webp differ diff --git a/content/docs/radr/assets/pcba-clean-weather-strip-area.webp b/content/docs/radr/assets/pcba-clean-weather-strip-area.webp index e96f0e1..ab9da23 100644 Binary files a/content/docs/radr/assets/pcba-clean-weather-strip-area.webp and b/content/docs/radr/assets/pcba-clean-weather-strip-area.webp differ diff --git a/content/docs/radr/assets/pcba-deburr-edges.webp b/content/docs/radr/assets/pcba-deburr-edges.webp index dafd84c..e032b4d 100644 Binary files a/content/docs/radr/assets/pcba-deburr-edges.webp and b/content/docs/radr/assets/pcba-deburr-edges.webp differ diff --git a/content/docs/radr/assets/pcba-seated-in-front-housing.webp b/content/docs/radr/assets/pcba-seated-in-front-housing.webp index 69d07a9..71106e3 100644 Binary files a/content/docs/radr/assets/pcba-seated-in-front-housing.webp and b/content/docs/radr/assets/pcba-seated-in-front-housing.webp differ diff --git a/content/docs/radr/assets/power-switch-cover-installed.webp b/content/docs/radr/assets/power-switch-cover-installed.webp index 8332ff0..4f8f304 100644 Binary files a/content/docs/radr/assets/power-switch-cover-installed.webp and b/content/docs/radr/assets/power-switch-cover-installed.webp differ diff --git a/content/docs/radr/assets/rear-screws-fastened.webp b/content/docs/radr/assets/rear-screws-fastened.webp index 1b78073..cf8b471 100644 Binary files a/content/docs/radr/assets/rear-screws-fastened.webp and b/content/docs/radr/assets/rear-screws-fastened.webp differ diff --git a/content/docs/radr/assets/screen-bottom-lip-insertion.webp b/content/docs/radr/assets/screen-bottom-lip-insertion.webp index c5cedb2..71791c0 100644 Binary files a/content/docs/radr/assets/screen-bottom-lip-insertion.webp and b/content/docs/radr/assets/screen-bottom-lip-insertion.webp differ diff --git a/content/docs/radr/assets/screen-connector-open.webp b/content/docs/radr/assets/screen-connector-open.webp index bae784e..ddb69a9 100644 Binary files a/content/docs/radr/assets/screen-connector-open.webp and b/content/docs/radr/assets/screen-connector-open.webp differ diff --git a/content/docs/radr/assets/screen-hot-glue-bead.webp b/content/docs/radr/assets/screen-hot-glue-bead.webp index 8e31df7..86dc39c 100644 Binary files a/content/docs/radr/assets/screen-hot-glue-bead.webp and b/content/docs/radr/assets/screen-hot-glue-bead.webp differ diff --git a/content/docs/radr/assets/screen-protective-film-removal.webp b/content/docs/radr/assets/screen-protective-film-removal.webp index c342f31..bb03c00 100644 Binary files a/content/docs/radr/assets/screen-protective-film-removal.webp and b/content/docs/radr/assets/screen-protective-film-removal.webp differ diff --git a/content/docs/radr/assets/screen-ribbon-connected.webp b/content/docs/radr/assets/screen-ribbon-connected.webp index 5769a1f..4eb50c5 100644 Binary files a/content/docs/radr/assets/screen-ribbon-connected.webp and b/content/docs/radr/assets/screen-ribbon-connected.webp differ diff --git a/content/docs/radr/assets/screen-ribbon-tucked.webp b/content/docs/radr/assets/screen-ribbon-tucked.webp index bb301e6..ae05c70 100644 Binary files a/content/docs/radr/assets/screen-ribbon-tucked.webp and b/content/docs/radr/assets/screen-ribbon-tucked.webp differ diff --git a/content/docs/radr/assets/screen-seated-flush.webp b/content/docs/radr/assets/screen-seated-flush.webp index 870be35..a1daed9 100644 Binary files a/content/docs/radr/assets/screen-seated-flush.webp and b/content/docs/radr/assets/screen-seated-flush.webp differ diff --git a/content/docs/radr/assets/weather-strip-installed.webp b/content/docs/radr/assets/weather-strip-installed.webp index f648396..fb252e2 100644 Binary files a/content/docs/radr/assets/weather-strip-installed.webp and b/content/docs/radr/assets/weather-strip-installed.webp differ diff --git a/content/docs/radr/bill-of-materials.de.mdx b/content/docs/radr/bill-of-materials.de.mdx deleted file mode 100644 index e1e8633..0000000 --- a/content/docs/radr/bill-of-materials.de.mdx +++ /dev/null @@ -1,903 +0,0 @@ ---- -title: "Stückliste" -description: "Stückliste für die drahtlose RADR-Fernbedienung." ---- - -{/* Ported from MkDocs: bom.md */} - -Die drahtlose RADR-Fernbedienung verwendet eine individuell bestückte Leiterplattenbaugruppe, ein Display, eine Batterie, 3D-gedruckte Gehäuseteile, gedruckte Bedienelemente, Dichtungsstreifen und tri-lobe-Schrauben. - -## Teile - -Diese Teileliste wird während der Erstellung der Baugruppendokumente aus [`hardware/bom.csv`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/bom.csv) generiert. Bearbeiten Sie die generierte Tabelle nicht manuell. Aktualisieren Sie stattdessen die CSV-Datei. Auf die Teile wird in der gesamten [Montageanleitung](assembly-guide) verwiesen. - -{/* BEGIN GENERATED BOM */} - -
-
-
Repository
-
- - RADR-OSS - -
-
Quellen-Commit
-
- - 6d3a161 - {" "} - - (6d3a161a0d604f521b65701b04951266bb92453f) - -
-
-
- Keine getaggte Version. Diese Stückliste wird aus dem aktuellen{" "} - main gerendert und ist Vorschau-/Referenzmaterial, kein - Produktions-Schnappschuss. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- {"#"} - - Teilename - - Kategorie - - Beschreibung - - Menge - - UOM - - Hersteller - - MFG PN - - Anbieter - - PN des Anbieters - - Quelle - - Notizen -
1 -
- tri-lobe-Schraube -
- 		- - FST - - -
- Gewindeformende tri-lobe-Schraube für die RADR-Gehäusebaugruppe -
- 		5each -
–
- 		-
–
- 		-
- Shorpioen -
- 		-
- BC-0408LTFB -
- 		-
–
- 		-
–
-
2 -
- Bildschirm -
- 		- - ASM - - -
- IPS 2,0 Zoll 14-Pin-SPI-LCD-Display, ST7789, 240 x 320 RGB -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- ST7789/Screen No Touch -
- 		-
–
- 		-
–
-
3 -
- Batterie -
- 		- - BTY - - -
- 3,7 V 800 mAh LiPo-Akku, 802735-Format -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- 802735 -
- 		-
–
- 		-
–
-
4 -
- RADR-Leiterplattenbaugruppe -
- 		- - PCA - - -
- Bestückte Leiterplattenbaugruppe RADR PCB v0.4 -
- 		1each -
–
- 		-
- RADR-PCB-V0.4 -
- 		-
- JLCPCB -
- 		-
–
- 		- - -
- Übergeordneter Stücklisteneintrag für die Leiterplattenbaugruppe; die detaillierte PCB-EBOM verbleibt in - pcb/RADR BOM - OSSM Wireless - v0.4 - S3.xlsx. -
-
5 -
- Vorderes Gehäuse -
- 		- - FDM - - -
- FDM-gedrucktes RADR-Front-/Obergehäuse -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
6 -
- Hinteres Gehäuse -
- 		- - FDM - - -
- FDM-gedrucktes RADR-Gehäuse hinten/unten -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
7 -
- Batterieklappe -
- 		- - FDM - - -
- FDM-gedruckte Batterieklappe -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
8 -
- Seitlicher Knopf -
- 		- - FDM - - -
- FDM-gedruckter Seitenknopf -
- 		2each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
9 -
- Mittlerer Knopf -
- 		- - FDM - - -
- FDM-gedruckter mittlerer Knopf -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
10 -
- Ein-/Ausschalter-Schiebeknopf -
- 		- - FDM - - -
- FDM-gedruckter Ein-/Ausschalter-Schiebeknopf -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
11 -
- Knopf -
- 		- - FDM - - -
- FDM-gedruckter Drehknopf -
- 		2each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
12 -
- Wiederverschließbarer Beutel -
- 		- - PKG - - -
- 6 x 8 Zoll, 1,5 mil wiederverschließbarer Beutel -
- 		1each -
–
- 		-
–
- 		-
- ULINE -
- 		-
- S-5065 -
- 		-
–
- 		-
–
-
13 -
- USB-A-auf-C-Kabel -
- 		- - CBL - - -
- 25 cm langes USB-A-auf-USB-C-Stromkabel -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- 0.25m -
- 		-
–
- 		-
–
-
14 -
- Dichtungsstreifen -
- 		- - INS - - -
- 1 x 1/8 Zoll Dichtungsstreifen, geschnitten von einer 33-Fuß-Rolle -
- 		0.5in -
–
- 		-
–
- 		-
- Amazon -
- 		-
- 1x1/8" -
- 		-
–
- 		-
–
-
-
-
-
- Stückliste generiert aus hardware/bom.csv durch die BOM-Tools von - Research and Desire. -
-
Lizenz: CERN-OHL-S v2.
-
- Quelle:{" "} - - RADR-OSS auf GitHub - - . -
-
© Research and Desire.
-
-
-{/* END GENERATED BOM */} - -## Montagewerkzeuge und Werkstattbedarf - -| Artikel | Verwendung | -| ----------------------------------- | -------------------------------------------------------------------------- | -| Raspel | Entgraten der PCBA-Kante vor der Montage des Gehäuses. | -| T8-Schraubendreherbit | Anbringen der tri-lobe-Gehäuseschrauben. | -| Elektroschrauber oder Handschrauber | Eindrehen der Schrauben für Gehäuse und Batterieabdeckung. | -| Isopropylalkohol | Reinigen der PCBA vor der Installation des Dichtungsstreifens. | -| Mikrofasertuch | Reinigung der PCBA und Schutz kosmetischer Oberflächen. | -| Rasierklinge | Trimmen der Pufferelemente des Vordergehäuses. | -| Heißklebepistole | Befestigen des Displays im vorderen Gehäuse. | -| Kleiner Schraubendreher | Öffnen des Display-Flachbandsteckers und Reinigen der Knopfbohrung. | diff --git a/content/docs/radr/bill-of-materials.fr.mdx b/content/docs/radr/bill-of-materials.fr.mdx deleted file mode 100644 index d98d7b3..0000000 --- a/content/docs/radr/bill-of-materials.fr.mdx +++ /dev/null @@ -1,903 +0,0 @@ ---- -title: "Nomenclature" -description: "Nomenclature pour la télécommande sans fil RADR." ---- - -{/* Ported from MkDocs: bom.md */} - -La télécommande sans fil RADR utilise une carte de circuit imprimé assemblée et spécialement équipée, un écran, une batterie, des pièces de boîtier imprimées en 3D, des organes de commande imprimés, un coupe-froid et des vis tri-lobe. - -## Pièces - -Cette liste de pièces est générée à partir de [`hardware/bom.csv`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/bom.csv) lors de la construction de la documentation d'assemblage. Ne modifiez pas manuellement le tableau généré. Mettez plutôt à jour le CSV. Les pièces sont référencées tout au long du [Guide d'assemblage](assembly-guide). - -{/* BEGIN GENERATED BOM */} - -
-
-
Dépôt
-
- - RADR-OSS - -
-
Commit source
-
- - 6d3a161 - {" "} - - (6d3a161a0d604f521b65701b04951266bb92453f) - -
-
-
- Il ne s’agit pas d’une version balisée. Cette nomenclature est générée à partir de la branche{" "} - main actuelle et constitue un aperçu / document de référence, pas un - instantané de production. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- {"#"} - - Nom de la pièce - - Catégorie - - Descriptif - - Quantité - - UdM - - Fabricant - - réf. du fabricant - - Fournisseur - - Référence du fournisseur - - Source - - Remarques -
1 -
- Vis tri-lobe -
- 		- - FST - - -
- Vis tri-lobe taraudeuse pour l’assemblage du boîtier RADR -
- 		5each -
–
- 		-
–
- 		-
- Shorpioen -
- 		-
- BC-0408LTFB -
- 		-
–
- 		-
–
-
2 -
- Écran -
- 		- - ASM - - -
- Écran LCD SPI IPS 2,0 pouces 14 broches, ST7789, 240 x 320 RVB -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- ST7789/Screen No Touch -
- 		-
–
- 		-
–
-
3 -
- Batterie -
- 		- - BTY - - -
- Batterie LiPo 3,7 V 800 mAh, format 802735 -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- 802735 -
- 		-
–
- 		-
–
-
4 -
- Carte de circuit imprimé assemblée RADR -
- 		- - PCA - - -
- Carte de circuit imprimé assemblée RADR PCB v0.4 -
- 		1each -
–
- 		-
- RADR-PCB-V0.4 -
- 		-
- JLCPCB -
- 		-
–
- 		- - -
- Poste de nomenclature de premier niveau pour la carte de circuit imprimé assemblée ; la nomenclature détaillée du PCB reste dans le fichier - pcb/RADR BOM - OSSM Wireless - v0.4 - S3.xlsx. -
-
5 -
- Boîtier avant -
- 		- - FDM - - -
- Boîtier avant/supérieur RADR imprimé FDM -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
6 -
- Boîtier arrière -
- 		- - FDM - - -
- Boîtier arrière/inférieur RADR imprimé FDM -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
7 -
- Volet de batterie -
- 		- - FDM - - -
- Trappe de batterie imprimée FDM -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
8 -
- Bouton latéral -
- 		- - FDM - - -
- Bouton latéral imprimé FDM -
- 		2each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
9 -
- Bouton du milieu -
- 		- - FDM - - -
- Bouton central imprimé FDM -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
10 -
- Bouton coulissant d'alimentation -
- 		- - FDM - - -
- Bouton coulissant d'alimentation imprimé FDM -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
11 -
- Bouton -
- 		- - FDM - - -
- Bouton rotatif imprimé FDM -
- 		2each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
12 -
- Sac refermable -
- 		- - PKG - - -
- Sac refermable de 6 x 8 pouces, 1,5 mil -
- 		1each -
–
- 		-
–
- 		-
- ULINE -
- 		-
- S-5065 -
- 		-
–
- 		-
–
-
13 -
- Câble USB A vers C -
- 		- - CBL - - -
- Câble d'alimentation USB-A vers USB-C de 25 cm -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- 0.25m -
- 		-
–
- 		-
–
-
14 -
- Coupe-froid -
- 		- - INS - - -
- Coupe-froid de 1 x 1/8 po, coupé dans un rouleau de 33 pi -
- 		0.5in -
–
- 		-
–
- 		-
- Amazon -
- 		-
- 1x1/8" -
- 		-
–
- 		-
–
-
-
-
-
- Nomenclature générée à partir de hardware/bom.csv par les outils de nomenclature de - Research and Desire. -
-
Licence : CERN-OHL-S v2.
-
- Source :{" "} - - RADR-OSS sur GitHub - - . -
-
© Research and Desire.
-
-
-{/* END GENERATED BOM */} - -## Outils d'assemblage et fournitures d'atelier - -| Article | Utilisation | -| ---------------------------------------- | --------------------------------------------------------------------------------- | -| Râpe | Ébavurage du bord du PCBA avant montage du boîtier. | -| Embout de tournevis T8 | Installation des vis tri-lobe du boîtier. | -| Tournevis électrique ou tournevis manuel | Vissage des vis du boîtier et du couvercle de batterie. | -| Alcool isopropylique | Nettoyer le PCBA avant d'installer le coupe-froid. | -| Chiffon en microfibre | Nettoyage du PCBA et protection des surfaces cosmétiques. | -| Lame de rasoir | Rogner les éléments du pare-chocs du boîtier avant. | -| Pistolet à colle chaude | Fixation de l'écran dans le boîtier avant. | -| Petit tournevis | Ouverture du connecteur de la nappe de l’écran et nettoyage de l’alésage du bouton. | diff --git a/content/docs/radr/bill-of-materials.mdx b/content/docs/radr/bill-of-materials.mdx deleted file mode 100644 index 6a2c48d..0000000 --- a/content/docs/radr/bill-of-materials.mdx +++ /dev/null @@ -1,903 +0,0 @@ ---- -title: "Bill of Materials" -description: "Bill of Materials for RADR Wireless Remote." ---- - -{/* Ported from MkDocs: bom.md */} - -The RADR wireless remote uses a custom populated PCB assembly, display, battery, 3D-printed enclosure parts, printed controls, weather stripping, and tri-lobe screws. - -## Parts - -This parts list is generated from [`hardware/bom.csv`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/bom.csv) during the assembly-docs build. Do not edit the generated table by hand. Update the CSV instead. Parts are referenced throughout the [Assembly Guide](assembly-guide). - -{/* BEGIN GENERATED BOM */} - -
-
-
Repository
-
- - RADR-OSS - -
-
Source commit
-
- - 6d3a161 - {" "} - - (6d3a161a0d604f521b65701b04951266bb92453f) - -
-
-
- Not a tagged release. This BOM is rendered from the current{" "} - main and is preview / reference material, not a production - release snapshot. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- {"#"} - - Part Name - - Category - - Description - - Qty - - UOM - - Manufacturer - - MFG PN - - Vendor - - Vendor PN - - Source - - Notes -
1 -
- Tri-lobe screw -
- 		- - FST - - -
- Thread-forming tri-lobe screw for RADR enclosure assembly -
- 		5each -
–
- 		-
–
- 		-
- Shorpioen -
- 		-
- BC-0408LTFB -
- 		-
–
- 		-
–
-
2 -
- Screen -
- 		- - ASM - - -
- IPS 2.0 inch 14-pin SPI LCD display, ST7789, 240 x 320 RGB -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- ST7789/Screen No Touch -
- 		-
–
- 		-
–
-
3 -
- Battery -
- 		- - BTY - - -
- 3.7 V 800 mAh LiPo battery, 802735 format -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- 802735 -
- 		-
–
- 		-
–
-
4 -
- RADR PCB assembly -
- 		- - PCA - - -
- RADR PCB v0.4 populated circuit-board assembly -
- 		1each -
–
- 		-
- RADR-PCB-V0.4 -
- 		-
- JLCPCB -
- 		-
–
- 		- - -
- Top-level PCB assembly line item; detailed PCB EBOM remains in - pcb/RADR BOM - OSSM Wireless - v0.4 - S3.xlsx. -
-
5 -
- Front housing -
- 		- - FDM - - -
- FDM-printed RADR front/top housing -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
6 -
- Back housing -
- 		- - FDM - - -
- FDM-printed RADR back/bottom housing -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
7 -
- Battery flap -
- 		- - FDM - - -
- FDM-printed battery flap -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
8 -
- Side button -
- 		- - FDM - - -
- FDM-printed side button -
- 		2each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
9 -
- Middle button -
- 		- - FDM - - -
- FDM-printed middle button -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
10 -
- Power slider button -
- 		- - FDM - - -
- FDM-printed power slider button -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
11 -
- Knob -
- 		- - FDM - - -
- FDM-printed rotary knob -
- 		2each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
12 -
- Resealable bag -
- 		- - PKG - - -
- 6 x 8 inch, 1.5 mil resealable bag -
- 		1each -
–
- 		-
–
- 		-
- ULINE -
- 		-
- S-5065 -
- 		-
–
- 		-
–
-
13 -
- USB A to C cable -
- 		- - CBL - - -
- 25 cm USB-A to USB-C power cable -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- 0.25m -
- 		-
–
- 		-
–
-
14 -
- Weather stripping -
- 		- - INS - - -
- 1 x 1/8 inch weather stripping, cut from 33 ft roll -
- 		0.5in -
–
- 		-
–
- 		-
- Amazon -
- 		-
- 1x1/8" -
- 		-
–
- 		-
–
-
-
-
-
- Bill of Materials generated from hardware/bom.csv by Research - and Desire BOM tooling. -
-
License: CERN-OHL-S v2.
-
- Source:{" "} - - RADR-OSS on GitHub - - . -
-
© Research and Desire.
-
-
-{/* END GENERATED BOM */} - -## Assembly Tools and Shop Supplies - -| Item | Use | -| ----------------------------------- | ---------------------------------------------------------------- | -| Rasp | Deburring the PCBA edge before enclosure fit-up. | -| T8 screwdriver bit | Installing tri-lobe enclosure screws. | -| Electric screwdriver or hand driver | Driving enclosure and battery-cover screws. | -| Isopropyl alcohol | Cleaning the PCBA before installing weather stripping. | -| Microfiber cloth | Cleaning the PCBA and protecting cosmetic surfaces. | -| Razor blade | Trimming the front-housing bumper features. | -| Hot glue gun | Securing the display into the front housing. | -| Small screwdriver | Opening the display ribbon connector and cleaning the knob bore. | diff --git a/content/docs/radr/bill-of-materials.nl.mdx b/content/docs/radr/bill-of-materials.nl.mdx deleted file mode 100644 index 7bdf7cd..0000000 --- a/content/docs/radr/bill-of-materials.nl.mdx +++ /dev/null @@ -1,903 +0,0 @@ ---- -title: "Stuklijst" -description: "Stuklijst voor RADR draadloze afstandsbediening." ---- - -{/* Ported from MkDocs: bom.md */} - -De draadloze RADR-afstandsbediening maakt gebruik van een speciaal bestukte PCB-assemblage, display, batterij, 3D-geprinte behuizingsonderdelen, gedrukte bedieningselementen, tochtstrip en tri-lobe-schroeven. - -## Onderdelen - -Deze onderdelenlijst wordt gegenereerd op basis van [`hardware/bom.csv`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/bom.csv) tijdens het bouwen van de assemblagedocumenten. Bewerk de gegenereerde tabel niet met de hand. Update in plaats daarvan het CSV-bestand. Er wordt overal in de [Montagehandleiding](assembly-guide) naar onderdelen verwezen. - -{/* BEGIN GENERATED BOM */} - -
-
-
Repository
-
- - RADR-OSS - -
-
Broncommit
-
- - 6d3a161 - {" "} - - (6d3a161a0d604f521b65701b04951266bb92453f) - -
-
-
- Geen getagde release. Deze stuklijst wordt weergegeven op basis van de huidige{" "} - main en is preview-/referentiemateriaal, geen productie- - momentopname. -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- {"#"} - - Onderdeelnaam - - Categorie - - Beschrijving - - Aantal - - Eenheid - - Fabrikant - - MFG-PN - - Leverancier - - Leveranciers-PN - - Bron - - Opmerkingen -
1 -
- tri-lobe-schroef -
- 		- - FST - - -
- Draadvormende tri-lobe-schroef voor RADR-behuizingsmontage -
- 		5each -
–
- 		-
–
- 		-
- Shorpioen -
- 		-
- BC-0408LTFB -
- 		-
–
- 		-
–
-
2 -
- Scherm -
- 		- - ASM - - -
- IPS 2,0 inch 14-pins SPI LCD-scherm, ST7789, 240 x 320 RGB -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- ST7789/Screen No Touch -
- 		-
–
- 		-
–
-
3 -
- Batterij -
- 		- - BTY - - -
- 3,7 V 800 mAh LiPo-batterij, 802735-formaat -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- 802735 -
- 		-
–
- 		-
–
-
4 -
- RADR-printplaatassemblage -
- 		- - PCA - - -
- Bestukte printplaatassemblage RADR PCB v0.4 -
- 		1each -
–
- 		-
- RADR-PCB-V0.4 -
- 		-
- JLCPCB -
- 		-
–
- 		- - -
- Bovenliggend stuklijstitem voor de printplaatassemblage; de gedetailleerde PCB-EBOM blijft in - pcb/RADR BOM - OSSM Wireless - v0.4 - S3.xlsx. -
-
5 -
- Voorste behuizing -
- 		- - FDM - - -
- FDM-geprinte RADR-voor-/bovenbehuizing -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
6 -
- Achterbehuizing -
- 		- - FDM - - -
- FDM-geprinte RADR-achter-/onderbehuizing -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
7 -
- Batterijklep -
- 		- - FDM - - -
- FDM-gedrukte batterijklep -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
8 -
- Zijknop -
- 		- - FDM - - -
- FDM-gedrukte zijknop -
- 		2each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
9 -
- Middelste knop -
- 		- - FDM - - -
- FDM-gedrukte middelste knop -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
10 -
- Aan/uit-schuifknop -
- 		- - FDM - - -
- FDM-gedrukte aan/uit-schuifknop -
- 		1each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
11 -
- Knop -
- 		- - FDM - - -
- FDM-gedrukte draaiknop -
- 		2each -
–
- 		-
–
- 		-
–
- 		-
–
- 		- - -
–
-
12 -
- Hersluitbare zak -
- 		- - PKG - - -
- 6 x 8 inch, 1,5 mil hersluitbare zak -
- 		1each -
–
- 		-
–
- 		-
- ULINE -
- 		-
- S-5065 -
- 		-
–
- 		-
–
-
13 -
- USB A naar C-kabel -
- 		- - CBL - - -
- 25 cm USB-A naar USB-C voedingskabel -
- 		1each -
–
- 		-
–
- 		-
- Aliexpress -
- 		-
- 0.25m -
- 		-
–
- 		-
–
-
14 -
- Tochtstrip -
- 		- - INS - - -
- 1 x 1/8 inch tochtstrip, gesneden uit een rol van 33 ft -
- 		0.5in -
–
- 		-
–
- 		-
- Amazon -
- 		-
- 1x1/8" -
- 		-
–
- 		-
–
-
-
-
-
- Stuklijst gegenereerd uit hardware/bom.csv door de BOM-tools van - Research and Desire. -
-
Licentie: CERN-OHL-S v2.
-
- Bron:{" "} - - RADR-OSS op GitHub - - . -
-
© Research and Desire.
-
-
-{/* END GENERATED BOM */} - -## Montagegereedschap en werkplaatsbenodigdheden - -| Artikel | Gebruik | -| ---------------------------------------------------- | ------------------------------------------------------------------ | -| Rasp | Ontbramen van de PCBA-rand voordat de behuizing wordt gemonteerd. | -| T8-schroevendraaierbit | tri-lobe-behuizingsschroeven installeren. | -| Elektrische schroevendraaier of handschroevendraaier | Indraaien van de schroeven voor de behuizing en het batterijdeksel. | -| Isopropylalcohol | Reiniging van de PCBA voordat u tochtstrips installeert. | -| Microvezeldoek | Reiniging van de PCBA en bescherming van cosmetische oppervlakken. | -| Scheermesje | Bijsnijden van de bumpers van de voorbehuizing. | -| Heetlijmpistool | Het display vastzetten in de voorbehuizing. | -| Kleine schroevendraaier | Openen van de displaylintconnector en reinigen van de knopboring. | diff --git a/content/docs/radr/bom.en.mdx b/content/docs/radr/bom.en.mdx new file mode 100644 index 0000000..7b3a9ef --- /dev/null +++ b/content/docs/radr/bom.en.mdx @@ -0,0 +1,27 @@ +--- +title: Bill of Materials +showToc: false +--- + +The RADR wireless remote uses a custom populated PCB assembly, display, battery, 3D-printed enclosure parts, printed controls, weather stripping, and tri-lobe screws. + +## Parts + +This parts list is generated from [`hardware/bom.csv`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/bom.csv) during the assembly-docs build. Do not edit the generated table by hand. Update the CSV instead. Parts are referenced throughout the [Assembly Guide](/radr/assembly-guide). + +import bom from "./_bom/bom.json"; + + + +## Assembly Tools and Shop Supplies + +| Item | Use | +| ---- | --- | +| Rasp | Deburring the PCBA edge before enclosure fit-up. | +| T8 screwdriver bit | Installing tri-lobe enclosure screws. | +| Electric screwdriver or hand driver | Driving enclosure and battery-cover screws. | +| Isopropyl alcohol | Cleaning the PCBA before installing weather stripping. | +| Microfiber cloth | Cleaning the PCBA and protecting cosmetic surfaces. | +| Razor blade | Trimming the front-housing bumper features. | +| Hot glue gun | Securing the display into the front housing. | +| Small screwdriver | Opening the display ribbon connector and cleaning the knob bore. | diff --git a/content/docs/radr/cable-harnesses.de.mdx b/content/docs/radr/cable-harnesses.de.mdx deleted file mode 100644 index 498fdb9..0000000 --- a/content/docs/radr/cable-harnesses.de.mdx +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: "Kabelbäume" -description: "Kabelbäume für die drahtlose RADR-Fernbedienung." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -RADR veröffentlicht derzeit keine Wireviz-Quelle für Kabelbäume unter -`hardware/cables/`. Die [Stückliste](bill-of-materials) auf Produktebene erfasst -kabelbezogene Artikel, darunter das USB-A-zu-USB-C-Stromkabel, als Positionen -auf oberster Ebene. - -Wenn eine RADR-Kabelbaumquelle hinzugefügt wird, platzieren Sie die Wireviz-YAML-Datei in -`hardware/cables/` und verknüpfen Sie das generierte Diagramm sowie die Artefakte der -untergeordneten Stückliste auf dieser Seite. - -| Ressource | Speicherort | Hinweise | -| --------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------- | -| Quellordner für Kabelbäume | [`hardware/cables/`](https://github.com/researchanddesire/RADR-OSS/tree/main/hardware/cables) | Die Wireviz-YAML-Quellen gehören hierher. | -| Stückliste auf Produktebene | [`hardware/bom.csv`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/bom.csv) | Erfasst Kabelartikel auf Produktebene. | diff --git a/content/docs/radr/cable-harnesses.en.mdx b/content/docs/radr/cable-harnesses.en.mdx new file mode 100644 index 0000000..b8a83ca --- /dev/null +++ b/content/docs/radr/cable-harnesses.en.mdx @@ -0,0 +1,17 @@ +--- +title: Cable Harnesses +--- + +RADR does not currently publish a Wireviz harness source under +`hardware/cables/`. The product-level [Bill of Materials](/radr/bom) tracks +cable-related items, including the USB-A to USB-C power cable, as top-level +line items. + +When a RADR harness source is added, place the Wireviz YAML in +`hardware/cables/` and link the generated diagram and child BOM artifacts from +this page. + +| Asset | Location | Notes | +| --- | --- | --- | +| Cable source folder | [`hardware/cables/`](https://github.com/researchanddesire/RADR-OSS/tree/main/hardware/cables/) | Wireviz YAML sources belong here. | +| Product-level BOM | [`hardware/bom.csv`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/bom.csv) | Lists cable items at the product level. | diff --git a/content/docs/radr/cable-harnesses.fr.mdx b/content/docs/radr/cable-harnesses.fr.mdx deleted file mode 100644 index b2a1445..0000000 --- a/content/docs/radr/cable-harnesses.fr.mdx +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: "Faisceaux de câbles" -description: "Faisceaux de câbles pour la télécommande sans fil RADR." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -RADR ne publie actuellement aucune source Wireviz de faisceaux de câbles sous -`hardware/cables/`. La [nomenclature](bill-of-materials) au niveau du produit recense -les éléments liés aux câbles, notamment le câble d’alimentation USB-A vers USB-C, comme -des postes de niveau supérieur. - -Lorsqu’une source de faisceau RADR est ajoutée, placez le fichier YAML Wireviz dans -`hardware/cables/` et, depuis cette page, créez des liens vers le diagramme généré et les artefacts de la -sous-nomenclature. - -| Ressource | Emplacement | Remarques | -| --------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------ | -| Dossier source des câbles | [`hardware/cables/`](https://github.com/researchanddesire/RADR-OSS/tree/main/hardware/cables) | Les sources YAML de Wireviz se trouvent ici. | -| Nomenclature au niveau du produit | [`hardware/bom.csv`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/bom.csv) | Répertorie les éléments de câblage au niveau du produit. | diff --git a/content/docs/radr/cable-harnesses.mdx b/content/docs/radr/cable-harnesses.mdx deleted file mode 100644 index 1956128..0000000 --- a/content/docs/radr/cable-harnesses.mdx +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: "Cable Harnesses" -description: "Cable Harnesses for RADR Wireless Remote." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -RADR does not currently publish a Wireviz harness source under -`hardware/cables/`. The product-level [Bill of Materials](bill-of-materials) tracks -cable-related items, including the USB-A to USB-C power cable, as top-level -line items. - -When a RADR harness source is added, place the Wireviz YAML in -`hardware/cables/` and link the generated diagram and child BOM artifacts from -this page. - -| Asset | Location | Notes | -| ------------------- | ---------------------------------------------------------------------------------------------- | --------------------------------------- | -| Cable source folder | [`hardware/cables/`](https://github.com/researchanddesire/RADR-OSS/tree/main/hardware/cables) | Wireviz YAML sources belong here. | -| Product-level BOM | [`hardware/bom.csv`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/bom.csv) | Lists cable items at the product level. | diff --git a/content/docs/radr/cable-harnesses.nl.mdx b/content/docs/radr/cable-harnesses.nl.mdx deleted file mode 100644 index 8b6597b..0000000 --- a/content/docs/radr/cable-harnesses.nl.mdx +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: "Kabelbomen" -description: "Kabelbomen voor de draadloze RADR-afstandsbediening." ---- - -{/* Ported from MkDocs: cable-harnesses.md */} - -RADR publiceert momenteel geen Wireviz-bron voor kabelbomen onder -`hardware/cables/`. De [stuklijst](bill-of-materials) op productniveau registreert -kabelgerelateerde artikelen, waaronder de USB-A-naar-USB-C-voedingskabel, als -stuklijstposten op het hoogste niveau. - -Wanneer een RADR-bron voor een kabelboom wordt toegevoegd, plaatst u het Wireviz-YAML-bestand in -`hardware/cables/` en koppelt u vanaf deze pagina het gegenereerde diagram en de artefacten van de -onderliggende stuklijst. - -| Bronbestand | Locatie | Opmerkingen | -| -------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------- | -| Map met kabelbronnen | [`hardware/cables/`](https://github.com/researchanddesire/RADR-OSS/tree/main/hardware/cables) | De Wireviz-YAML-bronnen horen hier. | -| Stuklijst op productniveau | [`hardware/bom.csv`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/bom.csv) | Vermeldt kabelartikelen op productniveau. | diff --git a/content/docs/radr/index.de.mdx b/content/docs/radr/index.de.mdx deleted file mode 100644 index da9cf16..0000000 --- a/content/docs/radr/index.de.mdx +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: "Dokumentation zur Montage der drahtlosen RADR-Fernbedienung" -description: "Dokumentation zur Montage der drahtlosen RADR-Fernbedienung." ---- - -{/* Ported from MkDocs: index.md */} - -Dokumentationspaket zur Montage der drahtlosen RADR-Fernbedienung. - -## Montagepaket - - - - Montieren Sie die Fernbedienung von der vorbereiteten PCBA bis zum abschließenden Gerätetest. - - - Prüfen Sie die Produktionsstückliste und die Fertigungsreferenzen. - - - Hier finden Sie die Kabelabgrenzung und Hinweise zum Batterieanschluss. - - - Prüfen Sie die PCB-Quelle und die Stücklistenabgrenzung auf Platinenebene. - - - -## Produktübersicht - -RADR ist eine drahtlose Fernbedienung auf Basis einer bestückten RADR-PCB-Baugruppe, eines 2,0-Zoll-SPI-Displays, einer 800-mAh-LiPo-Batterie, gedruckter Vorder- und Rückgehäuse, gedruckter Tasten, einer gedruckten Abdeckung des Netzschalters, eines gedruckten Drehknopfs, eines Dichtungsstreifens und tri-lobe-Gehäuseschrauben. - -## Produktabmessungen und Materialien - -Bekannte Material- und Teilehinweise: - -- Gehäuse: FDM-gedruckte RADR-Vorder- und Rückgehäuse. -- Display: 2,0-Zoll-SPI-LCD-Display mit 14 Pins. -- Batterie: 3,7-V-LiPo-Batterie mit 800 mAh. -- Befestigungselemente: `BC-0408LTFB` tri-lobe-Schrauben. -- Polsterung: ein 2,5 cm langes Stück Dichtungsstreifen, das auf der PCBA angebracht ist. diff --git a/content/docs/radr/index.en.mdx b/content/docs/radr/index.en.mdx new file mode 100644 index 0000000..b2da987 --- /dev/null +++ b/content/docs/radr/index.en.mdx @@ -0,0 +1,26 @@ +--- +title: RADR Wireless Remote Assembly Docs +license: CERN-OHL-S v2 +--- + +Assembly documentation package for the RADR wireless remote. + +## Assembly Package + +- [PCB Overview](/radr/pcb-overview) +- [Bill of Materials](/radr/bom) +- [Assembly Guide](/radr/assembly-guide) + +## Product Overview + +RADR is a wireless remote built around a populated RADR PCB assembly, 2.0 inch SPI display, 800 mAh LiPo battery, printed front and back housings, printed buttons, printed power switch cover, printed rotary knob, weather stripping, and tri-lobe enclosure screws. + +## Product Dimensions and Materials + +Known material and part notes: + +- Housing: FDM-printed RADR front and back housing. +- Display: 2.0 inch 14-pin SPI LCD display. +- Battery: 3.7 V 800 mAh LiPo battery. +- Fasteners: `BC-0408LTFB` tri-lobe screws. +- Cushioning: 2.5 cm piece of weather stripping installed on the PCBA. diff --git a/content/docs/radr/index.fr.mdx b/content/docs/radr/index.fr.mdx deleted file mode 100644 index 2e7600d..0000000 --- a/content/docs/radr/index.fr.mdx +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: "Documentation d’assemblage de la télécommande sans fil RADR" -description: "Documentation d’assemblage de la télécommande sans fil RADR." ---- - -{/* Ported from MkDocs: index.md */} - -Ensemble documentaire d’assemblage de la télécommande sans fil RADR. - -## Dossier d’assemblage - - - - Assemblez la télécommande, du PCBA préparé jusqu’au test final de l’appareil. - - - Consultez la liste des pièces de production et les références de fabrication. - - - Consultez le périmètre du câblage et les notes sur le raccordement de la batterie. - - - Examinez la source du PCB et la limite de la nomenclature au niveau de la carte. - - - -## Présentation du produit - -RADR est une télécommande sans fil construite autour d’une carte de circuit imprimé RADR assemblée et équipée, d’un écran SPI de 2,0 pouces, d’une batterie LiPo de 800 mAh, de boîtiers avant et arrière imprimés, de boutons imprimés, d’un couvercle d’interrupteur d’alimentation imprimé, d’un bouton rotatif imprimé, d’une bande d’étanchéité et de vis tri-lobe pour le boîtier. - -## Dimensions et matériaux du produit - -Notes connues sur les matériaux et les pièces : - -- Boîtier : boîtiers avant et arrière RADR imprimés en FDM. -- Écran : écran LCD SPI de 2,0 pouces à 14 broches. -- Batterie : batterie LiPo de 3,7 V et 800 mAh. -- Fixations : vis tri-lobe `BC-0408LTFB`. -- Amortissement : morceau de bande d’étanchéité de 2,5 cm installé sur le PCBA. diff --git a/content/docs/radr/index.mdx b/content/docs/radr/index.mdx deleted file mode 100644 index e54f465..0000000 --- a/content/docs/radr/index.mdx +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: "RADR Wireless Remote Assembly Docs" -description: "RADR Wireless Remote Assembly Docs for RADR Wireless Remote." ---- - -{/* Ported from MkDocs: index.md */} - -Assembly documentation package for the RADR wireless remote. - -## Assembly Package - - - - Assemble the remote from prepared PCBA through final device test. - - - Review the production parts list and manufacturing references. - - - Find the cable boundary and battery connection notes. - - - Inspect the PCB source and board-level BOM boundary. - - - -## Product Overview - -RADR is a wireless remote built around a populated RADR PCB assembly, 2.0 inch SPI display, 800 mAh LiPo battery, printed front and back housings, printed buttons, printed power switch cover, printed rotary knob, weather stripping, and tri-lobe enclosure screws. - -## Product Dimensions and Materials - -Known material and part notes: - -- Housing: FDM-printed RADR front and back housing. -- Display: 2.0 inch 14-pin SPI LCD display. -- Battery: 3.7 V 800 mAh LiPo battery. -- Fasteners: `BC-0408LTFB` tri-lobe screws. -- Cushioning: 2.5 cm piece of weather stripping installed on the PCBA. diff --git a/content/docs/radr/index.nl.mdx b/content/docs/radr/index.nl.mdx deleted file mode 100644 index 2e7b186..0000000 --- a/content/docs/radr/index.nl.mdx +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: "Montagedocumentatie voor de draadloze RADR-afstandsbediening" -description: "Montagedocumentatie voor de draadloze RADR-afstandsbediening." ---- - -{/* Ported from MkDocs: index.md */} - -Montagedocumentatiepakket voor de draadloze RADR-afstandsbediening. - -## Montagepakket - - - - Monteer de afstandsbediening vanaf de voorbereide PCBA tot en met de eindtest van het apparaat. - - - Bekijk de productiestuklijst en de fabricagereferenties. - - - Bekijk de afbakening van de kabelboom en de opmerkingen over de batterijaansluiting. - - - Bekijk de PCB-bron en de stuklijstgrens op bordniveau. - - - -## Productoverzicht - -RADR is een draadloze afstandsbediening opgebouwd rond een bestukte RADR-PCB-assemblage, een SPI-display van 2,0 inch, een LiPo-batterij van 800 mAh, een geprinte voor- en achterbehuizing, geprinte knoppen, een geprint kapje voor de aan/uit-schakelaar, een geprinte draaiknop, een afdichtstrip en tri-lobe-behuizingsschroeven. - -## Productafmetingen en materialen - -Bekende opmerkingen over materialen en onderdelen: - -- Behuizing: FDM-geprinte RADR-voor- en achterbehuizing. -- Display: 2,0-inch SPI-lcdscherm met 14 pinnen. -- Batterij: 3,7 V LiPo-batterij van 800 mAh. -- Bevestigingsmiddelen: `BC-0408LTFB` tri-lobe-schroeven. -- Demping: afdichtstrip van 2,5 cm op de PCBA aangebracht. diff --git a/content/docs/radr/meta.de.json b/content/docs/radr/meta.de.json deleted file mode 100644 index 8782adc..0000000 --- a/content/docs/radr/meta.de.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "RADR-Funkfernbedienung", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/radr/meta.en.json b/content/docs/radr/meta.en.json new file mode 100644 index 0000000..373bcd8 --- /dev/null +++ b/content/docs/radr/meta.en.json @@ -0,0 +1,11 @@ +{ + "title": "RADR Wireless Remote Assembly Docs", + "pages": [ + "index", + "pcb-overview", + "cable-harnesses", + "bom", + "assembly-guide", + "..." + ] +} diff --git a/content/docs/radr/meta.fr.json b/content/docs/radr/meta.fr.json deleted file mode 100644 index 18389ed..0000000 --- a/content/docs/radr/meta.fr.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "Télécommande sans fil RADR", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/radr/meta.json b/content/docs/radr/meta.json deleted file mode 100644 index 689ab7f..0000000 --- a/content/docs/radr/meta.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "RADR Wireless Remote", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/radr/meta.nl.json b/content/docs/radr/meta.nl.json deleted file mode 100644 index 17861b9..0000000 --- a/content/docs/radr/meta.nl.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "title": "RADR draadloze afstandsbediening", - "root": true, - "pages": [ - "index", - "assembly-guide", - "bill-of-materials", - "cable-harnesses", - "pcb-overview" - ] -} diff --git a/content/docs/radr/pcb-overview.de.mdx b/content/docs/radr/pcb-overview.de.mdx deleted file mode 100644 index 890e209..0000000 --- a/content/docs/radr/pcb-overview.de.mdx +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: "PCB-Übersicht" -description: "PCB-Übersicht für die drahtlose RADR-Fernbedienung." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -Die Quelldateien des PCB-Designs befinden sich in [`hardware/pcb/`](https://github.com/researchanddesire/RADR-OSS/tree/main/hardware/pcb). Die detaillierte Stückliste der Leiterplattenkomponenten wird dort geführt und ist über die Zeile `RADR PCB assembly` in der [Stückliste](bill-of-materials) verknüpft. - -| Ressource | Link | -| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| PCB-Designdateien | [`hardware/pcb/RADR - PCB Design Files v0.4/`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20-%20PCB%20Design%20Files%20v0.4) | -| PCB-Layout | [`PCB - OSSM Wireless v0.4.pcbdoc`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20-%20PCB%20Design%20Files%20v0.4/PCB%20-%20OSSM%20Wireless%20v0.4.pcbdoc) | -| Schaltplan (PDF) | [`RADR Schematic - OSSM Wireless V0.4.pdf`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20Schematic%20-%20OSSM%20Wireless%20V0.4.pdf) | -| PCB-Rendering | [`RADR PCB render.png`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20PCB%20render.png) | -| Stückliste der PCB-Komponenten | [`RADR BOM - OSSM Wireless - v0.4 - S3.xlsx`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20BOM%20-%20OSSM%20Wireless%20-%20v0.4%20-%20S3.xlsx) | diff --git a/content/docs/radr/pcb-overview.en.mdx b/content/docs/radr/pcb-overview.en.mdx new file mode 100644 index 0000000..973a842 --- /dev/null +++ b/content/docs/radr/pcb-overview.en.mdx @@ -0,0 +1,13 @@ +--- +title: PCB Overview +--- + +The source PCB design files live in [`hardware/pcb/`](https://github.com/researchanddesire/RADR-OSS/tree/main/hardware/pcb/). The detailed PCB component BOM is tracked there and linked from the `RADR PCB assembly` line in the [Bill of Materials](/radr/bom). + +| Asset | Link | +| ----- | ---- | +| PCB design files | [`hardware/pcb/RADR - PCB Design Files v0.4/`](https://github.com/researchanddesire/RADR-OSS/tree/main/hardware/pcb/RADR%20-%20PCB%20Design%20Files%20v0.4/) | +| Board layout | [`PCB - OSSM Wireless v0.4.pcbdoc`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20-%20PCB%20Design%20Files%20v0.4/PCB%20-%20OSSM%20Wireless%20v0.4.pcbdoc) | +| Schematic PDF | [`RADR Schematic - OSSM Wireless V0.4.pdf`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20Schematic%20-%20OSSM%20Wireless%20V0.4.pdf) | +| PCB render | [`RADR PCB render.png`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20PCB%20render.png) | +| PCB component BOM | [`RADR BOM - OSSM Wireless - v0.4 - S3.xlsx`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20BOM%20-%20OSSM%20Wireless%20-%20v0.4%20-%20S3.xlsx) | diff --git a/content/docs/radr/pcb-overview.fr.mdx b/content/docs/radr/pcb-overview.fr.mdx deleted file mode 100644 index 678516a..0000000 --- a/content/docs/radr/pcb-overview.fr.mdx +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: "Vue d’ensemble du PCB" -description: "Vue d’ensemble du PCB de la télécommande sans fil RADR." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -Les fichiers sources de conception du PCB se trouvent dans [`hardware/pcb/`](https://github.com/researchanddesire/RADR-OSS/tree/main/hardware/pcb). La nomenclature détaillée des composants du PCB y est gérée et est accessible via la ligne `RADR PCB assembly` dans la [nomenclature](bill-of-materials). - -| Élément | Lien | -| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Fichiers de conception de PCB | [`hardware/pcb/RADR - PCB Design Files v0.4/`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20-%20PCB%20Design%20Files%20v0.4) | -| Implantation du PCB | [`PCB - OSSM Wireless v0.4.pcbdoc`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20-%20PCB%20Design%20Files%20v0.4/PCB%20-%20OSSM%20Wireless%20v0.4.pcbdoc) | -| Schéma (PDF) | [`RADR Schematic - OSSM Wireless V0.4.pdf`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20Schematic%20-%20OSSM%20Wireless%20V0.4.pdf) | -| Rendu du PCB | [`RADR PCB render.png`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20PCB%20render.png) | -| Nomenclature des composants du PCB | [`RADR BOM - OSSM Wireless - v0.4 - S3.xlsx`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20BOM%20-%20OSSM%20Wireless%20-%20v0.4%20-%20S3.xlsx) | diff --git a/content/docs/radr/pcb-overview.mdx b/content/docs/radr/pcb-overview.mdx deleted file mode 100644 index 365e28e..0000000 --- a/content/docs/radr/pcb-overview.mdx +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: "PCB Overview" -description: "PCB Overview for RADR Wireless Remote." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -The source PCB design files live in [`hardware/pcb/`](https://github.com/researchanddesire/RADR-OSS/tree/main/hardware/pcb). The detailed PCB component BOM is tracked there and linked from the `RADR PCB assembly` line in the [Bill of Materials](bill-of-materials). - -| Asset | Link | -| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| PCB design files | [`hardware/pcb/RADR - PCB Design Files v0.4/`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20-%20PCB%20Design%20Files%20v0.4) | -| Board layout | [`PCB - OSSM Wireless v0.4.pcbdoc`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20-%20PCB%20Design%20Files%20v0.4/PCB%20-%20OSSM%20Wireless%20v0.4.pcbdoc) | -| Schematic PDF | [`RADR Schematic - OSSM Wireless V0.4.pdf`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20Schematic%20-%20OSSM%20Wireless%20V0.4.pdf) | -| PCB render | [`RADR PCB render.png`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20PCB%20render.png) | -| PCB component BOM | [`RADR BOM - OSSM Wireless - v0.4 - S3.xlsx`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20BOM%20-%20OSSM%20Wireless%20-%20v0.4%20-%20S3.xlsx) | diff --git a/content/docs/radr/pcb-overview.nl.mdx b/content/docs/radr/pcb-overview.nl.mdx deleted file mode 100644 index c35ec36..0000000 --- a/content/docs/radr/pcb-overview.nl.mdx +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: "PCB-overzicht" -description: "PCB-overzicht voor de draadloze RADR-afstandsbediening." ---- - -{/* Ported from MkDocs: pcb-overview.md */} - -De bronbestanden voor het PCB-ontwerp bevinden zich in [`hardware/pcb/`](https://github.com/researchanddesire/RADR-OSS/tree/main/hardware/pcb). De gedetailleerde stuklijst van de PCB-componenten wordt daar bijgehouden en is toegankelijk via de regel `RADR PCB assembly` in de [stuklijst](bill-of-materials). - -| Bron | Link | -| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| PCB-ontwerpbestanden | [`hardware/pcb/RADR - PCB Design Files v0.4/`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20-%20PCB%20Design%20Files%20v0.4) | -| PCB-layout | [`PCB - OSSM Wireless v0.4.pcbdoc`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20-%20PCB%20Design%20Files%20v0.4/PCB%20-%20OSSM%20Wireless%20v0.4.pcbdoc) | -| Schema (PDF) | [`RADR Schematic - OSSM Wireless V0.4.pdf`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20Schematic%20-%20OSSM%20Wireless%20V0.4.pdf) | -| PCB-weergave | [`RADR PCB render.png`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20PCB%20render.png) | -| Stuklijst van PCB-componenten | [`RADR BOM - OSSM Wireless - v0.4 - S3.xlsx`](https://github.com/researchanddesire/RADR-OSS/blob/main/hardware/pcb/RADR%20BOM%20-%20OSSM%20Wireless%20-%20v0.4%20-%20S3.xlsx) | diff --git a/scripts/validate-content.mjs b/scripts/validate-content.mjs index 514c77c..86ee29c 100644 --- a/scripts/validate-content.mjs +++ b/scripts/validate-content.mjs @@ -20,7 +20,7 @@ function fail(file, message) { failures.push(`${path.relative(process.cwd(), file)}: ${message}`); } -function candidateExists(fromFile, rawTarget) { +function candidateExists(fromFile, rawTarget, allowExtensionless = false) { const withoutSuffix = rawTarget.split(/[?#]/, 1)[0]; if (!withoutSuffix) return true; let decoded; @@ -30,6 +30,10 @@ function candidateExists(fromFile, rawTarget) { return false; } + // Extensionless links are application routes in Fumadocs and cannot be + // resolved reliably without the private renderer's route manifest. + if (!path.extname(decoded) && !allowExtensionless) return true; + const target = path.resolve(path.dirname(fromFile), decoded); const targetRelative = path.relative(contentRoot, target); if (targetRelative.startsWith("..") || path.isAbsolute(targetRelative)) return false; @@ -37,8 +41,12 @@ function candidateExists(fromFile, rawTarget) { target, `${target}.md`, `${target}.mdx`, + `${target}.en.md`, + `${target}.en.mdx`, path.join(target, "index.md"), path.join(target, "index.mdx"), + path.join(target, "index.en.md"), + path.join(target, "index.en.mdx"), ].some(existsSync); } @@ -86,40 +94,10 @@ function validateLinks(file, source) { ) { continue; } - if (/\.mdx?(?:[?#].*)?$/i.test(target)) { - fail(file, `use an extensionless Fumadocs route for "${target}"`); - continue; - } if (!candidateExists(file, target)) fail(file, `missing local target "${target}"`); } } -function validateHeadingStructure(file, source) { - const searchable = source.replace(/```[\s\S]*?```/g, ""); - if (/^#\s+\S/m.test(searchable)) { - fail(file, "body content must start at heading level 2; frontmatter renders the page title"); - } -} - -function validateBomCategoryStyles(file, source) { - for (const match of source.matchAll(//g)) { - if (!/style=\{\{\s*backgroundColor:\s*"#[0-9a-f]{6}"/i.test(match[0])) { - fail(file, "BOM category chips must retain their generated inline colour"); - } - } - - if (/([\s\S]*?)<\/footer>/, - ); - if (footer?.[1].includes("