9.2 无线电相关API
- 无线电模块允许设备通过简单的无线网络协同工作。
- 无线电在概念上非常简单：
- 广播发射的消息具有一定的可配置长度(最多251个字节)。
- 从可配置长度的消息队列中接受消息(队列越大，使用的RAM越多)。
- 如果队列已满，则会忽略新消息，读取消息会将其在队列中删除。
- 广播时设置一个广播功率，功率越大接受范围越大。
- 接收时按地址和组进行过滤。
- 发送和接受字节来处理任意数据。
- 使用
receive_full获取传入消息的完整信息包括：消息数据、信号强度和时间。 - 为了方便初学者使用，无线电可以使用字符串的形式发送和接受消息。
- 默认配置兼容其他micro:bit平台。
- 想要使用无线电模块，请在程序开头使用
import radio导入无线电模块。
无线电API
| API | 描述 |
|---|---|
radio.on() |
打开无线电，这需要明确使用，因为无线电消耗很多功率并且占用你可能需要使用的内存。 |
radio.off() |
关闭无线电，以节约点亮和内存。 |
radio.reset() |
将设置重置为其默认值（如下面配置功能的文档中所列）。 |
| 在收音机打开之前，以下所有发送或接收方法都不起作用。 | ------------------ |
radio.send_bytes(message) |
发送包含字节的消息。 |
radio.receive_bytes() |
接收消息队列中的下一个传入消息。 如果没有待处理消息，则返回None。 消息以字节形式返回。 |
radio.receive_bytes_into(buffer) |
接收消息队列中的下一个传入消息。 将消息复制到缓冲区中，必要时修剪消息的结尾。 如果没有消息，则返回None，否则返回消息的长度（可能超过缓冲区的长度）。 |
radio.send(message) |
发送消息字符串。 这相当于send_bytes(bytes(message，'utf8'))，但b' x01 x00 x01'前置于消息队列前面(使其与其他以micro：bit为目标的平台兼容)。 |
radio.receive() |
与receive_bytes()工作方式相同，它的返回值等同于str(receive_bytes(), 'utf8'),但检查前三个字节是b' x01 x00 x01'(以使其与micro的其他平台兼容)。 在转换为字符串之前剥离前置字节。如果转换为字符串失败，则会引发ValueError异常。 |
radio.receive_full() |
返回一个元组，其中包含三个值，表示消息队列中的下一个传入消息。 如果没有待处理消息，则返回None。 元组中的三个值表示：消息队列中的下一个传入消息为字节。 RSSI（信号强度）：以dBm为单位测量的0（最强）和-255（最弱）之间的值。 时间戳：收到消息时time.ticks_us()返回的值。 |
radio.config(**kwargs) |
配置与无线电相关的各种设置，其默认值如下。 |
-
length(默认值= 32)定义通过无线电发送的消息的最大长度(以字节为单位)。它最长可达251个字节(S0，LENGTH和S1前导码为254-3个字节)。 -
queue(默认值= 3)指定可以存储在传入消息队列中的消息数。如果队列中没有剩余空间用于传入消息，则丢弃传入消息。 -
channel(默认值= 7)可以是0到83(含)的整数值，它定义了无线电调谐到的任意“通道”。消息将通过此通道发送，只有通过此通道接收的消息才会被放入传入消息队列。每个步长为1MHz宽，基于2400MHz。 -
power(默认值= 6)是0到7(含)的整数值，表示广播消息时使用的信号强度。值越高，信号越强，但设备消耗的功率越多。编号转换为以下dBm(分贝毫瓦)值：-30，-20，-16，-12，-8，-4,0,4。 -
address(默认值= 0x75626974)是一个任意名称，表示为32位地址，用于过滤硬件级别的传入数据包，仅保留与您设置的地址匹配的数据包。其他micro：bit相关平台使用的默认设置是此处使用的默认设置。 -
group(默认值= 0)是一个8位值(0-255)，用于过滤消息时的地址。从概念上讲，“地址”就像是一个住宅/办公室地址，而“组”就像您要将消息发送到该地址的人。 -
data_rate(default = radio.RATE_1MBIT)表示数据吞吐量发生的速度。可以是无线电模块中定义的以下容量之一：- |
radio.RATE_250KBIT|常量用于表示每秒256 Kbit的吞吐量。| - |
radio.RATE_1MBIT|常量用于表示每秒1 MBIT的吞吐量。| - |
radio.RATE_2MBIT|常量用于表示每秒2 MBIT的吞吐量。|
- |
-
如果未调用config，则使用上述默认值。