modelPartialUartDevice

Information

Base class of the external serial devices. It cannot be instantiated directly: a concrete device extends it and sets its parameters — see Peripherals.UartEchoDevice, UartTemperatureSensor, UartGpsModule, UartLcd20x2, or Peripherals.UartGenericDevice for a device entirely described by its parameters.

The device is connected electrically to two GPx pins of an MCU: it receives real frames and transmits real ones, at its own baud rate and in its own format (dataBits, parity, stopBits: 8N1 by default, same choices as machine.UART). A baud rate or format mismatch with the microcontroller therefore produces wrong bytes, as on a real circuit; a received byte with a wrong parity bit or a low stop bit is kept, with a warning in the log (the first ten, then a total at the end of the simulation).

Two transmission modes, which can be combined, feeding the same queue:

• Request / response: the received bytes accumulate up to terminator, the complete line is matched against commandTable, and the reply leaves after responseDelay.
• Periodic: periodicTemplate is transmitted spontaneously every period seconds, without being asked.

Quantities exchanged with the rest of the model. {v1}…{vN} insert valueIn into a transmitted frame (with an optional precision, {v1:.1f}); {o1}…{oN}, placed in a command, capture a number of the received frame into valueOut. The same device can therefore be both sensor and actuator, which lets a control loop be closed inside the model.

The two dots of the icon light up during a transmitted frame (amber) or a received one (cyan) — visible while replaying a result with animation in OMEdit, not on a static rendering. Each received line and each transmitted payload also produce a line in the simulation log, prefixed with the component name.

Parameters

Connectors

Components