Gathering a Log - tedsalmon/BlueBus GitHub Wiki

macOS

First, with your BlueBus connected to the car, plug it into your machine and open Terminal. In Terminal, issue the following command to get the port for the BlueBus:

ls /dev/tty.usbserial-*

This should return one item. Make a note of the full path (copy it).

Now, run:

cd Downloads && screen -L /dev/tty.usbserial-xxxxx 115200

Replace /dev/tty.usbserial-xxxxx with the actual full path you just copied.

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

Type in the following commands (each terminated with a press of the enter key) to ensure we are logging all debug info:

set log ibus on
reboot
set log bt on
set log sys on

Now, return to the cabin and perform whatever action you wish to log.

When finished, come back to the laptop and run the following commands: Type in the following commands (each terminated with a press of the enter key) to ensure we are logging all debug info:

set log ibus off
set log bt off
set log sys off

Then, hit Ctrl + a then k and when you see it prompt at the very bottom, hit y. That will exit screen back to the Terminal you were in.

Close Terminal and send screenlog.0 from your Downloads folder via email. Ensure that you delete the file afterwards!

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 and select "Logging" on the left hand menu

  6. Under "Session Logging" select "All session output"

  7. Click "Browse" under "Log file name" and place the file in your downloads folder. Call it "bluebus.txt".

  8. 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

  9. Click "Open"

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

To ensure we are logging all debug info, Type in the following commands:

set log bt on
set log sys on
set log ibus on
reboot

It's a good idea to execute the bt log command first as the ibus log one creates a lot of noise and would make it more difficult to get the second command in. Now, return to the cabin and perform whatever action you wish to log.

Windows 10 (Windows Subsystem for Linux)

First, download and enable the Windows Subsystem for Linux (WSL)
This example uses the Ubuntu Linux distribution.

Plug your BlueBus into your Windows Machine. If doing this for the first time, Windows will automatically install a driver for BlueBus and may prompt you to restart. Do this if prompted. Your BlueBus will appear under Ports (COM & LPT) in Device Manager.

If it's not clear which of these is your BlueBus, unplug it from your PC, cycle Device Manager and plug it back in again.

The BlueBus will be the new device of port type COM that appears e.g. COM3 Make a note of this COM Port number.

Open the Ubuntu app. Navigate to your desired directory, bearing in mind C:\ is under /mnt. e.g:

cd /mnt/c/Users/John/Downloads/bluebus

Now run:

screen -L /dev/ttySX 115200

where X is the number of the COM port in device manager you noted earlier; e.g.: 3

If you get a screen 'permission denied' error you'll need to run:

sudo /etc/init.d/screen-cleanup start

Or alternatively, see this thread for making changes to your .bashrc

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

To ensure we are logging all debug info, Type in the following commands:

set log bt on
set log sys on
set log ibus on
reboot

These are case sensitive and it's a good idea to execute the bt log command first as the ibus log one creates a lot of noise and would make it more difficult to get the second command in. Now, return to the cabin and perform whatever action you wish to log.

When finished, come back to the machine and hit Ctrl + a then Shift + h. This will save a file to your working directory called screenlog.0. To exit the screen hit Ctrl + a then k and when you see it prompt at the very bottom, hit y. That will exit screen back to the Terminal you were in.

Close Terminal and send screenlog.0 from your working directory folder via email. Ensure that you delete the file afterwards!

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.