mirror of
https://github.com/sascha-hemi/pycom-documentation.git
synced 2026-03-22 19:07:04 +01:00
9a0602f9e5
* Products
-> updated with new products
-> added accessories
* Getting started
-> re-structured getting started guide
-> removed some of the advanced stuff
* Tutorials / Examples
-> added categories
-> added new basic tutorials Sleep, GPIO and Pring
-> added WiFi ap / sta tutorial
-> added wifi Scan MAC tutorial
* Firmware API
-> added pysense pytrack pygate categories here
* Datasheets
-> added CE FCC and RoHS documents
-> added pysense2 and pytrack 2 templates
* Update firmware
-> new section, added all methods of updating the firmware
* License
-> put license in its own section
general remarks:
-> updated the layout / theme
no more red code text
codeblocks actually work now
-> general layout updates, removed the old html structures (mostly)
107 lines
2.8 KiB
Markdown
107 lines
2.8 KiB
Markdown
---
|
|
title: "Bluetooth"
|
|
aliases:
|
|
- tutorials/all/ble.html
|
|
- tutorials/all/ble.md
|
|
- chapter/tutorials/all/ble
|
|
---
|
|
|
|
At present, basic BLE functionality is available. More features will be implemented in the near future, such as pairing. This page will be updated in line with these features.
|
|
|
|
## Scan for BLE devices
|
|
|
|
A quick usage example that scans and prints the raw data from advertisements.
|
|
|
|
```python
|
|
from network import Bluetooth
|
|
|
|
bluetooth = Bluetooth()
|
|
bluetooth.start_scan(-1) # start scanning with no timeout
|
|
|
|
while True:
|
|
print(bluetooth.get_adv())
|
|
```
|
|
|
|
## Connect to a BLE device
|
|
|
|
Connecting to a device that is sending advertisements.
|
|
|
|
```python
|
|
from network import Bluetooth
|
|
import ubinascii
|
|
bluetooth = Bluetooth()
|
|
|
|
# scan until we can connect to any BLE device around
|
|
bluetooth.start_scan(-1)
|
|
adv = None
|
|
while True:
|
|
adv = bluetooth.get_adv()
|
|
if adv:
|
|
try:
|
|
bluetooth.connect(adv.mac)
|
|
except:
|
|
# start scanning again
|
|
bluetooth.start_scan(-1)
|
|
continue
|
|
break
|
|
print("Connected to device with addr = {}".format(ubinascii.hexlify(adv.mac)))
|
|
```
|
|
|
|
## Connect to a BLE Device and retrieve data
|
|
|
|
Connecting to a device named 'Heart Rate' and receiving data from it's services.
|
|
|
|
```python
|
|
from network import Bluetooth
|
|
import time
|
|
bt = Bluetooth()
|
|
bt.start_scan(-1)
|
|
|
|
while True:
|
|
adv = bt.get_adv()
|
|
if adv and bt.resolve_adv_data(adv.data, Bluetooth.ADV_NAME_CMPL) == 'Heart Rate':
|
|
try:
|
|
conn = bt.connect(adv.mac)
|
|
services = conn.services()
|
|
for service in services:
|
|
time.sleep(0.050)
|
|
if type(service.uuid()) == bytes:
|
|
print('Reading chars from service = {}'.format(service.uuid()))
|
|
else:
|
|
print('Reading chars from service = %x' % service.uuid())
|
|
chars = service.characteristics()
|
|
for char in chars:
|
|
if (char.properties() & Bluetooth.PROP_READ):
|
|
print('char {} value = {}'.format(char.uuid(), char.read()))
|
|
conn.disconnect()
|
|
break
|
|
except:
|
|
pass
|
|
else:
|
|
time.sleep(0.050)
|
|
```
|
|
|
|
## Connect to a BLE device and get name and manufacturer data
|
|
|
|
Using `resolve_adv_data()` to attempt to retrieve the name and manufacturer data from the advertiser.
|
|
|
|
```python
|
|
import ubinascii
|
|
from network import Bluetooth
|
|
bluetooth = Bluetooth()
|
|
|
|
bluetooth.start_scan(20)
|
|
while bluetooth.isscanning():
|
|
adv = bluetooth.get_adv()
|
|
if adv:
|
|
# try to get the complete name
|
|
print(bluetooth.resolve_adv_data(adv.data, Bluetooth.ADV_NAME_CMPL))
|
|
|
|
mfg_data = bluetooth.resolve_adv_data(adv.data, Bluetooth.ADV_MANUFACTURER_DATA)
|
|
|
|
if mfg_data:
|
|
# try to get the manufacturer data (Apple's iBeacon data is sent here)
|
|
print(ubinascii.hexlify(mfg_data))
|
|
```
|
|
|