pxt-calliope/docs/reference/radio/get-received-packet-property.md

get Received Packet Property

Get one of the properties from the last received radio packet.

radio.getReceivedPacketProperty(radio.PacketProperty.SignalStrength)

Parameters

• type: the property type to get from the packet. These are:

• signal strength: the strength of the radio signal when the packet was received.
• serial number: the serial number of the board sending the packet.
• time: the time when the packet was sent.

Returns

• a number that is the property selected in the type parameter.

Example

This program uses the signal strength from received packets to graph the approximate distance between two @boardname@s.

basic.forever(() => {
    radio.sendNumber(0)
})
radio.onReceivedNumber(function (receivedNumber) {
    led.plotBarGraph(
        Math.abs(radio.getReceivedPacketProperty(radio.PacketProperty.SignalStrength) + 42),
        128 - 42
    )
})

See also

set transmit serial number