├── README.md
├── testblescan.py
└── blescan.py


/README.md:
--------------------------------------------------------------------------------
 1 | Replaced by github.com/switchdoclabs/SDL_Pi_iBeaconScanner   2020
 2 | 
 3 | 
 4 | SwitchDoc Labs, LLC
 5 | June 2014
 6 | 
 7 | blescanner is a python program designed to read iBeacon advertizments using a Bluetooth Dongle on a Raspberry Pi
 8 | 
 9 | To test, "sudo python testblescanner.py"
10 | 
11 | 
12 | 


--------------------------------------------------------------------------------
/testblescan.py:
--------------------------------------------------------------------------------
 1 | # test BLE Scanning software
 2 | # jcs 6/8/2014
 3 | 
 4 | import blescan
 5 | import sys
 6 | 
 7 | import bluetooth._bluetooth as bluez
 8 | 
 9 | dev_id = 0
10 | try:
11 | 	sock = bluez.hci_open_dev(dev_id)
12 | 	print "ble thread started"
13 | 
14 | except:
15 | 	print "error accessing bluetooth device..."
16 |     	sys.exit(1)
17 | 
18 | blescan.hci_le_set_scan_parameters(sock)
19 | blescan.hci_enable_le_scan(sock)
20 | 
21 | while True:
22 | 	returnedList = blescan.parse_events(sock, 10)
23 | 	print "----------"
24 | 	for beacon in returnedList:
25 | 		print beacon
26 | 
27 | 


