Micro:bit磁力感測器


Microbit_Magnetometer可用於設定BBC micro:bit開發板上的磁力感測器,並接收單筆或多筆磁力讀數。


屬性

  • BluetoothDevice – 連接至micro:bit 裝置之BluetoothLE元件。

get Microbit_Magnetometer1 BluetoothDevice

set Microbit_Magnetometer1 BluetoothDevice  to


方法

call Microbit_Magnetometer1 ReadMagnetometerBearing

  • ReadMagnetometerData – 讀取單筆磁力感測器資料。成功讀取之後就會自動呼叫MagnetometerDataReceived事件。

call Microbit_Magnetometer1 ReadMagnetometerData

  • ReadMagnetometerPeriod – 讀取磁力感測器當下的讀取速度(report rate)。成功讀取之後就會由MagnetometerPeriodReceived事件回傳相關數值。

call Microbit_Magnetometer1 ReadMagnetometerPeriod

call Microbit_Magnetometer1 RequestMagnetometerBearingUpdates

  • RequestMagnetometerDataUpdates – 要求關於micro:bit磁力感測器讀值變化的通知。磁力數值變化會以WriteMagnetometerPeriod方法所設定的速度來回傳。磁力資料會由MagnetometerDataReceived事件回傳。

call Microbit_Magnetometer1 RequestMagnetometerDataUpdates

  • StopMagnetometerBearingUpdates – 停止接收來自micro:bit方位角的更新。請注意可能會有來自裝置的pending messages,所以仍有可能觸發MagnetometerBearingReceived事件。

call Microbit_Magnetometer1 StopMagnetometerBearingUpdates

  • StopMagnetometerDataUpdates – 停止接收來自micro:bit磁力感測器的更新。請注意可能會有來自裝置的pending messages,所以仍有可能觸發MagnetometerDataReceived事件。

call Microbit_Magnetometer1 StopMagnetometerDataUpdates

  • WriteMagnetometerPeriod – 本方法可設定micro:bit發送磁力感測器資料給App Inventor的時間間隔。period單位為毫秒。根據micro:bit原廠文件,可用的參數有1, 2, 5, 10, 20, 80, 160與640(毫秒)。

    參數:

    • Magnetometer_Period (數字) — 所要設定的磁力感測器讀取速度,單位為毫秒。

call Microbit_Magnetometer1 WriteMagnetometerPeriodMagnetometer_Period


事件

  • MagnetometerBearingReceived – 收到來自micro:bit的方位角之後就會自動呼叫本事件。這通常是執行readrequest操作的結果。方位角(bearing value)代表對北方的相對角,單位為度。

    參數:

    • bearing_value (數字) — 對北方的方位角,單位為度。

when Microbit_Magnetometer1 MagnetometerBearingReceived bearing_value do

  • MagnetometerDataReceived – 只要收到來自micro:bit的磁力感測器值,就會自動呼叫本事件。這通常是執行readrequest操作的結果。X、Y與Z等事件數值的單位為毫特斯拉(milli-teslas),所以計算上要除以1000。

    參數:

    • Magnetometer_X (數字) — 磁力感測器的X軸數值,單位為milliT。
    • Magnetometer_Y (數字) — 磁力感測器的Y軸數值,單位為milliT。
    • Magnetometer_Z (數字) — 磁力感測器的Z軸數值,單位為milliT。

when Microbit_Magnetometer1 MagnetometerDataReceived Magnetometer_X Magnetometer_Y Magnetometer_Z do

  • MagnetometerPeriodReceived – 讀取micro:bit磁力感測器的讀取速度之後就會自動呼叫本事件。

    參數:

    • Magnetometer_Period (數字) —  micro:bit磁力感測器現在的讀取速度區間,單位為毫秒。

when Microbit_Magnetometer1 MagnetometerPeriodReceived Magnetometer_Period do

  • WroteMagnetometerPeriod – 透過ReadAccelerometerPeriod方法要求micro:bit回傳其讀取速度之後,就會自動呼叫本事件。

    參數

    • Magnetometer_Period (數字) — micro:bit磁力感測器現在的讀取速度區間,單位為毫秒。

when Microbit_Magnetometer1 WroteMagnetometerPeriod Magnetometer_Period do

Comments