Skip to the content
4 layers76.9 × 67.3 mmTerra HW, the printed circuit board in 3D

Terra 2.0 Firmware and Hardware

Size
76.9 × 67.3 mm
Copper layers
4
Thickness
1.55 mm
Parts
95
Nets
92
Pads
344
Tracks, vias
792, 208
Pours
267
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
19 Apr 2025
Updated
4 Feb 2026

Overview

Terra HW is an open-source printed circuit board by jamesmendel, from the jamesmendel/terra-nova repository on GitHub, published under the GPL-3.0 licence. It is a 4-layer board of 76.9 × 67.3 mm with 95 parts on 92 nets, routed with 792 tracks and 208 vias.

It is built around the ESP32-S3-MINI-1-N4R2, DRV2605LDGS and AP2112K-3.3TRG1, with the BNO055, BQ21040DBV and SN74LVC1G14DRL among its other parts. Its parts include 26 resistors, 18 capacitors, 12 diodes, 7 ICs and 5 connectors. It belongs with the ESP32 boards of this library.

Main components

12

README

README.md

TERRA is a companion for mindful wandering

⭐️ This is the working repository for the second generation of TERRA hardware and software. ⭐️



TERRA Device



Designed with the science of AI and the wisdom of mindfulness, TERRA is the incredible, pocket-sized compass that lets you wander without getting lost. Leave your phone behind and reconnect with your surroundings.


Features

  • Improvised Trails, Powered by AI: Every journey begins with a prompt. TERRA’s sophisticated AI translates your intentions, available time, and precise location into a tailored trail of GPS coordinates. Users don't know where TERRA will take them; the only certainty is finding their way back to the starting point.
  • Wander Without Your Phone: TERRA invites users to leave their smartphones behind and reconnect with their surroundings. The standalone device boasts a minimalist interface, featuring a tranquil compass needle and gentle haptic feedback to ensure users remain engaged with the present moment.
  • Open-Source by Design: TERRA is designed with a DIY mindset. Anyone can download the open-source software, 3D print the CAD designs, assemble the necessary hardware, and start wandering.


⚠️ NOTICE: This project is currently in an experimental phase and is undergoing rapid developments ⚠️


Software

The TERRA App generates coordinates or checkpoints from a starting point and an ideal trail length using the ChatGPT API.

Running TERRA App Locally

Prerequisites
  • Node.js v21.5
  • body-parser v1.20.2
  • cors v2.8.5
  • express v4.19.0
  • node-fetch v3.3.2

To run the TERRA App locally, follow these steps:

  1. Implement ChatGPT API Key: Obtain a ChatGPT API key and replace YOUR_OPENAI_API_KEY with it in the server.js file.
  2. Implement Google Maps API Key: Obtain a Google Places API key and replace YOUR_MAPS_KEY with it in the index.js file.
  3. Run Locally: To run the application, use the command:
    text
    node server.js
  4. Load Application: Open index.html in a browser to use the app for generating a route.
  5. Download config.h File: Download the config.h file which contains the generated route configuration.
  6. Update Arduino Code: Replace the config.h file in the Arduino code directory with the newly downloaded file.

Hardware

The hardware for the TERRA project is based on an ESP32 device, equipped with a range of sensors for navigation and interaction.

Components

The main components required are:

  • ESP32 Feather V2 link
  • Waveshare 1.28" Round LCD Display Module with GC9A01 Driver link
  • Adafruit Push-button Power Switch link
  • Beitian BN 880 GPS module link
  • Adafruit DRV2605L Haptic Controller Breakout link
  • CMPS12 Compass link
  • Round Battery
  • USB C charging port extender

Wiring

Connect the components together in the following order:

ESP32 PinScreenMotor DriverCompassGPSPush Button
3VVCCVINVINVIN
GNDGNDGNDGNDGNDGND
19 (MOSI)DIN
4 (A5)RST
5 (SCK)CLK
12BL
15CS
32 (A7)OFF
33DC
SDASDASDA
SCLSCLSCL
RXTX
TXRX

