最近老板的东西,要将斯坦福大学开发的NetFPGA版中的Java的GUI界面重新写一遍,为了进行代码的阅读和运行,需要在IDE工具下来进行二次开发,里面的Java的代码量虽然不大,不过也涉及到了或多或少的综合方面的知识,将源代码导入进去,是不可能直接运行成功的,因为斯坦福大学做的时候,是将上层界面和底层数据的获取编在了一起,有很大的耦合性。
刚刚做了几天的代码阅读,代码量没有之前想象的那么大,将目前阅读过的代码的层次结构进行列举如下:
四个文件包:
org.netfpga.backend |
org.netfpga.graphics |
org.netfpga.mdi |
org.netfpga.router |
其中比较重要的是backend(底层寄存器操作)和router(上层显示界面)两个文件包,将自己读过的比较重要文件的主要功能列举如下:
org.netfpga.backend.NFDevice |
Java对NF的抽象对象,对底层操作的最底层的封装 |
org.netfpga.backend.NFRegAccess |
一个接口,用来将动态文件加载成功并强制转换成该对象类型 |
org.netfpga.backend.Register |
对底层寄存器的对象封装 |
org.netfpga.backend.RegTableModel |
对AbstractTableModel的一种重写,这个类是其他上层界面进行界面显示的两个重要的model之一 |
org.netfpga.backend.WideRegTableModel |
对AbstractTableModel的一种重写,这个类是其他上层界面进行界面显示的两个重要的model之一 |
org.netfpga.router.AbstractMainFrame |
JavaGUI启动的主要入口的一个抽象对象,也就是说启动的时候,从该抽象对象的自对象作为入口 |
org.netfpga.router.RouterMainFrame |
AbstractMainFrame的唯一实现,是程序的唯一入口 |
org.netfpga.router.AbstractRouterQuickstartFrame |
作为二层frame来进行的一个主要入口,也是项目中代码量最大的一个单文件,这也是斯坦福大学NetFPGA中的Java的GUI界面开发采用的思路,使用了JInternalFrame这样的frame来进行二层frame的开发,具体的信息查看jdk的文档 |
org.netfpga.router.RouterQuickstartFrame |
AbstractRouterQuickstartFrame的唯一实现 |
org.netfpga.router.ARPTableModel |
界面部分的重要组成之一,进行model中相应的模块的定义,事件的响应 |
org.netfpga.router.InterfacePortConfigTableModel |
界面部分的重要组成之一,进行model中相应的模块的定义,事件的响应 |
org.netfpga.router.RoutingTableModel |
界面部分的重要组成之一,进行model中相应的模块的定义,事件的响应 |
org.netfpga.router.StatsRegTableModel |
界面部分的重要组成之一,进行model中相应的模块的定义,事件的响应 |
在CentOS下,当加载了相应的bit文件到NetFPGA板上,并且配置了各个nf2c的四个端口,运行./router.sh,Java的GUI界面便可以正常启动,但这是有如下两个条件才成功的:
- 正常加载了libnf2.so文件,这是java用jna库来加载c生成的动态文件
- 加载了相应的bit文件到NetFPGA板上,并且配置了各个nf2c的四个端口
那么如果将java的GUI界面导入Eclipse(个人认为,Java编写的首选IDE工具)之后,运行org.netfpga.router.RouterMainFrame.java,会出现无法加载“nf2”的错误,这是因为加载动态连接 库出现了问题导致的。进过代码底层的阅读,我将自己的解决方法列举如下,达到了在Windows的Eclipse下,正常启动了Java的GUI界面,不过这只是正常启动上层GUI界面,我之后要做的是,用Java的Socket编程进行远端连接Host,然后进行配置、显示并可以对一台Host上1台或者2台NetFPGA的板卡进行相应数据的配置、显示等,这包括Router、Ip、Mac、ARP等信息。
- 将所需要的jar文件导入到自己的工程下,并将Java代码导入到工程中
- 将需要用到底层访问寄存器的org.netfpga.backend.NFRegAccess.java中的“NFRegAccess INSTANCE = (NFRegAccess)Native.loadLibrary("nf2", NFRegAccess.class);”代码注释掉。
- 修改org.netfpga.backend.NFDevice.java代码,修改内容如下,修改的主要内容是将所有用到了底层访问寄存器的操作全部注释掉,替换成简单的操作,使得可以运行成功
package org.netfpga.backend;
//import com.sun.jna.ptr.IntByReference;
public class NFDevice {
public static final int WRITE_ACCESS = 0;
public static final int READ_ACCESS = 1;
private NFRegAccess.NF2 nf2 = new NFRegAccess.NF2 ();
public NFDevice(){};
public NFDevice(String ifaceName) {
this.nf2.device_name = ifaceName;
this.nf2.fd = 0;
this.nf2.net_iface = 0;
}
public NFDevice(String ifaceName, int fileDescriptor, int netIface) {
this.nf2.device_name = ifaceName;
this.nf2.fd = fileDescriptor;
this.nf2.net_iface = netIface;
}
/**
* Read the register at the specified address
* @param addr
* @return the value at the address
*/
public int readReg(long addr) {// modified by yuanbo 2011-03-16
/* create pointer to int */
// IntByReference val = new IntByReference();
// NFRegAccess.INSTANCE.readReg(nf2, (int)addr, val);
// return val.getValue();
return 1;
}
/**
* Write value to the specified address
* @param addr the location to write
* @param value the value to write
*/
public void writeReg(long addr, int val) {// modified by yuanbo 2011-03-16
// NFRegAccess.INSTANCE.writeReg(nf2, (int)addr, val);
}
/**
* Perform all operations in the array in one go
* @param addr the locations to read/write
* @param value the values to read/write
* @param access_types for each location, a 1 is a read, a 0 is a write
* @param num_accesses the number of addresses in the array to read/write
* @return
*/
public void accessRegArray(long []addr, int []value, int[] access_types, int num_accesses) {// modified by yuanbo 2011-03-16
// int i;
//
// /* perform the accesses */
// for(i=0; i<num_accesses; i=i+1) {
// if(access_types[i]==WRITE_ACCESS) {
// writeReg(addr[i], value[i]);
// } else if (access_types[i]==READ_ACCESS) {
// value[i] = readReg(addr[i]);;
// }
// }
}
/**
* check if the interface exists
* @return 1 on error
*/
public int checkIface() {// modified by yuanbo 2011-03-16
// return NFRegAccess.INSTANCE.check_iface(nf2);
return 0;
}
/**
* Opens the interface for access
* @return non-zero on error
*/
public int openDescriptor() {// modified by yuanbo 2011-03-16
// return NFRegAccess.INSTANCE.openDescriptor(nf2);
return 0;
}
/**
* Closes the file descriptor
* @return non-zero on error
*/
public int closeDescriptor() {// modified by yuanbo 2011-03-16
// return NFRegAccess.INSTANCE.closeDescriptor(nf2);
return 0;
}
public String getIfaceName() {// modified by yuanbo 2011-03-16
// return nf2.device_name;
return "test in NFDevice";
}
public void setIfaceName(String devName) {
// nf2.device_name = devName;
}
}
到此,你便可以正常启动org.netfpga.router.RouterMainFrame.java来启动Java的GUI界面了,进行二次开发便容易一些,不过要使用这些已经存在的代码来进行自己的开发不是几天能搞定的,他的代码耦合性比较大,没有考虑过二次开发的问题我觉得,要将界面和底层的寄存器访问操作分离,并加入网络编程进行远程操作,而且处理一台主机多台NetFPGA板卡的情况。之后的操作会在博客中继续更新。