Documentation

# IOT_4G.py 函数文档 4G网络连接和NTP时间同步模块。 ## 全局变量 - connect_status_4g: 4G连接状态标志
- lte: LTE网络对象实例
- version: LTE模块版本信息
- iccid: SIM卡ICCID号码 ## 核心函数 ### connect_4g()

python
def connect_4g()

- 功能: 建立4G网络连接
- 实现流程:
1. 检查LTE对象是否存在
2. 检查当前连接状态
3. 激活LTE模块
4. 尝试建立连接
5. 等待连接结果
- 返回值:
- True: 连接成功
- False: 连接失败
- 连接特性:
- 自动重试机制
- 状态检查
- 超时保护（一次重试）
- 输出信息:
- 连接状态
- 模块版本
- ICCID信息 ### synchronous_timer()

python
def synchronous_timer()

- 功能: NTP网络时间同步
- 实现细节:
- NTP服务器: pool.ntp.org
- 自动异常处理
- 时间同步状态反馈
- 返回值:
- True: 同步成功
- False: 同步失败
- 输出信息:
- 同步结果
- 当前本地时间 ### Sync_Timer()

python
def Sync_Timer()

- 功能: 综合网络连接和时间同步
- 执行流程:
1. 建立4G网络连接
2. 同步网络时间
3. 异常处理保护
- 返回值:
- True: 全部成功
- False: 任一步骤失败
- 错误处理:
- 网络连接失败处理
- 时间同步失败处理
- 异常捕获和日志 ## 使用示例 ### 基本网络连接

python
from IOT_4G import connect_4g

if connect_4g():
    print("4G网络连接成功")
else:
    print("4G网络连接失败")

### 时间同步

python
from IOT_4G import Sync_Timer

if Sync_Timer():
    print("网络连接和时间同步成功")
else:
    print("同步失败，请检查网络")

## 网络状态检查 ### 连接状态查看

python
from IOT_4G import lte

if lte and lte.isconnected():
    print("网络状态:", lte.status())
    print("模块版本:", lte.version())
    print("ICCID:", lte.iccid())

## 技术规格 1. 网络连接
- 类型: 4G LTE
- 重试次数: 1次
- 连接超时: 默认等待时间 2. 时间同步
- 协议: NTP
- 服务器: pool.ntp.org
- 备用服务器: time.aliyun.com（注释中提供） ## 错误处理 1. LTE模块初始化错误

python
try:
    lte = network.LTE()
except Exception as e:
    print(f"LTE模块初始化失败: {e}")

2. 网络连接错误

python
if not lte.isconnected():
    print("网络连接失败")

3. NTP同步错误

python
try:
    ntptime.settime()
except OSError as e:
    print(f"时间同步失败: {e}")

## 注意事项 1. 网络连接
- 确保SIM卡正确安装
- 检查信号强度
- 注意连接超时处理 2. 时间同步
- 需要成功的网络连接
- 可能受网络延迟影响
- 建议定期重新同步 3. 资源管理
- 及时处理连接异常
- 避免频繁重连
- 合理设置重试间隔 4. 调试建议
- 使用status()检查详细状态
- 记录重要错误信息
- 监控连接稳定性 5. 性能优化
- 按需连接
- 避免死循环等待
- 合理的超时设置