
G5 (RX),G6 (TX)。

setSatelliteMode() ,默认为 GPS 系统,当修改后屏幕上的前缀也会随之修改,方便确定卫星系统。/*
*SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
*
*SPDX-License-Identifier: MIT
*/
#include "M5Unified.h"
#include "M5GFX.h"
#include "MultipleSatellite.h"
static const int RXPin = 5, TXPin = 6;
static const uint32_t GPSBaud = 115200;
MultipleSatellite gps(Serial1, GPSBaud, SERIAL_8N1, RXPin, TXPin);
// Current satellite mode
satellite_mode_t currentMode = SATELLITE_MODE_GPS;
void displayInfo(void);
// Get the Sat prefix
const char* getSatPrefix(satellite_mode_t mode) {
switch (mode) {
case SATELLITE_MODE_GPS: return "GPS_Sat";
case SATELLITE_MODE_BDS: return "BDS_Sat";
case SATELLITE_MODE_GLONASS: return "GLN_Sat";
case SATELLITE_MODE_GALILEO: return "GAL_Sat";
case SATELLITE_MODE_QZSS: return "QZS_Sat";
default: return "Unknown";
}
}
void setup() {
M5.begin();
Serial.begin(115200);
gps.begin();
gps.setSystemBootMode(BOOT_FACTORY_START);
Serial.println(F("A simple demonstration of TinyGPSPlus with Atomic GPS Base"));
Serial.print(F("Testing TinyGPSPlus library v. "));
Serial.println(TinyGPSPlus::libraryVersion());
Serial.println();
String version = gps.getGNSSVersion();
Serial.printf("GNSS SW=%s\r\n", version.c_str());
delay(1000);
// Set the satellite mode and record the current mode
currentMode = SATELLITE_MODE_GPS;
gps.setSatelliteMode(currentMode);
M5.Display.setFont(&fonts::FreeMonoBold9pt7b);
}
void loop() {
// Update data
gps.updateGPS();
displayInfo();
delay(100);
}
void displayInfo(void) {
Serial.print(F("Location: "));
Serial.printf("satellites:%d\n", gps.satellites.value());
String gps_mode = gps.getSatelliteMode();
M5.Display.setCursor(110, 0);
Serial.printf("GNSS Mode:%s\r\n", gps_mode.c_str());
const char* satPrefix = getSatPrefix(currentMode);
if (gps.location.isUpdated()) {
Serial.print(gps.location.lat(), 6);
Serial.print(F(","));
Serial.print(gps.location.lng(), 6);
Serial.print(F("\n"));
M5.Display.fillRect(0, 0, 128, 128, BLACK);
M5.Display.setCursor(0, 0);
M5.Display.printf("%s: \nSat: %d\nLat: %d\nlng: %d\n", satPrefix,
(uint8_t)gps.satellites.value(),
(uint8_t)gps.location.lat(),
(uint8_t)gps.location.lng());
} else {
M5.Display.fillRect(0, 0, 128, 128, BLACK);
M5.Display.setCursor(0, 0);
M5.Display.printf("%s\n", satPrefix);
M5.Display.print("Sat: ----\n");
M5.Display.print("Lat: ----\n");
M5.Display.print("Lng: ----\n");
Serial.print(F("INVALID\n"));
}
Serial.print(F("Date/Time: "));
if (gps.date.isUpdated()) {
Serial.print(gps.date.month());
Serial.print(F("/"));
Serial.print(gps.date.day());
Serial.print(F("/"));
Serial.print(gps.date.year());
M5.Display.fillRect(0, 80, 128, 128, BLACK);
M5.Display.setCursor(0, 80);
M5.Display.printf("%d/%d/%d\n", gps.date.month(),
gps.date.day(), gps.date.year());
} else {
Serial.print(F("INVALID"));
}
Serial.print(F(" "));
if (gps.time.isUpdated()) {
if (gps.time.hour() < 10) Serial.print(F("0"));
Serial.print(gps.time.hour());
Serial.print(F(":"));
if (gps.time.minute() < 10) Serial.print(F("0"));
Serial.print(gps.time.minute());
Serial.print(F(":"));
if (gps.time.second() < 10) Serial.print(F("0"));
Serial.print(gps.time.second());
Serial.print(F("."));
if (gps.time.centisecond() < 10) Serial.print(F("0"));
Serial.print(gps.time.centisecond());
M5.Display.fillRect(0, 128, 128, 60, BLACK);
M5.Display.setCursor(0, 96);
M5.Display.printf("Time: \n%d:%d:%d.%d", gps.time.hour(), gps.time.minute(),
gps.time.second(),gps.time.centisecond());
} else {
Serial.print(F("INVALID"));
}
Serial.println();
delay(1000);
}下载模式:不同设备进行程序烧录前需要进入下载模式,不同的主控设备该步骤可能有所不同。详情可参考 Arduino IDE上手教程 页面底部的设备程序下载教程列表,查看具体的操作方式。
AtomS3R 长按复位按键 (大约 2 秒) 直到内部绿色 LED 灯亮起,便可松开,此时设备已进入下载模式,等待烧录。
由于该产品采用内置天线,无外置天线,请尽量在户外空旷区域使用,如操场、天台等,且初次使用等待时间较长,约为几分钟,请耐心等待设备成功搜索卫星与获取坐标。
