MacOS上 Bluetooth Low Energy/BLE 应用的Swift语言开发笔记

2024-03-16 02:10

本文主要是介绍MacOS上 Bluetooth Low Energy/BLE 应用的Swift语言开发笔记,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

1. 背景

最近由于各种原因打算做一个小gadget,这个小玩具需要用到BLE和PC/MAC通讯。作为一枚程序开发完完全全的新手,中途自然碰壁无数。而且说真的,本来在电脑上面用BLE就是比较罕见的奇葩要求,又找不到随手可用的教(copy)例(paste),总结一些经验教训(code),以供后来人参考。

2. BLE和各种蓝牙区别

首先要注意一下,BLE和以前普通标准的蓝牙不同!两者不通用!

现在常见的蓝牙技术大概有三种,加上新推出的5代:
1. Bluetooth Basic Rate_Enhanced Data Rate 也就是 BR_EDR
2. Bluetooth Low Energy 也就是 BLE
3. Bluetooth Smart 和 Smart Ready 大致是一种企图融合上面两种制式的过渡技术
Fig 1
4. Bluetooth 5.0 是最新的规格。买了chip有空再弄。

3. BLE蓝牙协议和实际利用

3.1 具体协议内容和连接方式

详情可以自行百度,或者看原文
协议和栈方面比较详细的介绍有:
蓝牙协议分析(1)_基本概念
蓝牙协议分析(2)_协议架构
蓝牙协议分析(3)_蓝牙低功耗(BLE)协议栈介绍
还有这个:BLE低功耗蓝牙介绍 - CSDN博客

当然了解具体协议和内容是非常非常重要的,不过对于日常小型应用来说,我们知道怎么发送怎么接受信息就可以了。
重点就是理解下图的Services和Characteristics
Fig 2

举个例子,BLE栈就像一个超市,里面有各个部署区域(Services),比方说:
* 蔬果区(HIDS/HID Service 人机交互服务)
* 熟食区(GLS/Glucose Service 血糖服务)
* 零食区(HRM/Heart Rate Monitor 心率监控服务 UUID=0x180D)

而每个部署区域都有货架,比如零食区(HRM心率)里面就有的:
* 巧克力架(Heart Rate Measurement, Value, UUID=0x2A37 心跳率)
* 饼干架(Heart Rate Sensor Location, Value, UUID=0x2A38 传感器位置)

例如,你想买牛奶巧克力,那就先要跑去零食区(UUID=0x180D),然后找到巧克力货架(UUID=0x2A37),et Voila!

这个Services和Characteristics都是用UUID来标记,都是约定俗成的,只能跑去看GATT里面的定义。也可以自行生成UUID:Online UUID Generator

-(当然有人会问那你想搞个没有定义或者不符合定义的数据的通讯怎么办呢?有个做法是挂羊头卖狗肉,当然Central和Peripheral两头设定都要对得上。)-

3.2 Central和Peripheral

一般来说Central是读取信息的一方,Peripheral是提供信息的一方现在的情况的话电脑是Central了。
Fig 3

3.3 比较有用的测试道具

Mac上面有两个道具比较有用:LightBlue和PacketLogger
Fig 4
Fig 5

iOS上面有:LightBlue,nRF Connect,nRF Toolbox

4. MacOS BLE App Swift编程的注意点

其实iOS的BLE程序的代码差不多改改UI组件就可以在MacOS上面使用,但是在Xcode里面编程调试MacOS Swift代码需要注意几个不同之处

4.1 XPC connection invalid

  1. 在MacOS的Xcode里面,打开沙盒(App Sandbox)里面的蓝牙
    路径:target -> Capabilities -> App Sandbox -> Hardware -> Bluetooth
    Fig 6

  2. info.plist 里面追加 Privacy - Bluetooth Peripheral Usage Description,Value随意
    Fig 7

好了,准备完成!现在可以开始写代码了。
使用的swift版本是4, MacOS是High Sierra 10.13.3


5.1 初始化

  • 导入库
import CoreBluetooth
  • 导入delegate
class ViewController: NSViewController, CBCentralManagerDelegate, CBPeripheralDelegate {}
  • 实例化
var MacCentralManager: CBCentralManager!
var TargetPeripheral: CBPeripheral!
var TargetCharacteristic: CBCharacteristic!
  • 初始化启动
MacCentralManager = CBCentralManager(delegate: self, queue: nil)
  • 定义UUID之类
let heartRateServiceCBUUID = CBUUID(string: "0x180D")
let UUID1 = CBUUID(string: "2A37")    //这个UUID是心率数据的特征
let UUID2 = CBUUID(string: "2A38")    //这个UUID是心率传感器位置的特征

5.2 检查蓝牙设备状态并开启搜索(必做)

