Difference between revisions of "Opto 22"

From Chemical Engineering @ UP wiki
Jump to: navigation, search
(Opto Setup)
 
(16 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
{| align="right" border="3" width="250px"
 +
|<center>'''Quick Links'''</center>
 +
* [[Opto Troubleshooting]]
 +
* [http://ragnarok/programdownloads/Opto22/1112_SNAP_Ethernet_Brain_Users_Guide.pdf Opto Brain manual]
 +
* [http://ragnarok/programdownloads/Opto22/ Opto documentation archive]
 +
|}
 
==Opto==
 
==Opto==
  
Line 13: Line 19:
 
2) Switch on power supply units in the Opto JB.
 
2) Switch on power supply units in the Opto JB.
  
3) Check LEDs on the Opto brain to see if there are any errors. LED meanings are descibed in [[file:\\freki\Opto 22\1112_SNAP_Ethernet_Brain_Users_Guide.pdf SNAP Ethernet Brain Users Guide]]. If you do come up with an issue and manage to fix it please document it here.
+
3) Check LEDs on the Opto brain to see if there are any errors. LED meanings are described in [http://ragnarok/programdownloads/Opto22/1112_SNAP_Ethernet_Brain_Users_Guide.pdf SNAP Ethernet Brain Users Guide]. If you do come up with an issue and manage to fix it please document it here.
  
 
4) Check that your SNAP modules are snaped into the system. Idealy they should be connected and configured but they are most probably not.
 
4) Check that your SNAP modules are snaped into the system. Idealy they should be connected and configured but they are most probably not.
  
5) Check connectivity with the Brain by opening the command promt (Start->run->cmd) and pinging the brain (e.g. "ping OPTO2"). If you can't ping the brain, check that you are on the same subnet (check your ip by typing "ipconfig" in the command prompt and see if the first three bytes are the same as the Opto. Your ip should be 137.215.117.xxx) If this doesn't work contact your Network Administrator.
+
5) Check connectivity with the Brain by opening the command prompt (Start->run->cmd) and pinging the brain (e.g. "ping OPTO2"). If you can't ping the brain, check that you are on the same subnet (see [[Finding your IP address]]) by verifyng that the first three bytes of the IP Address of the lab computer you use to interact with the opto brains are the same as the Opto ones. Your brains IP addresses should be 137.215.116.xxx (for the PM&Control Lab) and 137.215.117.xxx (for the Tribology Lab). If this doesn't work contact your Network Administrator (IT Help Service) on the extention numbers 3051 or 4845.
  
6) Configure the SNAP modules. Run Start->All Programs->Opto 22->SNAP Ethernet IO Configurator. see one of the existing configuration files as an example. I have found that the configuration fails in some cases if you don't configure all the attached SNAP modules, the workaround here is to pull out everyone elses SNAP modules. Idealy all the SNAPs should be connected and there should be one master configuration file for each Opto brain and then you are only repsponsible for setting up the scaling in the file. I cannot figure out how the scaling works, if you figure it out please document it here. I used default scaling and converted the mA signal to engineering units in my application.
+
To ping a brain, one must proceed as follows: click Start->run->cmd-> a black window prompt appears-> then type the comands:ping brainIP press Enter. (eg:for Opto1. >>ping 137.215.116.239 press Enter). If a message reading "Reply from 137.215.116.239:" appears, then the brain is responding to communication. If the message reads "Request timed out", then the brain does not respond and the network administrator should be contacted.
  
Opto provides a C API to code your own Opto interface applications. Included with this is an example application (\\freki\C$:\Opto22\OptoENET-IO\DriverToolkit\Examples\C++\VC6\Eiocon\Release\eiocon.exe) that you can use to easily test comunication witht the brain and easily writing manual data to the rig. Run the application from the command prompt with the Opto brain's ip as an argument (e.g. Start->run->cmd | cd C:\Opto22\OptoENET-IO\DriverToolkit\Examples\C++\VC6\Eiocon\Release | eiocon.exe 137.215.117.238) Type help to see a list of available commands. Consult [[\\freki\Opto 22\1112_SNAP_Ethernet_Brain_Users_Guide.pdf]] for information regarding the point numbers.
+
6) Configure the SNAP modules. Run Start->All Programs->Opto 22->SNAP Ethernet IO Configurator. see one of the existing configuration files as an example. I have found that the configuration fails in some cases if you don't configure all the attached SNAP modules, the workaround here is to pull out everyone else's SNAP modules. Ideally all the SNAPs should be connected and there should be one master configuration file for each Opto brain and then you are only responsible for setting up the scaling in the file. I cannot figure out how the scaling works, if you figure it out please document it here. I used default scaling and converted the mA signal to engineering units in my application.
  
 +
Opto provides a C API to code your own Opto interface applications. Included with this is an example application (\\freki\C$:\Opto22\OptoENET-IO\DriverToolkit\Examples\C++\VC6\Eiocon\Release\eiocon.exe) that you can use to easily test communication with the brain and easily writing manual data to the rig. Run the application from the command prompt with the Opto brain's ip as an argument (Start->run->cmd)
 +
