pxt-calliope/docs/reference/serial/write-line.md
Juri Wolf a93febb5b7
Map and clean deprecated functions (#175)
* add image and deprecated arrow functions

* update locales

* map basic.showArrow

* map arrow blocks

* map & remove arrow images

* remove arrow blocks

* update locales

* remove & patch:
rgbw -> rgb
button/pin pressed -> button/pin event
loudness -> soundLevel

* update ts mappings for arrows

* add wip ts patch rules

* update .blocks files

* use Click instead of Down as default in Documentation and tests

* patch test.blocks

* fix lowercase name tag

* update test.blocks

* update blocks test files

* update blocks test files

* format block files

* pass blocks file tests

* fix ts mapping

* fix color.defl value

closes https://github.com/microsoft/pxt-calliope/issues/136

* fix ts mappings

- add optional spacing at the end of rgbw()
- map up to v4.0.19

* add suggested changes

* replace innerText by textContent

Co-authored-by: JW <gitkraken@juriwolf.de>
Co-authored-by: Juri <info@juriwolf.de>
2022-04-26 10:28:42 -07:00

63 lines
1.5 KiB
Markdown

# Serial Write Line
Write a string to the [serial](/device/serial) port and start a new line of text
by writing `\r\n`.
```sig
serial.writeLine("");
```
## Parameters
* `text` is the [string](/types/string) to write to the serial port
## Examples
### Simple serial
Write the word `BOFFO` to the serial port repeatedly.
```blocks
basic.forever(() => {
serial.writeLine("BOFFO");
basic.pause(5000);
});
```
### Streaming data
Check the [compass heading](/reference/input/compass-heading) and show the direction on the screen. Also, send both the direction and degree heading to the serial port.
```blocks
let degrees = 0
let direction = ""
basic.forever(() => {
degrees = input.compassHeading()
if (degrees < 45) {
basic.showIcon(IconNames.ArrowNorth)
direction = "North"
} else if (degrees < 135) {
basic.showIcon(IconNames.ArrowEast)
direction = "East"
} else if (degrees < 225) {
basic.showIcon(IconNames.ArrowSouth)
direction = "South"
} else if (degrees < 315) {
basic.showIcon(IconNames.ArrowWest)
direction = "West"
} else {
basic.showIcon(IconNames.ArrowNorth)
direction = "North"
}
serial.writeLine(direction + " @ " + degrees + " degrees")
basic.pause(500)
})
```
## See also
[serial](/device/serial),
[serial write number](/reference/serial/write-number),
[serial write string](/reference/serial/write-string),
[serial write value](/reference/serial/write-value)