概況
本文檔主要介紹智能彩燈五路產(chǎn)品原型的應(yīng)用代碼部分，關(guān)于環(huán)境搭建、SDK移植、下載調(diào)試。

步驟

第 1 步：下載驗(yàn)證
?

ST Nucleo，按鍵1長(zhǎng)按為配網(wǎng)，指示燈旁黑色按鍵為開(kāi)發(fā)板復(fù)位口，USB為程序下載口。

涂鴉三明治（PWM）照明功能板

涂鴉三明治 Wi-Fi MCU 通信板（E3S）

連接方式如下：（從上到下依次為：涂鴉三明治（PWM）照明功能板，ST Nucleo，涂鴉三明治 Wi-Fi MCU 通信板（E3S））

注意:為防止電腦 USB 供電不足導(dǎo)致下載完成后，開(kāi)發(fā)板不斷重啟，推薦使用獨(dú)立電源板供電，或者，下載時(shí)將 RGB 板取下，下載完成后再接上。
?

第 2 步：程序?qū)崿F(xiàn)

開(kāi)發(fā)者需要重點(diǎn)關(guān)注三個(gè)函數(shù)setup（），loop（）與 dp_download_handle（）

1.setup（）函數(shù)用于執(zhí)行一些初始化內(nèi)容，只執(zhí)行一次

void setup() {
??pinMode(PC13, INPUT);? ???//配網(wǎng)初始化
??mySerial.begin(9600);? ???//軟件串口初始化
??mySerial.println("myserial init successful!");
??Serial.begin(115200);? ???//PA3 RX? ?PA2 TX
??Serial.println("serial init successful! ");
??light_data_int();? ? ? ? ? ? ? ? ? ? ? ? //RGB冷暖燈初始化
??IIC_Init();? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? //IIC初始化用于驅(qū)動(dòng)RGB燈
??delay(10);
??rgb_init(0, 0, 0);? ? ? ? ? ? ? ?
??wifi_protocol_init();? ? ? ? ? ? ? ? //協(xié)議串口初始化函數(shù)
??timer_init();? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? //定時(shí)器初始化
??Hue_shade_start(&a);
}


2.loop（）函數(shù)將會(huì)循環(huán)執(zhí)行函數(shù)體中的內(nèi)容

void loop() {
??if (init_flag == 0) {
? ? time_cnt++;
? ? if (time_cnt % 6000 == 0) {
? ?? ?time_cnt = 0;
? ?? ?cnt ++;
? ? }
? ? wifi_stat_led(&cnt);? ?? ? ? ? //WI-FI狀態(tài)處理
??}
??wifi_uart_service();? ? ? ? ? ? ? ? //WI-FI串口處理服務(wù)
??myserialEvent();? ?? ?? ?? ? ? ? //串口接收處理
??key_scan();? ?? ?? ?? ?? ?//重置配網(wǎng)按鍵檢測(cè)
}

/*****************************************************************************
??函數(shù)名稱 : dp_download_handle
??功能描述 : dp下發(fā)處理函數(shù)
??輸入?yún)?shù) : dpid:DP序號(hào)
? ?? ?? ???value:dp數(shù)據(jù)緩沖區(qū)地址
? ?? ?? ???length:dp數(shù)據(jù)長(zhǎng)度
??返回參數(shù) : 成功返回:SUCCESS/失敗返回:ERRO
??使用說(shuō)明 : 該函數(shù)用戶不能修改
*****************************************************************************/
unsigned char dp_download_handle(unsigned char dpid, const unsigned char value[], unsigned short length)
{
??/*********************************
? ? 當(dāng)前函數(shù)處理可下發(fā)/可上報(bào)數(shù)據(jù)調(diào)用
? ? 具體函數(shù)內(nèi)需要實(shí)現(xiàn)下發(fā)數(shù)據(jù)處理
? ? 完成用需要將處理結(jié)果反饋至APP端,否則APP會(huì)認(rèn)為下發(fā)失敗
??***********************************/
??unsigned char ret;
??printf("dpid = %d ", dpid);
??switch (dpid)
??{
? ? case DPID_SWITCH_LED:
? ?? ?//開(kāi)關(guān)處理函數(shù)
? ?? ?ret = dp_download_switch_led_handle(value, length);
? ?? ?break;
? ? case DPID_WORK_MODE:
? ?? ?//模式處理函數(shù)
? ?? ?ret = dp_download_work_mode_handle(value, length);
? ?? ?break;
? ? case DPID_BRIGHT_VALUE:
? ?? ?//白光亮度處理函數(shù)
? ?? ?ret = dp_download_bright_value_handle(value, length);
? ?? ?break;
? ? case DPID_TEMP_VALUE:
? ?? ?//白光色溫處理函數(shù)
? ?? ?ret = dp_download_temp_value_handle(value, length);
? ?? ?break;
? ? case DPID_COLOUR_DATA:
? ?? ?//彩光顏色處理函數(shù)
? ?? ?ret = dp_download_colour_data_handle(value, length);
? ?? ?break;
? ? case DPID_CONTROL_DATA:
? ?? ?//調(diào)節(jié)處理函數(shù)
? ?? ?ret = dp_download_control_data_handle(value, length);
? ?? ?break;

? ? default:
? ?? ?break;
??}
??return ret;
}