--------------------------------------------------------------------------------
/blescan.py:
--------------------------------------------------------------------------------
  1 | # BLE iBeaconScanner based on https://github.com/adamf/BLE/blob/master/ble-scanner.py
  2 | # JCS 06/07/14
  3 | 
  4 | DEBUG = False
  5 | # BLE scanner based on https://github.com/adamf/BLE/blob/master/ble-scanner.py
  6 | # BLE scanner, based on https://code.google.com/p/pybluez/source/browse/trunk/examples/advanced/inquiry-with-rssi.py
  7 | 
  8 | # https://github.com/pauloborges/bluez/blob/master/tools/hcitool.c for lescan
  9 | # https://kernel.googlesource.com/pub/scm/bluetooth/bluez/+/5.6/lib/hci.h for opcodes
 10 | # https://github.com/pauloborges/bluez/blob/master/lib/hci.c#L2782 for functions used by lescan
 11 | 
 12 | # performs a simple device inquiry, and returns a list of ble advertizements 
 13 | # discovered device
 14 | 
 15 | # NOTE: Python's struct.pack() will add padding bytes unless you make the endianness explicit. Little endian
 16 | # should be used for BLE. Always start a struct.pack() format string with "<"
 17 | 
 18 | import os
 19 | import sys
 20 | import struct
 21 | import bluetooth._bluetooth as bluez
 22 | 
 23 | LE_META_EVENT = 0x3e
 24 | LE_PUBLIC_ADDRESS=0x00
 25 | LE_RANDOM_ADDRESS=0x01
 26 | LE_SET_SCAN_PARAMETERS_CP_SIZE=7
 27 | OGF_LE_CTL=0x08
 28 | OCF_LE_SET_SCAN_PARAMETERS=0x000B
 29 | OCF_LE_SET_SCAN_ENABLE=0x000C
 30 | OCF_LE_CREATE_CONN=0x000D
 31 | 
 32 | LE_ROLE_MASTER = 0x00
 33 | LE_ROLE_SLAVE = 0x01
 34 | 
 35 | # these are actually subevents of LE_META_EVENT
 36 | EVT_LE_CONN_COMPLETE=0x01
 37 | EVT_LE_ADVERTISING_REPORT=0x02
 38 | EVT_LE_CONN_UPDATE_COMPLETE=0x03
 39 | EVT_LE_READ_REMOTE_USED_FEATURES_COMPLETE=0x04
 40 | 
 41 | # Advertisment event types
 42 | ADV_IND=0x00
 43 | ADV_DIRECT_IND=0x01
 44 | ADV_SCAN_IND=0x02
 45 | ADV_NONCONN_IND=0x03
 46 | ADV_SCAN_RSP=0x04
 47 | 
 48 | 
 49 | def returnnumberpacket(pkt):
 50 |     myInteger = 0
 51 |     multiple = 256
 52 |     for c in pkt:
 53 |         myInteger +=  struct.unpack("B",c)[0] * multiple
 54 |         multiple = 1
 55 |     return myInteger 
 56 | 
 57 | def returnstringpacket(pkt):
 58 |     myString = "";
 59 |     for c in pkt:
 60 |         myString +=  "%02x" %struct.unpack("B",c)[0]
 61 |     return myString 
 62 | 
 63 | def printpacket(pkt):
 64 |     for c in pkt:
 65 |         sys.stdout.write("%02x " % struct.unpack("B",c)[0])
 66 | 
 67 | def get_packed_bdaddr(bdaddr_string):
 68 |     packable_addr = []
 69 |     addr = bdaddr_string.split(':')
 70 |     addr.reverse()
 71 |     for b in addr: 
 72 |         packable_addr.append(int(b, 16))
 73 |     return struct.pack("<BBBBBB", *packable_addr)
 74 | 
 75 | def packed_bdaddr_to_string(bdaddr_packed):
 76 |     return ':'.join('%02x'%i for i in struct.unpack("<BBBBBB", bdaddr_packed[::-1]))
 77 | 
 78 | def hci_enable_le_scan(sock):
 79 |     hci_toggle_le_scan(sock, 0x01)
 80 | 
 81 | def hci_disable_le_scan(sock):
 82 |     hci_toggle_le_scan(sock, 0x00)
 83 | 
 84 | def hci_toggle_le_scan(sock, enable):
 85 | # hci_le_set_scan_enable(dd, 0x01, filter_dup, 1000);
 86 | # memset(&scan_cp, 0, sizeof(scan_cp));
 87 |  #uint8_t         enable;
 88 |  #       uint8_t         filter_dup;
 89 | #        scan_cp.enable = enable;
 90 | #        scan_cp.filter_dup = filter_dup;
 91 | #
 92 | #        memset(&rq, 0, sizeof(rq));
 93 | #        rq.ogf = OGF_LE_CTL;
 94 | #        rq.ocf = OCF_LE_SET_SCAN_ENABLE;
 95 | #        rq.cparam = &scan_cp;
 96 | #        rq.clen = LE_SET_SCAN_ENABLE_CP_SIZE;
 97 | #        rq.rparam = &status;
 98 | #        rq.rlen = 1;
 99 | 
