本帖最后由 szjuliet 于 2019-3-12 15:09 编辑
原文地址：http://iot.appinventor.mit.edu/#/microbit/microbitintro
请忽略排版，文中的空行不知为何无法删除，编辑的时候可以删除，编辑完后空行又出现:funk:。
Microbit_Accelerometer加速度传感器Microbit_Accelerometer组件允许用户配置BBC micro:bit的板载加速度传感器，并通过适当的方法接收一个或多个加速度传感器样本。 加速度传感器的报告速率（report rate）或周期（period）决定了将数据发送到App Inventor的频率。 Properties属性- BluetoothDevice - 连接到micro:bit设备的BluetoothLE组件。
Methods方法
- StopAccelerometerDataUpdates - 停止从micro:bit的加速度传感器接收更新。请注意，即使调用了这个stop过程，可能仍然会有来自设备的挂起的消息（pending message）通过AccelerometerDataReceived事件进行报告 。
- WriteAccelerometerPeriod - 使用WriteAccelerometerPeriod方法更改micro:bit向App Inventor发送加速度传感器数据的频率。period的值以毫秒为单位进行测量。根据micro:bit规格，有效值分别为1, 2, 5, 10, 20, 80, 160和640毫秒。
参数：
- period（Number数值） - 新的加速度传感器报告周期period，以毫秒为单位。
Events事件- AccelerometerDataReceived - 只要从micro:bit接收到加速度传感器采样，就会运行AccelerometerDataReceived事件。这通常是执行 读取或 请求操作的结果。X，Y和Z值是重力加速度（G = -9.8 m / s 2）的千分之一，因此应该按1/1000缩放。
参数：
- Accelerometer_X（Number数值） - 加速度传感器的X值，以毫G为单位。
- Accelerometer_Y（Number数值） - 加速度传感器的Y值，以毫G为单位。
- Accelerometer_Z（Number数值） - 加速度传感器的Z值，以毫G为单位。
- AccelerometerPeriodReceived - 读取到micro:bit加速度传感器的period值后，运行AccelerometerPeriodReceived事件。
参数：
- Accelerometer_Period（Number数值） - micro:bit加速度传感器的当前报告周期（period），以毫秒为单位。
参数：
- Accelerometer_Period（数字） - micro:bit的加速度传感器的报告周期(period)，以毫秒为单位。
Microbit_Button按钮Microbit_Button插件为App Inventor提供BBC micro:bit按钮状态的信息。当用户按下按钮或读取按钮的当前状态时，开发人员可以使用此插件来请求更新。按钮有三种状态：
Properties属性- BluetoothDevice - 连接到micro:bit设备的BluetoothLE组件。
Methods方法
- StopButtonAStateUpdates - 停止接收micro:bit的A按钮的状态更新。请注意，调用该方法后，可能仍然有未处理的挂起更新结果出现在 ButtonAStateReceived事件中。
- StopButtonBStateUpdates - 停止接收关于micro:bit的B按钮的状态更新。请注意，调用该方法后，可能仍然有未处理的挂起更新结果出现在 ButtonBStateReceived事件中。
Events事件参数：
- Button_State_Value（Number数值） - micro:bit的A按钮状态： 0为释放，1为按下，2为长按。
参数：
- Button_State_Value（Number数值） - micro:bit的B按钮状态： 0为释放，1为按下，2为长按。
Microbit_Io_Pin 输入输出引脚Microbit_Io_Pin组件允许用户配置BBC micro:bit的模拟引脚以进行输入和输出，以及读、写及请求引脚的输入输出状态。 Properties属性- BluetoothDevice - 连接到micro:bit设备的BluetoothLE组件。
Methods方法
- RequestPinDataUpdates - 请求对任何配置为输入的micro:bit引脚进行更新。请求更新后，只要micro:bit报告某个引脚更改为输入，就会运行PinDataReceived事件。
- StopPinDataUpdates - 停止接收micro:bit的I / O（输入/输出）引脚状态的更新。请注意，可能有尚未处理的挂起更新会导致运行 PinDataReceived事件。
- WritePWMControl - 将PWM控制字段写入micro:bit。PWM控制字段是一个有1~2个实例的可变长度数组的数据结构，它包含一个1字节的引脚（pin）字段（范围0~19），一个2字节的值（value）字段（范围0~1024）和一个4字节的周期（period）字段（以毫秒为单位）。
参数：
- PWM_Control_Field（列表list） - 在WritePWMControl方法描述中定义PWM控制字段数据。
- WritePinADConfiguration - WritePinADConfiguration用于配置micro:bit上的引脚是模拟的还是数字的。Pin_AD_Config_Value由三个字节组成，代表19位，每一位代表micro:bit的一个引脚。0位表示数字引脚，1位表示模拟引脚。在成功写入了新的引脚配置后，运行WrotePinADConfiguration事件。
参数：
- Pin_AD_Config_Value（list 列表） - 由一个19位掩码组成的8位值列表，每一位代表micro:bit上的一个引脚。
参数：
- IO_Pin_Data（list 列表） - 输出到micro:bit引脚的值的列表，该列表最多包含19个值，值的范围为0-255。
- WritePinIOConfiguration – 本方法用于配置micro:bit引脚是输入还是输出。参数Pin_IO_Config_Value应该是有3个元素的列表，每个元素是从0到255的数字，组成19位的位掩码。0表示输出，1表示输入。
参数：
- Pin_IO_Config_Value（list 列表） - 由一个19位掩码组成的8位值列表，每一位代表micro:bit上的一个引脚。
Events事件参数：
- Pin_AD_Config_Value（list 列表） - 在micro:bit上配置的模拟/数字引脚状态的列表。
参数：
- IO_Pin_Data（list 列表） - micro:bit的输入引脚的状态。未配置为输入的引脚值为0。
- PinIOConfigurationReceived - 在读取了micro:bit引脚的输入/输出配置后运行PinIOConfigurationReceived事件。参数Pin_IO_Config_Value将是一个三个字节的列表，其值为0-255，组成19位掩码，表示由micro:bit提供的19个引脚中每一个的输入输出状态。0表示输出，1表示输入。
参数：
- Pin_IO_Config_Value（list 列表） - 由一个19位掩码组成的8位值列表，每一位代表micro:bit上的一个引脚。
- WrotePWMControl - 在成功写入micro:bit的脉宽调制控制服务后运行WrotePWMControl事件。写入的控制字段的值作为参数PWM_Control_Field传递。
参数：
- PWM_Control_Field（list 列表） - 写入micro:bit的控制信息。
- WrotePinADConfiguration - 在将模拟和数字引脚成功写入micro:bit配置服务器后运行WrotePinADConfiguration事件。Pin_AD_Config_Value是字节列表，将作为最后一次调用服务的一部分写入。
参数：
- Pin_AD_Config_Value（list 列表） - 由一个19位掩码组成的8位值列表，每一位代表micro:bit上的一个引脚。
- WrotePinData - 调用WritePinData 方法成功写入micro:bit的输出引脚后，运行WrotePinData事件。
参数：
- IO_Pin_Data（list 列表） - 在最后一次调用WritePinData时写入到micro:bit引脚的最多包含19个值的列表，值的范围为0~255。
- WrotePinIOConfiguration - 在成功更新micro:bit的输入/输出引脚配置后运行WrotePinIOConfiguration事件。在事件中Pin_IO_Config_Value将作为参数发送到设备。
参数：
- Pin_IO_Config_Value（list 列表） - 由一个19位掩码组成的8位值列表，每一位代表micro:bit上的一个引脚。
Microbit_Led LED显示屏Microbit_LED插件让App Inventor用户可以通过编程来更改BBC micro:bit的5x5 LED矩阵，编程的形式既可以是自定义编码模式也可以编写文本字符串来编程。还可以定制显示的滚动速度。 更多链接： - 下载micro:bit LED矩阵的示例项目。
- 查看如何使用 micro:bit LED矩阵。
Properties属性- BluetoothDevice - 连接到micro:bit设备的BluetoothLE组件。
Methods方法
- WriteLEDMatrixState - 写入micro:bit的LED矩阵状态。LED_Matrix_State是范围在0-31的5组数值的列表，以指示在LED矩阵的5行中的每一行中应打开哪些LED。从左到右，LED的值为16, 8, 4, 2, 1。例如，如果要使某行中的LED电源状态为10011，则发送的值为（16 + 2 + 1）或19。写操作完成后，运行事件 WroteLEDMatrixState。
参数：
- LED_Matrix_State（list 列表） - 包含5组数值的列表，每组数值代表LED矩阵的一行，列表中的第n个值对应的是LED矩阵第n行位阵列的整数值。
- WriteLEDText - 将文本写入micro:bit的LED矩阵。每个字符出现在micro:bit上的显示速率取决于通过方法WriteScrollDelay写入的最后一个滚动值（scroll value）。受限于低功耗蓝牙包的允许长度，发送的字符串长度不超过20个UTF-8字节。尝试写入超过20个字节的字符串将导致消息被截断。
参数：
- LED_Text_Value（string字符串） - 要写入的文本。字符串长度限制为20个UTF-8字节。
参数：
- Scrolling_Delay_Value（Number数值） - LED矩阵上字符之间的延迟，以毫秒为单位。
Events事件- LEDMatrixStateReceived - 从设备读取micro:bit的LED矩阵的状态时，运行LEDMatrixStateReceived事件。LED_Matrix_State是一个包含5组值的列表，矩阵的每一行都有一个值。每个值都是一个范围从0到31的数字。从左到右，LED的值为16, 8, 4, 2, 1。
参数：
- LED_Matrix_State（list 列表） - 5个值的列表，每行一个，每个值在0-31之间以指示该行中哪些LED亮起。
- ScrollingDelayReceived - 在通过 ReadScrollingDelay方法请求micro:bit的LED矩阵滚动延迟后，运行Scrolling_Delay_Value事件。
参数：
- Scrolling_Delay_Value（Number数值） - LED矩阵上字符之间的延迟，以毫秒为单位。
参数：
- LED_Matrix_State（list 列表） - 之前特定调用时写入LED矩阵的值
- WroteLEDText - 调用WriteLEDText后，文本写入了micro:bit的LED矩阵，此时运行WroteLEDText事件。写入的文本由参数LED_Text_Value给出。
参数：
- LED_Text_Value（Text文本） - 要写入LED矩阵的文本。
- WroteScrollingDelay - 在调用WriteScrollingDelay方法并成功读取micro:bit的滚动延迟（scrolling delay）之后，运行事件WroteScrollingDelay。
参数：
- Scrolling_Delay_Value（Number数值） - LED矩阵上字符之间的延迟，以毫秒为单位。
Microbit_Magnetometer磁力计Microbit_Magnetometer可以对micro:bit的板载磁力计进行配置，通过适当的方法接收一个或多个磁力计的样本。 Properties属性- BluetoothDevice - 与micro:bit的BluetoothLE组件连接。
Methods方法
- StopMagnetometerDataUpdates - 停止接收来自micro:bit的磁力仪的更新。请注意，可能会有来自设备的待处理消息（pending messages）仍会通过MagnetometerDataReceived事件进行报告 。
- WriteMagnetometerPeriod- 使用WriteMagnetometerPeriod方法更改micro:bit将磁力计数据发送到App Inventor的频率。该周期（period）以毫秒为单位进行测量。根据micro:bit规格，有效值分别为1, 2, 5, 10, 20, 80, 160和640毫秒。
参数：
- Magnetometer_Period（Number数值） - 新的磁力计报告周期（Period），以毫秒为单位。
Events事件- MagnetometerBearingReceived - 无论何时从micro:bit接收到方位样本，都会运行MagnetometerBearingReceived事件。这通常是执行 读取或 请求操作的结果。方位值以相对于北（North）的度数报告。
参数：
- bearing_value（Number数值） - 方位（北），单位度。
- MagnetometerDataReceived - 只要从micro:bit接收到磁力计样本，就会运行MagnetometerDataReceived事件。这通常是执行 读取或 请求操作的结果。X，Y和Z值以毫特斯拉（milli-teslas）为单位，因此应按1/1000缩放。
参数：
- Magnetometer_X（Number数值） - 磁力计的X值，单位为毫特
- Magnetometer_Y（Number数值） - 磁力计的Y值，单位为毫特
- Magnetometer_Z（Number数值） - 磁力计的Z值，单位为毫特
- MagnetometerPeriodReceived - 从设备读取micro:bit磁力计周期（Period）后运行MagnetometerPeriodReceived事件。
参数：
- Magnetometer_Period（Number数值） - micro:bit磁力计的当前报告间隔（current reporting interval），以毫秒为单位。
参数：
- Magnetometer_Period（Number数值） - 报告micro:bit磁力计的周期（Period），以毫秒为单位。
Microbit_Temperature 温度传感器Microbit_Temperature可以让App Inventor用户对BBC micro:bit板载温度传感器进行配置，并通过适当的方法接收一个或多个温度样本。温度传感器的报告速率（report rate）或周期（period）决定了将数据发送到App Inventor的频率。 更多链接:
- 下载micro:bit温度传感器的示例项目。
- 查看如何使用 micro:bit温度传感器。
Properties属性- BluetoothDevice - 连接到micro:bit设备的低功耗蓝牙（BluetoothLE）组件。
Methods方法 [size=13.3333px]
- StopTemperatureUpdates - 停止接收micro:bit温度传感器的更新。注意：可能会有来自设备的待处理消息（pending messages）仍会通过TemperatureDataReceived事件进行报告 。
- WriteTemperaturePeriod - 使用WriteTemperaturePeriod方法更改micro:bit向App Inventor发送温度数据的频率。period以毫秒为单位进行测量。
参数:
- temperature_period_value（number数值） - micro:bit温度传感器的新的报告周期（reporting period）。
Events事件- TemperaturePeriodReceived - 当设备读取到micro:bit温度传感器的报告周期后运行TemperaturePeriodReceived事件。
参数:
- temperature_period_value（number数值） - micro:bit的温度传感器的当前报告间隔（current reporting interval）。
- TemperatureReceived - 只要从micro:bit接收到温度采样，就运行TemperatureReceived事件。这通常是执行 读取或请求更新 操作的结果。温度值以摄氏度测量。
参数:
- temperature_value（number数值） - 由micro:bit测量的温度，以摄氏度为单位
- WroteTemperaturePeriod - 在micro:bit温度传感器的报告周期写入设备后运行WroteTemperaturePeriod事件。
参数:
- temperature_period_value（number数值） - micro:bit温度传感器的新报告间隔（reporting interval）。
Microbit_Uart 通用异步收发器Microbit_Uart传感器可以在BBC micro:bit的串行UART端口读取和写入字符串。
Properties属性- BluetoothDevice – 与micro:bit的BluetoothLE组件连接。
Methods方法
- StopTXCharacteristicUpdates - 停止接收来自micro:bit串行UART的更新。注意：可能仍然会有来自设备的待处理（pending messages）消息通过TXCharacteristicReceived事件进行报告 。
- WriteRXCharacteristic - 将给定的UART_TX值写入micro:bit。消息的大小取决于UART_TX的值。数字将被转换为整数并以32位整数值的形式发送。字符串将使用UTF-8进行编码。对象列表（Lists of objects）将使用前面提到的数字和字符串规则以字节序列（sequence of bytes）的形式发送。
参数：
- UART_TX（any任何类型） - 要发送到micro:bit的RX引脚的值。字符串以UTF-8编码，数字将作为32位整数发送。根据列表中每个值的类型，列表中的值将被转换为字节序列。
Events事件- TXCharacteristicReceived - 只要通过micro:bit的串行UART协议收到消息，就会运行TXCharacteristicReceived事件。
参数：
- UART_TX_FIELD（list列表） - 从设备读取的无符号字节的值的列表。
- WroteRXCharacteristic - 通过串行UART将消息写入micro:bit后，运行WroteRXCharacteristic事件。
参数：
- UART_TX_FIELD（list列表） - 写入设备的无符号字节的值的列表。
| 
置顶卡
变色卡
千斤顶
版主限定
创作达人
编辑选择奖
ARD DAY
编辑选择奖
星球译员
编辑选择奖
编辑选择奖
编辑选择奖