3.dp_download_handle（）主要用于處理由云端下發(fā)的DP數(shù)據(jù)，開(kāi)發(fā)者需要根據(jù)相應(yīng)的DP下發(fā)實(shí)現(xiàn)相應(yīng)的功能

/*****************************************************************************
??函數(shù)名稱 : dp_download_handle
??功能描述 : dp下發(fā)處理函數(shù)
??輸入?yún)?shù) : dpidDP序號(hào)

value:dp數(shù)據(jù)緩沖區(qū)地址
? ?? ?? ???length:dp數(shù)據(jù)長(zhǎng)度
??返回參數(shù) : 成功返回:SUCCESS/失敗返回:ERRO
??使用說(shuō)明 : 該函數(shù)用戶不能修改
*****************************************************************************/
unsigned char dp_download_handle(unsigned char dpid, const unsigned char value[], unsigned short length)
{
??/*********************************
? ? 當(dāng)前函數(shù)處理可下發(fā)/可上報(bào)數(shù)據(jù)調(diào)用
? ? 具體函數(shù)內(nèi)需要實(shí)現(xiàn)下發(fā)數(shù)據(jù)處理
? ? 完成用需要將處理結(jié)果反饋至APP端,否則APP會(huì)認(rèn)為下發(fā)失敗
??***********************************/
??unsigned char ret;
??printf("dpid = %d ", dpid);
??switch (dpid)
??{
? ? case DPID_SWITCH_LED:
? ?? ?//開(kāi)關(guān)處理函數(shù)
? ?? ?ret = dp_download_switch_led_handle(value, length);
? ?? ?break;
? ? case DPID_WORK_MODE:
? ?? ?//模式處理函數(shù)
? ?? ?ret = dp_download_work_mode_handle(value, length);
? ?? ?break;
? ? case DPID_BRIGHT_VALUE:
? ?? ?//白光亮度處理函數(shù)
? ?? ?ret = dp_download_bright_value_handle(value, length);
? ?? ?break;
? ? case DPID_TEMP_VALUE:
? ?? ?//白光色溫處理函數(shù)
? ?? ?ret = dp_download_temp_value_handle(value, length);
? ?? ?break;
? ? case DPID_COLOUR_DATA:
? ?? ?//彩光顏色處理函數(shù)
? ?? ?ret = dp_download_colour_data_handle(value, length);
? ?? ?break;
? ? case DPID_CONTROL_DATA:
? ?? ?//調(diào)節(jié)處理函數(shù)
? ?? ?ret = dp_download_control_data_handle(value, length);
? ?? ?break;

? ? default:
? ?? ?break;
??}
??return ret;
}
?

云端下發(fā)的顏色數(shù)據(jù)為 HSV 格式我們需要將其轉(zhuǎn)化為 RGB 格式，并對(duì) RGB 數(shù)據(jù)修正，即得到正確的 RGB 值供顯示

RGB 調(diào)光部分幾個(gè)重要API:
?

lw