Browse the documentation

Preview documentation for AEL Beta 0.0.1 — launching soon

Monitoring a device

In AEL, the Agent Engineering Language, you will flash and monitor supported boards from the command line. ael monitor (command names may change before launch) will show the output of one device that you select, such as the lines a program on a board writes to its serial connection.

Status

Planned for AEL Beta 0.0.1. AEL is not available yet.

Usage

Preview syntax — may change before launch
ael monitor --device <device>
ael monitor --device <device> --json
OptionMeaning
--device <device>The device to monitor, by an identity from ael devices.
--jsonThe device's output and events in machine-readable form.

Stop monitoring by interrupting the command, as you would any program in your terminal.

What it shows

It will show:

  • What the device sends, as it arrives.
  • Events around it: the device connecting, disconnecting or restarting.

Bounded by design

  • Output will be bounded. The monitor will limit how fast it shows output and how much it keeps, so a busy device cannot flood your terminal or your disk.
  • Stopping will be prompt. Interrupting the monitor will stop it promptly, even while the device is sending.
  • One user at a time. The monitor will take the device for itself while it runs. A device that is being flashed will not be available to monitor until the flash has finished.

When the device goes away

If the device is unplugged or stops answering, ael monitor will say so clearly and end, rather than wait without a word. It will never switch to another device on its own.

What it never does

  • It will never flash, reset or reconfigure the device.
  • It will never select a device for you: --device will be required.