TiGPIO - 通用输入/输出

General Purpose Input Output (通用输入/输出)简称为GPIO,或总线扩展器,能够提供额外的控制和监视功能,具体可参考https://baike.baidu.com/item/gpio或https://en.wikipedia.org/wiki/General-purpose_input/output。

TiJOS Framework提供TiGPIO来支持GPIO功能,其将GPIO按照port分组,共支持256组,组号范围0-255,即,port0-port255,其中每组内按照pin划分16条线,线号范围0-15,即,pin0-pin15,每条线都支持指定模式的单独设置。

Java包

tijos.framework.devicecenter

TiGPIO工作模式定义

工作模式 说明
INPUT_FLOATING 浮空输入模式,默认模式
INPUT_PULLUP 上拉输入模式
INPUT_PULLDOWN 下拉输入模式
OUTPUT_OD 开漏输出模式
OUTPUT_PP 推挽输出模式
IO_FLOATING_OD 开漏输出复合浮空输入模式

TiGPIO事件模式定义

事件模式只有具备输入模式的pin能支持。

事件模式 说明
EVENT_NONE 无事件,默认模式
EVENT_RISINGEDGE 上升沿事件模式
EVENT_FALLINGEDGE 下降沿事件模式
EVENT_BOTHEDGE 双沿事件模式

TiGPIO方法定义

TiGPIO类中主要的方法:

说明 方法
静态方法,通过指定port和pin集合打开指定GPIO,返回TiGPIO对象 TiGPIO open(int portID, int... pinIDs)
关闭当前TiGPIO对象 void close()
设置当前TiGPIO对象指定pin的工作模式 void setWorkMode(int pinID, int mode)
设置当前TiGPIO对象指定pin的事件参数,捕获周期单位:us void setEventParameters(int pinID, int evt, int captureFilter)
读当前TiGPIO对象port数据,16位数据 readPort()
写当前TiGPIO对象port数据,16位数据 writePort(int value)
读当前TiGPIO对象指定pin电平 readPin(int pinID)
写当前TiGPIO对象指定pin电平 writePin(int pinID, int levelValue)

TiGPIO类中他方法的技术说明请参考TiJOS JDK framework说明文档。

TiGPIO对象创建与销毁

TiGPIO对象的创建需要调用open静态方法,传入指定port和pin集合参数,返回创建的接口对象。

TiGPIO对象的销毁需要调用close方法。

...
int gpioPort0 = 0; //定义接口,port0
int gpioPin0 = 0;  //定义pin集合
int gpioPin1 = 1;
TiGPIO gpio0 = TiGPIO.open(gpioPort0, gpioPin0, gpioPin1); //打开port0,返回TiGPIO接口对象
...
...
...
gpio0.close(); //销毁当前对象

TiGPIO模式设置

TiGPIO模式通过setWorkMode方法设置,设置参数为推挽输出模式和上拉输入模式。

...
gpio0.setWorkMode(gpioPin0, TiGPIO.OUTPUT_PP); //推挽输出
gpio0.setWorkMode(gpioPin1, TiGPIO.INPUT_PULLUP); //上拉输入
...

注意:输入输出以及上下拉模式受平台特性限制,设置时须了解硬件平台特性。

TiGPIO事件设置

TiGPIO事件通过setEventParameters方法设置,设置参数为事件类型和最小捕获周期。

最小捕获周期:指定周期内只能捕获一次事件,如:捕获周期为10us,在这个时间内发生了5次事件,则只能捕获第一次,其他事件自动丢弃。

事件的分发:TiJOS事件通过事件中心eventcenter统一管理和分发,TiGPIO设置了事件之后需要在事件中心注册GPIO类型事件监听回调。

...
gpio0.setEventParameters(gpioPin1, TiGPIO.EVENT_FALLINGEDGE, 0);
...
TiEventCenter.getEventCenter().addListener(new TiGPIOEvent()); //向事件中心添加GPIO事件监听
...
public class TiGPIOEvent implements ITiEventListener {
    @Override
    public TiEventType getType() {
        return TiEventType.GPIO;
    }

    @Override
    public void onEvent(ITiEvent evt) {
        TiGPIOEvent event =  (TiGPIOEvent)evt;
         System.out.println("pin:"event.getPin()+" event:"+event.getEvent()); //打印发生事件的                                                                        //pin和event
        }
    }
    ...
    ...
}

事件中心的详细使用方法请参考tijos.framework.eventcenter说明。

注意:事件类型受平台特性限制,设置时须了解硬件平台特性。

TiGPIO输入输出

TiGPIO通过readPort、writePort和readPin、writePin完成输入输出操作。

...
int value = gpio0.readPort(); //读接口数值,每个接口为16位
int level = gpio0.readPin(gpioPin1); //读取pin1电平,1:高电平   0:低电平
...
gpio0.writePort(0x01); //向接口写数值0x01
gpio0.writePort(0x00); //向接口写数值0x00
...
gpio0.writePin(gpioPin0, 1); //向pin0写高电平
gpio0.writePin(gpioPin0, 0); //向pin0写低电平
...

具体可参考TiJOS Framework说明文档。