Initial: knowledge base

2026-08-05 17:25:09 +08:00
parent bfabe83832
commit 5700eb4115
35 changed files with 5140 additions and 11 deletions
@@ -0,0 +1,811 @@
+# Common Devices Reference
+
+> **类别：reference** | **主题：常用器件与模块速查** | **信源：** 多平台汇总
+
+Cross-platform device/module reference for Raspberry Pi and ESP32 GPIO configuration. Used to determine pin requirements, I2C addresses, voltage levels, and platform-specific wiring guidance.
+
+## Table of Contents
+
+- [Category 1: Sensors — Environmental](#category-1-sensors--environmental)
+  - [BME280](#bme280-temperaturehumiditypressure)
+  - [BMP280](#bmp280-temperaturepressure--no-humidity)
+  - [DHT22 / AM2302](#dht22--am2302-temperaturehumidity)
+  - [DS18B20](#ds18b20-temperature-1-wire)
+  - [SHT31](#sht31-temperaturehumidity)
+- [Category 2: Sensors — Motion/Position](#category-2-sensors--motionposition)
+  - [MPU6050](#mpu6050-6-axis-imu--accelerometer--gyroscope)
+  - [ADXL345](#adxl345-3-axis-accelerometer)
+  - [HMC5883L / QMC5883L](#hmc5883l--qmc5883l-magnetometercompass)
+  - [NEO-6M / NEO-7M / NEO-M8N](#neo-6m--neo-7m--neo-m8n-gps-module)
+- [Category 3: Sensors — Analog/Power](#category-3-sensors--analogpower)
+  - [ADS1115](#ads1115-16-bit-adc-4-channel)
+  - [INA219](#ina219-currentvoltagepower-monitor)
+- [Category 4: Displays](#category-4-displays)
+  - [SSD1306](#ssd1306-oled-display-128x64-or-128x32)
+  - [ST7789](#st7789-tft-color-display-typically-240x240-or-240x320)
+  - [HD44780](#hd44780-character-lcd-16x2-or-20x4-via-pcf8574-i2c-backpack)
+  - [e-Paper / e-Ink Display](#e-paper--e-ink-display-waveshare-style)
+- [Category 5: Communication](#category-5-communication)
+  - [nRF24L01](#nrf24l01-24ghz-radio-transceiver)
+  - [HC-05 / HC-06](#hc-05--hc-06-bluetooth-classic-serial)
+  - [SX1276 / RFM95W](#sx1276--rfm95w-lora-radio)
+  - [MCP2515](#mcp2515-can-bus-controller)
+  - [ENC28J60](#enc28j60-spi-ethernet-controller)
+- [Category 6: Motor Control](#category-6-motor-control)
+  - [PCA9685](#pca9685-16-channel-pwmservo-driver)
+  - [L298N](#l298n-dual-h-bridge-motor-driver)
+  - [DRV8825 / A4988](#drv8825--a4988-stepper-motor-driver)
+- [Category 7: Other](#category-7-other)
+  - [MCP23017](#mcp23017-16-channel-gpio-expander)
+  - [WS2812B / NeoPixels](#ws2812b--neopixels-addressable-rgb-leds)
+  - [Rotary Encoder](#rotary-encoder-incremental-with-push-button)
+  - [Relay Modules](#relay-modules-1248-channel)
+  - [MAX31855 / MAX6675](#max31855--max6675-thermocouple-interface)
+- [I2C Address Collision Map](#i2c-address-collision-map)
+
+---
+
+## Category 1: Sensors — Environmental
+
+### BME280 (Temperature/Humidity/Pressure)
+
+- Interface：I2C (default), SPI
+- Required Pins：I2C: SDA, SCL. SPI: MOSI, MISO, SCLK, CS
+- I2C Address：0x76 (SDO→GND), 0x77 (SDO→VDD)
+- Voltage：1.8–3.6V (most breakouts accept 3.3V or 5V input)
+- Pull-ups：Provided on most breakouts
+
+**RPi Notes:**
+- Use I2C1 (GPIO2 SDA, GPIO3 SCL)
+- Enable with `dtparam=i2c_arm=on`
+- SPI mode: SPI0 (GPIO10 MOSI, GPIO9 MISO, GPIO11 SCLK, GPIO8 CE0)
+
+**ESP32 Notes:**
+- Any GPIO pair for I2C via GPIO matrix
+- Default Wire library: GPIO21 SDA, GPIO22 SCL
+- SPI VSPI default: GPIO23 MOSI, GPIO19 MISO, GPIO18 SCLK, GPIO5 CS
+
+**Gotchas:**
+- ADDRESS COLLISION with BMP280 — both use 0x76/0x77
+- Cannot use BME280 + BMP280 on same I2C bus unless one is on alternate address
+- Use I2C multiplexer (TCA9548A) if both needed at same address
+
+---
+
+### BMP280 (Temperature/Pressure — no humidity)
+
+- Interface：I2C (default), SPI
+- Required Pins：I2C: SDA, SCL. SPI: MOSI, MISO, SCLK, CS
+- I2C Address：0x76 (SDO→GND), 0x77 (SDO→VDD)
+- Voltage：1.8–3.6V (most breakouts accept 3.3V or 5V input)
+- Pull-ups：Provided on most breakouts
+
+**RPi Notes:**
+- Use I2C1 (GPIO2 SDA, GPIO3 SCL)
+- Enable with `dtparam=i2c_arm=on`
+- SPI mode: SPI0 (GPIO10 MOSI, GPIO9 MISO, GPIO11 SCLK, GPIO8 CE0)
+
+**ESP32 Notes:**
+- Any GPIO pair for I2C via GPIO matrix
+- Default Wire library: GPIO21 SDA, GPIO22 SCL
+- SPI VSPI default: GPIO23 MOSI, GPIO19 MISO, GPIO18 SCLK, GPIO5 CS
+
+**Gotchas:**
+- ADDRESS COLLISION with BME280
+- Registers are mostly compatible but not identical — don't assume BME280 libraries work on BMP280
+- Cheap clone boards sometimes mislabel BMP280 as BME280
+
+---
+
+### DHT22 / AM2302 (Temperature/Humidity)
+
+- Interface：Single-wire proprietary protocol (NOT 1-Wire/Dallas)
+- Required Pins：DATA (1 GPIO)
+- I2C Address：N/A
+- Voltage：3.3V–5V (data pin is 3.3V logic compatible)
+- Pull-ups：4.7kΩ–10kΩ on data line (some breakouts include it)
+
+**RPi Notes:**
+- Use any available GPIO
+- No overlay needed
+- Timing-sensitive — occasional read failures are normal; retry in software
+- Minimum 2-second sampling interval (do not exceed 0.5 Hz)
+
+**ESP32 Notes:**
+- Use any GPIO
+- Avoid strapping pins (GPIO0, 2, 5, 12, 15)
+- Avoid input-only pins (GPIO34-39) — data pin is bidirectional
+
+**Gotchas:**
+- THIS IS NOT 1-Wire PROTOCOL — do not use w1-gpio overlay
+- Do not confuse with DS18B20
+- Requires specific library (e.g., Adafruit DHT library)
+- DHT11 is the cheaper/less accurate variant — same protocol
+
+---
+
+### DS18B20 (Temperature, 1-Wire)
+
+- Interface：1-Wire (Dallas protocol)
+- Required Pins：DQ (data, 1 GPIO)
+- I2C Address：N/A
+- Voltage：3.0–5.5V (supports parasitic power: data + GND only)
+- Pull-ups：4.7kΩ required on data line
+
+**RPi Notes:**
+- Default: GPIO4 with `dtoverlay=w1-gpio`
+- Custom pin: `dtoverlay=w1-gpio,gpiopin=N`
+- Parasitic power: `dtoverlay=w1-gpio-pullup,gpiopin=N`
+- Multiple sensors can share one data pin (each has unique 64-bit address)
+
+**ESP32 Notes:**
+- Any GPIO via OneWire library
+- Avoid strapping pins
+- Avoid input-only pins (GPIO34-39)
+
+**Gotchas:**
+- Multiple sensors on one bus is a key feature — each has factory-programmed unique ID
+- Parasitic power mode can cause issues with cable runs >3m
+- Counterfeit DS18B20s are common — may have worse accuracy or fail parasitic power
+
+---
+
+### SHT31 (Temperature/Humidity)
+
+- Interface：I2C
+- Required Pins：SDA, SCL. Optional: ALERT (interrupt), RST (active-low reset)
+- I2C Address：0x44 (ADDR→GND), 0x45 (ADDR→VDD)
+- Voltage：2.4–5.5V (most breakouts have regulator)
+- Pull-ups：Provided on most breakouts
+
+**RPi Notes:**
+- Use I2C1 (GPIO2 SDA, GPIO3 SCL)
+- Enable with `dtparam=i2c_arm=on`
+
+**ESP32 Notes:**
+- Any GPIO pair for I2C via GPIO matrix
+
+**Gotchas:**
+- ADDRESS COLLISION — INA219 also uses 0x44/0x45
+- Has built-in heater element for self-diagnostics (enable via register)
+- Higher accuracy than DHT22
+
+---
+
+## Category 2: Sensors — Motion/Position
+
+### MPU6050 (6-Axis IMU — Accelerometer + Gyroscope)
+
+- Interface：I2C
+- Required Pins：SDA, SCL. Optional: INT (interrupt — recommended for DMP)
+- I2C Address：0x68 (AD0→GND), 0x69 (AD0→VDD)
+- Voltage：3.3V (VDD). Most breakouts accept 3.3V–5V input
+- Pull-ups：Provided on most breakouts
+
+**RPi Notes:**
+- Use I2C1 (GPIO2/3)
+- Connect INT to any GPIO if using interrupt-driven reads
+- No specific overlay needed beyond `dtparam=i2c_arm=on`
+
+**ESP32 Notes:**
+- Any GPIO pair for I2C
+- Connect INT to any input-capable GPIO
+- Input-only pins (GPIO34-39) are fine for INT output
+
+**Gotchas:**
+- ADDRESS COLLISION — 0x68 collides with DS3231 RTC
+- If using both, put one on alternate address or use I2C multiplexer
+- Has built-in DMP (Digital Motion Processor) — use INT pin for DMP-ready interrupts
+- MPU9250 is the 9-axis successor (adds magnetometer) — same I2C address scheme
+
+---
+
+### ADXL345 (3-Axis Accelerometer)
+
+- Interface：I2C, SPI
+- Required Pins：I2C: SDA, SCL. SPI: MOSI, MISO, SCLK, CS. Optional: INT1, INT2
+- I2C Address：0x53 (ALT ADDRESS/SDO→GND), 0x1D (ALT ADDRESS/SDO→VDD)
+- Voltage：2.0–3.6V (most breakouts accept 3.3V–5V)
+- Pull-ups：Provided on most breakouts
+
+**RPi Notes:**
+- I2C1 (GPIO2/3) or SPI0 (GPIO7-11)
+- Interrupt pins to any available GPIO
+
+**ESP32 Notes:**
+- Any GPIO pair for I2C, any pins for SPI via GPIO matrix
+- Avoid flash pins (GPIO6-11) for SPI
+
+**Gotchas:**
+- Default I2C address 0x53 is uncommon in collisions
+- SPI mode is activated by pulling CS low — if CS is floating, chip may not respond on I2C
+- Has configurable tap detection, freefall detection, and activity/inactivity interrupts
+
+---
+
+### HMC5883L / QMC5883L (Magnetometer/Compass)
+
+- Interface：I2C
+- Required Pins：SDA, SCL. Optional: DRDY (data ready interrupt)
+- I2C Address：HMC5883L: 0x1E (fixed). QMC5883L: 0x0D (fixed)
+- Voltage：2.16–3.6V (most breakouts accept 3.3V–5V)
+- Pull-ups：Provided on most breakouts
+
+**RPi Notes:**
+- I2C1 (GPIO2/3)
+- No special overlay
+
+**ESP32 Notes:**
+- Any GPIO pair for I2C
+
+**Gotchas:**
+- HMC5883L and QMC5883L have DIFFERENT I2C addresses and DIFFERENT register maps
+- They are NOT interchangeable in software
+- Many cheap "HMC5883L" boards actually contain QMC5883L chips — check chip marking
+- GY-271 boards may have either chip
+- Libraries must match the actual chip
+
+---
+
+### NEO-6M / NEO-7M / NEO-M8N (GPS Module)
+
+- Interface：UART (primary), I2C (some models), SPI (some models)
+- Required Pins：UART: TX, RX. Optional: PPS (pulse-per-second for precision timing)
+- I2C Address：0x42 (when I2C interface is used, some modules only)
+- Voltage：2.7–3.6V (most breakouts accept 3.3V–5V)
+- Pull-ups：N/A for UART
+
+**RPi Notes:**
+- UART0/PL011 on GPIO14 (TX) / GPIO15 (RX)
+- On Pi 3/4/Zero2W, Bluetooth uses PL011 — add `dtoverlay=disable-bt` or `dtoverlay=miniuart-bt`
+- On Pi 5, no BT conflict
+- For PPS: `dtoverlay=pps-gpio,gpiopin=N`
+- RPi TX → GPS RX, RPi RX → GPS TX (crossover)
+
+**ESP32 Notes:**
+- Use UART1 or UART2 on any GPIO pair via GPIO matrix
+- UART0 is typically USB-serial debug — avoid reassigning
+- PPS to any input-capable GPIO
+
+**Gotchas:**
+- Cold start can take 1-5 minutes to get a fix
+- Needs clear sky view for antenna
+- NMEA output at 9600 baud by default
+- PPS signal is critical for NTP servers or precision timing applications
+
+---
+
+## Category 3: Sensors — Analog/Power
+
+### ADS1115 (16-bit ADC, 4-channel)
+
+- Interface：I2C
+- Required Pins：SDA, SCL. Optional: ALERT/RDY (interrupt/data-ready)
+- I2C Address：0x48 (ADDR→GND), 0x49 (ADDR→VDD), 0x4A (ADDR→SDA), 0x4B (ADDR→SCL)
+- Voltage：2.0–5.5V
+- Pull-ups：Provided on most breakouts
+
+**RPi Notes:**
+- I2C1 (GPIO2/3)
+- Essential for RPi projects needing analog inputs — RPi has no built-in ADC
+- Enable with `dtparam=i2c_arm=on`
+
+**ESP32 Notes:**
+- Any GPIO pair for I2C
+- Less commonly needed since ESP32 has built-in 12-bit ADC
+- Useful for higher resolution (16-bit) or to avoid ADC2/WiFi conflicts
+
+**Gotchas:**
+- 0x48 address collides with TMP102 temperature sensor
+- Can run 4 devices on one I2C bus (4 addresses) for up to 16 analog channels
+- Programmable gain amplifier (PGA) allows measuring small voltages
+- Max sample rate is 860 SPS
+- ADS1015 is the cheaper 12-bit variant with same pinout and addresses
+
+---
+
+### INA219 (Current/Voltage/Power Monitor)
+
+- Interface：I2C
+- Required Pins：SDA, SCL. Also: VIN+, VIN- (power sense pins, not GPIO)
+- I2C Address：0x40 (A0=GND,A1=GND), 0x41, 0x44, 0x45 (via A0/A1 pins)
+- Voltage：3.0–5.5V (bus voltage measurement up to 26V)
+- Pull-ups：Provided on most breakouts
+
+**RPi Notes:**
+- I2C1 (GPIO2/3)
+
+**ESP32 Notes:**
+- Any GPIO pair for I2C
+
+**Gotchas:**
+- ADDRESS COLLISION — 0x40 collides with PCA9685 servo driver
+- 0x44/0x45 collide with SHT31
+- If using INA219 + PCA9685, must configure different addresses via A0/A1 pins
+- Shunt resistor value (typically 0.1Ω) determines current measurement range — must match library calibration
+
+---
+
+## Category 4: Displays
+
+### SSD1306 (OLED Display, 128×64 or 128×32)
+
+- Interface：I2C (most common), SPI
+- Required Pins：I2C: SDA, SCL. SPI: MOSI, SCLK, CS, DC, RST (optional)
+- I2C Address：0x3C (common), 0x3D (alternate, set by resistor)
+- Voltage：3.3V–5V (most modules have regulator)
+- Pull-ups：Provided on most breakouts
+
+**RPi Notes:**
+- I2C1 (GPIO2/3) for I2C mode
+- SPI0 for SPI mode
+- I2C mode fine for single display, SPI faster for animations
+
+**ESP32 Notes:**
+- Any GPIO pair for I2C, any pins for SPI
+- SPI recommended for high refresh rate
+
+**Gotchas:**
+- 0x3C address collides with SH1106 OLED (similar but different driver)
+- 128×32 variant usually has fixed 0x3C address
+- Some boards labeled "SSD1306" actually use SH1106 — different memory layout (132×64 with offset)
+
+---
+
+### ST7789 (TFT Color Display, typically 240×240 or 240×320)
+
+- Interface：SPI only
+- Required Pins：MOSI, SCLK, CS, DC, RST, BL (backlight)
+- I2C Address：N/A
+- Voltage：3.3V logic. Most modules accept 3.3V–5V power
+- Pull-ups：N/A
+
+**RPi Notes:**
+- SPI0 (GPIO10 MOSI, GPIO11 SCLK, GPIO8 CE0)
+- DC on any GPIO (commonly GPIO25)
+- RST on any GPIO (commonly GPIO27)
+- BL on PWM-capable GPIO (GPIO12 or GPIO18) for brightness control, or tie to 3.3V
+
+**ESP32 Notes:**
+- VSPI or any pins via GPIO matrix
+- SPI clock can run up to 80MHz — good for smooth display updates
+
+**Gotchas:**
+- SPI-only, no I2C option
+- ST7735 is the smaller cousin (128×160) — different driver, similar interface
+- Some displays omit CS pin (tied to GND) — prevents sharing SPI bus
+- BL pin may be active-high or active-low depending on module
+
+---
+
+### HD44780 (Character LCD, 16×2 or 20×4, via PCF8574 I2C Backpack)
+
+- Interface：Parallel GPIO (6+ pins), I2C via PCF8574 backpack (recommended)
+- Required Pins：I2C: SDA, SCL. Direct: RS, EN, D4-D7 (4-bit = 6 GPIOs)
+- I2C Address：0x27 (most common), 0x3F (some variants). PCF8574A: 0x38–0x3F
+- Voltage：5V for LCD. I2C backpack tolerates 3.3V I2C signals
+- Pull-ups：Provided on PCF8574 backpack
+
+**RPi Notes:**
+- Use I2C backpack to save GPIOs
+- I2C1 (GPIO2/3)
+- RPi's 3.3V I2C usually works with 5V PCF8574 but is out of spec — consider level shifter
+
+**ESP32 Notes:**
+- I2C backpack strongly recommended
+- ESP32 is 3.3V only — needs level shifter for direct 5V LCD parallel interface
+
+**Gotchas:**
+- PCF8574 address 0x27 collides with MCP23017 (0x20-0x27)
+- Contrast potentiometer must be adjusted or display appears blank — #1 troubleshooting issue
+- Backlight can be controlled via PCF8574 register bit
+
+---
+
+### e-Paper / e-Ink Display (Waveshare-style)
+
+- Interface：SPI
+- Required Pins：MOSI, SCLK, CS, DC, RST, BUSY (output from display)
+- I2C Address：N/A
+- Voltage：3.3V logic and power
+- Pull-ups：N/A
+
+**RPi Notes:**
+- SPI0 (GPIO10 MOSI, GPIO11 SCLK, GPIO8 CE0)
+- DC, RST, BUSY on any available GPIOs
+- Waveshare HAT uses: RST=GPIO17, DC=GPIO25, CS=GPIO8, BUSY=GPIO24
+
+**ESP32 Notes:**
+- Any SPI pins via GPIO matrix
+- BUSY must be on input-capable GPIO
+- Input-only pins (GPIO34-39) are fine for BUSY
+
+**Gotchas:**
+- Refresh time is slow (1-15 seconds for full refresh)
+- Partial refresh is faster but causes ghosting over time
+- Do NOT refresh continuously — damages the panel
+- Different Waveshare models (1.54", 2.13", 2.7", 4.2", 7.5") use different drivers — NOT interchangeable in software
+
+---
+
+## Category 5: Communication
+
+### nRF24L01 (2.4GHz Radio Transceiver)
+
+- Interface：SPI, GPIO
+- Required Pins：MOSI, MISO, SCLK, CSN (chip select), CE (chip enable). Optional: IRQ
+- I2C Address：N/A
+- Voltage：3.3V ONLY for VCC. SPI data pins are 5V tolerant
+- Pull-ups：N/A
+
+**RPi Notes:**
+- SPI0 (GPIO10 MOSI, GPIO9 MISO, GPIO11 SCLK, GPIO8 CE0 for CSN)
+- CE on any GPIO (commonly GPIO17 or GPIO22)
+- IRQ on any GPIO
+- Add 10µF + 100nF capacitor across VCC/GND close to module — extremely sensitive to power supply noise
+
+**ESP32 Notes:**
+- VSPI or any SPI pins via GPIO matrix
+- CE on any output GPIO
+- Avoid strapping pins for CE
+- Power supply decoupling equally important
+
+**Gotchas:**
+- PA+LNA variant draws up to 115mA — cannot be powered from typical breadboard 3.3V regulator
+- Use dedicated 3.3V supply
+- Range: basic module ~100m line of sight, PA+LNA ~1km+
+- CSN is NOT the same as CE — CSN is SPI chip select, CE is nRF24-specific enable pin
+
+---
+
+### HC-05 / HC-06 (Bluetooth Classic Serial)
+
+- Interface：UART
+- Required Pins：TX, RX. Optional: STATE/STATUS, EN/KEY (AT mode on HC-05)
+- I2C Address：N/A
+- Voltage：3.3V logic (module VCC 3.6–6V). Use voltage divider for 5V TX
+- Pull-ups：N/A
+
+**RPi Notes:**
+- GPIO14 (TX) / GPIO15 (RX)
+- On Pi 3/4/Zero2W, use `dtoverlay=disable-bt` or `dtoverlay=miniuart-bt`
+- Pi 5 has no conflict
+- RPi TX → HC-05/06 RX, RPi RX → HC-05/06 TX (crossover)
+
+**ESP32 Notes:**
+- UART1 or UART2 on any GPIO pair
+- Less commonly used since ESP32 has built-in Bluetooth
+- Useful for bridging to Bluetooth Classic devices
+
+**Gotchas:**
+- HC-05 is master/slave capable, HC-06 is slave only
+- Default baud rate: 9600 (HC-06), 38400 (HC-05 AT mode)
+- HC-05 enters AT mode by holding EN/KEY HIGH during power-up
+- Bluetooth Classic (not BLE) — not compatible with iOS without MFi
+
+---
+
+### SX1276 / RFM95W (LoRa Radio)
+
+- Interface：SPI, GPIO
+- Required Pins：MOSI, MISO, SCLK, NSS/CS, RST, DIO0 (interrupt). Optional: DIO1-DIO5
+- I2C Address：N/A
+- Voltage：3.3V
+- Pull-ups：N/A
+
+**RPi Notes:**
+- SPI0 (GPIO10 MOSI, GPIO9 MISO, GPIO11 SCLK, GPIO8 CE0)
+- RST on any GPIO
+- DIO0 on any GPIO (commonly GPIO25)
+- NSS can use GPIO8 (CE0) or any GPIO as software CS
+
+**ESP32 Notes:**
+- Any SPI pins via GPIO matrix
+- DIO0 to any input-capable GPIO
+- Input-only pins (GPIO34-39) are fine for DIO0
+
+**Gotchas:**
+- LoRa operates in ISM bands (433/868/915 MHz) — use correct frequency for your country
+- Antenna MUST be connected before transmitting or module can be damaged
+- RFM95W is the HopeRF clone of SX1276 — pin-compatible and functionally identical
+
+---
+
+### MCP2515 (CAN Bus Controller)
+
+- Interface：SPI, GPIO
+- Required Pins：MOSI, MISO, SCLK, CS, INT. Needs external CAN transceiver (TJA1050/MCP2551)
+- I2C Address：N/A
+- Voltage：2.7–5.5V. Most modules include transceiver and run at 5V
+- Pull-ups：N/A
+
+**RPi Notes:**
+- SPI0 with `dtoverlay=mcp2515-can0,oscillator=8000000,interrupt=25`
+- Adjust oscillator to match board crystal (8MHz or 16MHz)
+- INT on GPIO (commonly GPIO25)
+- Adds can0 network interface
+- Second bus: `dtoverlay=mcp2515-can1,oscillator=8000000,interrupt=24` on SPI0 CE1
+
+**ESP32 Notes:**
+- Any SPI pins
+- INT to any input-capable GPIO
+- ESP32 has built-in CAN (TWAI) — MCP2515 useful for second CAN bus
+- Still needs external transceiver
+
+**Gotchas:**
+- Oscillator frequency in overlay MUST match physical crystal — check markings (8MHz or 16MHz common)
+- Wrong oscillator value = CAN bus won't work
+- CAN bus requires 120Ω termination resistors at both ends
+- Some modules include termination resistor — check before adding another
+
+---
+
+### ENC28J60 (SPI Ethernet Controller)
+
+- Interface：SPI, GPIO
+- Required Pins：MOSI, MISO, SCLK, CS, INT. Optional: RST (can tie to VCC)
+- I2C Address：N/A
+- Voltage：3.3V
+- Pull-ups：N/A
+
+**RPi Notes:**
+- SPI0 with `dtoverlay=enc28j60,int_pin=25,speed=12000000`
+- INT on GPIO (commonly GPIO25)
+- Adds eth1 network interface
+- Max speed is 10 Mbps (10Base-T only)
+
+**ESP32 Notes:**
+- Any SPI pins via GPIO matrix
+- Less commonly used since many ESP32 boards have built-in WiFi
+- Useful for wired-only industrial applications
+
+**Gotchas:**
+- 10 Mbps only — no 100 Mbps or gigabit
+- Uses significant CPU time due to SPI polling
+- Not suitable for high-bandwidth applications
+- MAC address usually set in software
+- Consider W5500 (100 Mbps, hardware TCP/IP stack) as modern alternative
+
+---
+
+## Category 6: Motor Control
+
+### PCA9685 (16-Channel PWM/Servo Driver)
+
+- Interface：I2C
+- Required Pins：SDA, SCL. Optional: OE (output enable, active low)
+- I2C Address：0x40 (default). Configurable 0x40–0x7F via A0–A5 pins (62 addresses)
+- Voltage：VCC 3.3V–5V for logic. Separate V+ for servos (up to 6V)
+- Pull-ups：Provided on most breakouts
+
+**RPi Notes:**
+- I2C1 (GPIO2/3)
+- No special overlay needed
+- 12-bit resolution, 24Hz–1526Hz adjustable frequency
+- OE pin to any GPIO if needed
+
+**ESP32 Notes:**
+- Any GPIO pair for I2C
+- Useful for adding PWM channels or servo control
+
+**Gotchas:**
+- ADDRESS COLLISION — default 0x40 collides with INA219
+- Must change address via A0-A5 pins if both on same bus
+- PCA9685 is a PWM driver, NOT a motor driver — generates PWM signals but cannot drive motors directly
+- Connect outputs to motor drivers (L298N, DRV8825) or directly to servos
+- All 16 channels share same PWM frequency
+
+---
+
+### L298N (Dual H-Bridge Motor Driver)
+
+- Interface：GPIO (digital + PWM)
+- Required Pins：Per motor: IN1, IN2 (direction), ENA (PWM speed). 2 motors: 6 GPIOs total
+- I2C Address：N/A
+- Voltage：Motor: 5–35V. Logic: 5V (on-board regulator if motor >7V). 3.3V tolerant
+- Pull-ups：N/A
+
+**RPi Notes:**
+- IN1-IN4 on any GPIO
+- ENA/ENB on PWM-capable GPIO (GPIO12, GPIO13, GPIO18, GPIO19)
+- Use `dtoverlay=pwm` or `dtoverlay=pwm-2chan` for smooth control
+- Software PWM may cause audible motor whine
+
+**ESP32 Notes:**
+- IN1-IN4 on any output GPIO
+- ENA/ENB on any GPIO (all support LEDC PWM)
+- Avoid strapping pins
+
+**Gotchas:**
+- L298N has ~2V voltage drop across H-bridge — motor sees ~2V less than supply
+- Not efficient for battery-powered projects
+- 5V regulator on board can supply ~500mA for logic
+- TB6612FNG is a more efficient alternative (MOSFET-based, ~0.5V drop)
+
+---
+
+### DRV8825 / A4988 (Stepper Motor Driver)
+
+- Interface：GPIO (digital)
+- Required Pins：STEP, DIR, ENABLE (active low, optional). MS1-MS3 (microstepping)
+- I2C Address：N/A
+- Voltage：DRV8825: 8.2–45V motor, 3.3V logic. A4988: 8–35V motor, 3.3V/5V logic
+- Pull-ups：ENABLE has internal pull-down. STEP/DIR do not need pull-ups
+
+**RPi Notes:**
+- STEP on any GPIO (consider hardware PWM on GPIO12/13/18/19 for constant speed)
+- DIR on any GPIO
+- ENABLE on any GPIO
+
+**ESP32 Notes:**
+- STEP on any output GPIO
+- Use LEDC PWM or RMT peripheral for consistent step timing
+- Avoid strapping pins
+
+**Gotchas:**
+- DRV8825: up to 1/32 microstepping. A4988: up to 1/16
+- Current limit must be set via potentiometer BEFORE connecting motor
+- NEVER disconnect motor while driver is powered — back-EMF can destroy driver
+- A4988 and DRV8825 have same pinout but different microstepping truth tables
+
+---
+
+## Category 7: Other
+
+### MCP23017 (16-Channel GPIO Expander)
+
+- Interface：I2C
+- Required Pins：SDA, SCL. Optional: INTA, INTB (interrupts), RST (active-low reset)
+- I2C Address：0x20–0x27 (A0, A1, A2 = 8 configurable addresses)
+- Voltage：1.8–5.5V
+- Pull-ups：Provided on most breakouts. GPIO pins have optional internal pull-ups
+
+**RPi Notes:**
+- I2C1 (GPIO2/3)
+- Connect INTA/INTB to RPi GPIOs for interrupt-driven input
+- Up to 8 expanders = 128 additional GPIOs
+
+**ESP32 Notes:**
+- Any GPIO pair for I2C
+- Less commonly needed since ESP32 has many GPIOs
+- Useful for projects needing many inputs with interrupt support
+
+**Gotchas:**
+- Address range 0x20–0x27 collides with PCF8574 (HD44780 I2C backpacks)
+- If using both, ensure non-overlapping addresses
+- Each output pin can source/sink 25mA (total per port: 125mA)
+- PCF8574 is the 8-channel version with same address range
+
+---
+
+### WS2812B / NeoPixels (Addressable RGB LEDs)
+
+- Interface：Single GPIO (proprietary protocol — NOT Dallas 1-Wire)
+- Required Pins：DIN (1 GPIO). Chain DOUT→DIN between LEDs
+- I2C Address：N/A
+- Voltage：5V power. Data expects 5V logic (min 3.5V for logic high)
+- Pull-ups：N/A. Add 300–500Ω resistor on data line. Add 1000µF capacitor at power
+
+**RPi Notes:**
+- USE GPIO18 (PWM0/PCM) or GPIO10 (SPI0 MOSI) or GPIO21 (PCM)
+- rpi_ws281x library requires specific GPIOs (DMA-based timing)
+- GPIO18 most common. GPIO10 requires `dtparam=spi=on`
+- Needs sudo or specific permissions for DMA access
+- RPi outputs 3.3V — use level shifter (3.3V→5V) for reliable operation
+
+**ESP32 Notes:**
+- Any output GPIO via RMT peripheral
+- ESP32 outputs 3.3V — same level shifting recommendation
+- RMT peripheral handles timing precisely without CPU intervention
+
+**Gotchas:**
+- LEVEL SHIFTER WARNING — 3.3V logic is below WS2812B spec (needs >3.5V)
+- Works unreliably at short distances, fails with longer data lines
+- Use 74AHCT125, 74HCT245, or SN74LV1T34 level shifter
+- Each LED draws up to 60mA at full white — 60 LEDs = 3.6A
+- Inject power every 30-50 LEDs for long strips
+- SK6812 is compatible alternative with RGBW support
+
+---
+
+### Rotary Encoder (Incremental, with push button)
+
+- Interface：GPIO (digital inputs)
+- Required Pins：CLK/A, DT/B (encoder phases), SW (push button, active low)
+- I2C Address：N/A
+- Voltage：3.3V–5V (module dependent)
+- Pull-ups：Most modules have 10kΩ on board. Bare encoder needs pull-ups
+
+**RPi Notes:**
+- Use any 3 GPIOs with interrupt support (all RPi GPIOs support edge-triggered interrupts)
+- Enable internal pull-ups via gpiod or RPi.GPIO if bare encoder
+
+**ESP32 Notes:**
+- Any 3 input-capable GPIOs
+- Hardware interrupt on all GPIOs
+- Input-only pins (GPIO34-39) work fine
+- Avoid strapping pins
+
+**Gotchas:**
+- Mechanical encoders generate switch bounce — need debouncing
+- Hardware: 100nF capacitor across each pin to GND
+- Software: 1-5ms delay
+- Optical encoders don't bounce
+- Reading must use interrupt or high-frequency polling — slow polling misses steps
+- KY-040 is the most common breakout module
+
+---
+
+### Relay Modules (1/2/4/8 channel)
+
+- Interface：GPIO (digital output)
+- Required Pins：IN1 (one GPIO per channel). Multi-channel: IN1, IN2, IN3, IN4, etc.
+- I2C Address：N/A
+- Voltage：Module VCC typically 5V. Most blue relay modules are ACTIVE LOW
+- Pull-ups：N/A
+
+**RPi Notes:**
+- Any GPIO
+- Check if module is active-low or active-high
+- Most cheap modules are active-low — relay activates when GPIO goes LOW
+- At boot, GPIOs are floating — may cause relay chatter
+- Use pull-up resistor to keep relay OFF during boot
+
+**ESP32 Notes:**
+- Any output GPIO
+- Same active-low/high consideration
+- Avoid strapping pins (GPIO0, 2, 5, 12, 15) — boot states could trigger relays
+- Avoid GPIO34-39 (input only)
+
+**Gotchas:**
+- Most modules have opto-isolated inputs
+- Remove VCC-JD jumper for true isolation
+- Relay coils cause voltage spikes — modules should have flyback diodes (most do)
+- Never switch mains voltage without proper safety knowledge
+- For DC loads, consider MOSFETs instead
+
+---
+
+### MAX31855 / MAX6675 (Thermocouple Interface)
+
+- Interface：SPI (read-only — no MOSI needed)
+- Required Pins：MISO/SO, SCLK/SCK, CS. No MOSI needed
+- I2C Address：N/A
+- Voltage：MAX31855: 3.0–3.6V. MAX6675: 5V. Most breakouts accept both
+- Pull-ups：N/A
+
+**RPi Notes:**
+- SPI0 (GPIO9 MISO, GPIO11 SCLK, GPIO8 CE0)
+- MOSI (GPIO10) unused but SPI0 still claims it
+
+**ESP32 Notes:**
+- Any SPI pins via GPIO matrix
+- MOSI unused — can reassign to other functions
+
+**Gotchas:**
+- MAX31855 supports K, J, N, S, R, T type thermocouples — different variants for each
+- MAX6675 supports K-type only and is older/less accurate
+- Thermocouple wires are polarity-sensitive — red is always negative
+- Cold-junction compensation is built in
+- Keep chip close to terminal block to minimize cold-junction error
+- MAX31855 has open/short fault detection
+
+---
+
+## I2C Address Collision Map
+
+- 0x76：Devices=BME280, BMP280, MS5611, Resolution=Use alternate 0x77 for one device, or I2C multiplexer
+- 0x77：Devices=BME280 (alt), BMP280 (alt), Resolution=Only one per bus at this address
+- 0x40：Devices=INA219, PCA9685, HDC1080, Resolution=Change address via A0/A1 pins
+- 0x44：Devices=SHT31, INA219 (A1=VDD,A0=GND), Resolution=Change INA219 address via A0/A1
+- 0x45：Devices=SHT31 (alt), INA219 (alt), Resolution=Change INA219 address via A0/A1
+- 0x3C：Devices=SSD1306, SH1106, Resolution=Different drivers, unlikely to use both
+- 0x3D：Devices=SSD1306 (alt), Resolution=Rare collision
+- 0x68：Devices=MPU6050, DS3231 RTC, Resolution=Set MPU6050 to 0x69 (AD0→VDD)
+- 0x69：Devices=MPU6050 (alt), Resolution=Rare collision
+- 0x48–0x4B：Devices=ADS1115 (configurable), TMP102, Resolution=Configure ADS1115 to non-conflicting address
+- 0x20–0x27：Devices=MCP23017 (A0-A2), PCF8574, HD44780 backpack, Resolution=Configure A0-A2 to avoid overlap
+- 0x27：Devices=PCF8574 (HD44780 backpack), MCP23017 (A0-A2 all high), Resolution=Change MCP23017 address
+- 0x42：Devices=NEO-GPS (I2C mode), Resolution=Uncommon, rarely conflicts
+
+When address conflicts cannot be resolved via address pins, use a TCA9548A I2C multiplexer. Each TCA9548A has 8 channels and its own configurable address (0x70-0x77), supporting up to 64 separate I2C buses from a single host bus.