how do I install scantool proram

**lkraemer** · November 15th, 2010

How to enable BLUETOOTH in Ubuntu 10.04 for a BLUETOOTH ODBII Code Reader.

First of all, serial ports come in at least three different flavors.

- An old fashioned hardware based serial port, typically with a 9-pin connector on the computer
- A USB to Serial Adapter, plugged into a USB Port
- A Bluetooth (built-in or dongle) Serial Port Profile (SPP)

All of these are mapped to COMx names in Windows, where x is one or two digits, i.e. COM1.
In Linux there are separate names for each type: /dev/ttyS0, /dev/ttyUSB0 and /dev/rfcomm0.
As in Windows, the last digit might be different if more than one of each type is provided.

Note that /dev/ttyS0 is an ordinary serial port on your machine. If you use a USB to Serial
Adapter, you should instead use /dev/ttyUSB0. Also note, that the last digit in the Linux
name might be a different number, if you have more than one serial port or more than one
USB to Serial adapter.

INSTALL THE SUPPORTING BLUETOOTH SOFTWARE:
Install Blueman with Synaptics Package Manager

DETECT THE DEVICE - BLUETOOTH
Insert the USB Bluetooth Adapter in a USB Port. I used a Trendnet TBW-105UB.
Open a Linux Terminal window and cut/paste the following commands with
the BLUETOOTH Adapter plugged into a USB port.

Code:

 
lsusb

This will return a Manufactuer & Product Number, so use it to get more information....0a5c:2101...)

Code:

Bus 008 Device 003: ID 0a5c:2101 Broadcom Corp. A-Link BlueUsbA2 Bluetooth
Bus 008 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 007 Device 002: ID 046d:c408 Logitech, Inc. Marble Mouse (4-button)
Bus 007 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 006 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 005 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 004 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 003 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 003: ID 04f2:b091 Chicony Electronics Co., Ltd 
Bus 001 Device 002: ID 0bda:0158 Realtek Semiconductor Corp. Mass Storage Device
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Code:

lsusb -v -d 0a5c:2101

Code:

