• Microbit Io Pin：板载引脚
  • 属性
  • 方法
  • 事件

« 返回首页

Microbit Io Pin：板载引脚

Microbit_Io_Pin 组件允许用户配置 BBC micro:bit 的模拟引脚用于输入和输出，以及读取、写入和请求 I/O 引脚状态的通知。

更多链接：

• RGB LED 控制：示例项目和教程。
• 读取旋钮状态：示例项目和教程。
• 读取开关状态：示例项目和教程.

属性

• 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引脚状态的更新。注意可能仍有未处理的待更新事件会导致额外的PinDataReceived事件。

• WritePWMControl – 写入micro:bit的PWM控制字段。PWM控制字段是一个可变长度数组，包含一个或多个数据结构实例，每个实例包含1字节引脚字段(范围0-19)、2字节值字段(范围0-1024)和4字节周期字段(毫秒)。

参数:

 * <code>PWM\_Control\_Field</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/lists.html#emptylist">_列表_</a>) &mdash;
   如WritePWMControl方法描述中定义的PWM控制字段数据。

• WritePinADConfiguration – WritePinADConfiguration用于配置micro:bit引脚为模拟或数字。Pin\_AD\_Config\_Value由三个字节组成，代表19位，每位对应micro:bit的一个引脚。0位表示数字引脚，1位表示模拟引脚。成功写入新引脚配置后，将触发WrotePinADConfiguration事件。

参数:

 * <code>Pin\_AD\_Config\_Value</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/lists.html#emptylist">_列表_</a>) &mdash;
   8位值列表，组合成19位掩码，每位对应micro:bit的一个引脚。

• WritePinData – WritePinData用于设置micro:bit引脚的输出值(如果使用WritePinIOConfiguration方法配置为输出引脚)。写入引脚后，将触发WrotePinData事件。

参数:

 * <code>IO\_Pin\_Data</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/lists.html#makealist">_列表_</a>) &mdash; 要输出到micro:bit引脚的0-255值列表(最多19个)。

• WritePinIOConfiguration – WritePinIOConfiguration方法用于配置micro:bit引脚的输入或输出状态。Pin\_IO\_Config\_Value参数应为3元素列表，每个元素是0-255的数字，组合成19位掩码。0位表示输出，1位表示输入。

参数:

 * <code>Pin_IO_Config_Value</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/lists.html#emptylist">_列表_</a>) &mdash;
   8位值列表，组合成19位掩码，每位对应micro:bit的一个引脚。

事件

• PinADConfigurationReceived – 当micro:bit返回对ReadPinADConfiguration方法的成功调用后，将触发PinADConfigurationReceived事件。

参数:

 * <code>Pin\_AD\_Config\_Value</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/lists.html#emptylist">_列表_</a>) &mdash;
   micro:bit上配置的模拟/数字引脚状态列表。

• PinDataReceived – 当micro:bit发送其输入引脚状态时，将触发PinDataReceived事件。通常在调用ReadPinData或RequestPinData后触发。

参数:

 * <code>IO_Pin_Data</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/lists.html#makealist">_列表_</a>) &mdash;
   micro:bit输入引脚状态。未配置为输入的引脚值为0。

• PinIOConfigurationReceived – 当读取micro:bit引脚的输入/输出配置后，将触发PinIOConfigurationReceived事件。Pin\_IO\_Config\_Value将是三个0-255字节值的列表，组合成19位掩码，指示micro:bit提供的19个引脚的输入或输出状态。0位表示输出，1位表示输入。

参数:

 * <code>Pin\_IO\_Config\_Value</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/lists.html#emptylist">_列表_</a>) &mdash;
   8位值列表，组合成19位掩码，每位对应micro:bit的一个引脚。

• WrotePWMControl – 成功写入micro:bit的脉宽调制控制服务后，将触发WrotePWMControl事件。写入的控制字段值将作为PWM\_Control\_Field参数传递。

参数:

 * <code>PWM\_Control\_Field</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/lists.html#emptylist">_列表_</a>) &mdash;
   写入micro:bit的控制信息。

• WrotePinADConfiguration – 成功写入micro:bit的模拟和数字引脚配置服务器后，将触发WrotePinADConfiguration事件。Pin\_AD\_Config\_Value将是上次调用服务时写入的字节列表。

参数:

 * <code>Pin\_AD\_Config\_Value</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/lists.html#emptylist">_列表_</a>) &mdash;
   8位值列表，组合成19位掩码，每位对应micro:bit的一个引脚。

• WrotePinData – 当通过调用WritePinData方法成功写入micro:bit的输出引脚后，将触发WrotePinData事件。

参数:

 * <code>IO\_Pin\_Data</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/lists.html#makealist">_列表_</a>) &mdash; 上次调用<a href="#WritePinData"><code>WritePinData</code></a>时写入micro:bit引脚的0-255值列表(最多19个)。

• WrotePinIOConfiguration – 成功更新micro:bit的输入/输出引脚配置后，将触发WrotePinIOConfiguration事件。发送到设备的Pin\_IO\_Config\_Value将作为事件参数传递。

参数:

 * <code>Pin\_IO\_Config\_Value</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/lists.html#emptylist">_列表_</a>) &mdash;
   8位值列表，组合成19位掩码，每位对应micro:bit的一个引脚。