Protectli UPS固件安装与配置指南

Protectli UPS固件安装与配置指南

1. 项目基础介绍

Protectli UPS固件是为Protectli不间断电源（UPS）设计的固件。它基于Zephyr实时操作系统（RTOS），运行在ESP32和RP2040微控制器上。本项目旨在提供一个开源的固件解决方案，以监控和控制UPS的电源状态。

主要编程语言：C（82.0%）、C++（9.2%）、Makefile（6.2%）、CMake（1.9%）

2. 项目使用的关键技术和框架

• Zephyr RTOS：一个由Linux基金会托管的开源实时操作系统，适用于物联网边缘设备。
• ESP32：一款流行的低成本、低功耗的系统级芯片（SoC），具有集成的Wi-Fi和蓝牙功能。
• RP2040：由Raspberry Pi基金会推出的微控制器，具有双核心处理器和丰富的GPIO引脚。
• libopencm3：一个为ARM Cortex-M3微控制器提供硬件抽象层的C语言库。

3. 项目安装和配置的准备工作与详细步骤

准备工作

• 确保你的开发环境满足以下要求：

  • 操作系统：Linux、macOS或Windows（通过WSL2）
  • GCC ARM编译器工具链
  • west命令行工具
  • Python 3.6或更高版本
  • west支持的Git版本

• 安装必要的依赖项：

  • 对于Linux系统，可以使用以下命令安装依赖项：

    sudo apt-get install gcc-arm-none-eabi libopencm3-dev
    

  • 对于macOS系统，可以使用Homebrew安装依赖项：

    brew install arm-none-eabi-gcc
    

  • 对于Windows系统，确保通过WSL2安装了相应的依赖项。

安装步骤

1. 克隆项目仓库：

   git clone https://github.com/o7-machinehum/Protectli-UPS-Firmware.git
   cd Protectli-UPS-Firmware
   

2. 初始化west工具和项目：

   west init -m . --mr main
   

3. 更新项目依赖：

   west update
   

4. 编译ESP32应用程序：

   west build -b esp32_devkitc_wroom esp32-app --build-dir build/esp32
   

5. 编译RP2040应用程序：

   west build -b pl02_rp2040 rp2040-app --build-dir build/rp2040
   

6. 烧录ESP32应用程序：

   west flash --esp-device /dev/ttyUSBx --build-dir build/esp32
   

   请确保将/dev/ttyUSBx替换为你的ESP32设备对应的串行接口。

7. 烧录RP2040应用程序：

   west flash --runner jlink --build-dir build/rp2040
   

   如果没有JLink编程器，可以使用以下命令：

   sudo picotool load build/rp2040/zephyr/zephyr.elf
   

8. 对于STM32应用程序，需要初始化和更新子模块，然后编译和烧录：

   git submodule init
   git submodule update
   cd stm32-app
   make
   make flash
   

完成以上步骤后，Protectli UPS固件应当被成功安装并配置到你的开发板上。你可以按照项目文档进行进一步的测试和配置。