update gps sync guide

This commit is contained in:
Bob 2025-12-06 10:47:23 -08:00
parent 4e712bc436
commit 623c7ddd2f
1 changed files with 145 additions and 139 deletions

View File

@ -271,12 +271,22 @@
<h2>Required Hardware</h2> <h2>Required Hardware</h2>
<ul class="component-list"> <ul class="component-list">
<li><strong>ESP32-C5-DevKitC-1-N8R4</strong> - Development board with WiFi 6/6E, 4MB PSRAM, dual USB-C ports</li> <li><strong>ESP32-C5-DevKitC-1-N8R4</strong> - Development board with WiFi 6/6E, 4MB PSRAM, dual USB-C ports</li>
<li><strong>MakerFocus GT-U7 GPS Module</strong> - With PPS output and IPEX active antenna <li><strong>MakerFocus GT-U7 GPS Module</strong> - With PPS output and IPEX connector
<ul style="margin: 10px 0 0 20px;"> <ul style="margin: 10px 0 0 20px;">
<li>Operating Voltage: 3.6V - 5V (works perfectly with ESP32's 3.3V)</li> <li>Operating Voltage: 3.6V - 5V (works perfectly with ESP32's 3.3V)</li>
<li>Baud Rate: 9600</li> <li>Baud Rate: 9600</li>
<li>Compatible with NEO-6M (same NMEA format)</li> <li>Compatible with NEO-6M (same NMEA format)</li>
<li>Includes: EEPROM, USB interface, IPEX antenna</li> <li>Includes: EEPROM, USB interface</li>
</ul>
</li>
<li><strong>GPS Active Antenna - Waterproof with Magnetic Base</strong>
<ul style="margin: 10px 0 0 20px;">
<li>28dB Gain Active Antenna</li>
<li>3-5VDC powered (perfect for GT-U7)</li>
<li>SMA connector</li>
<li>Magnetic base for easy mounting</li>
<li>Waterproof for outdoor/vehicle use</li>
<li><strong>Note:</strong> GT-U7 has IPEX connector - you'll need an IPEX to SMA adapter cable (often included with antenna)</li>
</ul> </ul>
</li> </li>
<li><strong>Female-to-Female Dupont Wires</strong> - 4-5 wires minimum <li><strong>Female-to-Female Dupont Wires</strong> - 4-5 wires minimum
@ -300,17 +310,26 @@
<strong>✓ GT-U7 & ESP32-C5 Compatibility:</strong><br> <strong>✓ GT-U7 & ESP32-C5 Compatibility:</strong><br>
The MakerFocus GT-U7 operates at 3.6V-5V and is fully compatible with the ESP32-C5's 3.3V power output. You can safely connect GT-U7's VCC directly to the ESP32's 3V3 pin (J1 Pin 1). The GT-U7's logic levels are also 3.3V/5V tolerant, making it a perfect match. The MakerFocus GT-U7 operates at 3.6V-5V and is fully compatible with the ESP32-C5's 3.3V power output. You can safely connect GT-U7's VCC directly to the ESP32's 3V3 pin (J1 Pin 1). The GT-U7's logic levels are also 3.3V/5V tolerant, making it a perfect match.
</div> </div>
<div class="warning-box">
<strong>⚠️ Antenna Connection:</strong><br>
The GT-U7 GPS module has an <strong>IPEX connector</strong>, while your active antenna has an <strong>SMA connector</strong>. You'll need an <strong>IPEX to SMA adapter cable</strong> (also called U.FL to SMA). These are inexpensive (~$5-10) and usually included with external GPS antennas. The adapter allows you to connect the SMA antenna to the GT-U7's IPEX port.
</div>
</div> </div>
<div class="section"> <div class="section">
<h2>Pin Connections</h2> <h2>Pin Connections</h2>
<h3>ESP32-C5 Pinout</h3> <h3>ESP32-C5 Official Pinout Diagram</h3>
<div class="info-box">
<strong>📌 Refer to this official diagram</strong> from Espressif to locate the exact pins on your board.
</div>
<div class="pinout-diagram"> <div class="pinout-diagram">
<img src="https://docs.espressif.com/projects/esp-dev-kits/en/latest/_images/esp32-c5-devkitc-1-pin-layout_v1.2.png" <img src="https://docs.espressif.com/projects/esp-dev-kits/en/latest/_images/esp32-c5-devkitc-1-pin-layout_v1.2.png"
alt="ESP32-C5 Pinout Diagram"> alt="ESP32-C5 Pinout Diagram"
<p style="margin-top: 10px; font-size: 0.9em; color: #666;"> style="width: 100%; max-width: 1000px; height: auto; border: 3px solid #34495e; border-radius: 8px; background: white; padding: 20px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);">
Source: <a href="https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32c5/esp32-c5-devkitc-1/user_guide.html" target="_blank">Espressif ESP32-C5 Documentation</a> <p style="margin-top: 10px; font-size: 0.9em; color: #666; text-align: center;">
<strong>Source:</strong> <a href="https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32c5/esp32-c5-devkitc-1/user_guide.html" target="_blank">Espressif ESP32-C5 Official Documentation</a>
</p> </p>
</div> </div>
@ -358,62 +377,39 @@
</tbody> </tbody>
</table> </table>
<h3>Visual Connection Guide</h3> <h3>Quick Wiring Reference</h3>
<div style="background: #2c3e50; padding: 30px; border-radius: 8px; margin: 20px 0;"> <div style="background: #2c3e50; padding: 25px; border-radius: 8px; margin: 20px 0;">
<pre style="color: #ecf0f1; font-size: 1.2em; line-height: 1.8; margin: 0; font-family: 'Courier New', monospace; font-weight: bold;"> <pre style="color: #ecf0f1; font-size: 1.3em; line-height: 2; margin: 0; font-family: 'Courier New', monospace; font-weight: bold;">
GT-U7 GPS Module ESP32-C5-DevKitC-1 Board <span style="color: #f39c12;">4 WIRES NEEDED:</span>
---------------- ═══════════════════════════════════════
<span style="color: #f39c12;"> ┌─── J1 (LEFT) ──┐ ┌── J3 (RIGHT) ──┐</span> <span style="color: #27ae60;">1. GT-U7 VCC → J1 Pin 1 (3V3) [Left side, top]</span>
<span style="color: #27ae60;">VCC (3.3V-5V) ────────→ │ Pin 1: 3V3 │ │ │</span> <span style="color: #27ae60;">2. GT-U7 GND → J1 Pin 15 (GND) [Left side, bottom]</span>
│ Pin 2: RST │ │ │ <span style="color: #27ae60;">3. GT-U7 TXD → J3 Pin 8 (GPIO4) [Right side]</span>
│ Pin 3: GPIO2 │ │ │ <span style="color: #27ae60;">4. GT-U7 PPS → J1 Pin 6 (GPIO1) [Left side]</span>
│ Pin 4: GPIO3 │ │ │
│ Pin 5: GPIO0 │ │ │
<span style="color: #27ae60;">PPS (pulse) ────────→ │ Pin 6: GPIO1 │ │ │</span>
│ Pin 7: GPIO6 │ │ │
│ Pin 8: GPIO7 │ │ │
│ Pin 9: GPIO8 │ │ │
│ Pin 10: GPIO9 │ │ │
│ Pin 11: GPIO10 │ │ │
│ Pin 12: GPIO26 │ │ │
│ Pin 13: GPIO25 │ │ │
│ Pin 14: 5V │ │ │
<span style="color: #27ae60;">GND ────────→ │ Pin 15: GND │ │ │</span>
│ Pin 16: NC │ │ │
└────────────────┘ │ │
│ Pin 1: GND │
│ Pin 2: TX │
│ Pin 3: RX │
│ Pin 4: GPIO24 │
│ Pin 5: GPIO23 │
│ Pin 6: NC │
│ Pin 7: GPIO27 │
<span style="color: #27ae60;">TXD (data out) ──────────────────────────→ │ Pin 8: GPIO4 │</span>
<span style="color: #95a5a6;">RXD (optional) ←────────────────────────────│ Pin 9: GPIO5 │</span>
│ Pin 10: NC │
│ Pin 11: GPIO28 │
│ Pin 12: GND │
│ Pin 13: GPIO14 │
│ Pin 14: GPIO13 │
│ Pin 15: GND │
│ Pin 16: NC │
└────────────────┘
<span style="color: #3498db;">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GT-U7 IPEX ANTENNA:
• Connect active antenna to GT-U7's IPEX connector
• Place antenna with clear view of sky for best reception
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</span>
<span style="color: #e74c3c;">REQUIRED CONNECTIONS (4 wires):</span>
<span style="color: #27ae60;"> 1. GT-U7 VCC → J1 Pin 1 (3V3)
2. GT-U7 GND → J1 Pin 15 (GND)
3. GT-U7 TXD → J3 Pin 8 (GPIO4)
4. GT-U7 PPS → J1 Pin 6 (GPIO1)</span>
</pre> </pre>
</div> </div>
<div style="background: #f8f9fa; padding: 20px; border-radius: 8px; margin: 20px 0; border: 2px solid #34495e;">
<div style="font-weight: bold; font-size: 1.2em; margin-bottom: 15px;">📍 Pin Locations on Board:</div>
<div style="display: grid; grid-template-columns: 1fr 1fr; gap: 20px;">
<div style="background: white; padding: 15px; border-radius: 6px;">
<div style="font-weight: bold; color: #e74c3c; margin-bottom: 10px;">J1 (LEFT SIDE)</div>
<div style="font-family: monospace; font-size: 1.1em;">
Pin 1: 3V3 ← <span style="color: #27ae60;">VCC</span><br>
Pin 6: GPIO1 ← <span style="color: #27ae60;">PPS</span><br>
Pin 15: GND ← <span style="color: #27ae60;">GND</span>
</div>
</div>
<div style="background: white; padding: 15px; border-radius: 6px;">
<div style="font-weight: bold; color: #3498db; margin-bottom: 10px;">J3 (RIGHT SIDE)</div>
<div style="font-family: monospace; font-size: 1.1em;">
Pin 8: GPIO4 ← <span style="color: #27ae60;">TXD</span><br>
Pin 9: GPIO5 ← <span style="color: #95a5a6;">RXD (optional)</span>
</div>
</div>
</div>
</div>
<div class="warning-box"> <div class="warning-box">
<strong>⚠️ Important Notes:</strong> <strong>⚠️ Important Notes:</strong>
<ul style="margin: 10px 0 0 20px;"> <ul style="margin: 10px 0 0 20px;">
@ -809,7 +805,15 @@ echo &quot;All devices flashed!&quot;</code></pre>
<h3>Physical Setup Recommendations</h3> <h3>Physical Setup Recommendations</h3>
<ul style="margin: 15px 0 0 20px;"> <ul style="margin: 15px 0 0 20px;">
<li>Use short (10cm) dupont wires to minimize antenna interference</li> <li>Use short (10cm) dupont wires to minimize antenna interference</li>
<li>Mount GPS modules on top of enclosure for best sky view</li> <li><strong>External Active Antenna:</strong> Mount waterproof SMA antenna with magnetic base on roof or high point for optimal GPS reception</li>
<li><strong>IPEX to SMA Adapter:</strong> Each GT-U7 needs an adapter cable (~3-6 inches) to connect to external antenna</li>
<li><strong>Antenna Placement:</strong> For 32+ device deployment, consider:
<ul style="margin-top: 5px;">
<li>Single roof-mounted antenna with GPS signal splitter (1-to-N)</li>
<li>OR individual antennas for each device (better accuracy but more expensive)</li>
<li>Keep antenna cables as short as possible (signal loss increases with length)</li>
</ul>
</li>
<li>Keep ESP32 antennas clear of metal/GPS modules</li> <li>Keep ESP32 antennas clear of metal/GPS modules</li>
<li>Consider 3D printed stackable enclosures for clean deployment</li> <li>Consider 3D printed stackable enclosures for clean deployment</li>
<li>Label each device with its static IP for tracking</li> <li>Label each device with its static IP for tracking</li>
@ -821,10 +825,12 @@ echo &quot;All devices flashed!&quot;</code></pre>
<h3>No GPS Fix</h3> <h3>No GPS Fix</h3>
<ul style="margin: 15px 0 0 20px;"> <ul style="margin: 15px 0 0 20px;">
<li><strong>GT-U7 Antenna:</strong> Ensure IPEX active antenna is properly connected to the module</li> <li><strong>External Active Antenna:</strong> Connect waterproof active antenna (SMA) to GT-U7 IPEX port using IPEX-to-SMA adapter</li>
<li><strong>Antenna Placement:</strong> Mount antenna outdoors or on window with magnetic base for best sky view</li>
<li>Ensure GPS module has clear view of sky (outdoors or near window)</li> <li>Ensure GPS module has clear view of sky (outdoors or near window)</li>
<li>Cold start can take 30-60 seconds, hot start &lt;1 second</li> <li>Cold start can take 30-60 seconds, hot start &lt;1 second</li>
<li>GT-U7 has excellent sensitivity - works in challenging environments</li> <li>GT-U7 has excellent sensitivity - works in challenging environments</li>
<li><strong>Active antenna power:</strong> GT-U7 provides 3.3V to power the active antenna (28dB gain)</li>
<li>Check UART connections (TXD→GPIO4, RXD←GPIO5)</li> <li>Check UART connections (TXD→GPIO4, RXD←GPIO5)</li>
<li>Verify 3.3V power (measure with multimeter - should be 3.2-3.4V)</li> <li>Verify 3.3V power (measure with multimeter - should be 3.2-3.4V)</li>
<li>GT-U7 LED should blink when acquiring satellites</li> <li>GT-U7 LED should blink when acquiring satellites</li>