docs: add comprehensive hardware wiring guide (#4)#7
Open
addidea wants to merge 1 commit intoClawland-AI:mainfrom
Open
docs: add comprehensive hardware wiring guide (#4)#7addidea wants to merge 1 commit intoClawland-AI:mainfrom
addidea wants to merge 1 commit intoClawland-AI:mainfrom
Conversation
Closes Clawland-AI#4 Complete wiring diagrams and pin reference for common sensors: **Pin Reference Table**: - ESP32 GPIO functions and safe pins - I2C, SPI, UART defaults - Strapping pins to avoid **Sensor Wiring Diagrams** (ASCII art + tables): 1. **DHT22** - Temperature/humidity with 10kΩ pullup 2. **DS18B20** - Waterproof 1-Wire with 4.7kΩ pullup 3. **PIR HC-SR501** - Motion sensor with sensitivity adjustment 4. **Relay Module** - High-voltage device control with safety warnings **Each Sensor Includes**: - Pin connection diagram (ASCII art) - Pullup resistor requirements - Code example with Arduino library - Parts list with prices - Common issues & fixes **Power Supply Guidelines**: - USB power budget calculation - External power for relays/motors - Battery operation with deep sleep **Safety Section**: - AC mains handling warnings - Wire gauge recommendations - Insulation requirements Production-ready guide for hardware makers! ⚡
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Complete hardware wiring guide with diagrams, code examples, and troubleshooting for common sensors.
Closes #4
What's Included
✅ Pin Reference Table
✅ 4 Sensor Wiring Diagrams (ASCII art)
✅ For Each Sensor:
✅ Power Supply Guidelines:
✅ Safety Section:
Key Features
Example Diagrams
Next Steps
Ready to build! ⚡
Note
Low Risk
Adds a new documentation file only; no runtime code or build changes, so risk is limited to potential accuracy of wiring guidance.
Overview
Adds a new
HARDWARE.mdhardware wiring guide for ESP32-based MicroClaw builds, including a GPIO/pin reference plus wiring diagrams forDHT22,DS18B20,HC-SR501 PIR, and a single-channel relay.Includes copy-paste Arduino code snippets, parts lists, power-supply sizing guidance, common troubleshooting tips, and explicit AC-mains safety warnings for relay use.
Written by Cursor Bugbot for commit 1f9df7b. This will update automatically on new commits. Configure here.