Skip to content

Accessing the Terminal

Jump to bottom
Ted Salmon edited this page Apr 7, 2021 · 2 revisions

macOS

First, plug the BlueBus into your machine and open Terminal. In Terminal, issue the following command:

screen /dev/tty.usbserial* 115200

In the new screen, you should see the BlueBus version string.

The BlueBus is now ready to accept commands. Try help for the available command list.

Windows 7, 8, 8.1, 10 (non-WSL)

Please download PuTTY.

Then:

  1. Plug the BlueBus in

  2. Hold down the "Windows Flag" key on your Keyboard, then hit r at the same time. Type in: devmgmt.msc into the small box that has popped up, then click Ok

  3. Look under "Ports (COM & LPT)

  4. Note the "COM" port number

  5. Open PuTTY

  6. Click on "Session" at the top left, then "Serial" (radio button on the right) then type in the COM number and for the speed use 115200

  7. Click "Open"

The BlueBus is now ready to accept commands. Try help for the available command list.

Troubleshooting

If you are not able to type into PuTTY, you're not seeing any "COM" ports, or if macOS is complaining that the "File does not exist", please read below.

macOS

  1. Try another cable. Many USB Micro-B cables are "Charge only", meaning that the data lines are missing, making it useless for data communcation.

  2. If your BlueBus has Phillips screws on top, slightly loosen them off so you can better seat the USB cable.

Windows

  1. Try another cable. Many USB Micro-B cables are "Charge only", meaning that the data lines are missing, making it useless for data communcation.

  2. If your BlueBus has Phillips screws on top, slightly loosen them off so you can better seat the USB cable.

  3. Check the Device Manager

    1. Windows 10: Right Click the "Start" menu button > Device Manager
    2. All other versions: Hold the "Windows Key" on the keyboard then hit r. In the box that pops up, enter devmgmt.msc and hit enter
    3. Disconnect the BlueBus and reconnect it. If the screen DOES NOT refresh itself, then there is an issue with the USB cable.
    4. If the screen does refresh, look for any entry that might say FT232R or USB Serial Converter. If you see either of these entries, you need to download and install the drivers. I recommend the "setup executable" linked for Windows.
    5. After installing the drivers, reboot and try again.
Clone this wiki locally