Arduino Code

To run the Arduino code, you will need to set up the ESP32 board and install the necessary libraries.

Setup Steps

  1. ESP32 Arduino Setup: Add the ESP32 board to the Arduino IDE.

    • Go to Arduino > Preferences.
    • Add the following URL to the Additional Boards Manager URLs:
      text
      https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_dev_index.json
    • Select Adafruit Feather ESP32 V2 as the board.
  2. Install Libraries: Install the following libraries through the Library Manager in the Arduino IDE.

    • TinyGPSPlus.h
    • TFT_eSPI.h
    • Adafruit_DRV2605.h
  3. Upload the Code: After installing the libraries and updating the config.h file with new coordinates, upload the code to the ESP32 device. The device should work without further adjustments.

  4. Debug Mode: A debugMode flag is available in the code. To test the device with manual coordinates, set this flag to true and input coordinates into the serial monitor.

Further Customizations

You can use your own checkpoint files by converting black and white images into a compatible format.

Using Your Own Checkpoint Files
  • Convert static black and white, 240x240PX .bmp images to .XBM format using this online tool.
  • Open the XBM file in a text editor and copy the hexadecimal values included in the curly brackets.
  • Replace the existing files in the images/checkpoints directory with your customized .h file.

Contributors

Vision + Concept: Modem
Industrial Design: Panter&Tourron
Software + Hardware: Alice Stewart
Product Renderings: Côme Lart
Illustrations: Hugo Bernier
Campaign Teaser: Michael Willis

License

TERRA is licensed under the GNU General Public License v3.0 © 2024 Modem

Parts

95
QtyValueFootprintReferences
10100kResistor_SMD:R_0603_1608MetricR7, R8, R9, R10, R11, R13, R14, R23, R24, R27
90.1uCapacitor_SMD:C_0603_1608MetricC2, C7, C8, C13, C14, C17, C18, C19, C21
81uCapacitor_SMD:C_0603_1608MetricC3, C4, C5, C6, C9, C10, C11, C12
610kResistor_SMD:R_0603_1608MetricR4, R12, R17, R19, R20, R21
51.5kResistor_SMD:R_0603_1608MetricR5, R6, R18, R26, R31
45.1kResistor_SMD:R_0603_1608MetricR2, R3, R15, R16
4B5819WS-TPDiode_SMD:D_SOD-323D3, D4, D11, D12
4DESD5V0U1BB-7Diode_SMD:D_SOD-523D6, D7, D8, D9
3FiducialFiducial:Fiducial_1mm_Mask2mmFID1, FID2, FID3
3KMR231NGButton_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2SW2, SW3, SW4
2GNDM20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP5, TP6
2Hole M2MountingHole:MountingHole_2.2mm_M2H1, H2
2Plated Hole M2MountingHole:MountingHole_2.2mm_M2_PadH3, H4
1+3.3VDiode_SMD:D_0603_1608MetricD5
10532610271Connector_Molex:Molex_PicoBlade_53261-0271_1x02-1MP_P1.25mm_HorizontalJ3
10RResistor_SMD:R_0603_1608MetricR25
122uCapacitor_SMD:C_0603_1608MetricC1
12N7002Package_TO_SOT_SMD:SOT-23Q2
13.3VM20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP3
1AP2112K-3.3Package_TO_SOT_SMD:SOT-23-5U2
1B8B-PH-SM4-TBConnector_JST:JST_PH_B8B-PH-SM4-TB_1x08-1MP_P2.00mm_VerticalJ5
1BNO055Package_LGA:LGA-28_5.2x3.8mm_P0.5mmU5
1BQ21040DBVPackage_TO_SOT_SMD:SOT-23-6U3
1CHARGINGDiode_SMD:D_0603_1608MetricD1
1Conn_CoaxialConnector_Coaxial:U.FL_Molex_MCRF_73412-0110_VerticalJ4
1DMP3099LPackage_TO_SOT_SMD:SOT-23Q1
1DRV2605LDGSPackage_SO:VSSOP-10_3x3mm_P0.5mmU4
1ESP32-S3-MINI-1RF_Module:ESP32-S2-MINI-1U1
1GPIO48Diode_SMD:D_0603_1608MetricD10
1GT-USB-7010ASVConnector_USB:USB_C_Receptacle_G-Switch_GT-USB-7010ASVJ1
1I2C_SCLM20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP8
1I2C_SDAM20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP7
1KSS3xxGxC&K:SW_KSS323_CNKSW5
1PA1616DTESO-LIV3F:PA1616DU10
1PMEG2010AEHDiode_SMD:D_SOD-123D2
1RXD0M20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP2
1RXD1M20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP12
1S2B-PH-SM4-TBConnector_JST:JST_PH_S2B-PH-SM4-TB_1x02-1MP_P2.00mm_HorizontalJ2
1SN74LVC1G14DRLPackage_TO_SOT_SMD:SOT-553U9
1SPI_CS0M20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP9
1SPI_MOSIM20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP10
1SPI_SCKM20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP11
1TXD0M20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP1
1TXD1M20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP14
1VUSBM20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP13
1V_SWM20048-1:TestPoint_Pad_D1.5mm_WITH_LABELTP4

