pxt-calliope/docs/reference/radio/send-number.md

79 lines
1.8 KiB
Markdown
Raw Normal View History

2016-03-26 00:47:20 +01:00
# Send Number
Broadcasts a number data packet to other micro:bits connected via ``radio``.
## Important Security Consideration
The functions in the ``radio`` namespace allow the BBC micro:bit to communicate with other micro:bits.
This API does not contain any form of encryption, authentication or authorization. It's purpose is solely for use as a teaching aid to demonstrate how simple communications operates, and to provide a sandpit through which learning can take place.
For serious applications, BLE should be considered a substantially more secure alternative.
```sig
radio.sendNumber(0)
```
### Parameters
* packet - a number to be transmitted.
### Examples
Broadcasts the value of ``acceleration`` x to other micro:bits.
```blocks
input.onButtonPressed(Button.A, () => {
radio.sendNumber(input.acceleration(Dimension.X))
})
```
### Light level sender
This example broadcasts the level of the light around it:
```blocks
radio.setGroup(99)
basic.forever(() => {
let level = input.lightLevel()
radio.sendNumber(level)
})
```
This example shows the light level from the sender (above):
```blocks
radio.setGroup(99)
basic.forever(() => {
let level = radio.receiveNumber()
basic.showNumber(level)
})
```
### Mailbot
This example takes the signal from the light level sender (above)
and shows a text string if the light level becomes much brighter.
You can put the light level sender in your mailbox and it will
tell you when someone opens the box. You can try this with a normal
box too, like a present.
```blocks
radio.setGroup(99)
let max = 0
basic.forever(() => {
let level = radio.receiveNumber()
if (level > max) {
let max = level
}
if (max > 10) {
basic.showString("ALERT")
}
})
```
2016-03-26 00:47:20 +01:00
### See also
2016-04-16 00:02:26 +02:00
[receive number](/reference/radio/receive-number), [on data received](/reference/radio/on-data-received)
2016-03-26 00:47:20 +01:00