当前页面为 开发中 版本，查看特定版本的文档，请在页面左下角的下拉菜单中进行选择。

SDK 快速入门指南

1 概述

本文是 PAN271x SDK 的快速入门指引，旨在帮助使用者快速入门 PAN271x SoC 的开发。

2 PAN271x EVB 介绍

PAN271x EVB (EValuation Board) 是 Panchip 提供给 PAN271x SoC 用户的一系列开发板的总称，目前包括 1 种 EVB 核心板，1 种 EVB 底板：

开发板名称

SoC 型号

封装

OTP 大小

SRAM 大小

PAN2710U5GA EVB 核心板

PAN2710U5GA

QFN28

16 KB (SRAM 模拟)

3 KB

PAN271x EVB 底板

-

-

-

-

注意：PAN271x EVB 核心板上搭载的 PAN2710U5GA 芯片为预生产芯片，可支持多次烧录，方便用户进行开发调试；而量产版本的 PAN271x 芯片为 OTP 芯片（详见 PAN271x 产品说明书），仅可烧录一次，且烧录后不可擦除。

关于 PAN271x EVB 开发板硬件的详细介绍，请参考 PAN271x EVB 硬件资源介绍。

3 SDK 开发环境确认

3.1 搭建 PC 开发环境

在使用 PAN271x SDK 开发之前，请确保您的 PC 上有如下开发环境：

  • Keil MDK：我们使用 Keil MDK v5 + ARMCC v5.06 作为集成开发环境 IDE

  • JLink：我们使用 JLink SWD 的方式调试和烧录程序

关于具体的开发环境要求与搭建建议，请参考 SDK 开发环境搭建。

3.2 下载 PAN271x DK 开发套件

您可以通过如下几种方式获取到 PAN271x DK 开发套件：

  1. 从 PAN271x 芯片的产品介绍 WIKI 网页中的“产品开发资料”一节中下载到最新版本的开发套件：

  2. 从 PAN271x DK 文档中心（即本文档所在的网站）网页的左下角 “版本选择及下载”选项卡中，下载到与文档版本相对应的开发套件版本：

  3. 直接联系 Panchip 获取

3.3 PAN271x DK 框架概览

<PAN271x-DK>
├── 01_SDK                 // PAN271x SDK 软件开发包，包括 SoC 驱动、例程、及相关脚本等
│   ├── build_tools           // Build 工具，包括 JFlash 烧录工具、编译脚本等工具
│   ├── components            // Component 组件，包括 PAN_USB 等组件
│   ├── drivers               // SoC Drivers 驱动，包括 GPIO、UART、SPI、I2C 等硬件驱动
│   ├── platform              // Platform 平台相关代码，包括芯片启动代码、平台初始化代码、Log 机制代码等
│   ├── proprietary_rf        // PRF 2.4G 相关代码，包括 2.4G Lib、2.4G API 接口等
│   └── samples               // Samples 例程，包括组件/驱动/2.4G/低功耗/方案等例程工程
├── 02_HDK                 // PAN271x 硬件参考设计，开发板的相应图纸等
├── 03_DOC                 // PAN271x DK 文档（网页）
└── 04_TOOLS               // PAN271x 相关工具，包括量产烧录工具，RF 测试固件等

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

  1. 将 EVB 核心板（V1.0）插到 EVB 底板（V1.0）上

  2. 将 EVB 底板 SWD（P00：SWD_CLK，P01：SWD_DAT，GND：SWD_GND）接口通过 JLink 连接至 PC

  3. 将 EVB 底板 USB->UART 接口通过 USB Type-C 线连接至 PC，同时将 EVB 底板 J8 排针对 (SoC_P06 & USB-UART_TXD) 和 J9 排针对 (SoC_P05 & USB-UART_RXD) 分别用跳线帽短接起来，然后在 PC 上打开串口终端或串口调试助手（串口波特率：115200）

  4. 将 EVB 底板 J17 排针对 (P04 & LED) 使用跳线帽短接起来

  5. 打开 PAN271x SDK 中的 Blinky 例程（演示 GPIO 推挽输出控制 LED 灯闪烁）：<PAN271x-DK>\01_SDK\samples\miscellaneous\blinky

  6. 点击 Keil Build 编译按钮，成功后点击 Download 按钮进行烧录下载

    • 若无法正常编译，请检查 Keil 版本以及 ARMCC 编译器版本是否正确

    • 若无法正常下载，请确认使用的芯片型号是否为 PAN2710U5GA（预生产版本芯片，SRAM 模拟 OTP）

  7. 烧录成功后：

    • 观察串口 Log 打印，可以看到系统成功初始化并闪灯的 Log：

      CPU @ 32000000Hz
LED on
LED off
LED on
LED off
...

    • 观察 EVB 底板上的 LED 灯，可以看到其以约 1Hz 的频率闪烁：

      image

      Blinky LED on EVB

4 更多相关文档

下面这些文档有助于您进一步了解 PAN271x 系列 SoC 开发的相关知识：

  1. SDK 例程汇总：列出了目前 SDK 内置的所有例程的简单介绍及对应文档的跳转链接

  2. PRF 2.4G 开发指南：介绍 PRF (Panchip Private RF) 2.4G 开发的基本方法

  3. 常见问题（FAQs）：介绍 PAN271x 开发中的常见问题及解决方法