每次启动了APP必须首先检查本机蓝牙设备的状态是否在正常运作,否则以后代码很可能报错
[CoreBluetooth] API MISUSE: <CBCentralManager: 0x17426af00> can only accept this command while in the powered on state

func centralManagerDidUpdateState(_ central: CBCentralManager) {
//检查蓝牙设备是否有在更新if central.state == CBManagerState.poweredOn { print("did update:\(central.state)")//蓝牙设备确实有反应了才开始搜索central.scanForPeripherals(withServices: nil,options: nil)print("Start Scanning")   //调试用} else {//蓝牙设备没有更新的话,报告原因print("BLE on this Mac is not ready")switch central.state {case .unknown:print("蓝牙的central.state is .unknown")case .resetting:print("蓝牙的central.state is .resetting")case .unsupported:print("蓝牙的central.state is .unsupported")case .unauthorized:print("蓝牙的central.state is .unauthorized")case .poweredOff:print("蓝牙的central.state is .poweredOff")case .poweredOn:print("蓝牙的central.state is .poweredOn") }}}

5.3 搜索目标BLE设备然后连接设备

func centralManager(_ central: CBCentralManager,didDiscover peripheral: CBPeripheral,advertisementData: [String : Any],rssi RSSI: NSNumber) {//陈列周围的BLE设备print("BLE Device identified: \(peripheral)")//寻找identifier代码含有P_UUID的周边设备if peripheral.identifier.uuidString.contains("P_UUID"){ TargetPeripheral = peripheralTargetPeripheral.delegate = self              //初始化peripheral的delegateMacCentralManager.stopScan() MacCentralManager.connect(TargetPeripheral)   //连接该peripheral}print("\(peripheral) is connected")               //调试用输出}

5.4 确认连接上了

func centralManager(_ central: CBCentralManager, didConnect peripheral: CBPeripheral) {print("Connection Confirmed!")TargetPeripheral.discoverServices([heartRateServiceCBUUID])print("Target Service Confirmed!")}

不执行这一步的话下面代码会出错

5.5 搜索指定Services服务并陈列Characteristics特征

var TargetService: CBService!   // 实例化一般放在前面func peripheral(_ peripheral: CBPeripheral, didDiscoverServices error: Error?) {guard let services = peripheral.services else { return }for service in services {print(service)//陈列所有的service和旗下的characteristicsperipheral.discoverCharacteristics(nil, for: service)   //寻找指定UUID的服务if service.uuid.uuidString.contains("UUID") { print("Identified TargetServices \(service.uuid.uuidString)")TargetService = service as CBService  }}}

5.6 找出指定的characteristics特征并读取

func peripheral(_ peripheral: CBPeripheral, didDiscoverCharacteristicsFor service: CBService, error: Error?) {guard let characteristics = TargetService.characteristics else { return }print("Existing Characteristics identified")    //调试用输出for characteristic in characteristics {print(characteristic)//陈列所有read方式的特征if characteristic.properties.contains(.read) {print("\(characteristic.uuid): properties contains .read")  //找到read方式的characteristics并读取peripheral.readValue(for: characteristic)}//陈列所有notify方式的特征if characteristic.properties.contains(.notify) {print("\(characteristic.uuid): properties contains .notify")  //找到notify方式的characteristics并读取peripheral.setNotifyValue(true, for: characteristic)}//也可以找指定UUID的characteristic特征if characteristic.properties.contains("UUID") {print("\(characteristic.uuid): properties contains UUID")  //找到指定UUID的特征然后下面采取read或者notifyperipheral.setNotifyValue(true, for: characteristic)peripheral.readValue(for: characteristic)}}}

5.7 监控Characteristics新数据并提取

func peripheral(_ peripheral: CBPeripheral, didUpdateValueFor characteristic:  CBCharacteristic, error: Error?) {switch characteristic.uuid {case UUID1:guard let characteristicData1 = characteristic.value//这里的characteristicData1就是读取成功的数据啦!//自由添加代码自己爱怎么操作就怎么操作case UUID2:guard let characteristicData2 = characteristic.value//这里的characteristicData2就是读取成功的数据啦!//自由添加代码自己爱怎么操作就怎么操作default:print("Unhandled Characteristic UUID: \(characteristic.uuid)")}}

5.8 写数据

TargetPeripheral.writeValue(dataToTrans, for:   WriteCharactistic, type: CBCharacteristicWriteType.withResponse)

type还有withoutResponse

6. 总结

以上介绍了MacOS连接BLE设备最简单的基本操作流程,利用以上代码基本可以进行初级的读写数据。
如有错误还请指出。

MacOS的代码例子有空再写~
iOS上面的比较好的GitHub例子:https://github.com/DennisMao/eswiftBLE a.k.a 【Mac/ios】Swift3.0 BLE开发 - RazilFelix的博客 - CSDN博客

其他诸多参考

[1]iOS×BLE Core Bluetoothプログラミング

[2]iOS SwiftでBLEのサンプルを動かしてみる

[3]macOS x mbed OS でBLE通信する方法

[4]Core Bluetooth Tutorial for iOS: Heart Rate Monitor

[5]swift使ってEddystone-URLを受信するiOSアプリを作った - BlankTar

[6]iOS蓝牙之Introduction to Core Bluetooth: Building a Heart Rate Monitor(翻译) - CSDN博客

[7]BLEのペリフェラルを今更実装してみた(iOS編)

[8]Getting started with Bluetooth Low Energy on iOS

[9]Core Bluetooth Programming Guide Apple

վ HᴗP ի

这篇关于MacOS上 Bluetooth Low Energy/BLE 应用的Swift语言开发笔记的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/813966

相关文章

Spring Boot + MyBatis Plus 高效开发实战从入门到进阶优化(推荐)

《SpringBoot+MyBatisPlus高效开发实战从入门到进阶优化(推荐)》本文将详细介绍SpringBoot+MyBatisPlus的完整开发流程,并深入剖析分页查询、批量操作、动... 目录Spring Boot + MyBATis Plus 高效开发实战:从入门到进阶优化1. MyBatis

Python基于wxPython和FFmpeg开发一个视频标签工具

《Python基于wxPython和FFmpeg开发一个视频标签工具》在当今数字媒体时代,视频内容的管理和标记变得越来越重要,无论是研究人员需要对实验视频进行时间点标记,还是个人用户希望对家庭视频进行... 目录引言1. 应用概述2. 技术栈分析2.1 核心库和模块2.2 wxpython作为GUI选择的优

macOS无效Launchpad图标轻松删除的4 种实用方法

《macOS无效Launchpad图标轻松删除的4种实用方法》mac中不在appstore上下载的应用经常在删除后它的图标还残留在launchpad中,并且长按图标也不会出现删除符号,下面解决这个问... 在 MACOS 上,Launchpad(也就是「启动台」)是一个便捷的 App 启动工具。但有时候,应

Python中随机休眠技术原理与应用详解

《Python中随机休眠技术原理与应用详解》在编程中,让程序暂停执行特定时间是常见需求,当需要引入不确定性时,随机休眠就成为关键技巧,下面我们就来看看Python中随机休眠技术的具体实现与应用吧... 目录引言一、实现原理与基础方法1.1 核心函数解析1.2 基础实现模板1.3 整数版实现二、典型应用场景2

Python Dash框架在数据可视化仪表板中的应用与实践记录

《PythonDash框架在数据可视化仪表板中的应用与实践记录》Python的PlotlyDash库提供了一种简便且强大的方式来构建和展示互动式数据仪表板,本篇文章将深入探讨如何使用Dash设计一... 目录python Dash框架在数据可视化仪表板中的应用与实践1. 什么是Plotly Dash?1.1

利用Python开发Markdown表格结构转换为Excel工具

《利用Python开发Markdown表格结构转换为Excel工具》在数据管理和文档编写过程中,我们经常使用Markdown来记录表格数据,但它没有Excel使用方便,所以本文将使用Python编写一... 目录1.完整代码2. 项目概述3. 代码解析3.1 依赖库3.2 GUI 设计3.3 解析 Mark

Android Kotlin 高阶函数详解及其在协程中的应用小结

《AndroidKotlin高阶函数详解及其在协程中的应用小结》高阶函数是Kotlin中的一个重要特性,它能够将函数作为一等公民(First-ClassCitizen),使得代码更加简洁、灵活和可... 目录1. 引言2. 什么是高阶函数?3. 高阶函数的基础用法3.1 传递函数作为参数3.2 Lambda

C语言中的数据类型强制转换

《C语言中的数据类型强制转换》:本文主要介绍C语言中的数据类型强制转换方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录C语言数据类型强制转换自动转换强制转换类型总结C语言数据类型强制转换强制类型转换:是通过类型转换运算来实现的,主要的数据类型转换分为自动转换

利用Go语言开发文件操作工具轻松处理所有文件

《利用Go语言开发文件操作工具轻松处理所有文件》在后端开发中,文件操作是一个非常常见但又容易出错的场景,本文小编要向大家介绍一个强大的Go语言文件操作工具库,它能帮你轻松处理各种文件操作场景... 目录为什么需要这个工具?核心功能详解1. 文件/目录存javascript在性检查2. 批量创建目录3. 文件

C语言实现两个变量值交换的三种方式

《C语言实现两个变量值交换的三种方式》两个变量值的交换是编程中最常见的问题之一,以下将介绍三种变量的交换方式,其中第一种方式是最常用也是最实用的,后两种方式一般只在特殊限制下使用,需要的朋友可以参考下... 目录1.使用临时变量(推荐)2.相加和相减的方式(值较大时可能丢失数据)3.按位异或运算1.使用临时