PyCharm安装与配置全攻略：从下载到高效开发

遇到的大坑

spi一定要选 跳变沿选第二个2Edge模式因为跳变沿为 1 的话MOSI 的空闲电平为高电平为 2 的话则会延续上次发送的最后电平我们发送数据的末尾都是低电平这样 WS2812 不会误判

其实你的驱动波形根本不需要那么严格手册规定的时间以外还有余量我就是本来要求560ns-1us我就到·1us但是颜色不对丢数据了最后证实只是因为

中跳变沿选第二个2Edge模式没选对导致刚开始波形错误这也是最重要的你刚开始给高电平其实是真的会错以后遇到任何驱动只要你的时序差她手册的极限几纳秒一点都是没事的

手册有些人的是错的我去嘉立创拿的也是错的下次写驱动得多参考价看几份成功经历spi就行不用dma也可以因为最快就那样你使用dma可以节约cpu资源但对我来说没啥用gpionop也能驱动就是可能会有几率显示错误具体配置为内部时钟倍频到72m主频 spi 8分频产生波形参考代码/*! \file main.c \brief USART DMA receive by IDLE interrupt SPI驱动WS2812B \version

, V

3.

0, firmware update for GD32F1x0(x3,

*/ /* Copyright (c) 2025, GigaDevice Semiconductor Inc. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #include gd32f1x

h #include stdio.h #include gd32f1x0r_eval.h #include systick.h // // 类型定义 // typedef struct { uint8_t green; uint8_t red; uint8_t blue; } WS2812B_Color; // // 系统时钟配置 (72MHz) // #define SYSTEM_CLOCK 72000000 // 系统主频72MHz // // WS2812B SPI驱动配置 (72MHz系统时钟) // #define SPI_CLOCK_DIV SPI_PSC_8 // 预分频8得到9MHz SPI时钟 #define SPI_CLOCK_FREQ 9000000 // 9MHz SPI时钟 #define SPI_BIT_TIME_NS 111 // 每个SPI位约111ns // WS2812B SPI编码基于9MHz SPI时钟 #define WS2812B_SPI_0_CODE 0xC0 // 0码: 11000000 - 高电平222ns(2bits)低电平667ns(6bits) #define WS2812B_SPI_1_CODE 0xF8 // 1码: 11111000 - 高电平556ns(5bits)低电平333ns(3bits) #define WS2812B_SPI_RESET_US 300 // 复位时间300us #define WS2812B_SPI_RESET_BYTES 270 // // LED配置 // #define MAX_LED_COUNT 100 // 最大LED数量 #define DEFAULT_LED_COUNT 40 // 默认LED数量 // // 模式定义根据你的上位机调整 // #define MODE_STATIC_COLOR 0 // 静态颜色模式上位机当前使用 #define MODE_RAINBOW_BREATH 1 // 彩虹呼吸灯模式 #define MODE_RAINBOW_FLOW 2 // 彩虹流水灯模式 #define MODE_RAINBOW_WAVE 3 // 彩虹波浪模式 #define MODE_COLOR_WIPE 4 // 颜色扫除模式 #define MODE_THEATER_CHASE 5 // 剧场追逐模式 #define MODE_SINGLE_COLOR_BREATH 6 // 单色呼吸灯模式 // // 指令字节索引定义适配你的22字节指令 // #define CMD_HEADER_0 0 // DD #define CMD_HEADER_1 1 // 55 #define CMD_HEADER_2 2 // EE #define CMD_MODE_SELECT 3 // 模式选择你的上位机固定为00 #define CMD_EFFECT_SPEED 4 // 效果速度你的上位机固定为00 #define CMD_EFFECT_BRIGHTNESS 5 // 效果亮度你的上位机固定为00 #define CMD_EFFECT_PARAM1 6 // 参数1你的上位机固定为01 #define CMD_EFFECT_PARAM2 7 // 参数2你的上位机固定为00 #define CMD_EFFECT_PARAM3 8 // 参数3你的上位机固定为99 #define CMD_EFFECT_PARAM4 9 // 参数4你的上位机固定为01 #define CMD_EFFECT_PARAM5 10 // 参数5你的上位机固定为00 #define CMD_EFFECT_PARAM6 11 // 参数6你的上位机固定为00 #define CMD_EFFECT_PARAM7 12 // 参数7你的上位机固定为00 #define CMD_EFFECT_PARAM8 13 // 参数8你的上位机固定为03 #define CMD_EFFECT_PARAM9 14 // 参数9你的上位机固定为00 #define CMD_LED_COUNT 15 // LED数量你的指令索引15 #define CMD_COLOR_R 16 // 颜色R你的指令索引16 #define CMD_COLOR_G 17 // 颜色G你的指令索引17 #define CMD_COLOR_B 18 // 颜色B你的指令索引18 #define CMD_CHECKSUM_1 19 // 校验码1 AA #define CMD_CHECKSUM_2 20 // 校验码2 BB #define CMD_TOTAL_LENGTH 21 // 总指令长度你的指令是22字节 #define CMD_MIN_LENGTH 21 // 最小指令长度 // // 全局变量 // WS2812B_Color led_buffer[MAX_LED_COUNT]; uint8_t current_led_count DEFAULT_LED_COUNT; // 特效相关变量 uint8_t effect_mode MODE_STATIC_COLOR; // 当前模式 uint8_t effect_speed 30; // 特效速度(ms) uint8_t effect_brightness 150; // 特效亮度(0-

// 特效专用变量 uint8_t breath_direction 1; // 呼吸方向 0:减弱 1:增强 uint8_t breath_current_brightness 100; // 当前呼吸亮度 WS2812B_Color current_color {0, 255, 0}; // 当前颜色默认绿色 uint16_t rainbow_hue 0; // 色调 (0-

uint16_t flow_position 0; // 流水位置 uint16_t wave_offset 0; // 波浪偏移 uint8_t wipe_position 0; // 扫除位置 uint8_t theater_position 0; // 追逐位置 uint8_t theater_color_index 0; // 颜色索引 // 串口接收相关 uint8_t rxbuffer[256]; uint8_t rx_count 0; uint8_t receive_flag 0; // // 函数声明 // void dma_config(void); void usart_config(void); void nvic_config(void); void spi_ws2812b_config(void); void ws2812b_init(void); void ws2812b_set_led(uint16_t led_num, WS2812B_Color color); void ws2812b_update(void); void ws2812b_clear_all(void); void spi_send_data_blocking(uint8_t *data, uint32_t length); void ws2812b_color_to_spi(uint8_t r, uint8_t g, uint8_t b, uint8_t *spi_buffer); void ws2812b_send_pixel_spi(uint8_t r, uint8_t g, uint8_t b); void ws2812b_send_reset_spi(void); void ws2812b_update_spi(void); // 特效函数 WS2812B_Color hsv_to_rgb(uint16_t h, uint8_t s, uint8_t v); void rainbow_breathing_effect(void); void single_color_breathing_effect(void); void rainbow_flow_effect(void); void rainbow_wave_effect(void); void color_wipe_effect(void); void theater_chase_effect(void); void process_effects(void); // // WS2812B SPI配置函数 // void spi_ws2812b_config(void) { spi_parameter_struct spi_init_struct; // 启用GPIO和SPI时钟 rcu_periph_clock_enable(RCU_GPIOA); rcu_periph_clock_enable(RCU_SPI

; // 配置SPI引脚PA5SCK, PA7MOSI gpio_af_set(GPIOA, GPIO_AF_0, GPIO_PIN_5 | GPIO_PIN_

; gpio_mode_set(GPIOA, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO_PIN_5 | GPIO_PIN_

; gpio_output_options_set(GPIOA, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_5 | GPIO_PIN_

; // 初始化SPI spi_i2s_deinit(SPI

; spi_struct_para_init(spi_init_struct); spi_init_struct.trans_mode SPI_TRANSMODE_BDTRANSMIT; spi_init_struct.device_mode SPI_MASTER; spi_init_struct.frame_size SPI_FRAMESIZE_8BIT; spi_init_struct.clock_polarity_phase SPI_CK_PL_LOW_PH_2EDGE; spi_init_struct.nss SPI_NSS_SOFT; spi_init_struct.prescale SPI_CLOCK_DIV; spi_init_struct.endian SPI_ENDIAN_MSB; spi_init(SPI0, spi_init_struct); spi_enable(SPI

; } // // SPI数据发送函数 // void spi_send_data_blocking(uint8_t *data, uint32_t length) { for (uint32_t i 0; i length; i) { while(spi_i2s_flag_get(SPI0, SPI_FLAG_TBE) RESET); spi_i2s_data_transmit(SPI0, data[i]); } while(spi_i2s_flag_get(SPI0, SPI_FLAG_TRANS) RESET); } // // WS2812B颜色转换函数 // void ws2812b_color_to_spi(uint8_t r, uint8_t g, uint8_t b, uint8_t *spi_buffer) { uint32_t color ((uint32_t)g

| ((uint32_t)r

| b; uint8_t *ptr spi_buffer; for (int32_t i 23; i 0; i--) { if (color (1 i)) { *ptr WS2812B_SPI_1_CODE; } else { *ptr WS2812B_SPI_0_CODE; } } } // // WS2812B SPI驱动核心函数 // void ws2812b_send_pixel_spi(uint8_t r, uint8_t g, uint8_t b) { uint8_t spi_buffer[24]; ws2812b_color_to_spi(r, g, b, spi_buffer); spi_send_data_blocking(spi_buffer,

; } void ws2812b_send_reset_spi(void) { static uint8_t reset_buffer[WS2812B_SPI_RESET_BYTES] {0}; spi_send_data_blocking(reset_buffer, WS2812B_SPI_RESET_BYTES); } void ws2812b_update_spi(void) { for (uint16_t i 0; i current_led_count; i) { ws2812b_send_pixel_spi(led_buffer[i].red, led_buffer[i].green, led_buffer[i].blue); } ws2812b_send_reset_spi(); } // // HSV转RGB函数 // WS2812B_Color hsv_to_rgb(uint16_t h, uint8_t s, uint8_t v) { WS2812B_Color rgb {0, 0, 0}; uint8_t region, remainder, p, q, t; if (s

{ rgb.red v; rgb.green v; rgb.blue v; return rgb; } region h / 60; remainder (h %

* 4; p (v * (255 - s)) 8; q (v * (255 - ((s * remainder)

)) 8; t (v * (255 - ((s * (255 - remainder))

)) 8; switch (region) { case 0: rgb.red v; rgb.green t; rgb.blue p; break; case 1: rgb.red q; rgb.green v; rgb.blue p; break; case 2: rgb.red p; rgb.green v; rgb.blue t; break; case 3: rgb.red p; rgb.green q; rgb.blue v; break; case 4: rgb.red t; rgb.green p; rgb.blue v; break; default: rgb.red v; rgb.green p; rgb.blue q; break; } return rgb; } // // 彩虹呼吸灯效果 // void rainbow_breathing_effect(void) { rainbow_hue 1; if (rainbow_hue

{ rainbow_hue 0; } if (breath_direction) { breath_current_brightness 2; if (breath_current_brightness effect_brightness) { breath_direction 0; breath_current_brightness effect_brightness; } } else { breath_current_brightness - 2; if (breath_current_brightness

{ breath_direction 1; breath_current_brightness 50; } } WS2812B_Color rainbow_color hsv_to_rgb(rainbow_hue, 255, breath_current_brightness); for (uint16_t i 0; i current_led_count; i) { led_buffer[i] rainbow_color; } } // // 单色呼吸灯效果 // void single_color_breathing_effect(void) { if (breath_direction) { breath_current_brightness 2; if (breath_current_brightness effect_brightness) { breath_direction 0; breath_current_brightness effect_brightness; } } else { breath_current_brightness - 2; if (breath_current_brightness

{ breath_direction 1; breath_current_brightness 50; } } WS2812B_Color current_color_adj; current_color_adj.red (current_color.red * breath_current_brightness) / effect_brightness; current_color_adj.green (current_color.green * breath_current_brightness) / effect_brightness; current_color_adj.blue (current_color.blue * breath_current_brightness) / effect_brightness; for (uint16_t i 0; i current_led_count; i) { led_buffer[i] current_color_adj; } } // // 彩虹流水灯效果 // void rainbow_flow_effect(void) { flow_position; if (flow_position current_led_count) { flow_position 0; } WS2812B_Color black {0, 0, 0}; for (uint16_t i 0; i current_led_count; i) { led_buffer[i] black; } for (uint8_t i 0; i 3; i) { uint16_t pos (flow_position i) % current_led_count; uint16_t hue (rainbow_hue i *

% 360; WS2812B_Color color hsv_to_rgb(hue, 255, effect_brightness); led_buffer[pos] color; } rainbow_hue 3; if (rainbow_hue

{ rainbow_hue 0; } } // // 彩虹波浪效果 // void rainbow_wave_effect(void) { wave_offset 3; if (wave_offset

{ wave_offset 0; } for (uint16_t i 0; i current_led_count; i) { uint16_t hue (wave_offset i * 360 / current_led_count) % 360; WS2812B_Color color hsv_to_rgb(hue, 255, effect_brightness); led_buffer[i] color; } } // // 颜色扫除效果 // void color_wipe_effect(void) { wipe_position; if (wipe_position current_led_count) { wipe_position 0; } led_buffer[wipe_position] current_color; static uint8_t last_position 0; if (wipe_position ! last_position) { led_buffer[last_position] (WS2812B_Color){0, 0, 0}; last_position wipe_position; } } // // 剧场追逐效果 // void theater_chase_effect(void) { theater_position (theater_position

% 3; WS2812B_Color chase_colors[3] { {0, 255, 0}, // 绿色 {0, 0, 255}, // 蓝色 {255, 0, 0} // 红色 }; theater_color_index (theater_color_index

% 3; for (uint16_t i 0; i current_led_count; i) { if ((i theater_position) % 3

{ led_buffer[i] chase_colors[theater_color_index]; } else { led_buffer[i] (WS2812B_Color){0, 0, 0}; } } } // // 处理特效 // void process_effects(void) { switch (effect_mode) { case MODE_RAINBOW_BREATH: rainbow_breathing_effect(); break; case MODE_SINGLE_COLOR_BREATH: single_color_breathing_effect(); break; case MODE_RAINBOW_FLOW: rainbow_flow_effect(); break; case MODE_RAINBOW_WAVE: rainbow_wave_effect(); break; case MODE_COLOR_WIPE: color_wipe_effect(); break; case MODE_THEATER_CHASE: theater_chase_effect(); break; case MODE_STATIC_COLOR: default: return; } ws2812b_update(); } // // WS2812B用户API函数 // void ws2812b_init(void) { spi_ws2812b_config(); ws2812b_clear_all(); } void ws2812b_set_led(uint16_t led_num, WS2812B_Color color) { if (led_num 0 led_num current_led_count) { led_buffer[led_num - 1] color; } } void ws2812b_update(void) { ws2812b_update_spi(); } void ws2812b_clear_all(void) { WS2812B_Color black {0, 0, 0}; for (uint16_t i 0; i MAX_LED_COUNT; i) { led_buffer[i] black; } ws2812b_update(); } // // 串口DMA配置函数 // #define USART0_RDATA_ADDRESS ((uint32_t)USART_RDATA(USART

) void dma_config(void) { dma_parameter_struct dma_init_struct; rcu_periph_clock_enable(RCU_DMA); dma_deinit(DMA_CH

; dma_init_struct.direction DMA_PERIPHERAL_TO_MEMORY; dma_init_struct.memory_addr (uint32_t)rxbuffer; dma_init_struct.memory_inc DMA_MEMORY_INCREASE_ENABLE; dma_init_struct.memory_width DMA_MEMORY_WIDTH_8BIT; dma_init_struct.number 256; dma_init_struct.periph_addr (uint32_t)USART0_RDATA_ADDRESS; dma_init_struct.periph_inc DMA_PERIPH_INCREASE_DISABLE; dma_init_struct.periph_width DMA_PERIPHERAL_WIDTH_8BIT; dma_init_struct.priority DMA_PRIORITY_ULTRA_HIGH; dma_init(DMA_CH2, dma_init_struct); dma_circulation_disable(DMA_CH

; dma_channel_enable(DMA_CH

; } void usart_config(void) { rcu_periph_clock_enable(RCU_GPIOA); rcu_periph_clock_enable(RCU_USART

; gpio_af_set(GPIOA, GPIO_AF_1, GPIO_PIN_

; gpio_af_set(GPIOA, GPIO_AF_1, GPIO_PIN_

; gpio_mode_set(GPIOA, GPIO_MODE_AF, GPIO_PUPD_PULLUP, GPIO_PIN_

; gpio_output_options_set(GPIOA, GPIO_OTYPE_PP, GPIO_OSPEED_10MHZ, GPIO_PIN_

; gpio_mode_set(GPIOA, GPIO_MODE_AF, GPIO_PUPD_PULLUP, GPIO_PIN_

; gpio_output_options_set(GPIOA, GPIO_OTYPE_PP, GPIO_OSPEED_10MHZ, GPIO_PIN_

; usart_deinit(USART

; usart_baudrate_set(USART0, 115200U); usart_receive_config(USART0, USART_RECEIVE_ENABLE); usart_transmit_config(USART0, USART_TRANSMIT_ENABLE); usart_dma_receive_config(USART0, USART_DENR_ENABLE); usart_dma_transmit_config(USART0, USART_DENR_ENABLE); usart_enable(USART

; } void nvic_config(void) { nvic_irq_enable(USART0_IRQn, 0,

; } // // 主函数适配你的22字节指令 // int main(void) { systick_config(); nvic_config(); dma_config(); usart_config(); ws2812b_init(); ws2812b_clear_all(); while(RESET usart_flag_get(USART0, USART_FLAG_IDLE)); usart_flag_clear(USART0, USART_FLAG_IDLE); usart_interrupt_enable(USART0, USART_INT_IDLE); printf(\n\rWS2812B Driver Ready (22-byte command mode)\n\r); printf(Default command: DD 55 EE 00 00 00 01 00 99 01 00 00 00 03 00 [LED] [R] [G] [B] AA BB); while(

{ if(1 receive_flag) { // 检查指令长度是否为22字节 if (rx_count CMD_MIN_LENGTH) { // 检查数据头 if (rxbuffer[CMD_HEADER_0] 0xDD rxbuffer[CMD_HEADER_1] 0x55 rxbuffer[CMD_HEADER_2] 0xEE) { // 提取模式你的上位机固定为00 uint8_t mode rxbuffer[CMD_MODE_SELECT]; // 提取参数你的上位机固定值可暂时忽略 effect_speed rxbuffer[CMD_EFFECT_SPEED]; effect_brightness rxbuffer[CMD_EFFECT_BRIGHTNESS]; // 提取LED数量你的指令索引15 uint8_t new_led_count rxbuffer[CMD_LED_COUNT]; // 检查LED数量是否有效 if (new_led_count 0 new_led_count MAX_LED_COUNT) { current_led_count new_led_count; printf(LED count updated to: %d\n\r, current_led_count); } else { printf(Error: Invalid LED count: %d\n\r, new_led_count); } // 提取颜色值你的指令索引

uint8_t cmd_R rxbuffer[CMD_COLOR_R]; uint8_t cmd_G rxbuffer[CMD_COLOR_G]; uint8_t cmd_B rxbuffer[CMD_COLOR_B]; printf(Color: R%d, G%d, B%d\n\r, cmd_R, cmd_G, cmd_B); // 保存颜色 current_color.red cmd_R; current_color.green cmd_G; current_color.blue cmd_B; // 根据模式处理 effect_mode mode; if (mode MODE_STATIC_COLOR) { // 静态颜色模式 - 适配你的上位机 WS2812B_Color target_color {cmd_G, cmd_R, cmd_B}; // WS2812B使用GRB顺序 // 设置所有LED的颜色 for (uint16_t i 0; i current_led_count; i) { ws2812b_set_led(i 1, target_color); } // 更新LED显示 ws2812b_update(); printf(Static color mode applied\n\r); } else if (mode MODE_SINGLE_COLOR_BREATH) { // 单色呼吸灯模式 breath_current_brightness 100; breath_direction 1; printf(Single color breath mode activated\n\r); } else if (mode MODE_RAINBOW_BREATH) { // 彩虹呼吸灯模式 breath_current_brightness 100; breath_direction 1; rainbow_hue 0; printf(Rainbow breath mode activated\n\r); } else if (mode MODE_RAINBOW_FLOW) { // 彩虹流水灯模式 flow_position 0; rainbow_hue 0; printf(Rainbow flow mode activated\n\r); } else if (mode MODE_RAINBOW_WAVE) { // 彩虹波浪模式 wave_offset 0; printf(Rainbow wave mode activated\n\r); } else if (mode MODE_COLOR_WIPE) { // 颜色扫除模式 wipe_position 0; printf(Color wipe mode activated\n\r); } else if (mode MODE_THEATER_CHASE) { // 剧场追逐模式 theater_position 0; theater_color_index 0; printf(Theater chase mode activated\n\r); } else { // 未知模式默认使用静态颜色 effect_mode MODE_STATIC_COLOR; WS2812B_Color target_color {cmd_G, cmd_R, cmd_B}; for (uint16_t i 0; i current_led_count; i) { ws2812b_set_led(i 1, target_color); } ws2812b_update(); printf(Unknown mode %d, using static color\n\r, mode); } } else { printf(Error: Invalid data header: %02X %02X %02X\n\r, rxbuffer[0], rxbuffer[1], rxbuffer[2]); } } else { printf(Error: Received data too short: %d bytes (expected %d)\n\r, rx_count, CMD_MIN_LENGTH); } receive_flag 0; } // 处理特效模式 if (effect_mode ! MODE_STATIC_COLOR) { process_effects(); delay_1ms(effect_speed); } else { // 静态模式小延时 delay_1ms(

; } } } // // 串口输出重定向 // #ifdef GD_ECLIPSE_GCC int __io_putchar(int ch) { usart_data_transmit(EVAL_COM0, (uint8_t)ch); while(RESET usart_flag_get(EVAL_COM0, USART_FLAG_TBE)); return ch; } #else int fputc(int ch, FILE *f) { usart_data_transmit(EVAL_COM0, (uint8_t)ch); while(RESET usart_flag_get(EVAL_COM0, USART_FLAG_TBE)); return ch; } #endif /* GD_ECLIPSE_GCC */

100部黑客家庭监控视频软件官方版-100部黑客家庭监控视频软件官方版应用