Bus 008 Device 003: ID 0a5c:2101 Broadcom Corp. A-Link BlueUsbA2 Bluetooth
Device Descriptor:
  bLength                18
  bDescriptorType         1
  bcdUSB               2.00
  bDeviceClass          224 Wireless
  bDeviceSubClass         1 Radio Frequency
  bDeviceProtocol         1 Bluetooth
  bMaxPacketSize0        64
  idVendor           0x0a5c Broadcom Corp.
  idProduct          0x2101 A-Link BlueUsbA2 Bluetooth
  bcdDevice            1.00
  iManufacturer           1 Broadcom Corp
  iProduct                2 BCM92045B3 ROM
  iSerial                 0 
  bNumConfigurations      1
  Configuration Descriptor:
    bLength                 9
    bDescriptorType         2
    wTotalLength          216
    bNumInterfaces          4
    bConfigurationValue     1
    iConfiguration          0 
    bmAttributes         0xa0
      (Bus Powered)
      Remote Wakeup
    MaxPower              100mA
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        0
      bAlternateSetting       0
      bNumEndpoints           3
      bInterfaceClass       224 Wireless
      bInterfaceSubClass      1 Radio Frequency
      bInterfaceProtocol      1 Bluetooth
      iInterface              0 
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x81  EP 1 IN
        bmAttributes            3
          Transfer Type            Interrupt
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0010  1x 16 bytes
        bInterval               1
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x82  EP 2 IN
        bmAttributes            2
          Transfer Type            Bulk
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0040  1x 64 bytes
        bInterval               1
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x02  EP 2 OUT
        bmAttributes            2
          Transfer Type            Bulk
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0040  1x 64 bytes
        bInterval               1
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        1
      bAlternateSetting       0
      bNumEndpoints           2
      bInterfaceClass       224 Wireless
      bInterfaceSubClass      1 Radio Frequency
      bInterfaceProtocol      1 Bluetooth
      iInterface              0 
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x83  EP 3 IN
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0000  1x 0 bytes
        bInterval               1
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x03  EP 3 OUT
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0000  1x 0 bytes
        bInterval               1
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        1
      bAlternateSetting       1
      bNumEndpoints           2
      bInterfaceClass       224 Wireless
      bInterfaceSubClass      1 Radio Frequency
      bInterfaceProtocol      1 Bluetooth
      iInterface              0 
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x83  EP 3 IN
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0009  1x 9 bytes
        bInterval               1
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x03  EP 3 OUT
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0009  1x 9 bytes
        bInterval               1
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        1
      bAlternateSetting       2
      bNumEndpoints           2
      bInterfaceClass       224 Wireless
      bInterfaceSubClass      1 Radio Frequency
      bInterfaceProtocol      1 Bluetooth
      iInterface              0 
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x83  EP 3 IN
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0011  1x 17 bytes
        bInterval               1
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x03  EP 3 OUT
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0011  1x 17 bytes
        bInterval               1
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        1
      bAlternateSetting       3
      bNumEndpoints           2
      bInterfaceClass       224 Wireless
      bInterfaceSubClass      1 Radio Frequency
      bInterfaceProtocol      1 Bluetooth
      iInterface              0 
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x83  EP 3 IN
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0019  1x 25 bytes
        bInterval               1
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x03  EP 3 OUT
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0019  1x 25 bytes
        bInterval               1
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        1
      bAlternateSetting       4
      bNumEndpoints           2
      bInterfaceClass       224 Wireless
      bInterfaceSubClass      1 Radio Frequency
      bInterfaceProtocol      1 Bluetooth
      iInterface              0 
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x83  EP 3 IN
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0021  1x 33 bytes
        bInterval               1
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x03  EP 3 OUT
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0021  1x 33 bytes
        bInterval               1
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        1
      bAlternateSetting       5
      bNumEndpoints           2
      bInterfaceClass       224 Wireless
      bInterfaceSubClass      1 Radio Frequency
      bInterfaceProtocol      1 Bluetooth
      iInterface              0 
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x83  EP 3 IN
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0031  1x 49 bytes
        bInterval               1
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x03  EP 3 OUT
        bmAttributes            1
          Transfer Type            Isochronous
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0031  1x 49 bytes
        bInterval               1
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        2
      bAlternateSetting       0
      bNumEndpoints           2
      bInterfaceClass       255 Vendor Specific Class
      bInterfaceSubClass    255 Vendor Specific Subclass
      bInterfaceProtocol    255 Vendor Specific Protocol
      iInterface              0 
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x84  EP 4 IN
        bmAttributes            2
          Transfer Type            Bulk
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0020  1x 32 bytes
        bInterval               1
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x04  EP 4 OUT
        bmAttributes            2
          Transfer Type            Bulk
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0020  1x 32 bytes
        bInterval               1
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        3
      bAlternateSetting       0
      bNumEndpoints           0
      bInterfaceClass       254 Application Specific Interface
      bInterfaceSubClass      1 Device Firmware Update
      bInterfaceProtocol      0 
      iInterface              0 
      Device Firmware Upgrade Interface Descriptor:
        bLength                             7
        bDescriptorType                    33
        bmAttributes                        5
          Will Not Detach
          Manifestation Tolerant
          Upload Unsupported
          Download Supported
        wDetachTimeout                   5000 milliseconds
        wTransferSize                      64 bytes
Device Status:     0x0000
  (Bus Powered)

Code:

dmesg | tail

[ 1062.710711] Bluetooth: RFCOMM TTY layer initialized
[ 1062.710720] Bluetooth: RFCOMM socket layer initialized
[ 1062.710725] Bluetooth: RFCOMM ver 1.11

LINKING the COMM PORT: SYMBOLIC vs HARD

Code:

ls -l /dev/ttyS*

crw-rw---- 1 root dialout 4, 64 2010-11-14 21:37 /dev/ttyS0
crw-rw---- 1 root dialout 4, 65 2010-11-14 21:37 /dev/ttyS1
crw-rw---- 1 root dialout 4, 66 2010-11-14 21:37 /dev/ttyS2
crw-rw---- 1 root dialout 4, 67 2010-11-14 21:37 /dev/ttyS3

