Skip to content

Statuses, errors, indicators

There are two main status indication areas on Brian. Some error states are communicated using additional channels:

  • Charging status LED: Indicates battery and charging status, placed near the USB-C port. The LED is active even when Brian is off, but connected to a charger.
  • Status bar: Top part of the LCD display. Indicates various states and information. Brian needs to be running for the status bar to be active.
  • Error animations: Brian is in beta-testing and errors may still occur. Some errors are detected and communicated to the user.

Status bar

Status bar contains information about a state of various functions. The list of icons from right to left:

Charging status

Battery and charging status can be seen at two different places - the status LED, which is operational even when Brian is powered off; and icons shown in the status bar.

Status bar icon LED behavior Description
Battery icon Off No charger connected
Battery icon - charged Green Fully charged; Charger is connected
Battery icon - charging Orange Charging
Battery icon - slow charging Red

Slow charging or discharging with a connected charger

This may be caused by a high power consumption (motors running) or a low output power of the used charger

Battery icon - empty Flashing red

Battery is very low or empty, Brian will shutdown

When Brian is shutting down, it indicates this by a red fading out and down effect of the knob.

Display off Flashing red

Battery or internal electronics is overheating. Self shutdown.

Overheating

When Brian's battery or internal electronics will start to get too hot, the temperature warning icon (Temperature warning icon) will be shown in the status bar, on the right side of the battery icon. When this is shown, performance is limited (charging speed, motor output, ...)

In case the temperature will keep rising, Brian will self-shutdown to prevent damage or battery fire. At this point, it will no longer be possible to run user programs or do anything in the menu. The display will be shutdown and refuse to power on. See section brian overheating.

Audio output

The speaker icon shows current setting of the volume and a sound output:

Output device 0% (mute) 1 - 33% 34 - 66% 67 - 100%
Internal speaker Speaker icon - internal, 0% (mute) Speaker icon - internal, 1-33% Speaker icon - internal, 34-66% Speaker icon - internal, 67-100%
Jack / headphones Speaker icon - jack, 0% (mute) Speaker icon - jack, 1-33% Speaker icon - jack, 34-66% Speaker icon - jack, 67-100%

SD card

When micro sd card is inserted, it can be in various states. These are indicated by the following icons:

Icon Description
No icon No card inserted
SD card icon

Card detected, processing...

For example when mounting, unmounting or something else. File system cannot be accessed and the card cannot be pulled out.

SD card icon Card is ready
SD card icon Card is mounted to a computer
SD card icon Card can be ejected by user, waiting...
SD card icon

Card is no longer usable because of an error

Card needs to be ejected and reinserted for a new attempt

Identification

The text in the left part of the status bar is an identification of Brian and a specific hardware and firmware version you are using. This is very helpful information for the developers whenever they are addressing reported issues.

Preview: Brian version identification

Beta testing: Sending feedback

Brian is currently in beta-testing phase and we want to involve the community as much as possible. We ask for feedback and bug reports and our big thank you goes to everyone who will contact us with a constructive feedback.

Feedback: https://github.com/Voltavian/brian-forum/issues

[ ] When we move away from beta-testing, you will be able to set a custom name or other identification for each of your Brian's. This will be displayed here.

Error animations

Empty battery

A red color fades down and out of the knob, whenever Brian's battery is too low to power on (or continue operation while powered on), it will shut itself down to prevent a battery damage. If this happens, please do not attempt to restart Brian, but rather connect a charger and wait for the battery to charge a little bit.

Brian overheating

Similar to the case of empty battery, a red color fades down and out of the knob and an error icon is shown on the display. After that, the display will stay black and Brian will shutdown. If connected to the external power, its display will stay off and the red status LED by the USB port will be blinking.

Please leave Brian to cool down.

Internal communication lost

A red inside-out animation is shown on the UI knobs and buttons. It is similar, but not the same as the power-off animation. If you see this, please report it to the developers.

[ ] Brian is internally controlled by a main processor and a co-processor. They are connected by a communication link. When this link is temporarily lost the animation is triggered. In some cases, this is an expected behavior. For example, when uploading the code to the main processor.

Co-processor crash

The knob and the buttons are solid red color. If you have sd card inserted, a log may have been created in the brian_logs directory. If you see this error, please report it to the developer, with the log file. Pressing the knob may restore Brian's operation. If not, you can trigger a force shutdown by pressing all four buttons simultaneously, while not being connected to a charger.

[ ] This state indicates a crash of the co-processor was detected. The co-processor then immediately restarts and attempts to push a log message and stack trace to the main processor, which can log this to the micro sd card, if enabled and the card is present. The knob press restarts the co-processor to a normal state, however, the problem may persist if it was caused for example by an erroneous command from the main processor and the co-processor may enter the crashed state again.