terra

<h1 align="center">TERRA是一款用于正念漫步的伴侣设备</h1> <img src="https://yellow-cdn.veclightyear.com/ab5030c0/b2e4c13f-fc17-49e2-80aa-96d7a14df7b3.png" alt="TERRA设备">

结合人工智能科技和正念智慧设计，TERRA是一款令人惊叹的口袋式指南针，让您可以随意漫步而不会迷路。把手机留在家里，重新与周围环境建立联系。

特点

由人工智能驱动的即兴路线：每次旅程都始于一个提示。TERRA的先进人工智能将您的意图、可用时间和精确位置转化为定制的GPS坐标路线。用户不知道TERRA会带他们去哪里；唯一可以确定的是，他们一定能找到回到起点的路。
无需手机的漫步体验：TERRA邀请用户将智能手机留在家中，重新与周围环境建立联系。这款独立设备拥有极简界面，配备宁静的指南针指针和柔和的触觉反馈，确保用户始终专注于当下。
开源设计理念：TERRA采用DIY思维设计。任何人都可以下载开源软件，3D打印CAD设计，组装必要的硬件，然后开始漫步。

⚠️ 注意：本项目目前处于实验阶段，正在快速开发中 ⚠️

软件

TERRA应用程序使用ChatGPT API，从起点和理想的路线长度生成坐标或检查点。

本地运行TERRA应用程序

前提条件

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

要在本地运行TERRA应用程序，请按以下步骤操作：

实现ChatGPT API密钥： 获取ChatGPT API密钥，并在server.js文件中将YOUR_OPENAI_API_KEY替换为您的密钥。
实现Google Maps API密钥： 获取Google Places API密钥，并在index.js文件中将YOUR_MAPS_KEY替换为您的密钥。
本地运行： 使用以下命令运行应用程序：
```
node server.js
```
加载应用程序： 在浏览器中打开index.html以使用应用程序生成路线。
下载config.h文件： 下载包含生成的路线配置的config.h文件。
更新Arduino代码： 用新下载的文件替换Arduino代码目录中的config.h文件。

硬件

TERRA项目的硬件基于ESP32设备，配备了一系列用于导航和交互的传感器。

组件

主要所需组件包括：

ESP32 Feather V2 链接
Waveshare 1.28英寸圆形LCD显示模块（GC9A01驱动）链接
Adafruit按钮电源开关链接
Beitian BN 880 GPS模块链接
Adafruit DRV2605L触觉控制器分线板链接
CMPS12电子罗盘链接
圆形电池
USB C充电口延长线

接线

按以下顺序连接组件：

ESP32引脚	屏幕	电机驱动	罗盘	GPS	按钮
3V	VCC	VIN	VIN	VIN
GND	GND	GND	GND	GND	GND
19 (MOSI)	DIN
4 (A5)	RST
5 (SCK)	CLK
12	BL
15	CS
32 (A7)					OFF
33	DC
SDA		SDA	SDA
SCL		SCL	SCL
RX				TX
TX				RX

Arduino代码

要运行Arduino代码，您需要设置ESP32开发板并安装必要的库。

设置步骤

ESP32 Arduino设置： 在Arduino IDE中添加ESP32开发板。
- 转到Arduino > 首选项。
- 在附加开发板管理器网址中添加以下URL：
```
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_dev_index.json
```
- 选择Adafruit Feather ESP32 V2作为开发板。
安装库： 通过Arduino IDE的库管理器安装以下库。
- TinyGPSPlus.h
- TFT_eSPI.h
- Adafruit_DRV2605.h
上传代码： 安装库并用新坐标更新config.h文件后，将代码上传到ESP32设备。设备应该可以正常工作，无需进一步调整。
调试模式： 代码中提供了一个debugMode标志。要使用手动坐标测试设备，请将此标志设置为true，并在串行监视器中输入坐标。