Plug the Bluetooth ODBII Reader into the vehicle's ODBII Port.
Click on the Bluetooth Icon in the Top Right Toolbar, and select the
Device once it is detected. Select the PIN, or try 1234. Open Blueman,
and start the Serial Service. This should create /dev/rfcomm0, and there should
be a additional BLUE DOT on the Top Right of the Blueman Icon in the Top Toolbar.

Code:

ls -l /dev/rf*
sudo chmod 766 /dev/rfcomm0

Create a HARD Link to an unused COMM Port. We need to REMOVE
/dev/ttyS3, and then create a HARD Link with:

Code:

sudo rm /dev/ttyS3
sudo ln /dev/rfcomm0 /dev/ttyS3
sudo chmod 766 /dev/ttyS3

Open your ODBII Software, and select the proper Communications Port & the correct Baud Rate.

LK

REF:
http://www.techmetica.com/howto/blue...tu-linux-bluez

**lkraemer** · April 11th, 2011

For all you Linux Folks & Windows too, there is a OBDII Software program
that works with the ELMSCAN5 (ELM327) and the Chinese Clone (F54) sold by
lilinghua597v2009 on Ebay. This software can be downloaded and tested with
your Serial, USB, Bluetooth OBDII Adapter before purchase.

I've uploaded a Video on youtube titled "OBDAutoDoctor-Demo". Check out
the video, and download the DEMO software to test Communications with your
OBDII Device. http://www.obdautodoctor.com/

There is an new Version of software that should be available early May 2011,
if all goes well with the Developer.

When it is released I'll rework my video, and post on youtube, along with a review
of the new software.

lk

**wright.hans@gmail.com** · October 4th, 2011

this is a fully working solution
https://www.scantool.net/forum/index.php?topic=5096.0
download the compressed folder at http://www.megaupload.com/?d=8X82CCW2
enable bluetooth here https://www.scantool.net/forum/index...17327#msg17327

**rewoiu** · February 12th, 2012

Originally Posted by jlac

With this patch dzcomm is not necessary, scantool uses termios instead.
We don't need to make symlink, /dev/ttyUSB? is detected by scantool_net.

Get the ScanTool.net package here (http://www.scantool.net/scantool/dow..._net121src.zip)
Get this patch Attachment 163552

Code:

sudo apt-get install liballegro4.2-dev liballegro4.2
mkdir scantool
cd scantool
unzip ../scantool_net121src.zip
zcat ../scantool_net121-linux-termios.patch.gz | patch
make
./ScanTool

Works perfect.. Thanks for the patch and instructions.. Most helpful

**gsgleason** · April 22nd, 2012

I am having issues:

Code:

greglap ~/scantool
$ zcat scantool_net121-linux-termios.patch.gz |patch
patching file error_handlers.c
patching file main.c
patching file makefile
patching file options.c
patching file reset.c
patching file serial.c
patching file serial.h
gsg@greglap ~/scantool
$ make
gcc -O -Wall -Werror -DTERMIOS -c main.c
gcc -O -Wall -Werror -DTERMIOS -c main_menu.c
gcc -O -Wall -Werror -DTERMIOS -c serial.c
serial.c: In function ‘read_comport’:
serial.c:289:8: error: variable ‘i’ set but not used [-Werror=unused-but-set-variable]
cc1: all warnings being treated as errors

make: *** [serial.o] Error 1

I got it to work by removing the -Wall from the makefile.

**markzielon** · October 28th, 2012

I'm going to add a footnote just to hopefully save some time and frustration to people who have had my errors

IF USING AN ELMSCAN 5 (or similar), you do not need to do any hard linking. If your system generates a /dev/ttyUSB0 (etc) folder for you, the program should automatically recognize the port.

IF NO RESULTS SHOW UP IN THE COM PORT FIELD - Make sure you are running ScanTool as ROOT.

Good luck!