Niagara程序入门

最新推荐文章于 2024-04-09 09:37:37 发布

jqk666999

最新推荐文章于 2024-04-09 09:37:37 发布

阅读量6.8k

点赞数 2

分类专栏： NiagaraAX楼宇开发文章标签： Tridium组件开发

NiagaraAX楼宇开发专栏收录该内容

4 篇文章 2 订阅

订阅专栏

Sources By: nightycd

献给和几个月前的我一样的对Niagra模块编程不知如何着手的同学们。
首先，说明一下要编制的模块的功能，很简单，假设一个设备有3个错误干结点，将其在一个字符点输出该设备的错误原因，例如干结点1为真则输出“断电”，干结点2错误输出“保险丝融毁”，干结点3为真错误点输出“缺相保护”。
第二，预备条件，NiagaraAX，Eclipse，Eclipse_Niagara_Plugin即Niagara的Eclipse插件要安装好()。设置好Eclipse插件中NiagaraAX的地址。
下面开始：
1.New AX Module，填写模块名等信息，例如

2.添加依赖包，例如

3.添加工程包，例如

4.完成向导。
5.右键单机刚建立工程里com.sh.eb包，选new->new class,填写类名并设定依赖包(JAVAX.BAJA.SYS.BConponent)，例如

此步要注意的是，类名首字母必须是大写B，第二个字母必须大写，否则Niagara插件的Slotomatic工具可能不过滤你的类文件。
建立好类后，应显示类，  以“/*”- 开头 “-*/” 结尾结尾的Slotomatic注释区域，该区域用起来很方便。
6.使用Niagara插件的Slotomatic工具，过滤你的文件，如条件符合，你会发现类文件中多了类型返回语句，点击Ctrl+shift+o,添加javax.baja.sys.TYPE类型的import。
还有，module-include.xml文件中添加了如下语句
<type name="ErroBand" class="com.sh.eb.BErroBand"/>
7.添加输入属性和输出属性，将例子中BErroBand类中的Slotomatic注释区域编辑为如下语句
/*-
   class BErroBand
   {
     properties
     {
       InBool_1:BStatusBoolean
       default{[ new BStatusBoolean(false) ]}
       flags{ summary,executeOnChange }

       InBool_2:BStatusBoolean
       default{[ new BStatusBoolean(false) ]}
       flags{ summary,executeOnChange }

       InBool_3:BStatusBoolean
       default{[ new BStatusBoolean(false) ]}
       flags{ summary,executeOnChange }

       InBool_1_BindingString:BStatusString
       default{[ new BStatusString("Bool_1 band Message") ]}
       flags{ summary }

       InBool_2_BindingString:BStatusString
       default{[ new BStatusString("Bool_2 band Message") ]}
       flags{ summary }

       InBool_3_BindingString:BStatusString
       default{[ new BStatusString("Bool_2 band Message") ]}
       flags{ summary }

       OutMessage : BStatusString
       default{[new BStatusString("")]}
       flags{summary}
     }
     actions
     {
     }
     topics
     {
     }
   }
   -*/

其中InBool_1、2、3为输入的3个设备故障干结点，有任何变化都会触发事件。
InBool_1_BindingString、 InBool_2_BindingString 、InBool_3_BindingString分别为3个故障干结点所对应的设备故障信息字符串。
OutMessage为设备的总的故障信息输出点。
其格式对应含义为
       InBool_1:BStatusBoolean                         //属性名及类型
       default{[ new BStatusBoolean(false) ]} //默认值及构造函数
       flags{ summary,executeOnChange }      //属性标签函数，executeOnChange标识该属性一有变化就会触发OnChange事件。
8.运行Slotomatic工具，会发现函数内自动增加了上述属性的语句。点击Ctrl+shift+o,添加引用类，如下图

9.手工添加模块的OnChange事件函数，在自动代码后添加如下代码，含义见注释

//OnChange Event

//覆盖BComponent类中的changed事件，意即只要flags里包含executeOnChange 属性的任意一个属性值有变化，都会
//调用该函数，发生变化的属性作为property参数传入。
public void changed(Property property , Context context)
{
    super.changed(property, context);           //基类事件调用
    if(!isRunning())                                         //模块没在运行则跳过
    return;
    else if(Flags.isExecuteOnChange(this, property))
    {
      if(property.getName().equals(InBool_1.getName()))     //如果发生变化的属性的名称是InBool_1的名称
        getOutMessage().setValue(getInBool_1_BindingString().getValue().toString()); //就将InBool_1_BindingString()的字符串值赋值给
                                                                                                                                     //OutMessage属性。下同

      else if(property.getName().equals(InBool_2.getName()))
        getOutMessage().setValue(getInBool_2_BindingString().getValue().toString());

      else if(property.getName().equals(InBool_3.getName()))
        getOutMessage().setValue(getInBool_3_BindingString().getValue().toString());
    }
}
10.打开module.palette文件，在其中<p m="b=baja" t="h:Folder">语句下添加如下语句
<p n="erroBandTool" m="eb=erroBand" t="eb:ErroBand"/>
具体含义为：
     AX里palette工具下        模块名，不是类名     模块下的类名
      的名称
此文件将使我们的模块在AX中的Palette工具窗口中出现可拖动的工具图标。

11.运行Slotomatic工具，再运行Niagara工具里的Build FUll工具，编译为erroBand.jar模块发布到NiageraAX安装目录下的Module目录中。
12.运行AX，建立站点，用Palette工具栏打开erroBand.jar模块，将erroBandTool拖入连线视图，实验功能是否实现。如下图

关于工程中几个文件的作用：
1.build.xml文件，主管模块的依赖信息等编译链接信息，上例中的1、2、3步都在此文件中有体现，可手工添加，Slotomatic工具不在此文件中自动添加。
2.module-include.xml 文件，主管模块中类型对应、管理，如上例中工程建立的实际类名为BErroBand，在此文件中被映射为ErroBand，并且在module.palette文件中使用的是ErroBand这个名称。Slotomatic工具会在此文件中添加必要的语句，但一些高级功能就要手工添加了。

注：本教程仅供参考，如有错漏请指正，所做模块功能基本能用，但要真用到实际当中的话就要进一步改进。

这个PXInclude的功能真的是非常实用，也很好的体现了界面复用的效果，可以大大提高我们工程中的效率，同时由于可以复用图形界面，也可以缩小Station的空间，提高效率。
1。利用PX建立重复使用的图形元素，这个元素有别于我们使用的Module，应该是图形Module的各种组合，例如文档中使用的ahuRow.px；
2。为这些图形元素定义相对数据源，固定名字，但路径是相对的；
3。定义各种动画；
4。使用时，指定路径就可以，只要数据点名称一致，就可以建立与PX界面的连接；
5。修改图形元素的PX，所有引用的地方都会修改，大大缩短时间。

这里提出了一个问题，什么是好的命名规则：
以前的软件中，我们习惯用具体的位置和属性来为一个点命名，如：
1#空调送风温度
1F_23#水泵运行状态

但是在Niagara中，点是通过位置+名字来引用的，名字只是这个点的内容，这样子的好处是点的命名变得很简单，并且根据位置很容易重复引用不同的数据。如：
config\1F\AHU1\SupplyTemp
comfig\Driver\Lonworknetwork\DDC1\AHU2\SupplyTemp

这个两个点的名字完全相同，可是它们代表不同设备的数据。也就是说位置信息尽量用文件夹来表示和管理。
一旦我们指定了引用的位置，PX只需要查找相同的名字就可以。