【龙芯1c库】封装引脚复用接口和使用示例

龙芯1c库是把龙芯1c的常用外设的常用功能封装为一个库，类似于STM32库。Git地址：https://gitee.com/caogos/OpenLoongsonLib1c

引脚复用不是一个单独的功能，但在很多地方都需要用到。我想还是有必要单独讨论一下的，所以就有了此文。

龙芯1c库中引脚复用接口使用示例

引脚复用接口简介

提供两个接口，分别是

/*
 * 把指定pin设置为指定用途(普通gpio，非gpio)
 * @gpio gpio引脚编号
 * @purpose 用途
 */
void pin_set_purpose(unsigned int gpio, pin_purpose_t purpose);


/*
 * 设置指定pin为第n复用
 * @gpio gpio编号
 * @remap 第n复用
 */
void pin_set_remap(unsigned int gpio, pin_remap_t remap);

再来看看第二个参数分别是啥

// 引脚用途
typedef enum
{
    PIN_PURPOSE_GPIO = 0,               // 引脚用作普通gpio
    PIN_PURPOSE_OTHER,                  // 引脚用作其它功能(非gpio)
}pin_purpose_t;


// 引脚复用
typedef enum
{
    PIN_REMAP_FIRST = 0,                // 第一复用
    PIN_REMAP_SECOND,                   // 第二复用
    PIN_REMAP_THIRD,                    // 第三复用
    PIN_REMAP_FOURTH,                   // 第四复用
    PIN_REMAP_FIFTH,                    // 第五复用
}pin_remap_t;

这里讨论的是引脚复用，为何会涉及gpio呢，请看下图

这是《龙芯1c300处理器用户手册》v1.4中的截图，其中有提到GPIO复用，我想这里的GPIO复用应该就是指引脚用作GPIO，其优先级仅高于默认功能。
再来看看《龙芯1c300处理器数据手册》v1.3中关于引脚复用的表格，如下

按道理上讲，引脚复用的接口应该有引脚编号，并且应该以引脚编号作为索引，可前面提到的接口怎么没有引脚编号，而是以gpio编号作为索引呢？
龙芯1c处理器上有些引脚是固定的，只能用作某个固定功能，不能用作其它功能，否则cpu不能正常工作，比如晶振，内存占用的引脚，flash占用的引脚等。一般可以复用的引脚也可以作为普通GPIO使用，如果这个理由还不够充分，那么再给你个理由