Service flow & 7-year parts

SERVICE-FLOW.md — Ambassador-side Service Flow

Inbound Diagnostic

Initial Inspection Procedure

Step 1: Power-On Test

• Objective: Ensure basic power-on functionality and identify immediate

immediate issues that prevent proper operation.

• Procedure:
• Remove the battery cover (part number WB-CVR-BATT, vendor: Jabil Inc)

Inc) and inspect for physical damage, corrosion or leakage.

• Connect a known good power source to the device and verify LED status l

lights (firmware version indicator).

• LED behavior codes:
• Solid Green Light = Firmware boot successful
• Flashing Red Light = Power supply issue / overvoltage
• Expected Outcome:
• Device powers on without any error messages or LED anomalies.

Step 2: System Health Check

• Objective: Confirm the device is capable of running diagnostic tests.

tests.

• Procedure:
• Run internal system diagnostics (command sequence sys-diag-run).
• Check logs for errors (log-read-all).
• Look for any critical error codes indicating hardware failure or soft

software malfunction.

• Expected Outcome:
• System diagnostics complete without any critical failures.

Step 3: Connectivity Test

• Objective: Validate the ability to connect both locally and wirelessl

wirelessly (LoRa/Wi-Fi).

• Procedure:
• Ensure device is properly connected to a known good network or LoRa gat

gateway.

• Execute connectivity test command (conn-test-run).
• Evaluate success based on successful ping/pong responses from gateway

gateway/controller.

• Expected Outcome:
• Device responds correctly to all pings and passes the connectivity test

test.

Field-Replaceable Units

Identification & Replacement Guide

FRU: ESP32-S3-WROOM-1 (Microcontroller Module)

• Replacement Steps:
• Disconnect any power sources.
• Remove module screws (SCREW-MICRO, vendor: Stanley) and gently pry ou

out the module using a plastic tool to avoid damaging adjacent components.

• Inspect PCB contacts for corrosion or damage; clean if necessary.
• Install new module, ensuring secure seating.
• Part Number: ESP32-S3-WROOM-1 from Espressif Systems.

FRU: Nordic nRF52840 (Alternate Microcontroller)

• Replacement Steps:
• Similar to ESP32 module replacement; ensure correct orientation and pro

proper connector pin alignment.

• Part Number: NRF52840-QIAA from Nordic Semiconductor.

Troubleshooting Common FRU Issues

• Issue: Inconsistent power-on cycles, frequent resets.
• Solution: Verify battery condition (WB-BATT-LIPO, vendor: LG Chem)

and ensure power circuit components (part PCBC-PWR-CIRCUIT, vendor: Murat Murata) are intact. Replace faulty parts as necessary.

Battery Service

Battery Replacement Procedure

Step 1: Remove Old Battery

• Procedure:
• Use a Phillips head screwdriver (SCREW-BATT-REM, vendor: Stanley Tool

Tools) to remove the battery cover screws.

• Carefully lift off the battery compartment cover and disconnect any ele

electrical connectors attached to the old battery.

• Expected Outcome:
• Old battery removed without damaging connections.

Step 2: Insert New Battery

• Procedure:
• Place new lithium-ion battery (WB-BATT-LIPO, vendor: LG Chem) into co

compartment with correct polarity.

• Reconnect electrical connectors and replace the battery cover, ensuring

ensuring proper sealing to prevent moisture ingress (waterproofing rating I IP65).

• Expected Outcome:
• Battery securely installed with no signs of leakage or damage.

Step 3: Power-On Test

• Procedure:
• Ensure device powers on normally and operates within expected parameter

parameters.

• Expected Outcome:
• Device functions as intended, passing all pre-installation tests.

Firmware Rollback Procedure

Pre-Rollback Preparation

• Objective: Prepare the system for firmware rollback in case of unexpe

unexpected issues with a recent update.

• Steps:
• Ensure device is fully powered and connected to network for data backup

backup (if applicable).

