FreakWAN 项目下载及安装教程

1. 项目介绍

FreakWAN 是一个基于 LoRa 技术的开源 WAN 网络项目，旨在创建一个完全独立于互联网和蜂窝电话网络的 LoRa 网络。该网络的主要目标是提供一个分布式的聊天系统，适用于技术爱好者或在互联网不可用的地方，如灾难期间。此外，FreakWAN 还旨在创建一个强大的 LoRa 协议，支持其他应用，如传感器数据收集和家庭自动化，克服 OOK/FSK 通信的范围限制。

2. 项目下载位置

FreakWAN 项目托管在 GitHub 上，可以通过以下命令进行克隆：

git clone https://github.com/antirez/freakwan.git

3. 项目安装环境配置

3.1 硬件要求

FreakWAN 项目支持以下 ESP32 设备：

• LILYGO TTGO T3 v2.1.6 LoRa 模块
• LILYGO TTGO T3-S3 v1.2 LoRa 模块（2.4 GHz 版本未测试/不支持）
• LILYGO TTGO T Beam LoRa 模块
• LILYGO T-WATCH S3

3.2 软件要求

FreakWAN 项目使用 MicroPython 进行开发。请确保您的设备上安装了 MicroPython。推荐使用 MicroPython 版本 1.22.2 或更高版本。

3.2.1 安装 MicroPython

1. 下载适用于 ESP32 的 MicroPython 固件。
2. 使用 esptool.py 工具将固件刷入设备。

esptool.py --chip esp32 --port /dev/ttyUSB0 erase_flash
esptool.py --chip esp32 --port /dev/ttyUSB0 --baud 460800 write_flash -z 0x1000 esp32-idf3-20210202-v1.14.bin

3.3 配置设备

1. 克隆 FreakWAN 项目到本地。
2. 编辑 wan_config.py 文件，设置您的昵称和状态消息，并根据您的设备设置频率。

# wan_config.py
nickname = "YourNickname"
status_message = "YourStatusMessage"
frequency = 433000000  # 根据您的 LoRa 模块设置频率

4. 项目安装方式

4.1 传输文件

使用 mpremote 或 talk32 工具将项目文件传输到设备。

mpremote cp *py :

或

talk32 /dev/ttyUSB0 put *py

4.2 重启设备

重启设备以加载新安装的 FreakWAN 项目。

mpremote repl

在 REPL 中输入 Ctrl+D 触发软重启。

5. 项目处理脚本

FreakWAN 项目包含多个 Python 脚本，用于处理不同的功能，如消息发送、接收、加密等。以下是一些关键脚本的简要介绍：

• main.py: 主程序入口，负责初始化和启动 FreakWAN 网络。
• message.py: 处理消息的发送和接收。
• networking.py: 处理网络通信和路由。
• encryption.py: 处理消息的加密和解密。

通过这些脚本，您可以自定义和扩展 FreakWAN 的功能，以满足特定的需求。

---

通过以上步骤，您可以成功下载并安装 FreakWAN 项目，并开始使用其强大的 LoRa 网络功能。