【 NXP UWB 】Lock8 區堿演算架設與基本測試

一. Lock8 簡介

NXP 原廠提供 Lock8 ( v2.14 ) 為 2D 區間範圍演算示例，引用 C 標準數學式，也提供了 Lock8 的函式庫，此外，RD 在開發階段時功能的引用，可透過 Python 的範例進行測試與了解，接下來就教你如何架設 Python 環境與執行 Lock8 演示及驗證範例。

如下圖片為規劃車身區間範圍 2m 的 2D 示意圖 :

二. Lock8 環境架設說明

說明 Windows 測試 Lock8 範例時必要的 Python 安裝與注意項目

1. Windows 10 ( 64位元 ) 下載與安裝 Python 64bit version 3.8.2

https://www.python.org/ftp/python/3.8.2/python-3.8.2-amd64.exe

2. Python 64bit version 3.8.2 安裝步驟

(1) 勾選 Add Python3.8 to PATH 項目並選擇 Customize installation

(2) 選擇 Next

(3) 確認勾選項目 > 選擇安裝路徑 > Install

(4) 等待進行安裝

(5) 安裝完成

(6) 確認 Python 完成安裝並在程式集中可以找到主程式

(7) 用命令提示字元確認 Python 版本

開啟 cmd.exe，輸入Python 即會顯示安裝版本，Ctrl+Z 為離開 Python 程式

三. 執行 Lock8 範例

Lock8 的範例使用方式

1. 環境變數設定示意圖示

如圖所示為摸擬和演算Key Fob所在區域範圍內或外，而偵測區域範圍的基本參數設定說明如下：

(1) 首先設置車身上４個 Anchors，這4個點分別為 A1、A2、A3與A4，以A1為啟始點，初始設置Anchors 點之間的距離 ( 如同車身的長、寬 ) 參數並代入：
lock8_context = lock8.Lock8([d12, d23, d34, d14])
lock8_context = lock8.Lock8([1.8, 4.5, 1.8, 4.5])

(2) 設置車身可自動開鎖的距離範圍為 2m 內 :
lock8_context.set_close_enough_distance(2)

(3) 設置臨界點與容許範圍判斷 :
lock8_context.set_max_measurable_distance(20)
lock8_context.set_min_measurable_distance(-1)
lock8_context.set_smoothing_acceptance_threshold(0.6)
lock8_context.set_trust_too_distant_measure(0.1)
lock8_context.switch_smoothing(1)

2. Python 範例模擬測試

步驟1. 開啟命令提示字元的執行程式，進入到 Python 程式的目錄下 ①
步驟2. 輸入 Python 字串並啟動 Python ②，設置 lock8 相關初始化設定 ③
步驟3. 加入 Key Fob 的測試參數，設定離車身距離與靠近 Anchor 數 ( 方向 ) ④
步驟4. 確認 Key Fob 演算的結果是在車身指定的範圍外 ( lock ) 或是內 ( unlock )
步驟5. 修改不同的參數測試與確認結果

更多 Lock8 函式的使用可參考 Lock8_API_docs.chm 檔案說明

四. 文件參考

1. UM-SCA-2002 Zone Detection Example Lock8.pdf
2. Lock8_API_docs.chm