# 4G土壤检测系统

**Repository Path**: ygui/4G-soil-detection-system

## Basic Information

- **Project Name**: 4G土壤检测系统
- **Description**: 基于 STM32L432 微控制器与 LoRa 无线模块，集成 LoRa 无线通信与 4G 模块 MQTT 协议，实现土壤温湿度与电导率（EC）数据的采集、显示与远程传输。系统采用 3.7V 锂电池供电，集成充放电与保护电路，兼顾本地显示与云端交互，适用于农业与环境监测场景。
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-10-27
- **Last Updated**: 2025-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 4G 土壤检测系统

## 项目简介
**LoRa 土壤温湿度监测系统**（2025.05-2025.07）  
基于 STM32L432 微控制器与 LoRa 无线模块，集成 LoRa 无线通信与 4G 模块 MQTT 协议，实现土壤温湿度与电导率（EC）数据的采集、显示与远程传输。系统采用 3.7V 锂电池供电，集成充放电与保护电路，兼顾本地显示与云端交互，适用于农业与环境监测场景。

---

## 职责与实现
- 基于 MAX3485 实现 RS485 通信，读取土壤温湿度与 EC 数据  
- 在 FreeRTOS 下进行多任务调度，实现数据采集、打包、无线传输与 OLED 界面显示  
- 通过 AT 指令配置 LoRa，实现 2~3 km 范围内通信及上位机指令交互  
- 集成 4G 模块，基于 MQTT 协议实现数据上报与云端下发控制，提高远程运维能力  
- 系统配置 Stop2 低功耗模式，并实现电池电量检测，支持长时间低功耗运行  

---

## 技术栈
- **MCU**：STM32L432  
- **通信**：MAX3485（RS485）、LoRa、4G 模块、MQTT  
- **显示**：OLED（I2C）  
- **操作系统**：FreeRTOS  
- **调试**：串口调试  
- **设计特点**：低功耗、远程控制  

---

## 软件架构

Core：CubeMX 自动生成的 HAL 初始化，系统启动与外设基础配置

BSP（Board Support Package）：硬件抽象层，提供统一接口给应用层操作外设

App（应用层）：主要业务逻辑，任务调度、多线程处理、数据采集、通信和显示

Drivers / libs：第三方库和外设驱动，独立可替换

Tasks（在 App 中）：按功能拆分，比如传感器采集任务、显示任务、通信任务、低功耗管理任务

---

## 安装教程
1. 克隆仓库：
   ```bash
   git clone https://gitee.com/rich-and-honorable-market/4G-soil-detection-system.git