pxt-calliope/docs/reference/radio/on-received-value.md

on Received Value

Run part of a program when the @boardname@ receives a name-value-pair over radio.

radio.onReceivedValue(function (name, value) {})

Parameters

• name: a string that is a name for the value received.
• value: a number that is the value received.

~ hint

Watch this video to see how the radio hardware works on the @boardname@:

https://www.youtube.com/watch?v=Re3H2ISfQE8

~

Example

This program keeps sending numbers that say how fast the @boardname@ is slowing down or speeding up. When it receives numbers for the same thing from nearby @boardname@s, show the numbers as a bar graph.

basic.forever(() => {
    radio.sendValue("accel-x", input.acceleration(Dimension.X))
})
radio.onReceivedValue(function (name, value) {
    if (name == "accel-x") {
        led.plotBarGraph(value, 1023);
    }
})

Troubleshooting

The ||radio:on received value|| event can only be created once, due to the hardware restrictions.

The radio set group might need to be set, synchronized , before the radio events will function.

See also

on received number, received packet, send number, send string, send value, set group

radio