cd C:\Opto22\OptoENET-IO\DriverToolkit\Examples\C++\VC6\Eiocon\Release
 +
eiocon.exe 137.215.116.238
 +
Type '''help''' to see a list of available commands. Consult [http://ragnarok/programdownloads/Opto22/1112_SNAP_Ethernet_Brain_Users_Guide.pdf this] for information regarding the point numbers.
  
 
=== Matlab ===
 
=== Matlab ===
Line 31: Line 41:
 
</pre>
 
</pre>
 
You will get a success message.
 
You will get a success message.
 +
 +
See the [[Matlab OPTO]] page for more detailed information.
  
 
----
 
----
 +
 
==Real Time vs Simulation Time==
 
==Real Time vs Simulation Time==
  
You also need the [http://ragnarok.up.ac.za/programdownloads/Matlab/Rtclock/rtclock.dll <tt>rtclock.dll</tt>] and [http://ragnarok.up.ac.za/programdownloads/Matlab/Rtclock/rtc.mdl <tt>rtc.mdl</tt>] files to keep everything synchronised. Make sure that you also have [http://ragnarok.up.ac.za/programdownloads/Matlab/Rtclock/rtclock.c <tt>rtclock.c</tt>].  If you have trouble with this procedure, follow any one of the three methods below to syncronize real time with simulation time.  
+
You also need the [http://ragnarok.up.ac.za/programdownloads/Matlab/Rtclock/rtclock.dll <tt>rtclock.dll</tt>] and [http://ragnarok.up.ac.za/programdownloads/Matlab/Rtclock/rtc.mdl <tt>rtc.mdl</tt>] files to keep everything synchronised. Make sure that you also have [http://ragnarok.up.ac.za/programdownloads/Matlab/Rtclock/rtclock.c <tt>rtclock.c</tt>].  If you have trouble with this procedure, follow any one of the three methods below to synchronize real time with simulation time.  
  
Matlab has a separate product called "Real-Time Workshop" to syncronize real time with simulation time. The Real-Time Workshop can create stand-alone executable files which will run in real-time when under a Real-Time Operating System/embedded system. For more on this product, please see:

http://www.mathworks.com/products/rtw/. 

It is also possible to turn you own PC into a Real-Time Operating System, with the Real-Time Windows Target. For more information about this product, please have a look at the following URL:

http://www.mathworks.com/products/rtwt/.
+
Matlab has a separate product called "Real-Time Workshop" to synchronize real time with simulation time. The Real-Time Workshop can create stand-alone executable files which will run in real-time when under a Real-Time Operating System/embedded system. For more on this product, please see:

http://www.mathworks.com/products/rtw/. 

It is also possible to turn you own PC into a Real-Time Operating System, with the Real-Time Windows Target. For more information about this product, please have a look at the following URL:

http://www.mathworks.com/products/rtwt/.
  
 


If you are only interested in slowing your model down within Simulink to view results, please see the following:


 


If you are only interested in slowing your model down within Simulink to view results, please see the following:


  
There are three example folders in the attached [http://ragnarok/programdownloads/Matlab/examples.zip zip file].
+
There are three example folders in the attached [ftp://ragnarok.up.ac.za/publicftp/lab/Matlab/examples.zip zip file].
  
 
===Example 1===
 
===Example 1===
Line 70: Line 83:
 
* Run the M-File rtc.m to create a new model with a "Real-time clock" block created from the C-file above.


 
* Run the M-File rtc.m to create a new model with a "Real-time clock" block created from the C-file above.


  
In all of these examples the sine function acts as "simulation". The other simulation can just be dragged into the system where you want to syncronize.
+
In all of these examples the sine function acts as "simulation". The other simulation can just be dragged into the system where you want to synchronize.
 
   
 
   
 
Please note that all of the above examples will allow the system will run approximately Real-Time, but not exactly. If you need the simulation to run in exact Real-Time, please look at the Real-Time Workshop along with a Real-Time Operating System.  
 
Please note that all of the above examples will allow the system will run approximately Real-Time, but not exactly. If you need the simulation to run in exact Real-Time, please look at the Real-Time Workshop along with a Real-Time Operating System.  
 
----
 
----

Latest revision as of 12:50, 25 October 2012

Quick Links

Opto

OpTo is how we send/receive information from the rigs.

In the PM&C laboratory, all analog to digital conversion is handled by the OPTO22 units in the central box in the laboratory. The control units for each group of AD modules is known as a Brain, and is connected to the network so that all the computers on the local network (and maybe even the Internet in the future) are able to access the values of the readings and write outputs to the rigs.

Opto Setup

To start using the Opto, follow the following procedure:

1) Switch on transmitters. There are electrical plugs at the rigs that need to be switched on. Be careful not to switch on a pump by accident!

2) Switch on power supply units in the Opto JB.

3) Check LEDs on the Opto brain to see if there are any errors. LED meanings are described in SNAP Ethernet Brain Users Guide. If you do come up with an issue and manage to fix it please document it here.

4) Check that your SNAP modules are snaped into the system. Idealy they should be connected and configured but they are most probably not.

5) Check connectivity with the Brain by opening the command prompt (Start->run->cmd) and pinging the brain (e.g. "ping OPTO2"). If you can't ping the brain, check that you are on the same subnet (see Finding your IP address) by verifyng that the first three bytes of the IP Address of the lab computer you use to interact with the opto brains are the same as the Opto ones. Your brains IP addresses should be 137.215.116.xxx (for the PM&Control Lab) and 137.215.117.xxx (for the Tribology Lab). If this doesn't work contact your Network Administrator (IT Help Service) on the extention numbers 3051 or 4845.

