Console

Utilities No project needed

Watch live output and device logs without leaving the toolkit.

The Console shows a running log of what the toolkit is doing — build output, load progress and other tasks — and can stream live logs from the connected display. Click Console on the toolbar to show it, and again to hide it.

Note: Tasks such as Generate, Load To Target and Add SDK Package open the Console by themselves, and close it again when they succeed. If you opened the Console yourself, it stays open. If a task fails, it stays open so you can read what went wrong.
Note: If a job stops at Waiting for Debugger to Attach, CLI Debug is switched on — see Debug the CLI to use it, or turn it off under Account → Options.

The Console panel is shown below, idle, with each numbered button described in turn:

  1. Watch Diagnostics — streams the display's kernel and system log (dmesg -w).
  2. Watch LayerManager — streams the log of Ahsoka.LayerManager, which manages the display's screens and surfaces.
  3. Watch Application — streams the log of your app: its Ahsoka.Application, Ahsoka.UserInterface and Ahsoka.Services units, plus every service your package installs (such as the ones ticked on the Service Manager panel).
  4. Watch Installer — streams the log of Ahsoka.Installer, which installs packages on the display.
  5. Copy — copies the whole log to the clipboard, as plain text.
  6. Close — hides the Console. The log is kept, so it's still there when you open the Console again.
The Console panel, numbered
The Console panel, numbered

Watch a Device Log

Watch video walkthrough

  1. On the toolbar, click Console.

    The Console button
    The Console button
  2. Click a Watch button — here, Watch Diagnostics.

    The Watch Diagnostics button
    The Watch Diagnostics button
  3. The log is cleared, and the display's log streams in live — first everything already in it, then each new line as it happens. While it runs, the toolbar is greyed out, and the Watch buttons are replaced by Cancel. The bar at the bottom shows the newest line, with a second Cancel button. To stop, click Cancel.

    Watch Diagnostics streaming, with the Cancel button
    Watch Diagnostics streaming, with the Cancel button
  4. The log ends with Watch Diagnostics Messages (dmesg) Ended, and the Watch buttons are back.

    The watch stopped
    The watch stopped
Note: The Console always scrolls to the newest line while a log is streaming. To read earlier lines, click Cancel first, or click Copy and paste the log somewhere else.
Note: The Watch buttons connect over SSH to the connection selected in Active Connection. If the display isn't reachable, there's no error — after up to 30 seconds the log just shows the watch Ended, with nothing in between. Check that the display is connected and try again.
Note: The Console keeps about the last 2,000 lines on screen. Copy still copies everything since the log was last cleared.

What Each Watch Shows

Watch LayerManager shows the screens and surfaces being set up — here, the startup logo surface being created, configured and then removed.

Watch LayerManager
Watch LayerManager

Watch Application shows your app starting — here, Ahsoka.CS.SimpleUI starting its services and creating its window.

Watch Application
Watch Application

Watch Installer shows the log of the display's Installer, so it only has data while the display is running the Installer — while a package is being installed, or after you stop your app. When the display is running your app, it's empty. See Watch the Installer below.

Watch the Installer

  1. Watch Installer only has data while the display is running the Installer. To switch the display to the Installer, click Stop Application (■) in the bar at the bottom.

    The Stop Application button
    The Stop Application button
  2. Your app stops and the display restarts into the Installer. Once it's back, the bar shows Connected to OpenView (Ahsoka.Installer.UI).

    Connected to the Installer
    Connected to the Installer
  3. On the toolbar, click Console, then click Watch Installer. The Console shows Stop Application Sent from the step before.

    The Watch Installer button
    The Watch Installer button
  4. The Installer's log streams in — here, the Installer starting its services, its screen, USB and WiFi. Click Cancel to stop watching.

    Watch Installer streaming the Installer's log
    Watch Installer streaming the Installer's log
Note: Your app stays stopped until you load it again with Load To Target.
Note: Opening New... or Open... hides the Console panel.