通用输出控件

官网地址：https://lcd4linux.bulix.org/wiki/widget_gpo

通用输出控件/通用输入设备

通用输出控件(GPO widget)用来控制所谓的通用输出口，你的显示器可能有这个东西。这个通用输出口可以用来连接发光二极管，蜂鸣器，继电器等器件。一些显示器上可能有电路图/引脚符号(特别是当你使用一些拆自电话机上的显示器的时候)，这些引脚符号可以被通用输出控件控制。

通用输入输出设备(GPIO driver)不仅提供通用输出控件(GPO widget)，还提供通用输入控件(GPI widget)功能。这些输入可以是逻辑值(0/1)或者模拟值，以提供真实(世界)的值(如：风扇转速，温度，电压…)

通用输出控件与输出线的对应关系写在布局类的节里：就像你用Row*.Col*放置其它控件一样，你可以用’GPO*‘这么一行来说明通用输出控件和实际输出线的对应关系。发送到通用输出线的值由控件的表达式( ‘expression’参数 )决定。

定义一个通用输出控件的方法如下： 

  1. Widget <widget_name> {     # 控件名
  2.     class      'GPO'       # 控件类型
  3.     expression <string>    # 表达式
  4.     update     <number>    # 刷新频率
  5. }

下面是把控件(表达式的值)与实际输出线对应起来的方法：

  1. Layout <layout_name> {               # 布局名
  2.     GPO<num>      '<widget_name>'    # GPO对应关系
  3. }

注意：只有当你的显示器支持通用输出时，通用输出控件和LCD::GPO()插件才可用(同时需要配置好它们)！


参数

参数 含义 说明
expression 表达式 传递值给通用输出口的表达式。
update 刷新频率 刷新频率(单位：毫秒)。


插件

LCD4Linux为通用输入输出设备提供了以下几个函数： |函数|作用| |-|-| |LCD::GPI(num)|返回从通用输入口num 获取到的值。| |LCD::GPO(num)|返回通用输出口num 当前的值。| |LCD::GPO(num, val)|设置通用输出口num 的值为val，并返回其当前值。|


例子

这是一个简单的通用输出控件的例子。在这个例子中，系统的平均负载将会在GPO_Test这个控件里计算，然后把它的值发送到显示器的通用输出口1 (GPO1).如果负载大于0的话GPO1为高电位，等于0的话GPO1为低电位。

  1. Widget GPO_Test {
  2.     class 'GPO'
  3.     expression loadavg(1) > 0
  4.     update 1000
  5. }
  7. Layout TestGPO {
  8.     Row1.Col1 'AnyWidget'
  9.     GPO1      'GPO_Test'
  10. }

使用通用输入口的使用例子（在MatrixOrbital LK202设备上的测试）:

  1. Widget Fan_Set {
  2.     class 'GPO'
  3.     expression test::bar(0,255, 0, 1)
  4.     update 100
  5. }
  7. Widget Fan_PWM {
  8.     class 'Text'
  9.     expression LCD::GPO(1)
  10.     prefix 'PWM'
  11.     width 8
  12.     precision 0
  13.     align 'R'
  14.     update 100
  15. }
  17. Widget Fan_RPM {
  18.     class 'Text'
  19.     expression LCD::GPI(1)
  20.     prefix 'RPM'
  21.     width 8
  22.     precision 0
  23.     align 'R'
  24.     update 100
  25. }
  27. Layout FanDemo {
  28.     Row1.Col1  'Fan_PWM'
  29.     Row1.Col10 'Fan_RPM'
  30.     GPO1       'Fan_Set'
  31. }

风扇的PWM值在0和255之间徘徊，且实际的PWM值和风扇速度将会打印到显示器上。