Client Development Application Note

Size: px

Start display at page:

Download "Client Development Application Note"

其巫
3 years ago
Views:

1 WebChip WebChipServer

2 WebChipServer TM JRE WebChipServer TM WebChip TM WebChipAccess WebChipAPI WebChipManager WebChipManager

3 Win98\WinNt\Win , WebChipServer TM WebChip TM WebChipServer TM 1.2 CPU 400MHz 128M 100M CDROM Windows 98 WindowsNT4.0 Windows2000 PSEA00A Evaluation kit 1.3 WebChipServer TM PSEA00A Evaluation kit DataCom JRE WebChipServer TM java java JRE, 1.3 JRE DataCom Corp Page 1/27

$Windows HKEY_LOCAL_MACHINE\Software\JavaSoft\Java HKEY_LOCAL_MACHINE\Software\JavaSoft\Java Plug-in HKEY_LOCAL_MACHINE\Software\JavaSoft\Java HKEY_LOCAL_MACHINE\Software\JavaSoft\Java Runtime$

4 1. JRE1.3 International version 2. JRE1.3 JRE Windows HKEY_LOCAL_MACHINE\Software\JavaSoft\Java HKEY_LOCAL_MACHINE\Software\JavaSoft\Java Plug-in HKEY_LOCAL_MACHINE\Software\JavaSoft\Java HKEY_LOCAL_MACHINE\Software\JavaSoft\Java Runtime Environment Windows regedit HKEY_LOCAL_MACHINE Software JavaSoft Java Java Plug-in Java Java Runtime Environment JRE WebChipServer TM WebChipServer TM WebChipServer TM setup.exe setup.exe 1 2 DataCom Corp Page 2/27

5 2 Next Cancel Next 3 3 DataCom Corp Page 3/27

6 Yes No Yes 4 4 Next Cancel Next 5 5 DataCom Corp Page 4/27

7 Browse Next Next 6 6 Typical Compact Custom Typical Next 7 7 DataCom Corp Page 5/27

Program Folders WebChipServer TM 8 Next 8 1.

8 Program Folders WebChipServer TM 8 Next DataCom Corp Page 6/27

9 2.1 Internet Internet MCU 1999 OSGi 9 9 OSGi DataCom Corp Page 7/27

OSGi PDA OSGi OSGi 2000 5 OSGi 1.0 OSGi Prosyst mbserver mbserver 4.1 mbserver4.

10 OSGi PDA OSGi OSGi OSGi 1.0 OSGi Prosyst mbserver mbserver 4.1 mbserver4.1 OSGi WebChip TM WebChipServer TM OSGi OSGi OSGi 2.2 WebChip TM OSGi WebChip TM WebChip TM OSGi mbserver4.1 DataCom Corp Page 8/27

11 WebChipAccess WebChipAPI WebChipManage, Bundle Bundle WebChipAccess.jar WebChipAPI.jar WebChipManager.jar Bundle WebChipAccess, WebChip TM Webchip TM WebChipAccess MCUap TM 1.0 MCUap TM 1.0 McuApAccessServiceImpl McuApAccessService WebChipAPI WebChipAccess WebChipAPI ChipAPIImpl ChipAPI API WebChipAPI WebChipAccess McuApAccessServiceImpl WebChipAccess Bundle WebChipManage Bundle mbserver, Bundle Prosyst mbserver Administrator WebChipAPI 2.3 WebChipServer TM OSGi Framework mbserver mbserver 4.1 mbserver 4.1 CPU OS Java mbserevr4.1 DataCom Corp Page 9/27

12 2.3.1 mbserver 4.1 CPU 200MHz, 128M 50M CPU 400MHz RAM 128MB 100M mbserver 4.1 Java Java Java Windows 98 /Windows NT 4.0 / Windows2000 / Unix Java JRE 1.2 / 1.3 OSGi mbserver mbserver4.1 OSGi Service Gateway Specification Release 1.0 OSGi mbserver4.1 Prosyst mbserver4.1 Bundle Bundle init.jar lib.jar putil.jar console.jar registry.jar log.jar http.jar devicem.jar usermgr.jar pmp.jar telnet.jar license.jar pbloader WebChipServer TM Bundle WebChipAccess.jar WebChipAPI.jar WebChipManager.jar mbserver4.1 init.jar boot.ini Bundle boot.ini Java package WebChipAccess WebChipAccess MCUap PointBase WebChipAPI polling WebChipAccess 11 DataCom Corp Page 10/27

13 WebChipAPI Table Thread WebChipAccess Thread Polling RS232 RS485 Device Device Device Device 11 WebChipAccess PointBase WebChip.dbn WebChipAccess 1 DevicesConstants WebChipAPI 2 DevicesVariables WebChipAPI 3 (DevicesEvents) WebChipAPI DataCom Corp Page 11/27

