按這個步驟 STM32即可完美控制 NeoPixels
加入技術(shù)交流群
問：玩轉(zhuǎn)STM32 - 使用 STM32 來控制 NeoPixels
目前，諸如 Arduino 和 Feather 等高級開發(fā)平臺已經(jīng)提供了出色的支持，可以通過易于使用的庫和普遍使用的示例代碼與NeoPixel LED 、燈帶、矩陣 等相連接。然而，更高級的平臺（例如 STM32 開發(fā)板 ）通常缺乏相同水平的支持。因此，希望將NeoPixels整合到項目中的 開發(fā)人員需要全面了解NeoPixel通信協(xié)議以及如何克服它所帶來的挑戰(zhàn)。
NeoPixels
Adafruit 推出的極受歡迎的可尋址全彩LED燈“NeoPixels”系列分為RGB和RGBW兩個種類。盡管二者都將紅、綠和藍色LED與驅(qū)動器芯片相集成，但RGBW組件還集成了第四個純白色的LED?？梢允褂妙愃频膯尉€串行接口來控制這兩種類型的NeoPixel，其時間值和數(shù)據(jù)結(jié)構(gòu)僅存在微小的差異。
WS2812
RGB NeoPixels實際上是WS2812智能控制LED，包括數(shù)據(jù)信號輸入引腳（DIN）和數(shù)據(jù)信號輸出引腳（DOUT）。這允許多個LED級聯(lián)并且只用一個數(shù)據(jù)線進行控制。鏈中的第一個LED負責(zé)處理從MCU接收到的前三個字節(jié)數(shù)據(jù)，然后將后續(xù)的數(shù)據(jù)簡單地轉(zhuǎn)發(fā)給DOUT引腳，該引腳可以連接到另一個LED的DIN引腳。LED將以此方式繼續(xù)向下傳遞數(shù)據(jù)，直到它們接收到復(fù)位信號為止（即，DIN線在一段時間內(nèi)持續(xù)保持低電平狀態(tài)）。傳輸?shù)淖止?jié)按照圖1所示的協(xié)議進行組織。第一個字節(jié)（G7-G0）表示綠色LED的8位PWM強度，其中0x00是完全關(guān)閉，0xFF是完全打開。類似地，第二個字節(jié)（R7-R0）用于控制紅色LED的強度，第三個字節(jié)（B7-B0）用于控制藍色LED的強度。
圖 1 ： WS2812 LED的3字節(jié)數(shù)據(jù)協(xié)議的結(jié)構(gòu)
這些24位數(shù)據(jù)都是通過改變方波的脈沖寬度來進行編碼的，如圖2所示。請注意，無論發(fā)送代碼0還是代碼1，方波的周期仍保持在1.25μs。對于WS2812，使數(shù)據(jù)線保持低電平至少50μs即可生成復(fù)位信號。另請注意，圖2中顯示的計時值具有±0.15μs的公差。
圖2：WS2812 LED的0和1位的計時圖
一種截然不同的組件，NeoPixels的RGBW種類實際上是SK6812智能控制LED，采用與WS2812 LED相同的運作原理。然而，由于它們包含第四個LED，因此實施了圖3所示的4字節(jié)數(shù)據(jù)協(xié)議。與圖1相比，唯一的區(qū)別在于數(shù)據(jù)的串聯(lián)字節(jié)（W7-W0），該字節(jié)指定了白色LED的8位PWM強度。
圖 3 ： SK6812 LED的4字節(jié)數(shù)據(jù)協(xié)議的結(jié)構(gòu)。
圖4展示了SK6812控制信號的時間值，同樣與WS2812略有差別（不過仍在±0.15μs的公差范圍內(nèi)）。請注意，這兩種代碼的方波周期均保持不變，都為1.2μs。此外，SK6812的復(fù)位信號長度為80μs ，而非50μs。
圖4：SK6812 LED的0位和1位的計時圖。
步驟
由于NeoPixel的控制信號對計時要求非常嚴格，因此除非使用匯編語言，否則無法通過簡單的比特帶寬方法產(chǎn)生此信號。雖然還有許多其他方法可以利用各種MCU外設(shè)、外部硬件或其組合來生成該信號，但其中最直接的方法是配置MCU定時器來生成PWM輸出信號。這是因為，如上一部分中所述，NeoPixel控制信號只是一種固定頻率的PWM信號，采用不同的占空比表示0位和1位。為了以與傳輸協(xié)議相同的速率高效地在這兩個占空比之間進行切換，還必須配置DMA流來管理更新。盡管這種方法可能是內(nèi)存效率最低的方式，但它易于理解、CPU高效并且易于實施（得益于STM32Cube環(huán)境）。
以下應(yīng)用程式利用STM32CubeIDE（版本1.8.0）、NUCLEO-F401RE開發(fā)板和RGBW 5x8 NeoPixel Shield實現(xiàn)上述的方法。不過，這些步驟可以輕松地推廣到任何STM32 MCU/板和NeoPixel產(chǎn)品上。假定我們已經(jīng)創(chuàng)建了一個STM32CubeIDE項目。如需使用其他IDE，你可以改為使用獨立的STM32CubeMX代碼配置器工具，將項目導(dǎo)出到所需的開發(fā)平臺上。
1.配置PWM
a. 先打開STM32CubeMX配置.ioc 文件（如果還未打開的話）。隨后，STM32CubeIDE將切換到*器件配置工具（*Device Configuration Tool ） 視圖，供你配置MCU。
b. 將定時器通道備用功能分配給選定的GPIO引腳，以與NeoPixel進行連接。所選定時器通道應(yīng)該能夠生成PWM輸出。圖5顯示了我的項目中的相關(guān)部分，我選擇了引腳PB10，并將它分配給定時器2、通道3（TIM2_CH3）功能。
圖5：將連接到DIN的GPIO引腳配置為定時器通道
c. 從左側(cè)的組件列表中選擇上一步中確定的定時器外設(shè)，以打開模式和配置（*Mode and Configuration ） 面板。在模式（*Mode ） 面板中，選擇“內(nèi)部時鐘”作為時鐘源，并從適當(dāng)?shù)亩〞r器通道的下拉列表中選擇“PWM生成CHx”。在圖6中，定時器2、通道3已設(shè)為“PWM生成CH3”模式，因為我在上一步中選擇了TIM2_CH3備用功能。請注意，在完成此步驟后，關(guān)聯(lián)的GPIO引腳應(yīng)在引腳排列視圖中從黃色變?yōu)榫G色。
d. 在定時器的*配置（*Configuration ） 面板中，驗證“預(yù)分頻器”和“脈沖”值是否都設(shè)置為0。計數(shù)器周期，即自動重載寄存器（ARR），需要進行設(shè)置以得到所需的PWM周期（如果使用RGB WS2812 LED，則為1.25μs；如果使用RGBW SK6812 LED，則為1.2μs）。這將取決于定時器外設(shè)輸入的速率。只需將所需的PWM周期除以時鐘周期，并減去1即可得到此值（減去1是因為定數(shù)器從0開始）。就我的器件而言，該公式得出的ARR值為99.8，我將其四舍五入為100（圖6）。請參見下文，了解有關(guān)計算理想ARR值的詳細說明。
圖6：將所選定時器通道配置為PWM輸出
計算ARR值
假設(shè)定時器“預(yù)分頻器”值設(shè)為0，可以很容易的計算出ARR值
具體來說，ARR值等于PWM信號周期除以定時器外設(shè)的時鐘信號周期。我們知道，根據(jù)使用的NeoPixel類型不同，TPWM可以是1.25μs或1.2μs（例如本例中，TPWM=1.2μs）。要確定Ttimer，你需要查閱器件的規(guī)格書，確定定時器外設(shè)連接到哪個總線。規(guī)格書可以在ST的網(wǎng)站上找到或STM32CubeIDE會隨附提供：選擇幫助>目標器件文檔和資源（ Help > Target Device Docs and Resources ） 。然后，在MCU 選項卡下選擇規(guī)格書，如圖7所示。
圖 7 ： 查找器件規(guī)格書
在我使用的MCU（STM32F401RE）規(guī)格書中，器件框圖中顯示我的定時器（TIM2）已連接到APB1（見圖8）。
圖 8 ： STM32F401xD/xE的部分框圖（源自DS10086）
圖9介紹了：通過切換到STM32CubeIDE中的*時鐘配置（*Clock Configuration）選項卡，我們可以發(fā)現(xiàn)TIM2的時鐘頻率為84MHz
圖 9 ： 確定定時器時鐘頻率
因此，
為了使PWM周期盡可能接近NeoPixel控制信號的周期，我們四舍五入至最接近的整數(shù)并得到 ARR=100 。
2.配置DMA
a. 從組件列表中選擇DMA外設(shè)。
b. 在配置（Configuration） 面板的DMA1 選項卡下，點擊添加 （ Add ） 按鈕。在下拉菜單中，選擇你的定時器/通道組合。在我的項目中，我選擇了“TIM2_CH3/UP”。
c. 針對該新的DMA請求，將方向改為“內(nèi)存到外設(shè)”。
d. 同時，將優(yōu)先級改為“非常高”。
e. 驗證默認的DMA請求設(shè)置是否與圖10中顯示的相匹配。
f. 保存.ioc 文件，以生成項目代碼。
圖 10 ： 配置DMA流，以便有效更新PWM信號的占空比
3.編寫代碼
在main.c 文件中，按從上到下的順序編寫，本部分展示了一個簡單的示例應(yīng)用，用于測試NeoPixel LED的全彩能力。此處提供了兩個版本的main() 函數(shù)，一個用于RGB WS2818 LED，另一個用于RGBW SK6812 LED。
a. 在main.c 文件的私有typedef部分，你可以創(chuàng)建一個新的數(shù)據(jù)類型，以便輕松訪問單個LED顏色值以及整個NeoPixel數(shù)據(jù)結(jié)構(gòu)（如圖1和圖3所示）。列表1提供了RGB和RGBW NeoPixel組件的typedef。此代碼應(yīng)粘貼在/* USER CODE BEGIN PTD */ 和/* USER CODE END PTD */ 注釋之間。
列表 1 ： 為RGB WS2812和RGBW SK6812 LED自定義數(shù)據(jù)類型
typedef union
{
struct
{
uint8_t b;
uint8_t r;
uint8_t g;
} color;
uint32_t data;
} PixelRGB_t;
typedef union
{
struct
{
uint8_t w;
uint8_t b;
uint8_t r;
uint8_t g;
} color;
uint32_t data;
} PixelRGBW_t;
b. 更改“脈沖”寄存器（也稱為CCRx）的值，這樣可以改變PWM波形的占空比。因此，我們必須計算適當(dāng)?shù)腃CRx值，以實現(xiàn)使用的NeoPixels所需的代碼0和代碼1方波（無論是在圖2還是圖4中所示的那些）。對于RGB WS2812 LED，這些值計算如下：
ZERO=(ARR+1)(0.32)
ONE=(ARR+1)(0.64)
對于RGBW SK6812 LED，其計算過程稍有不同。
ZERO=(ARR+1)(0.25)
ONE=(ARR+1)(0.5)
當(dāng)然，這些計算出的值應(yīng)該四舍五入到最接近的整數(shù)。在 main.c 文件的私有定義部分，為每個值創(chuàng)建一個#define指令（請參見以下圖11中的示例）。
c. 除了CCRx值之外，還應(yīng)在私有定義部分中定義控制的NeoPixel LED數(shù)量和DMA緩沖區(qū)大小。如圖11所示，只需將LED的數(shù)量乘以相應(yīng)的NeoPixel數(shù)據(jù)結(jié)構(gòu)中的位數(shù)即可（回想圖1和圖3）。還必須分配一個額外的緩沖區(qū)元素，因為最后一個CCRx值應(yīng)為零（復(fù)位信號）。
圖 11 ： WS2812和SK6812 LED的私有定義
d. 將列表2中提供的DMA完成回調(diào)函數(shù)添加到/* USER CODE BEGIN 0 /和/ USER CODE END 0*/之間的私有用戶代碼部分。務(wù)必將 TIM_CHANNEL_x 更改為步驟1c中配置的通道。
列表 2 ： HAL_TIM_PWM_PulseFinishedCallback() 函數(shù)的實施
void HAL_TIM_PWM_PulseFinishedCallback(TIM_HandleTypeDef *htim)
{
HAL_TIM_PWM_Stop_DMA(htim, TIM_CHANNEL_x);
}
e. 最后，必須將應(yīng)用代碼添加到main() 函數(shù)中。列表3提供了一個使用WS2812 LED的示例main() 函數(shù)，而列表4提供了使用SK6812 LED的類似示例main() 函數(shù)。請注意，HAL_TIM_PWM_Start_DMA() 函數(shù)的TIM_CHANNEL_x 參數(shù)必須再次進行修改，以匹配步驟1c中配置的通道。
列表 3 ： RGB WS2812 LED的示例main() 函數(shù)
int main(void)
{
/* USER CODE BEGIN 1 */
PixelRGB_t pixel[NUM_PIXELS] = {0};
uint32_t dmaBuffer[DMA_BUFF_SIZE] = {0};
uint32_t *pBuff;
int i, j, k;
uint16_t stepSize;
/* USER CODE END 1 */
/* MCU Configuration--------------------------------------------------------*/
/* Reset of all peripherals, Initializes the Flash interface and the Systick. */
HAL_Init();
/* USER CODE BEGIN Init */
/* USER CODE END Init */
/* Configure the system clock */
SystemClock_Config();
/* USER CODE BEGIN SysInit */
/* USER CODE END SysInit */
/* Initialize all configured peripherals */
MX_GPIO_Init();
MX_USART2_UART_Init();
MX_DMA_Init();
MX_TIM2_Init();
/* USER CODE BEGIN 2 */
/* USER CODE END 2 */
/* Infinite loop */
/* USER CODE BEGIN WHILE */
k = 0;
stepSize = 4;
while (1)
{
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
for (i = (NUM_PIXELS - 1); i > 0; i--)
{
pixel[i].data = pixel[i-1].data;
}
if (k < 255)
{
pixel[0].color.g = 254 - k; //[254, 0]
pixel[0].color.r = k + 1; //[1, 255]
pixel[0].color.b = 0;
}
else if (k < 510)
{
pixel[0].color.g = 0;
pixel[0].color.r = 509 - k; //[254, 0]
pixel[0].color.b = k - 254; //[1, 255]
j++;
}
else if (k < 765)
{
pixel[0].color.g = k - 509; //[1, 255];
pixel[0].color.r = 0;
pixel[0].color.b = 764 - k; //[254, 0]
}
k = (k + stepSize) % 765;
// not so bright
pixel[0].color.g >>= 2;
pixel[0].color.r >>= 2;
pixel[0].color.b >>= 2;
pBuff = dmaBuffer;
for (i = 0; i < NUM_PIXELS; i++)
{
for (j = 23; j >= 0; j--)
{
if ((pixel[i].data >> j) & 0x01)
{
*pBuff = NEOPIXEL_ONE;
}
else
{
*pBuff = NEOPIXEL_ZERO;
}
pBuff++;
}
}
dmaBuffer[DMA_BUFF_SIZE - 1] = 0; // last element must be 0!
HAL_TIM_PWM_Start_DMA(&htim2, TIM_CHANNEL_x, dmaBuffer, DMA_BUFF_SIZE);
HAL_Delay(10);
}
/* USER CODE END 3 */
}
列表 4 ： RGBW SK6812 LED的示例main() 函數(shù)
int main(void)
{
/* USER CODE BEGIN 1 */
PixelRGBW_t pixel[NUM_PIXELS] = {0};
uint32_t dmaBuffer[DMA_BUFF_SIZE] = {0};
uint32_t *pBuff;
int i, j, k;
uint16_t stepSize;
/* USER CODE END 1 */
/* MCU Configuration--------------------------------------------------------*/
/* Reset of all peripherals, Initializes the Flash interface and the Systick. */
HAL_Init();
/* USER CODE BEGIN Init */
/* USER CODE END Init */
/* Configure the system clock */
SystemClock_Config();
/* USER CODE BEGIN SysInit */
/* USER CODE END SysInit */
/* Initialize all configured peripherals */
MX_GPIO_Init();
MX_USART2_UART_Init();
MX_DMA_Init();
MX_TIM2_Init();
/* USER CODE BEGIN 2 */
/* USER CODE END 2 */
/* Infinite loop */
/* USER CODE BEGIN WHILE */
k = 0;
stepSize = 4;
while (1)
{
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
for (i = (NUM_PIXELS - 1); i > 0; i--)
{
pixel[i].data = pixel[i-1].data;
}
if (k < 255)
{
pixel[0].color.g = 254 - k; //[254, 0]
pixel[0].color.r = k + 1; //[1, 255]
pixel[0].color.b = 0;
pixel[0].color.w = 0;
}
else if (k < 510)
{
pixel[0].color.g = 0;
pixel[0].color.r = 509 - k; //[254, 0]
pixel[0].color.b = k - 254; //[1, 255]
pixel[0].color.w = 0;
j++;
}
else if (k < 765)
{
pixel[0].color.g = 0;
pixel[0].color.r = 0;
pixel[0].color.b = 764 - k; //[254, 0]
pixel[0].color.w = k - 509; //[1, 255]
}
else if (k < 1020)
{
pixel[0].color.g = k - 764; //[1, 255]
pixel[0].color.r = 0;
pixel[0].color.b = 0;
pixel[0].color.w = 1019 - k; //[254, 0]
}
k = (k + stepSize) % 1020;
// 50% brightness
pixel[0].color.g >>= 2;
pixel[0].color.r >>= 2;
pixel[0].color.b >>= 2;
pixel[0].color.w >>= 2;
pBuff = dmaBuffer;
for (i = 0; i < NUM_PIXELS; i++)
{
for (j = 31; j >= 0; j--)
{
if ((pixel[i].data >> j) & 0x01)
{
*pBuff = NEOPIXEL_ONE;
}
else
{
*pBuff = NEOPIXEL_ZERO;
}
pBuff++;
}
}
dmaBuffer[DMA_BUFF_SIZE - 1] = 0; // last element must be 0!
HAL_TIM_PWM_Start_DMA(&htim2, TIM_CHANNEL_x, dmaBuffer, DMA_BUFF_SIZE);
HAL_Delay(10);
}
/* USER CODE END 3 */
}
該項目現(xiàn)在應(yīng)該能夠成功構(gòu)建，并支持你在器件上運行代碼了。
結(jié)論
使用邏輯分析儀捕獲了上面提供的RGB和RGBW配置生成的控制信號。分別如圖12和圖13中所示。請注意，它們與圖2和圖4中指定的預(yù)期輸出相匹配。
圖 12 ： 生成的WS2812控制信號（正在發(fā)送0b0011……）
圖 13 ： 生成的SK6812控制信號（正在發(fā)送0b0010……）
*博客內(nèi)容為網(wǎng)友個人發(fā)布，僅代表博主個人觀點，如有侵權(quán)請聯(lián)系工作人員刪除。
