以下是一个基于STM32的按键控制流水灯方向变化的实现代码（使用HAL库），包含详细的中文注释：

#include "main.h"

// 定义LED引脚 (以GPIOA为例，实际根据电路修改)
#define LED_PORT GPIOA
const uint16_t LED_PINS[] = {
    GPIO_PIN_0, GPIO_PIN_1, GPIO_PIN_2, GPIO_PIN_3,
    GPIO_PIN_4, GPIO_PIN_5, GPIO_PIN_6, GPIO_PIN_7
};
#define LED_COUNT 8)

// 定义按键引脚 (以GPIOB的PIN0为例)
#define KEY_PIN GPIO_PIN_0
#define KEY_PORT GPIOB

// 全局变量
uint8_t direction = 0; // 0=从左到右, 1=从右到左
uint8_t current_led = 0; // 当前点亮LED位置

int main(void) {
    HAL_Init();
    SystemClock_Config();

    // 初始化LED GPIO为推挽输出
    GPIO_InitTypeDef gpio = {0};
    gpio.Pin = 0x00FF; // PA0-PA7
    gpio.Mode = GPIO_MODE_OUTPUT_PP;
    gpio.Pull = GPIO_NOPULL;
    gpio.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(LED_PORT, &gpio);

    // 初始化按键GPIO为输入模式（带上拉）
    gpio.Pin = KEY_PIN;
    gpio.Mode = GPIO_MODE_INPUT;
    gpio.Pull = GPIO_PULLUP;
    HAL_GPIO_Init(KEY_PORT, &gpio);

    // 初始关闭所有LED
    HAL_GPIO_WritePin(LED_PORT, 0x00FF, GPIO_PIN_SET);

    while (1) {
        // 检测按键按下（低电平有效）
        if (HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) == GPIO_PIN_RESET) {
            HAL_Delay(20); // 消抖延时
            if (HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) == GPIO_PIN_RESET) {
                // 切换方向
                direction = !direction;
                // 等待按键释放
                while (HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) == GPIO_PIN_RESET);
            }
        }

        // 关闭当前LED
        HAL_GPIO_WritePin(LED_PORT, LED_PINS[current_led], GPIO_PIN_SET);

        // 根据方向更新位置
        if (direction == 0) {
            current_led = (current_led + 1) % LED_COUNT; // 向右移动
        } else {
            current_led = (current_led == 0) ? LED_COUNT - 1 : current_led - 1; // 向左移动
        }

        // 点亮新LED
        HAL_GPIO_WritePin(LED_PORT, LED_PINS[current_led], GPIO_PIN_RESET);

        HAL_Delay(200); // 流水灯速度控制
    }
}

// 系统时钟配置函数（需根据实际MCU型号实现）
void SystemClock_Config(void) {
    // 此处添加你的时钟配置代码
    // 例: 使用HSI时钟
    RCC_OscInitTypeDef osc = {0};
    osc.OscillatorType = RCC_OSCILLATORTYPE_HSI;
    osc.HSIState = RCC_HSI_ON;
    osc.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT;
    HAL_RCC_OscConfig(&osc);

    RCC_ClkInitTypeDef clk = {0};
    clk.ClockType = RCC_CLOCKTYPE_SYSCLK;
    clk.SYSCLKSource = RCC_SYSCLKSOURCE_HSI;
    clk.AHBCLKDivider = RCC_SYSCLK_DIV1;
    clk.APB1CLKDivider = RCC_HCLK_DIV1;
    HAL_RCC_ClockConfig(&clk, FLASH_LATENCY_0);
}

关键说明：

1. 硬件连接：

   • LED：连接在GPIOA0~GPIOA7（低电平点亮）
   • 按键：连接在GPIOB0（按下为低电平，内部上拉）

2. 功能逻辑：

   • 初始状态：LED从左向右流动（PA0→PA1→...→PA7）
   • 每次按下按键：流水方向反转
   • 按键带消抖处理（20ms延时）

3. 自定义调整：

   • 修改：调整LED_PINS数组和LED_COUNT
   • 速度修改：调整HAL_Delay(200)中的延时值
   • 电平逻辑：若LED高电平点亮，将GPIO_PIN_SET和GPIO_PIN_RESET互换

4. 时钟配置：

   • 需要根据实际使用的STM32型号补充SystemClock_Config()内容
   • 示例中使用内部HSI时钟（8MHz）

注意：实际使用时需在STM32CubeMX中配置引脚，或手动修改为实际使用的GPIO引脚。