Openbci_gui: [USABILITY] Warn users when the dongle and device are not on the same channel

Created on 4 Jan 2019  路  8Comments  路  Source: OpenBCI/OpenBCI_GUI

Problem

It's very confusing for new users if they hit "START SYSTEM" and then "Start Data Stream" but no data is streaming because the dongle and device are not on the same channel (or the device is off!). There is no warning or message to explain why no data is streaming, app behaves as if everything is normal.

When hitting "STATUS", the message "System is down" is pretty vague and does not convey to new users that the device and dongle are not talking at all. Users might assume they are talking, but that something else is wrong with the device.

Expected

  • When hitting "START SYSTEM" or "Start Data Stream" (ideally both, but at least the latter) warn users that the dongle and the device are not talking (due to channel mismatch, or device being off). A good place for this would be the status bar at the bottom.

  • When hitting "STATUS", we either get "System is up" or "System is down". Replace that with something else that explains that the dongle and the device are either talking or not talking. If they're not talking, suggest the "AUTOSCAN" button.

Operating System and Version

macOS/Windows/Linux

enhancement good first issue

All 8 comments

Working on this today!

Screen Shot 2019-05-04 at 12 29 50 PM
Screen Shot 2019-05-04 at 12 32 03 PM

"Success: System is up" or "Failure: System is down" are messages received from the board. As a compromise, the GUI can display additional information as Errors or Successes as seen above.

All we need to do here is replace "system is up" and "system is down" with somethinng more descriptive. For example:

"Success: Cyton dongle and board are connected"

"Failure: Cyton dongle could not connect to the board. Perhaps they are on different channels? Try hitting AUTOSCAN"

Most users will not click "STATUS" before starting the system. They will jsut pick a serial port and click "START SYSTEM". We need a way to show these users the failure error message. What you did with the output() message seems good enough IMO!

added the words " [connected] to Cyton". I agree this type of wording improves clarity.
Screen Shot 2019-05-04 at 12 43 08 PM

@daniellasry I can do that. I can catch both of those messages from the board and re-write them.

Should be fixed, here is the case where the Cyton board is off but the user selects the Dongle

Screen Recording 2019-05-04 at 2 47 47 PM 2019-05-04 14_49_23

Great fix richard!

Instead of "Failure: System is Down" :
Screen Shot 2019-05-04 at 1 42 48 PM

Was this page helpful?
0 / 5 - 0 ratings

Related issues

rakansha picture rakansha  路  5Comments

jps2000 picture jps2000  路  6Comments

mgroth0 picture mgroth0  路  5Comments

jps2000 picture jps2000  路  8Comments

cfausn picture cfausn  路  3Comments