14 4 DevicesFunctions WebChipAPI WebChipAccess 5 (DevicesFiles) WebChipAPI WebChipAccess 6 DevicesRegsister WebChipAccess WebChipAPI com.pns.webchip.mcuapaccessservice mbserver4.1 Register package com.pns.webchip; public interface McuApAccessService { public void AccessHelloWorld( ); public boolean AccessDiscovery( String strcomport, String StrTelePhone ); public boolean AccessConnectDevice( long LngDeviceID, String StrPWD, String StrTelePhone, String StrCommPort, int IntBaud ); public boolean AccessDisConnectDevice( long LngDeviceID ); public String AccessGetConnectState( String StrCommPort ); public boolean AccessDeviceIsConnected( long LngDeviceID ); public byte AccessGetDeviceCharacteristic( long LngDeviceID ); public int AccessGetMaxRec( long LngDeviceID ); public int AccessGetMaxSend( long LngDeviceID ); public int AccessGetObjCount( long LngDeviceID ); public short AccessGetProtocolVersion( long LngDeviceID ); public byte[] AccessCallFunction( long LngDeviceID, String StrFunctionName, byte[] ABytParament, int IntReturn, byte BytParaType, byte BytReturnType ); DataCom Corp Page 12/27

15 } public byte[] AccessReadProperty( long LngDeviceID, String StrPropertyName, int IntOffset, int IntLen, byte BytDataType ); public byte[] AccessReadMemoryProperty( long LngDeviceID, String StrPropertyName, int IntOffset, int IntLen ); public boolean AccessWriteProperty( long LngDeviceID, String StrPropertyName, int IntOffset, byte[] ABytValue, byte BytDataType ); public boolean AccessEnableEvent( long LngDeviceID, String StrEventName ); public boolean AccessDisableEvent( long LngDeviceID, String StrEventName ); public boolean AccessWritePropertyTable( long LngDeviceID, String StrSuperPWD, byte[] ABytData ); public void AccessSetFrameInterval( int IntFrameInterval ); public void AccessSetRecTimeOut( int IntTimeOut ); public void AccessSetBackgroundTimeOut( int IntTimeOut ); public void AccessGetReSendTimes( int IntReSendTimes ); public int AccessGetFrameInterval( ); public int AccessGetRecTimeOut( ); public int AccessGetBackgroundTimeOut( ); public int AccessGetReSendTimes( ); public void AccessClose(); WebChipAccess WebChipAccess Offline com.pns.webchip.mcuapaccessservice com.prosyst.mbs.services.pbloader.pointbaseservice com.prosyst.mbs.services.pmp.pmpserver com.pns.webchip com.prosyst.mbs.services.pbloader.jdbcdriver com.prosyst.mbs.services.pbloader com.prosyst.mbs.services.pmp com.pointbase.jdbc com.prosyst.util.event javax.comm DataCom Corp Page 13/27

