当前文档版本为 v0.5.0,您可以访问当前页面的 开发中 版本以获取最近可能的更新。

SDK 快速入门

1 概述

本文是 PAN2628 开发的快速入门指引,旨在帮助使用者快速入门 PAN2628 应用程序的开发,搭建软硬件环境,并编译、运行、调试一个例程。

2 PAN2628 EVB 硬件资源介绍

在开始使用 PAN2628 SDK 之前,我们建议您先阅读PAN2628 EVB 硬件资源介绍文档,熟悉 EVB 开发板的基本使用方法。

3 PAN2628 SDK 开发环境确认

3.1 PC 环境检查

目前 PAN2628 提供的编译工具链只支持 Windows 7 及以上版本的 64 位操作系统,请确保您的开发环境满足此要求。

您可以按照如下操作快速确认您的 PC 是否满足要求:

  1. 按快捷键 Win + R,在弹出的运行对话框中输入 dxdiag 并回车:

image

运行dxdiag

  1. 稍等片刻,在弹出的 DirectX 诊断工具对话框中,可以看到当前 PC 的系统信息:

image

DirectX诊断工具对话框

3.2 获取并配置 SDK 及编译工具链环境

  1. 请确认您已经获取到如下 2 个必要的压缩包:

    PAN2628-dk-v<x>.<y>.<z>.zip:PAN2628 Development Kit 开发套件

  2. 请确保 PC 上已经正常解压缩了 PAN2628 Development Kit 开发包:

image-20230110112803423

PAN028 DK 开发包主目录结构

  1. SDK 目录文件说明

    01_SDK 目录结构如下图所示

image-20221105151132682

SDK 目录结构

driver: 该目录下主要包括各个外设操作所使用的 API、数据结构的头文件及源文件,用户可直接用于自己的应用程序也可以借此熟悉底层寄存器的操作。

example_base: 该目录主要包括各个外设基本功能的使用例程(支持 Keil 开发工具),用户可使用该样例快速熟悉各个外设的常用功能的实现方式及驱动库的使用方法,该样例可以配合该系列芯片配套的EVB板直接进行下载和运行。

example_extension: 该目录主要包括一些扩展例程,功能相较基础例程更复杂,更偏向实际应用,该样例可以配合该系列芯片配套的EVB板直接进行下载和运行。

mcu: 该目录主要包括该系列 MCU 工程所需的基本头文件和启动文件。

middleware:

该目录主要包括一些常用的软件中间件,支撑扩展例程的开发。

注意:

在使用Keil 作为开发工具进行调试和下载时,须先安装panlink-driver-v<x>.<y>.<z>.exe驱动程序,并在Keil 工程配置下载选项中配置和选择PANLink Driver

3.3 快速编译运行一个简单的例程

  1. 硬件接线准备,请确认您已经将 PAN2628B1 EVB 板的:

    • 用micro usb数据线将EVB板的PANLINK USB接口连接至 PC

    • 用micro usb数据线将EVB板的UART USB接口连接至PC

    • 将 J19(P3_1) 开关拔至TX侧,将P3_1与uart的TX引脚相连

  2. 下面我们以uart_printf示例代码为例,演示如何编译运行一个 Sample App 工程

    • 确认已安装好keil C51开发环境

    • 进入例程目录01_SDK\example_basic\uart\uart_printf\keil,打开uart_printf.uvproj工程文件,如下图:

    image-20221105162357552

    uart_printf例程keil工程界面


 > 按照上图顺序:
 >
 > (1)双击打开README.md文件
 >
 > (2)查看例程的演示说明
 >
 > (3)点击代码编译按钮,编译示例代码工程,确认编译成功
 >
 > (4)点击程序下载按钮,下载固件程序

3. 烧录完成后,打开串口工具(如 sscom),串口参数:115200/8bit/1stop/无校验,会看到约1秒打印一次

   `Hello Panchip.`,表示程序下载成功:

    **串口输出信息如下:**

    ```
    uart printf test.
    Hello Panchip.
    Hello Panchip.
    Hello Panchip.
    Hello Panchip.
    Hello Panchip.
    Hello Panchip.
    ```