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

# Received Packet Property

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

```sig
radio.receivedPacket(RadioPacketProperty.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](/types/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.

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

## See also

[set transmit serial number](/reference/radio/set-transmit-serial-number)

```package
radio
```