pxt-calliope/docs/reference/radio/set-group.md

46 lines
1.1 KiB
Markdown

# set Group
Make a program have the group ID you tell it for sending and receiving
with radio.
```sig
radio.setGroup(0);
```
A group is like a cable channel (a @boardname@ can only
send or receive in one group at a time). A group ID is like the cable
channel number.
If you do not tell your program which group ID to use with this
function, it will figure out its own group ID by itself. If you load
the very same program onto two different @boardname@s, they will be able
to talk to each other because they will have the same group ID.
## Parameters
* **id**: a [number](/types/number) from ``0`` to ``255``.
## Simulator
This function only works on the @boardname@, not in browsers.
## Example
This program makes the group ID equal 128.
```blocks
radio.setGroup(128)
```
## See also
[on received number](/reference/radio/on-received-number),
[on received string](/reference/radio/on-received-string),
[on received value](/reference/radio/on-received-value),
[send number](/reference/radio/send-number),
[send value](/reference/radio/send-value),
[send string](/reference/radio/send-string)
```package
radio
```