To ping a brain, one must proceed as follows: click Start->run->cmd-> a black window prompt appears-> then type the comands:ping brainIP press Enter. (eg:for Opto1. >>ping 137.215.116.239 press Enter). If a message reading "Reply from 137.215.116.239:" appears, then the brain is responding to communication. If the message reads "Request timed out", then the brain does not respond and the network administrator should be contacted.

6) Configure the SNAP modules. Run Start->All Programs->Opto 22->SNAP Ethernet IO Configurator. see one of the existing configuration files as an example. I have found that the configuration fails in some cases if you don't configure all the attached SNAP modules, the workaround here is to pull out everyone else's SNAP modules. Ideally all the SNAPs should be connected and there should be one master configuration file for each Opto brain and then you are only responsible for setting up the scaling in the file. I cannot figure out how the scaling works, if you figure it out please document it here. I used default scaling and converted the mA signal to engineering units in my application.

Opto provides a C API to code your own Opto interface applications. Included with this is an example application (\\freki\C$:\Opto22\OptoENET-IO\DriverToolkit\Examples\C++\VC6\Eiocon\Release\eiocon.exe) that you can use to easily test communication with the brain and easily writing manual data to the rig. Run the application from the command prompt with the Opto brain's ip as an argument (Start->run->cmd)

cd C:\Opto22\OptoENET-IO\DriverToolkit\Examples\C++\VC6\Eiocon\Release
eiocon.exe 137.215.116.238

Type help to see a list of available commands. Consult this for information regarding the point numbers.

Matlab

A Simulink example shows how to access a rig through Matlab. Basically you need an opto22.m file in the appropriate Matlab directory refering to the point number on the opto. Before your PC will communicate through the LAN you need to run the opto22 service. Start by coping the .dll from here (right click and save as...) to c:\windows\system32. Then run cmd and start the service with

regsvr32 MatLabOpto

You will get a success message.

See the Matlab OPTO page for more detailed information.


Real Time vs Simulation Time

You also need the rtclock.dll and rtc.mdl files to keep everything synchronised. Make sure that you also have rtclock.c. If you have trouble with this procedure, follow any one of the three methods below to synchronize real time with simulation time.

Matlab has a separate product called "Real-Time Workshop" to synchronize real time with simulation time. The Real-Time Workshop can create stand-alone executable files which will run in real-time when under a Real-Time Operating System/embedded system. For more on this product, please see:

http://www.mathworks.com/products/rtw/. 

It is also possible to turn you own PC into a Real-Time Operating System, with the Real-Time Windows Target. For more information about this product, please have a look at the following URL:

http://www.mathworks.com/products/rtwt/.



If you are only interested in slowing your model down within Simulink to view results, please see the following:



There are three example folders in the attached zip file.

Example 1

An example of a MATLAB function which goes into a "busy wait" loop which kills time to slow down the simulation until the real-time clock catches up to the Simulink clock:

  • Open the folder example1

.
  • Run the model rtc.mdl.

Example 2

An example of a C-MEX S-function that compares simulation time with the system clock time to slow down the simulation speed:



  • Open the folder example2

.
  • Execute the command:

MEX sfun_time.c

 (In the MATLAB command-line).
  • Run the model rtc_C.

Example 3


A MEX-file which syncs a simulation to the PC internal clock or the UNIX system clock. This is an older example the was created for Simulink 1.3c:

  • Open the folder example 3.
  • Execute the command
:
CMEX rtclock.c (
in MATLAB 4.x) (In the MATLAB command-line).

MEX rtclock.c (
in MATLAB 5.x and above)
 (In the MATLAB command-line).
  • Run the M-File rtc.m to create a new model with a "Real-time clock" block created from the C-file above.



In all of these examples the sine function acts as "simulation". The other simulation can just be dragged into the system where you want to synchronize.

Please note that all of the above examples will allow the system will run approximately Real-Time, but not exactly. If you need the simulation to run in exact Real-Time, please look at the Real-Time Workshop along with a Real-Time Operating System.