Skip to content

probe-web / @probe-web/ui / ProbeSerialMonitor

Class: ProbeSerialMonitor

Defined in: packages/ui/src/serial-monitor.ts:23

<probe-serial-monitor>: a WebSerial console (baud picker, send line with a chosen line ending, RTS reset pulse, clear) in an xterm.js terminal. For boards whose console is a UART bridge rather than RTT. The first previously granted port is preselected.

Fires

  • serial-line: One per complete line received. detail is the line (a string, without its line ending).
  • serial-state: The port was opened or closed. detail is { connected: boolean, reason?: string }; reason says why it closed.

Extends

  • LitElement

Constructors

Constructor

ts
new ProbeSerialMonitor(): ProbeSerialMonitor;

Defined in: node_modules/@lit/reactive-element/development/reactive-element.d.ts:527

Returns

ProbeSerialMonitor

Inherited from

ts
LitElement.constructor

Properties

PropertyTypeDefault valueDescriptionDefined in
portSerialPortLike | nullnullThe port to use; set it, or let the user pick one with Choose port….packages/ui/src/serial-monitor.ts:40
baudRatenumber115200Baud rate used by ProbeSerialMonitor.connect.packages/ui/src/serial-monitor.ts:42
lineEndingLineEnding'crlf'Line ending appended by ProbeSerialMonitor.send: 'none', 'lf', 'cr' or 'crlf'.packages/ui/src/serial-monitor.ts:44

Methods

choosePort()

ts
choosePort(): Promise<void>;

Defined in: packages/ui/src/serial-monitor.ts:85

Open the browser's port chooser (needs a user gesture) and select the chosen port.

Returns

Promise<void>


connect()

ts
connect(): Promise<void>;

Defined in: packages/ui/src/serial-monitor.ts:95

Open ProbeSerialMonitor.port at ProbeSerialMonitor.baudRate and start showing its output; fires serial-state.

Returns

Promise<void>


disconnect()

ts
disconnect(): Promise<void>;

Defined in: packages/ui/src/serial-monitor.ts:117

Close the port; serial-state fires once it has closed.

Returns

Promise<void>


send()

ts
send(text): Promise<void>;

Defined in: packages/ui/src/serial-monitor.ts:129

Send a line with the selected line ending.

Parameters

ParameterType
textstring

Returns

Promise<void>