Microbit_Io_Pin元件可用於設定BBC micro:bit的類比腳位為輸入或輸出模式、可讀取、寫入並 request notifications for the I/O pin states.

屬性

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

方法

• ReadPinADConfiguration – 讀取micro:bit的腳位設定狀態，讀取結果根據該腳位是設定為數位(0/1)或類比(0~255)而異。成功讀取之後會自動呼叫PinADConfigurationReceived事件。

• ReadPinData – 讀取一次micro:bit的腳位狀態。成功讀取之後會自動呼叫PinDataReceived事件。在讀取之前，該腳位要先使用WritePinIOConfiguration方法設定為輸入。

• ReadPinIOConfiguration – 讀取micro:bit腳位當下的輸入/輸出設定。成功讀取之後會自動呼叫PinIOConfigurationReceived事件。

• RequestPinDataUpdates – 要求任一個已設定為輸入的micro:bit腳位更新。要求更新之後，micro:bit只要任一隻輸入腳位數值發生變化都會呼叫PinDataReceived事件。

• StopPinDataUpdates – 停止接收來自micro:bit的I/O腳位狀態更新。請注意可能會有來自裝置的pending messages，所以仍有可能觸發PinDataReceived事件。

• WritePWMControl – 對micro:bit的PWM控制參數。PWM control field是一個長度可變動的陣列 of one or two instances of a data structure containing a 1-byte pin field (數字0~19), a 2-byte value field (數字0~1024), and a 4-byte period field (毫秒).

  參數：

  • PWM_Control_Field (清單) — PWM控制數值。

• WritePinADConfiguration – 本方法是用於設定指定micro:bit的腳位模式為類比或數位。Pin_AD_Config_Value是由19個位元所組成，長度為3個位元組，每一個位元分別代表micro:bit的一個腳位。位元0代表數位腳位，1則代表類比腳位。成功寫入新的腳位設定之後會自動呼叫WrotePinADConfiguration事件。

  參數：

  • Pin_AD_Config_Value (清單) — 長度19位元的位元清單，每一個位元分別代表micro:bit的一個腳位。

• WritePinData – 本方法可設定micro:bit腳位的輸出數值，但該腳位需要先用WritePinIOConfiguration方法設定為輸出。成功寫入腳位之後會自動呼叫WrotePinData事件。

  參數：

  • IO_Pin_Data (清單) — 用於設定micro:bit腳位的數值清單，清單最多可包含19個數值，範圍0-255。

• WritePinIOConfiguration – 本方法是用於設定指定micro:bit的腳位為輸入或輸出。Pin_IO_Config_Value參數為三個元素的清單，每個元素為0~255之間的數字，長度共19個位元。位元0代表輸出，1則代表輸入。

  參數：

  • Pin_IO_Config_Value (清單) — 長度19位元的位元清單，每一個位元分別代表micro:bit的一個腳位。

事件

• PinADConfigurationReceived – 成功執行ReadPinADConfiguration方法之後就會自動呼叫本事件。

  參數：

  • Pin_AD_Config_Value (清單) — 代表micro:bit腳位為類比(1)/數位(0)的位元清單。

• PinDataReceived – 成功接收到micro:bit的輸入腳位狀態之後就會自動呼叫本事件。這通常是跟在ReadPinData或RequestPinData方法之後所執行。

  參數：

  • IO_Pin_Data (清單) — 代表micro:bit的輸入腳位狀態的位元清單。未設定為輸入的腳位數值皆為0。

• PinIOConfigurationReceived – 成功讀取micro:bit腳位的輸入/輸出設定之後就會自動呼叫本事件。Pin_IO_Config_Value will be a list of three bytes valued from 0-255 composing a 19-bit mask indicating the input or output state of each of the 19 pins provided by the micro:bit。如某位元為0代表輸出，1代表輸入。

  參數：

  • Pin_IO_Config_Value (清單) — 長度19位元的位元清單，每一個位元分別代表micro:bit的一個腳位。

• WrotePWMControl – 成功寫入micro:bit的PWM參數之後就會自動呼叫本事件。所寫入的控制參數會以PWM_Control_Field事件變數來回傳。

  參數：

  • PWM_Control_Field (清單) — 要寫入micro:bit的控制資訊。

• WrotePinADConfiguration – 成功設定micro:bit指定腳位為類比或數位模式，就會自動呼叫本事件。Pin_AD_Config_Value事件變數是一個位元清單 were written as part of the last call to the service.

  參數：

  • Pin_AD_Config_Value (清單) — 長度19位元的位元清單，每一個位元分別代表micro:bit的一個腳位。

• WrotePinData – 成功透過WritePinData方法寫入micro:bit輸出腳位之後就會呼叫本事件。

  參數：

  • IO_Pin_Data (清單) — 最後一次由WritePinData方法所寫入micro:bit腳位的數值清單(最多可包含19個數值，範圍0-255)。

• WrotePinIOConfiguration – 成功更新micro:bit的腳位設定之後就會自動呼叫本事件。Pin_IO_Config_Value that was sent to the device will be passed as a parameter to the event.

  參數：

  • Pin_IO_Config_Value (清單) — 長度19位元的位元清單，每一個位元分別代表micro:bit的一個腳位。