115 lines
3.6 KiB
C++
115 lines
3.6 KiB
C++
#include "pxt.h"
|
|
|
|
using namespace pxt;
|
|
|
|
//% color=#E3008C weight=96 icon="\uf012"
|
|
namespace radio {
|
|
|
|
bool radioEnabled = false;
|
|
PacketBuffer packet;
|
|
|
|
int radioEnable() {
|
|
int r = uBit.radio.enable();
|
|
if (r != MICROBIT_OK) {
|
|
uBit.panic(43);
|
|
return r;
|
|
}
|
|
if (!radioEnabled) {
|
|
uBit.radio.setGroup(pxt::programHash());
|
|
uBit.radio.setTransmitPower(6); // start with high power by default
|
|
radioEnabled = true;
|
|
}
|
|
return r;
|
|
}
|
|
|
|
/**
|
|
* Sends an event over radio to neigboring devices
|
|
*/
|
|
//% blockId=radioRaiseEvent block="radio raise event|from source %src=control_event_source_id|with value %value=control_event_value_id"
|
|
//% blockExternalInputs=1
|
|
//% advanced=true
|
|
//% weight=1
|
|
//% help=radio/raise-event
|
|
void raiseEvent(int src, int value) {
|
|
if (radioEnable() != MICROBIT_OK) return;
|
|
uBit.radio.event.eventReceived(MicroBitEvent(src, value, CREATE_ONLY));
|
|
}
|
|
|
|
/**
|
|
* Takes the next packet from the radio queue and returns its contents in a Buffer
|
|
*/
|
|
//% help=radio/received-packet
|
|
Buffer readRawPacket() {
|
|
if (radioEnable() != MICROBIT_OK) return mkBuffer(NULL, 0);
|
|
uint8_t buf[32];
|
|
int size = uBit.radio.datagram.recv(buf, sizeof(buf));
|
|
if (size <= 0)
|
|
return mkBuffer(NULL, 0);
|
|
return mkBuffer(buf, size);
|
|
}
|
|
|
|
/**
|
|
* Sends a raw packet through the radio
|
|
*/
|
|
//% advanced=true
|
|
//% async
|
|
void sendRawPacket(Buffer msg) {
|
|
if (radioEnable() != MICROBIT_OK || NULL == msg) return;
|
|
uBit.radio.datagram.send(msg->data, msg->length);
|
|
}
|
|
|
|
/**
|
|
* Registers code to run when a packet is received over radio.
|
|
*/
|
|
//% help=radio/on-data-received
|
|
//% weight=50
|
|
//% blockId=radio_datagram_received_event block="radio on data received" blockGap=8
|
|
//% deprecated=true
|
|
void onDataReceived(Action body) {
|
|
if (radioEnable() != MICROBIT_OK) return;
|
|
registerWithDal(MICROBIT_ID_RADIO, MICROBIT_RADIO_EVT_DATAGRAM, body);
|
|
readRawPacket();
|
|
}
|
|
|
|
/**
|
|
* Gets the received signal strength indicator (RSSI) from the last packet taken
|
|
* from the radio queue (via ``receiveNumber``, ``receiveString``, etc). Not supported in simulator.
|
|
* namespace=radio
|
|
*/
|
|
//% help=radio/received-signal-strength
|
|
//% weight=40
|
|
//% blockId=radio_datagram_rssi block="radio received signal strength"
|
|
//% deprecated=true
|
|
int receivedSignalStrength() {
|
|
if (radioEnable() != MICROBIT_OK || packet == NULL) return 0;
|
|
return packet.getRSSI();
|
|
}
|
|
|
|
/**
|
|
* Sets the group id for radio communications. A micro:bit can only listen to one group ID at any time.
|
|
* @param id the group id between ``0`` and ``255``, eg: 1
|
|
*/
|
|
//% help=radio/set-group
|
|
//% weight=100
|
|
//% blockId=radio_set_group block="radio set group %ID"
|
|
//% id.min=0 id.max=255
|
|
void setGroup(int id) {
|
|
if (radioEnable() != MICROBIT_OK) return;
|
|
uBit.radio.setGroup(id);
|
|
}
|
|
|
|
/**
|
|
* Change the output power level of the transmitter to the given value.
|
|
* @param power a value in the range 0..7, where 0 is the lowest power and 7 is the highest. eg: 7
|
|
*/
|
|
//% help=radio/set-transmit-power
|
|
//% weight=9 blockGap=8
|
|
//% blockId=radio_set_transmit_power block="radio set transmit power %power"
|
|
//% power.min=0 power.max=7
|
|
//% advanced=true
|
|
void setTransmitPower(int power) {
|
|
if (radioEnable() != MICROBIT_OK) return;
|
|
uBit.radio.setTransmitPower(power);
|
|
}
|
|
}
|