Software_Architecture/facelightcontrol/README_faceLight.md

FaceLight 命令行控制工具

编译方法

# 使用新的CMakeLists.txt编译
mkdir build2
cd build2
cmake -f ../CMakeLists2.txt ..
make

# 编译完成后，可执行文件位于 bin/faceLightClient2

使用方法

基本语法

./bin/faceLightClient2 [选项]

可用选项

选项	长选项	参数	说明
-m	--mode	MODE	控制模式：all|single|cycle|custom|pattern
-c	--color	COLOR	颜色：red|green|blue|yellow|white|black
-i	--index	INDEX	LED索引（0-11），用于single模式
-d	--delay	DELAY	延时（毫秒），默认2000
-p	--pattern	PATTERN	自定义图案："0:red,1:green,2:blue"
-t	--times	TIMES	循环次数，默认无限
-h	--help		显示帮助信息

控制模式说明

1. all - 全部LED同色

所有LED使用相同颜色

./bin/faceLightClient2 -m all -c red          # 全部LED红色
./bin/faceLightClient2 -m all -c blue         # 全部LED蓝色

2. single - 单个LED控制

控制指定索引的单个LED

./bin/faceLightClient2 -m single -i 0 -c red    # LED 0 红色
./bin/faceLightClient2 -m single -i 5 -c green  # LED 5 绿色

3. cycle - 颜色循环

自动循环显示不同颜色

./bin/faceLightClient2 -m cycle                 # 无限循环
./bin/faceLightClient2 -m cycle -t 3            # 循环3次
./bin/faceLightClient2 -m cycle -d 1000 -t 5    # 每秒切换，循环5次

4. custom - RGB交替模式

原始示例程序的RGB交替模式

./bin/faceLightClient2 -m custom

5. pattern - 自定义图案

根据指定的图案设置不同LED

./bin/faceLightClient2 -m pattern -p "0:red,1:green,2:blue"
./bin/faceLightClient2 -m pattern -p "0:red,5:green,10:blue"

使用示例

# 1. 查看帮助
./bin/faceLightClient2 -h

# 2. 设置所有LED为红色
./bin/faceLightClient2 -m all -c red

# 3. 设置第0个LED为蓝色（其他关闭）
./bin/faceLightClient2 -m single -i 0 -c blue

# 4. 颜色循环，每1秒切换一次，循环10次
./bin/faceLightClient2 -m cycle -d 1000 -t 10

# 5. 自定义图案：0号红色，3号绿色，6号蓝色
./bin/faceLightClient2 -m pattern -p "0:red,3:green,6:blue"

# 6. RGB交替模式
./bin/faceLightClient2 -m custom

LED索引说明

机器狗面部LED索引范围：0-11

• 具体的LED位置映射请参考硬件文档

可用颜色

• red（红色）
• green（绿色）
• blue（蓝色）
• yellow（黄色）
• white（白色）
• black（黑色/关闭）

注意事项

1. 使用前确保已正确连接到机器狗系统
2. 确保libfaceLight_SDK_arm64.so库文件在lib目录中
3. 程序需要在机器狗系统上运行（ARM64架构）
4. 设置颜色后需要调用sendCmd()函数才能生效（程序已自动处理）