通讀Docs - 《OPL1000 自學整理教程》

通讀Docs

新接觸任何一款MCU，沒有指導，自己摸索的情況下，第一件事情都應該是通讀參考文檔，參考文檔一般分爲Common的和Private的（我自己這麼分的），也就是通用型的，和專用型的。通用型的就是不論哪一個應用都會涉及到的，也就是基礎的。專用型的，一般是對一個Demo或程序進行的說明，一般不和通用型文檔放在一起。先讀通用型的，基本上文檔一打開簡單看看前言目錄，就知道是哪一類。

這篇就是整理一下第一次閱讀這些文檔的筆記。建議讀者自己閱讀做筆記，然後和我的對比，之後咱討論。有更好的筆記建議，也歡迎提出！

標記文本用來標記當前沒有理解，或者之後需要測試的功能

OPL1000-Adaptive-DTIM-Solution-Guide.pdf

看標題知道是講Adaptive DTIM 的，初期略看。有3個認知：
1， 設置/讀取DTIM的AT指令和API。
2， 可以設置Adaptive DTIM，其實並非自適應，而是可運行中修改設置。
3， 設置DTIM之後最好重新接入網絡，以使DTIM生效。

OPL1000-AT-instruction-set-and-examples.pdf

標題：與AT指令相關，初期略看，當遇到AT時，作爲工具書參考。

1， AT指令格式：

2， 基礎AT、WIFI相關AT、BLE相關AT。
3， 所以後續首先要嘗試列舉的各種AT指令，之後看其實現，再之後添加自己的AT指令使之生效，甚至可以單獨提取作爲模塊使用。

OPL1000-AT-UART-Switch-Command.pdf

1. 在 AT UART 打入“at+switchdbg” 可以改變 IO0 和 IO1 到 Debug UART。
2. 在 Debug UART 中， 打入“switchat” 可以改變 IO0 和 IO1 到 AT UART。
3. 介紹如何測試當前的Uart模式。
   4. 介紹如何開發的時候設置Uart功能：
   
   經實踐，以上方法並不好使，需要修改IO引腳定義：
   #define HAL_PIN_TYPE_IO_0 PIN_TYPE_UART1_TX
   #define HAL_PIN_TYPE_IO_1 PIN_TYPE_UART1_RX
   #define HAL_PIN_TYPE_IO_8 PIN_TYPE_UART_APS_TX
   #define HAL_PIN_TYPE_IO_9 PIN_TYPE_UART_APS_RX
   爲
   #define HAL_PIN_TYPE_IO_0 PIN_TYPE_UART_APS_TX
   #define HAL_PIN_TYPE_IO_1 PIN_TYPE_UART_APS_RX
   #define HAL_PIN_TYPE_IO_8 PIN_TYPE_UART1_TX
   #define HAL_PIN_TYPE_IO_9 PIN_TYPE_UART1_RX
4. API ，並未找到
   
   6，不使用的Pin應設置爲Float以達到省電的目的。

OPL1000-BLEWIFI-Application-Dev-Guide.pdf

關於BLEWifi配網的，等看到blewifi sample code 的時候再細讀。

OPL1000-DEVKIT-getting-start-guide.pdf

初學者入門教程，細讀。

1， 官方認證開發板：DevKit 和 LM80。
2， 官方論壇：www.lbluetooth.com 。 但並沒什麼有用的信息，也沒人討論。
3， ICE Mode Pin用於在線開發。
4， 提供了Pin Function Map。


5， 接口：AT= AT Cmd ; APS = Debug Log; IO8: APS Tx, IO9: APS Rx.
6， 裝驅動，介紹瞭如何使用Flash Programmer。
7， SWD可以仿真調試。
8， helloworld例子部分功能講解：固件燒寫、禁用WatchDog、仿真調試。

OPL1000-Flash-User-Guide.pdf

講解了Flash的結構與讀寫擦除等操作。等之後用到再細讀。

OPL1000-IOT-Application-Framework-User-Guide.pdf

關於 BleWifi的講解，用到再細讀。

OPL1000-patch-download-tool-user-guide.pdf

介紹了固件下載工具的使用方法。需要細讀，並在有條件時跟着操作。
1． AT串口用於燒錄。
2． Bin文件是M0+M3+PatchData Pack 出來的。
3． OTA文件是Bin文件+ota.bin Pack 出來的。

OPL1000-peripheral-PWM-application-notes.pdf

需要PWM調試的時候再詳讀。

OPL1000-pinmux-tool-user-guide.pdf

一個管腳功能配置的工具，最好能跟着實際操作一下。

1. 配置後，將生成.c .h .ini 三個文件。拷貝到用戶目錄下，調用API使用。
2. 資源列表：
   
   4， 管腳功能選擇有順序，先選比較少的，一對一的，如PWM、ADC，之後GPIO，再之後再選其他通訊管腳功能。

OPL1000-Power-Consumption-Measurement-Guide.pdf

關於功耗測量的說明。

1. DevKit 測量功耗的連線圖，之後還是用模組直接測量比較方便。
2. 三種休眠模式的觸發方法與對應的驗證方法。

OPL1000-Power-Saving-Introduction.pdf

提供三種睡眠模式。用到再詳讀。

1. 三種睡眠模式比較：
   
2. smart sleep 只有 STA模式，且連接路由後生效。
3. smart sleep 是通過 32K RTC實現的。

OPL1000-Reference-transparent-transmission-application-guide.pdf

講了關於透傳相關知識，透傳即作爲從設備，與主設備通過AT指令的方式進行透明傳輸。略讀。

OPL1000-RF-Testing-Guide.pdf

通過WT-200 WLAN Meter 用AT指令的方式控制RF動作，進行RF性能測試。略讀。

OPL1000-SDK-Development-guide.pdf

詳讀，關於文件目錄的說明。

1. 合併腳本文件 PatchData.txt 和發佈的 Bin 文件是配合使用的，不同版本的 M3/M0 Bin 文件和 PatchData.txt 不能混用。
2. Example目錄下的工程實現各種需要的功能，之後要都試一試。
3. IDE在線調試開發方法。
4. 可以使用Makefile進行Builid。
5. 多任務操作系統底層採用 FreeRTOS 嵌入式操作系統，上層使用 CMSIS-RTOS API 對FreeRTOS 封裝。
6. CMSIS-RTOS API Version 1 ？
7. 例程講解 hello_world \log \wpa2_station \wpa2_station_gpio 等。
8. 配置一個新的工程的方法。

OPL1000-SDK-getting-start-guide.pdf

作爲初步瞭解，詳讀。

1. Patch補丁方式組成完整固件。
   
2. 詳細講解了OTA Image的Flash Layout。
3. helloworld 的在線調試。

OPL1000-system-initialization-brief-introduction.pdf

系統初始化簡介，結合代碼看。

OPL1000-WIFI-BLE-API-guide.pdf

看BleWifi部分內容時候再作爲工具書參考。

OPL1000-WiFi-Interoperability-Results.pdf

官方已經驗證的AP列表，略看。

----First Breed at 2019-11-10 ----