100 | #        if (hci_send_req(dd, &rq, to) < 0)
101 | #                return -1;
102 |     cmd_pkt = struct.pack("<BB", enable, 0x00)
103 |     bluez.hci_send_cmd(sock, OGF_LE_CTL, OCF_LE_SET_SCAN_ENABLE, cmd_pkt)
104 | 
105 | 
106 | def hci_le_set_scan_parameters(sock):
107 |     old_filter = sock.getsockopt( bluez.SOL_HCI, bluez.HCI_FILTER, 14)
108 | 
109 |     SCAN_RANDOM = 0x01
110 |     OWN_TYPE = SCAN_RANDOM
111 |     SCAN_TYPE = 0x01
112 | 
113 | 
114 |     
115 | def parse_events(sock, loop_count=100):
116 |     old_filter = sock.getsockopt( bluez.SOL_HCI, bluez.HCI_FILTER, 14)
117 | 
118 |     # perform a device inquiry on bluetooth device #0
119 |     # The inquiry should last 8 * 1.28 = 10.24 seconds
120 |     # before the inquiry is performed, bluez should flush its cache of
121 |     # previously discovered devices
122 |     flt = bluez.hci_filter_new()
123 |     bluez.hci_filter_all_events(flt)
124 |     bluez.hci_filter_set_ptype(flt, bluez.HCI_EVENT_PKT)
125 |     sock.setsockopt( bluez.SOL_HCI, bluez.HCI_FILTER, flt )
126 |     done = False
127 |     results = []
128 |     myFullList = []
129 |     for i in range(0, loop_count):
130 |         pkt = sock.recv(255)
131 |         ptype, event, plen = struct.unpack("BBB", pkt[:3])
132 |         #print "--------------" 
133 |         if event == bluez.EVT_INQUIRY_RESULT_WITH_RSSI:
134 | 		i =0
135 |         elif event == bluez.EVT_NUM_COMP_PKTS:
136 |                 i =0 
137 |         elif event == bluez.EVT_DISCONN_COMPLETE:
138 |                 i =0 
139 |         elif event == LE_META_EVENT:
140 |             subevent, = struct.unpack("B", pkt[3])
141 |             pkt = pkt[4:]
142 |             if subevent == EVT_LE_CONN_COMPLETE:
143 |                 le_handle_connection_complete(pkt)
144 |             elif subevent == EVT_LE_ADVERTISING_REPORT:
145 |                 #print "advertising report"
146 |                 num_reports = struct.unpack("B", pkt[0])[0]
147 |                 report_pkt_offset = 0
148 |                 for i in range(0, num_reports):
149 | 		
150 | 		    if (DEBUG == True):
151 | 			print "-------------"
152 |                     	#print "\tfullpacket: ", printpacket(pkt)
153 | 		    	print "\tUDID: ", printpacket(pkt[report_pkt_offset -22: report_pkt_offset - 6])
154 | 		    	print "\tMAJOR: ", printpacket(pkt[report_pkt_offset -6: report_pkt_offset - 4])
155 | 		    	print "\tMINOR: ", printpacket(pkt[report_pkt_offset -4: report_pkt_offset - 2])
156 |                     	print "\tMAC address: ", packed_bdaddr_to_string(pkt[report_pkt_offset + 3:report_pkt_offset + 9])
157 | 		    	# commented out - don't know what this byte is.  It's NOT TXPower
158 |                     	txpower, = struct.unpack("b", pkt[report_pkt_offset -2])
159 |                     	print "\t(Unknown):", txpower
160 | 	
161 |                     	rssi, = struct.unpack("b", pkt[report_pkt_offset -1])
162 |                     	print "\tRSSI:", rssi
163 | 		    # build the return string
164 |                     Adstring = packed_bdaddr_to_string(pkt[report_pkt_offset + 3:report_pkt_offset + 9])
165 | 		    Adstring += ","
166 | 		    Adstring += returnstringpacket(pkt[report_pkt_offset -22: report_pkt_offset - 6]) 
167 | 		    Adstring += ","
168 | 		    Adstring += "%i" % returnnumberpacket(pkt[report_pkt_offset -6: report_pkt_offset - 4]) 
169 | 		    Adstring += ","
170 | 		    Adstring += "%i" % returnnumberpacket(pkt[report_pkt_offset -4: report_pkt_offset - 2]) 
171 | 		    Adstring += ","
172 | 		    Adstring += "%i" % struct.unpack("b", pkt[report_pkt_offset -2])
173 | 		    Adstring += ","
174 | 		    Adstring += "%i" % struct.unpack("b", pkt[report_pkt_offset -1])
175 | 
176 | 		    #print "\tAdstring=", Adstring
177 |  		    myFullList.append(Adstring)
178 |                 done = True
179 |     sock.setsockopt( bluez.SOL_HCI, bluez.HCI_FILTER, old_filter )
180 |     return myFullList
181 | 
182 | 
183 | 


--------------------------------------------------------------------------------