{"id":24091603,"url":"https://github.com/RT-Thread-packages/bsal","last_synced_at":"2025-09-17T01:31:23.001Z","repository":{"id":46426012,"uuid":"350189978","full_name":"RT-Thread-packages/bsal","owner":"RT-Thread-packages","description":"蓝牙协议栈抽象层","archived":false,"fork":false,"pushed_at":"2021-10-14T07:16:22.000Z","size":853,"stargazers_count":13,"open_issues_count":3,"forks_count":6,"subscribers_count":8,"default_branch":"main","last_synced_at":"2023-03-09T11:40:59.895Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RT-Thread-packages.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-22T03:07:38.000Z","updated_at":"2023-01-30T13:47:45.000Z","dependencies_parsed_at":"2022-09-06T08:11:17.162Z","dependency_job_id":null,"html_url":"https://github.com/RT-Thread-packages/bsal","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RT-Thread-packages%2Fbsal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RT-Thread-packages%2Fbsal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RT-Thread-packages%2Fbsal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RT-Thread-packages%2Fbsal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RT-Thread-packages","download_url":"https://codeload.github.com/RT-Thread-packages/bsal/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233312626,"owners_count":18657080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-10T07:44:37.935Z","updated_at":"2025-09-17T01:31:17.424Z","avatar_url":"https://github.com/RT-Thread-packages.png","language":"C","readme":"# BSAL\n\n## 1.  BSAL 软件包介绍\n\nBSAL （Bluetooth Stack Abstract Layer）软件包是由 RT-Thread 针对不同 蓝牙协议栈接口实现的，目前支持的 协议栈有：nimble，realtek 等协议栈。\n\n\u003e 提示：目前支持芯片为 Realtek 和 Nordic，若在其他芯片上使用该软件包，编译将通不过。\n\n### 1.1 背景介绍\n\nBluetooth Stack Abstract Layer 蓝牙协议栈抽象层。用于适配各家协议栈以及底层卡片。\n\n主要在协议栈基础之上封装一层抽象层接口。\n\n## 2. BSAL 使用说明\n\nBSAL 配置如下图所示：\n\n![img](./doc/figures/menuconfig.png)\n\n选择需要生成的角色（默认选择 Peripheral 即可）：\n\n- Peripheral role:\n- Central role\n- Broadcaster role\n- Observer role\n\n选择不同的示例可以实现不同的 APP 功能：\n\n- Battery service     单 battery servcie 测试 sample\n- battery and blufi service  两个 profile servic（blufi 配网， bas）测试 sample\n\n再选择对应的协议栈：\n\n- nimble   （nimble 协议栈适配层）\n- realtek  （realtek 协议栈适配层）\n- empty_stack   （移植协议栈模板）\n\n## 3. BSAL 依赖\n\nBSAL 依赖对应的协议栈，比如 nimble，需要先有 nimble+RTT 的 sample 工程，首先确保可以跑对应协议栈的原生的 sample。再试着添加 BSAL 层跑 sample\n\n每个 sample 对应一个 cmd：\n\n- battery service： bsal_bas_app\n- battery and blufi service： bsal_bas_blufi_app\n\n输入对应的 cmd 即可。\n\n## 4. 测试验证工具\n\n输入 cmd bsal_bas_blufi_app 启动 sample\n\n手机下载 nRF Connect 工具（apple 使用 lightblue）\n\n[nRF Connect](https://github.com/NordicSemiconductor/Android-nRF-Connect/releases)\n\n搜索广播看到如下界面：\n\n![image-20200618164034578](./doc/figures/adv.png)\n\n点击 connect 连接上之后：\n\n![image-20200618164126725](./doc/figures/srv_table.png)\n\n可以看到 battery service 和 0xffff 配网 blufi service，说明 sample 运行成功。\n\n## 5. BSAL 入门指引\n\n1. 如果没有蓝牙开发的经验，可以先学习一下基础知识：[supperthomas_wiki](https://supperthomas-wiki.readthedocs.io/en/latest/index.html#)\n\n2. 简单入门 BSAL：[文档地址](https://github.com/WaterFishJ/Summer2021_docs/tree/master/%E7%AE%80%E5%8D%95%E5%85%A5%E9%97%A8BSAL)\n3. bas_sample 分析：[文档地址](https://github.com/WaterFishJ/Summer2021_docs/blob/master/pca10056%E7%9A%84bsal%E5%B1%82bas_sample%E8%A7%A3%E6%9E%90/pca10056%E7%9A%84bsal%E5%B1%82bas_sample%E8%A7%A3%E6%9E%90.md)\n4. BSAL 实现 HRS：[文档地址](https://github.com/WaterFishJ/Summer2021_docs/blob/master/bsal%E5%B1%82%E5%AE%9E%E7%8E%B0HRS/bsal%E5%B1%82%E5%AE%9E%E7%8E%B0HRS.md)\n\n3. 蓝牙技术联盟的 SPEC：[链接地址](https://www.bluetooth.com/specifications/specs/)\n\n4. UUID 列表：[链接地址](https://btprodspecificationrefs.blob.core.windows.net/assigned-values/16-bit%20UUID%20Numbers%20Document.pdf)","funding_links":[],"categories":["Packages"],"sub_categories":["IoT"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRT-Thread-packages%2Fbsal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRT-Thread-packages%2Fbsal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRT-Thread-packages%2Fbsal/lists"}