概況
本文檔主要介紹智能彩燈五路產品原型的應用代碼部分，關于環境搭建、SDK移植、下載調試。

步驟

第 1 步：下載驗證
?

ST Nucleo，按鍵1長按為配網，指示燈旁黑色按鍵為開發板復位口，USB為程序下載口。

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

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

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

注意:為防止電腦 USB 供電不足導致下載完成后，開發板不斷重啟，推薦使用獨立電源板供電，或者，下載時將 RGB 板取下，下載完成后再接上。
?

第 2 步：程序實現

開發者需要重點關注三個函數setup（），loop（）與 dp_download_handle（）

1.setup（）函數用于執行一些初始化內容，只執行一次

void setup() {
??pinMode(PC13, INPUT);? ???//配網初始化
??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初始化用于驅動RGB燈
??delay(10);
??rgb_init(0, 0, 0);? ? ? ? ? ? ? ?
??wifi_protocol_init();? ? ? ? ? ? ? ? //協議串口初始化函數
??timer_init();? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? //定時器初始化
??Hue_shade_start(&a);
}


2.loop（）函數將會循環執行函數體中的內容

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

/*****************************************************************************
??函數名稱 : dp_download_handle
??功能描述 : dp下發處理函數
??輸入參數 : dpid:DP序號
? ?? ?? ???value:dp數據緩沖區地址
? ?? ?? ???length:dp數據長度
??返回參數 : 成功返回:SUCCESS/失敗返回:ERRO
??使用說明 : 該函數用戶不能修改
*****************************************************************************/
unsigned char dp_download_handle(unsigned char dpid, const unsigned char value[], unsigned short length)
{
??/*********************************
? ? 當前函數處理可下發/可上報數據調用
? ? 具體函數內需要實現下發數據處理
? ? 完成用需要將處理結果反饋至APP端,否則APP會認為下發失敗
??***********************************/
??unsigned char ret;
??printf("dpid = %d ", dpid);
??switch (dpid)
??{
? ? case DPID_SWITCH_LED:
? ?? ?//開關處理函數
? ?? ?ret = dp_download_switch_led_handle(value, length);
? ?? ?break;
? ? case DPID_WORK_MODE:
? ?? ?//模式處理函數
? ?? ?ret = dp_download_work_mode_handle(value, length);
? ?? ?break;
? ? case DPID_BRIGHT_VALUE:
? ?? ?//白光亮度處理函數
? ?? ?ret = dp_download_bright_value_handle(value, length);
? ?? ?break;
? ? case DPID_TEMP_VALUE:
? ?? ?//白光色溫處理函數
? ?? ?ret = dp_download_temp_value_handle(value, length);
? ?? ?break;
? ? case DPID_COLOUR_DATA:
? ?? ?//彩光顏色處理函數
? ?? ?ret = dp_download_colour_data_handle(value, length);
? ?? ?break;
? ? case DPID_CONTROL_DATA:
? ?? ?//調節處理函數
? ?? ?ret = dp_download_control_data_handle(value, length);
? ?? ?break;

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


3.dp_download_handle（）主要用于處理由云端下發的DP數據，開發者需要根據相應的DP下發實現相應的功能

/*****************************************************************************
??函數名稱 : dp_download_handle
??功能描述 : dp下發處理函數
??輸入參數 : dpidDP序號

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

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

云端下發的顏色數據為 HSV 格式我們需要將其轉化為 RGB 格式，并對 RGB 數據修正，即得到正確的 RGB 值供顯示

RGB 調光部分幾個重要API:
?

lw