開始使用瑪律特

發行項
07/08/2024

本主題定義如何將韌體上傳至 MALT，以及如何使用 SensorExplorer 來校正感測器。我們建議控制微控制器的計算機也是受測系統或裝置（SUT/DUT）。

將瑪律特導向

瑪律特前方（環境面向）	馬爾他背面（面向螢幕）

設定硬體

適用於瑪律特的硬體設定圖片

使用USB 2.0纜線類型 A/B 將Arduino Mega 連線到您的裝置。
使用彩虹絲帶纜線，將MALTE控制器面板連接到Arduino Mega的後接腳。
使用 CAT5（x）或 CAT6（x）纜線，將MALT控制器面板連接到MALT感測器面板。（例如 CAT5、CAT5e、CAT6 等）

注意

用來連接瑪律特控制器板與 MALT 感測器面板的乙太網路纜線必須具有所有 8 個電線，而且這些電線不得交叉。
按下 Arduino Mega 上的 [重設] 按鈕。

取得必要的檔案

在電腦的 C 磁碟驅動器上建立名為 MALT 的資料夾。 filepath 應該是 C：\MALT。我們將在這裡放置所有必要的檔案和複製的存放庫。
將 busiotools 存放庫複製到 您的 MALT 資料夾。 filepath 應該是 C：\MALT\busiotools。
將 SerialCommand 和 SoftI2CMaster 存放庫複製到 您的 MALT 資料夾。檔案路徑應 分別為 C：\MALT\Arduino-SerialCommand 和 C：\MALT\SoftI2CMaster 。

更新 MALT 韌體

MALT 是由 Arduino 所執行，其需要韌體來設定和與瑪律特面板上的感測器互動。

取得並設定 Arduino 命令行介面。
1. 下載最新版的 arduino-cli ，並將它儲存到您的電腦。
2. 如果您尚未將arduino-cli 新增至 PATH變數。
  
  注意
  
  在將arduino-cli 新增至PATH變數之後，請確定您關閉命令提示字元並開啟新的命令提示字元！
3. 從提升權限的指令提示字元執行下列命令：
```
arduino-cli config init
arduino-cli core update-index
arduino-cli core install arduino:avr
```
從提升權限的命令提示字元執行下列命令，從 Arduino 連結庫管理員新增必要的連結庫：
```
arduino-cli lib install MatrixMath
arduino-cli lib install AsyncDelay
```
從提升許可權的命令提示字元執行下列命令，以識別指派給 Arduino 的 COM 埠：
```
arduino-cli board list
```
從提升許可權的命令提示字元執行下列命令，並將 COMX 中的 X 取代為上一個步驟中識別的 COM 連接埠號碼，將韌體上傳至 Arduino：
```
arduino-cli compile --fqbn arduino:avr:mega --port COMX --upload --library C:\MALT\Arduino-SerialCommand --library C:\MALT\SoftI2CMaster C:\MALT\busiotools\sensors\tools\MALT\Code\malt
```
預期的輸出如下：

校正 MALT 色彩感測器

瑪律特的色彩感測器不會針對真實世界色彩進行工廠校正。以下是校正程式，以確保您獲得精確的讀數。 必須針對環境色彩感測器和螢幕色彩感測器進行瑪律特校正。 此程式只需要針對每個感測器面板完成一次，而且在PCC上的記憶體晶元會儲存設定。若要重新整理設定，請按arduino上的 [重設] 按鈕。

將 MALT 插入 SUT 上的 USB 埠。
開啟 SensorExplorer ，然後流覽至左側的 [瑪律特] 索引標籤（#3）。在 [裝置選取] 窗格中選取正確的 Vid/Pid“，然後選取 [連線到裝置]。
選取視窗頂端的 [ 校正] 索引標籤。
已知色彩值是任何校正程序的關鍵，而且來自已經校正且具有正確值的感測器。使用i1Display Pro之類的手動外部校正裝置來收集這些值，以擷取 XYZ 值和三個代表紅色、綠色和藍色的彩色光源。您可以使用下方的彩色方塊來校正手持裝置。任何具有可驗證正確值的裝置，例如現有的校正計算機，都可以用來尋找這些數位。這些 XYZ 值應該大約在 0-100 範圍左右，才能成為最有效的值。針對紅色顯示器、藍色顯示器和綠色顯示器執行此動作。

使用下列模式，將觀察到的值放入 已知值 3x3 矩陣中：
```
┌                                                            ┐
│Known RED X value | Known BLUE X value | Known GREEN X value│
│Known RED Y value | Known BLUE Y value | Known GREEN Y value│
|Known RED Z value | Known BLUE Z value | Known GREEN Z value│
└                                                            ┘
```
原始或未自定義的值是套用任何數學或校正之前，從目前未自定義的MALTE色彩感測器中產生的值。藉由指向您收集已知值的相同顯示色彩來收集這些值，以收集這些值。此步驟很重要，而且讓方程式可靠。決定是否要校正螢幕對向感測器或環境面向感測器。此決定會決定收集數據時要按下的 UI 按鈕。

依序將所需的感測器指向下方的色塊，然後針對您要校正的感測器所決定的每個色彩選取 [讀取畫面] 或 [讀取環境]。

這會填入 Raw Uncalibrated Values 3x3 矩陣，看起來應該類似下圖。
填入 [已知值] 和 [未經自定義的值] 馬蒂斯之後，請選取 畫面底部的 [計算 ] 按鈕。校正值 3x3 矩陣應該填入類似下列螢幕快照。

產生這些數字之後，請選取 [校正頂端] 或 [校正底部] ，如您要校正的感測器所決定。

測試 MALT 校正

正確校正螢幕色彩感測器和環境色彩感測器之後，請選取 視窗頂端的 [首頁 ] 以返回 [瑪律特] 區段的主索引標籤。

SensorExplorer 的螢幕快照，其中顯示如何流覽至首頁索引標籤。

在 [首頁] 索引標籤上，您應該能夠選取 [感測器數據] 標題下的任何按鈕，並取得非負數。

疑難排解

校正時，不論您按下 [讀取畫面紅色]、[讀取畫面綠色] 或 [讀取畫面藍色] （與 [讀取環境] 類似，原始值都相同。
- 確定 MALT 感測器面板是透過乙太網路纜線連接。
- 接下來，請檢查您使用的纜線是否可支援透過乙太網路的電源（POE）。所有 CAT5 或更好的纜線都支援此功能。
- 最後，如果您確定纜線支援POE，請嘗試按下Arduino Mega上的重設按鈕。
校正時，您的校正矩陣會在按下 [計算 ] 按鈕之後，在其中一個方塊中包含 “NaN”。
- 請確定原始值會為 RED、GREEN 和 BLUE 提供不同的數位。
- 請確定您在按下紅色時將 MALT 感測器按住紅色、按下綠色時按下綠色，並在按下 BLUE 時保持藍色。
- 如果您的原始值仍然沒有差異，請檢查上述的 #1。
校正完成後（即您已選取校正頂端或校正底部），您的感測器就會在主畫面上讀取不合理的值。
- 請確定您確實選取 [校正頂端] 或 [校正底部] 按鈕。
- 如果您確定您已根據上述指示適當地校正頂端和底部感測器，請傳送電子郵件 sensortools@microsoft.com。

如果此疑難解答區段無法解決您的問題，請傳送電子郵件 sensortools@microsoft.com。

共用方式為