# LED-strip-server

**Repository Path**: ibdp/led-strip-server

## Basic Information

- **Project Name**: LED-strip-server
- **Description**: 通过java控制串口，串口控制LED控制器实现LED全彩灯带的控制程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-26
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LED灯带控制器项目

## 项目简介

本项目是一个基于Java和Vue的LED灯带控制器，支持控制WS2815 12V供电的灯带，实现各种灯光效果。

## 功能特性

- 亮度控制
- 固定颜色设置
- 颜色渐变效果
- 跑马灯效果
- 流水灯效果
- 追逐效果
- 关闭灯光

## 硬件要求

- LED灯带：WS2815 12V供电，114颗灯珠
- 串口控制器：232串口
- 电源：12V电源适配器

## 软件要求

- JDK 11+
- Maven 3.6+
- Node.js 14+
- Vue CLI 5+

## 项目结构

```
led-strip-server/
├── doc/                    # 文档文件夹
│   ├── 串口全彩灯带控制器使用手册v2.1.pdf
│   └── 串口全彩灯带控制器通信协议详解V2.1.pdf
├── frontend/               # 前端Vue项目
│   ├── src/
│   │   ├── main.js         # 前端入口文件
│   │   └── App.vue         # 主组件
│   └── package.json        # 前端依赖
├── src/                    # 后端Java项目
│   └── main/java/com/ledstrip/
│       ├── Application.java             # 应用主类
│       ├── controller/LedController.java  # REST控制器
│       ├── service/SerialService.java     # 串口服务
│       └── service/LedControllerService.java  # LED控制服务
└── pom.xml                 # 后端依赖
```

## 安装与运行

### 后端安装

1. 克隆项目到本地
2. 进入项目目录
3. 执行Maven构建：
   ```
   mvn clean package
   ```
4. 运行项目：
   ```
   java -jar target/led-strip-server-1.0-SNAPSHOT.jar
   ```

### 前端安装

1. 进入frontend目录
2. 安装依赖：
   ```
   npm install
   ```
3. 运行开发服务器：
   ```
   npm run serve
   ```

## 使用方法

1. 连接硬件：
   - 将LED灯带与控制器连接
   - 将控制器通过串口线连接到电脑

2. 启动后端服务：
   - 运行Java应用
   - 服务将在http://localhost:8080启动

3. 启动前端应用：
   - 运行Vue开发服务器
   - 访问http://localhost:8081

4. 控制灯光：
   - 在前端界面上调节各种参数
   - 点击相应的按钮启动不同的灯光效果

## 注意事项

1. 确保串口连接正确，默认使用第一个可用串口
2. 确保灯带供电充足，WS2815 12V灯带需要足够的电源
3. 调整效果时，注意速度参数的设置，值越小速度越快
4. 长时间运行时，注意控制器的散热

## API接口

- POST /api/led/brightness - 设置亮度
- POST /api/led/color - 设置固定颜色
- POST /api/led/gradient - 颜色渐变效果
- POST /api/led/running - 跑马灯效果
- POST /api/led/flowing - 流水灯效果
- POST /api/led/chase - 追逐效果
- POST /api/led/off - 关闭灯光

## 故障排查

1. 串口无法打开：
   - 检查串口线是否连接正确
   - 检查串口是否被其他程序占用

2. 灯光无反应：
   - 检查电源是否正常
   - 检查灯带连接是否正确
   - 检查串口通信是否正常

3. 效果异常：
   - 检查参数设置是否合理
   - 检查灯带数量设置是否正确

## 技术说明

- 后端使用Spring Boot框架，提供RESTful API
- 前端使用Vue 3框架，实现响应式界面
- 串口通信使用jSerialComm库
- 通信协议基于控制器的串口通信协议

## 许可证

本项目仅供个人学习使用，请勿用于商业用途。