当前文档为 本地版本 (v0.1.0)，您可以访问当前页面的 在线版本 以获取最近可能的更新。

# 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 网页中的“产品开发资料”一节中下载到最新版本的开发套件：

   - PAN271x 系列产品介绍

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

   - PAN271x Development Kit 文档中心

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 的频率闪烁：

     Blinky LED on EVB

## 4 更多相关文档

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

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

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

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

版本选择及下载 v: 0.1.0

版本选择
  latest
  0.1.0

下载
  PAN271x 开发套件文档（PDF）

相关链接
  PAN271x 系列产品 WIKI
  PAN271x 系列产品技术论坛
  上海磐启微电子有限公司