61aae94d8b
* Refactoring radio into the ts * Moving the rest of the radio functionality to the TypeScript * Removing sim implementation of old radio cpp * Adding test script * Removing handler key * Rename internal functions * PR feedback * Refactoring to use event bus
111 lines
3.5 KiB
C++
111 lines
3.5 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);
|
|
packet = uBit.radio.datagram.recv();
|
|
return mkBuffer(packet.getBytes(), packet.length());
|
|
}
|
|
|
|
/**
|
|
* Sends a raw packet through the radio
|
|
*/
|
|
//% advanced=true
|
|
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=10 blockGap=8
|
|
//% 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);
|
|
}
|
|
}
|