16 2.4.2 WebChipAPI (API), WebChipAccess WebChipManager WebChipAPI.ChipAPI, package WebChipAPI; import java.util.vector; public interface ChipAPI { /////////////////////////////Constant Access Interface//////////////////////// public Vector getallconstants(long DeviceId); public AnDeviceConstant getanconstant(long DeviceId,String ConName); /////////////////////////////Variable Access Interface//////////////////////// public Vector getallreadablevars(long DeviceId); public AnDeviceVariable getanreadablevar (long DeviceId,String VarName); public String setanwritablevar(long DeviceId,String VarName,int Offset, byte[] VarValue,byte DataType); /////////////////////////////Event Access Interface//////////////////////////// public AnDeviceEvent getanevent(long DeviceId,String EventName); public Vector getallevents(long DeviceId); public String WriteEvent(long DeviceId,String EventName,int Offset, byte[] EventValue,byte DataType); /////////////////////////////Device Connect Interface//////////////////// public String DeviceConnect(String DeviceName,String UserName,String UserPassword); public Boolean DeviceDisconnect(String DeviceName,String UserName,String UserPassword); public Vector gettotalconnection(); public Vector getuserconnection(); ////////////////////////////Event Subscribe Interface//////////////////// public Boolean SubscribeEvent(long DeviceId,String EventName); public Boolean UnsubscribeEvent(long DeviceId,String EventName); ////////////////////////////Function Access Interface//////////////////// public Vector getallfundescriptor(long DeviceId); DataCom Corp Page 14/27

17 public FunctionDescriptor getanfundescriptor (long DeviceId,String FunName); public FunctionParm ExeAnFunction(long DeviceId,String FunName,byte[] FunParm,int IntReturnLen, byte BytParaType, byte BytReturnType ); /////////////////////////////File Access Interface//////////////////////// public Vector getallfiledescriptor(long DeviceId); public FileDescriptor getanfiledescriptor (long DeviceId,String FileName); public FileContent getfilecontent(long DeviceId, String FileName, int Offset, int Len); public String WriteFile(long DeviceId,String FileName,int offset,byte[] FileContent); //////////////////////////// User Manager Interface ///////////////////////// public Vector getallusers(string arg); public Boolean deleteanuser(string UserName); public Boolean addanuser(string UserName,String Password,boolean Valid); public Boolean UpdateAnUser(String OldUserName,String NewUserName,String NewPassword,boolean NewValid); //////////////////////////// Device Register Manager Interface ///////////////////////// public Vector getalldevices(); public Boolean deleteandevice(long deviceid); public Boolean addandevice(long DeviceId, int ServerId,String DeviceName,String DevicePassword,String AccessPath,int TUpdate); public Boolean UpdateAnDevice(long OldDeviceId,long NewDeviceId,int ServerId,String DeviceName,String DevicePassword,String AccessPath,int TUpdate); //////////////////////////// user/device privilege Manager Interface ///////////////////////// public Vector getanuserprivileges(string UserName); public Boolean deleteanprivilege(string UserName,long DeviceId); public Boolean addanprivilege(string UserName,long DeviceId,String DeviceName); /////////////////////////// Real Time Read & Memory Read Property Interface ////////////////////// public ByteArray RealTimeReadProperty(long DeviceID, String PropertyName, int Offset, int Len, byte DataType ); public ByteArray MemoryReadProperty(long DeviceID, String PropertyName, int Offset, int Len ); } DataCom Corp Page 15/27

18 UserConnectEvent UserDisConnectEvent WebChipAccess WebChipAPI. ChipAPI com.prosyst.mbs.services.pbloader.pointbaseservice com.prosyst.mbs.services.pmp.pmpserver com.pns.webchip.mcuapaccessservice WebChipAPI com.prosyst.mbs.services.pbloader.jdbcdriver, com.pns.webchip, com.prosyst.mbs.services.pmp, com.prosyst.mbs.services.pbloader, com.pointbase.jdbc, com.prosyst.util.io, com.prosyst.util.event WebChipManager Bundle mbserver Web jar pguieditor.jar, Bundle WebChipManager.jar Prosyst mbserver 4.1 Administrator Administrator pguieditor.jar / DataCom Corp Page 16/27

19 MCUap TM DataCom Corp Page 17/27

20 3.1 WebChipManager WebChip Manager Tab 12 There are four tabpages, every one is a function module 12 WebChipManager WebChip Manager Bundle pguieditor.jar WebChipManager.jar WebChip Manager WebChipManager.jar Bundle WebChipManager DataCom Corp Page 18/27

21 WebChipAPI WebChipManager.jar WebChipAPI.jar Bundle Prosyst administrator administrator pguieditor.jar mbserver 4.1 administrator WebChip Manage PointBase webchip AllUsers DevicesRegister UserPrivilege WebChip Manager Prosyst Administraor Bundle WebChip / WebChipManager / ManagerEditor WebChipManager 13 Click here to show WebChipManager TM user interface 13 WebChipManager DataCom Corp Page 19/27

22 Disable Enable, AllUsers Enabled NoUser DevicesRegister devicesregister AllUsers DevicesRegister NoDevice UserPrivilege UserPrivilege "NoPrivilege" DataCom Corp Page 20/27

1 "UserConnectEvent" 1 "UserDisConnectEvent" 3.

23 1 "UserConnectEvent" 1 "UserDisConnectEvent" User manager interface Enabled/ Disabled user Add User button Delete User button Update User button 14 Tab / 1 DataCom Corp Page 21/27

1 Add, 15 Add user dialog box 15 2 / 3 OK 2 1 2 Remove

24 1 Add, 15 Add user dialog box 15 2 / 3 OK Remove User, 3 Yes 3 DataCom Corp Page 22/27

25 1 2 / 3 Update User 4 / 1 2 true false 3 Update User Available false Tab 16 Device manager interface Add device Delete device Update device Discovery device 16 DataCom Corp Page 23/27

26 1 1 Add 17 Add device dialogbox 17 2 AccessPath Modem 3 OK TimeOut DataCom Corp Page 24/27

2 1 2 Remove 3 Yes 3 1 2 3 Update 4 Discovery 1, 18 Device

27 2 1 2 Remove 3 Yes Update 4 Discovery 1, 18 Device Discovery Dialog 18 DataCom Corp Page 25/27

2 3 OK 3.3.3. Cance 4 3.3.3 18 Privilege manager interface Accessible devices Grant button Revoke button Selected

28 2 3 OK Cance Privilege manager interface Accessible devices Grant button Revoke button Selected user Inaccessible devices All Users 2 Unaccessible Devices 3 Grant DataCom Corp Page 26/27

29 2 1 All Users 2 Accessible Devices 3 Revoke Connection event monitor Connection monitor interface Total Connection Connection count by user DataCom Corp Page 27/27

Chapter 2

Chapter 2 2 (Setup) ETAP PowerStation ETAP ETAP PowerStation PowerStation PowerPlot ODBC SQL Server Oracle SQL Server Oracle Windows SQL Server Oracle PowerStation PowerStation PowerStation PowerStation ETAP PowerStation