Similar boards

  • 2 layers21 × 20.9 mmBattery pico, the printed circuit board in 3D

    Battery pico

    4f48/battery-pico

    A battery charger add-on board for all Raspberry Pi Pico development boards.

    14 partsCERN-OHL-S-2.0
  • 4 layers408.7 × 50 mmPartial Drawer Controller v1, the printed circuit board in 3D

    Partial Drawer Controller v1

    Robast-GmbH/PCB_Designs

    This repository contains all the necessary files and instructions for the PCBs that are designed using KiCad. Here is an overview of the main components: - .github: Contains Github-specific configurations, including…

    619 parts1MIT
  • 4 layers130 × 81 mmDash, the printed circuit board in 3D

    Dash

    sundevilmotorsports/pcb-dev

    PCB development repository

    106 parts3
  • 4 layers52.1 × 40.7 mmXDV, the printed circuit board in 3D

    XDV

    TeamFoxbat/XDV

    100% Digital Video Solution for Original Xbox!

    61 parts2CERN-OHL-P-2.0
  • 2 layers80 × 100 mmMacro keyboard, the printed circuit board in 3D

    Macro keyboard

    drfhaust/Macro-keyboard

    macro keyboard esp32 s3

    74 parts
  • 4 layers90 × 40 mmLinear act controller, the printed circuit board in 3D

    Linear act controller

    Talw3g/linear_act_controller

    Controller for 24V linear actuator with potentiometer position control and feedback.

    80 parts
  • 2 layers100 × 70 mmCRT main supply, the printed circuit board in 3D

    CRT main supply

    Thinkpad4by3/chibitron

    Electrostatic CRT driver designed from the ground up for performance, versatility and ease-of-manufacturability

    63 parts6
  • 4 layers50 × 16 mmSystem board, the printed circuit board in 3D

    System board

    proegssilb/lightsaber-hardware

    PCBs and other files for lightsaber soundboard hardware.

    72 parts2CERN-OHL-S-2.0

Questions

How big is the Terra HW PCB?

It measures 76.9 × 67.3 mm and has 4 copper layers, 1.55 mm thick.

What parts does the Terra HW use?

95 parts, built around the ESP32-S3-MINI-1-N4R2, DRV2605LDGS, AP2112K-3.3TRG1 and BNO055. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Terra HW KiCad files?

From the jamesmendel/terra-nova repository on GitHub, at the commit this page was made from: the board is Hardware/Terra-HW.kicad_pcb and its schematic Hardware/Microcontroller.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Terra HW design in my own project?

Its repository publishes it under the GPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).