• Execute firmware-version-get command to confirm current firmware vers

version.

Rollback Execution

Step 1: Download Backup Firmware

• Procedure:
• Access the manufacturer's website or server hosting previous firmwares.

firmwares.

• Retrieve a known-good build for the device model and variant.

variant.

• Expected Outcome:
• Downloaded file is verified to match checksums and signatures provided

by manufacturer.

Step 2: Install Backup Firmware

• Procedure:
• Transfer firmware file via USB or network to device.
• Execute firmware-update command with rollback parameters (e.g., speci

specifying version number).

• Expected Outcome:
• Device reboots into previous firmware configuration without errors.

Decommission + Secure-Wipe

Pre-Decommission Checks

Step 1: Data Backup & Erasure

• Procedure:
• Run sys-backup-run to save all user-configurable data locally.
• Execute secure wipe command (secure-wipe-all) to erase non-volatile m

memory (NVM) and clear configuration settings.

• Ensure logs are also cleared using log-clear.
• Expected Outcome:
• No residual data remains on the device, meeting compliance standards fo

for end-of-life disposal.

Step 2: Physical Inspection

• Procedure:
• Conduct a thorough visual inspection of the unit to confirm there is no

no visible damage.

• Focus on components such as connectors (part CONN-LORA, vendor: u-b

u-blox), PCB traces, and battery contacts.

• Expected Outcome:
• Unit passes physical integrity test with no observable defects.

Ambassador Signature Provenance

Authenticity Verification Process

Step 1: Inspect Engraving Area

• Objective: Validate the presence of an ambassador's signature engrave

engraved on the enclosure's internal wall, confirming assembly authenticity authenticity.

• Procedure:
• Open device enclosure to access internal components and find the design

designated area for signing (typically near main PCB).

• Signature should be legible with embossed initials or full name of as

assembler.

• Expected Outcome:
• Authentic signature present without any signs of tampering.

Step 2: Cross-reference Assembly Records

• Objective: Confirm assembly details match expected criteria based on

build order and shipment data.

• Procedure:
• Reference internal records (BOM-modules.csv, BOM-normalized.csv) to ver

verify that the device was indeed assembled by an authorized ambassador.

• Each unit should have a unique serial number traceable back to its pr

production batch.

• Expected Outcome:
• Assembly record shows alignment with standard procedures and quality co

controls.

Cost +10% Parts Table

Summary of Replacement Costs Including Buffer

| Part Number | Description | Quantity | Unit Price Price (USD) | Total Price (USD) |

| WB-CVR-BATT | Battery Cover | 2 | 0.35

0.70

| SCREW-MICRO | Microcontroller Mount Screw | 4 | 0.18

0.72

| PCBC-PWR-CIRCUIT | Power Circuit Breaker | 1 | 3.50

3.50

| WB-BATT-LIPO | Lithium-Ion Battery Pack | 1 | 19.50

19.50

| CONN-LORA | LoRa Wireless Connectivity | 2 | 7.60

15.20

| ESP32-S3-WROOM-1 | Primary Microcontroller | 1 | 8.45

8.45

| NRF52840-QIAA | Secondary Microcontroller | 1 | 7.95

7.95

Note: All unit prices are based on latest procurement rates and include include a 10% buffer for unforeseen costs.

---

This document outlines comprehensive procedures and guidelines for handling handling common service operations related to the WanderGarden product line line at an ambassador level, ensuring adherence to quality standards and cu customer satisfaction expectations.

Open STL files

WanderGarden — Open Mechanical Files

Per the WanderVerse 7-year repair commitment, every mechanical file required to fabricate replacement parts is published here under CC-BY-SA 4.0.

Files

• enclosure-front.stl, enclosure-back.stl — outer case
• pcb-mount-bracket.stl, battery-tray.stl — internal mounts
• pcb-3d-step.step — full mechanical PCB outline
• drawings.pdf — assembly drawings + tolerance sheet

Engraved signature stays inside; do not place wordmarks on the exterior.