1# device_board_telink 2 3- [device_board_telink](#device_board_telink) 4 - [简介](#简介) 5 - [开发板规格](#开发板规格) 6 - [OpenHarmony关键特性](#openharmony关键特性) 7 - [开发板设计文档](#开发板设计文档) 8 - [环境搭建](#环境搭建) 9 - [编译调试](#编译调试) 10 - [示例代码](#示例代码) 11 - [联系](#联系) 12 13## 简介 14 15泰凌微公司的B91 Generic Starter Kit是一个可用于评估TLSR9系列芯片组的硬件平台,BLE,BLE Mesh,Zigbee 3.0, Thread和2.4GHz私有协议等多种适用于2.4GHz接口标准的应用程序都可以用它来进行开发。如果有兴趣了解更多相关信息,可以在 [B91 Generic Starter Kit Hardware Guide](http://wiki.telink-semi.cn/wiki/Hardware/B91_Generic_Starter_Kit_Hardware_Guide/) 中进行浏览。 16 17开发板正反面视图如下: 18 19 20 21 22 23## 开发板规格 24 25| 器件类别 | 开发板 | 26| ---------- | -------------------------------- | 27| CPU | TLSR9518A, RISC-V (Max: 96MHz) | 28| RAM | 256KB SRAM | 29| Flash | 2MB SPI Flash | 30| GPIO | 40 | 31| I2C | 1 | 32| UART | 2 | 33| SPI | Memory SPI, HSPI, PSPI | 34| USB | 1 | 35| PWM | 6 | 36| LED | 4 | 37| Debug | JTAG、Swire | 38| ADC | 10-channel 14bit auxilary ADC | 39| Button | 4 | 40 41## OpenHarmony关键特性 42 43| 组件名 | 能力介绍 | 44| -------------- | ------------------------------------------------------------------------------------------------ | 45| 内核 | LiteOS-M | 46| 上电启动 | 上电启动OpenHarmony | 47| BLE服务 | 提供BLE功能 | 48| 外设控制 | 提供操作外设的能力,包括:I2C、ADC、UART、SPI、GPIO、PWM、FLASH等。 | 49| 系统服务管理 | 系统服务管理基于面向服务的架构,提供了OpenHarmony统一化的系统服务开发框架。 | 50| 启动引导 | 提供系统服务的启动入口标识。在系统服务管理启动时,调用boostrap标识的入口函数,并启动系统服务。 | 51| 系统属性 | 提供获取与设置系统属性的能力。 | 52| 基础库 | 提供公共基础库能力,包括:文件操作、KV存储管理等。 | 53| DFX | 提供DFX能力,包括:流水日志等。 | 54| HDF | 提供OpenHarmony硬件配置驱动的能力。 | 55| XTS | 提供OpenHarmony生态认证测试套件的集合能力。 | 56 57## 开发板设计文档 58 59B91开发板的总体情况可以参见 [B91 Generic Starter Kit Hardware Guide](http://wiki.telink-semi.cn/wiki/Hardware/B91_Generic_Starter_Kit_Hardware_Guide/) 的Overview章节。 60 61详细的开发设计文档可以下载 [Reference Design](http://wiki.telink-semi.cn/doc/hw/B91_DevelopmentBoard_TLSR9518ADK80D.zip) 到本地后,解压后查阅。 62 63## 环境搭建 64 65推荐在Windows+Ubuntu环境下进行开发,如果对环境搭建的过程有问题,可以参见 [环境搭建步骤](https://gitee.com/openharmony/device_soc_telink/blob/master/README_zh.md#安装工具) 中开发环境、安装工具、获取源码、确认目录结构等章节。 66 67## 编译调试 68 69在完成上述环境搭建之后,可以进行编译生成B91开发板上所需的二进制固件。可以使用烧录工具将固件烧录进B91开发板。 70编译调试的详细过程可以参见 [编译调试步骤](https://gitee.com/openharmony/device_soc_telink/blob/master/README_zh.md#编译工程) 中编译工程、烧录固件等章节。 71 72## 示例代码 73 74可以将示例生成的二进制固件烧录进B91开发板,代码默认有3个示例: 75 761. [LED应用示例](https://gitee.com/openharmony/vendor_telink/tree/master/led_demo) 77 78 在B91开发板上烧录固件 `led_demo.bin` 并上电重启后,可以实现简单的点亮LED灯的功能。 79 其主要功能的任务代码如下图所示: 80 81  82 83 第一个任务是使用串口模块打印出 `Hello World, time:{RUNNING_TIME_SECOND}`,另一个是使用开发板上GPIO口去操控蓝色LED灯,实现闪烁效果。 84 这里的打印间隔以及LED闪烁的间隔都由宏 `DELAY` 定义,即1000ms。 85 另外,打印出的时间戳 `{RUNNING_TIME_SECOND}` 也根据 `DELAY` 的取值而计时。 86 872. [BLE测试示例](https://gitee.com/openharmony/vendor_telink/tree/master/ble_demo) 88 89 在B91开发板上烧录 `ble_demo.bin` 并上电重启后,可以实现BLE协议栈的相关功能。 90 通过智能手机上的蓝牙连接工具,如nRF Connect,可以搜索到名为“eSample”的BLE测试示例的广播信息,如下图: 91 92  93 94 点击“CONNECT”按钮之后,手机会和B91开发板建立起蓝牙连接,可以在下图中查看到所建立的GATT服务: 95 96  97 98 同时,白色的LED灯会在建立连接时进入常亮状态,提示蓝牙已连接。此时按下“DISCONNECT"按钮,蓝牙连接会断开,白灯熄灭。 99 1003. [XTS测试示例](https://gitee.com/openharmony/vendor_telink/tree/master/xts_demo) 101 102 XTS测试示例是OpenHarmony生态认证测试套件的集合的XTS子系统,在B91开发板上进行的实现。 103 本实现参考了应用兼容性测试套件中的[测试用例源码与配置文件](https://gitee.com/openharmony/xts_acts)和[测试用例开发框架](https://gitee.com/openharmony/xts_tools)。 104 105 在B91开发板上烧录 `xts_demo.bin` 并上电重启后,会运行以下XTS测试用例集合。 106 107 ```shell 108 "module_ActsKvStoreTest", 109 "module_ActsUtilsFileTest", 110 "module_ActsParameterTest", 111 "module_ActsBootstrapTest", 112 "module_ActsHieventLiteTest", 113 "module_ActsDfxFuncTest", 114 "module_ActsSamgrTest", 115 ``` 116 117 也可以在 `xts_demo\BUILD.gn` 当中添加您想要的测试用例集合,测试结果会以串口打印输出。 118 119## 联系 120 121如果您在开发过程中有问题,请在仓库[issues](https://gitee.com/openharmony/device_board_telink/issues)提问。 122