首页
/ FreakWAN 项目下载及安装教程

FreakWAN 项目下载及安装教程

2024-12-09 15:46:46作者:董斯意

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 传输文件

使用 mpremotetalk32 工具将项目文件传输到设备。

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 网络功能。

登录后查看全文
热门项目推荐