C Software
C Software
C Software
(Revision C)
Original Instructions
Woodward VxWorks®
Real Time Operating System (RTOS)
Software Manual
This is the safety alert symbol. It is used to alert you to potential personal
injury hazards. Obey all safety messages that follow this symbol to avoid
possible injury or death.
DANGER—Indicates a hazardous situation which, if not avoided, will result in death
or serious injury.
DEFINITIONS WARNING—Indicates a hazardous situation which, if not avoided, could result in
death or serious injury.
CAUTION—Indicates a hazardous situation which, if not avoided, could result in
minor or moderate injury.
NOTICE—Indicates a hazard that could result in property damage only (including
damage to the control).
IMPORTANT—Designates an operating tip or maintenance suggestion.
The engine, turbine, or other type of prime mover should be equipped with an
overspeed shutdown device to protect against runaway or damage to the prime
mover with possible personal injury, loss of life, or property damage.
The overspeed shutdown device must be totally independent of the prime mover
control system. An overtemperature or overpressure shutdown device may also
be needed for safety, as appropriate.
Read this entire manual and all other publications pertaining to the work to be performed before
installing, operating, or servicing this equipment. Practice all plant and safety instructions and
precautions. Failure to follow instructions can cause personal injury and/or property damage.
This publication may have been revised or updated since this copy was produced. To verify that
you have the latest revision, be sure to check the Woodward website:
www.woodward.com/pubs/current.pdf
The revision level is shown at the bottom of the front cover after the publication number. The latest
version of most publications is available at:
www.woodward.com/publications
If your publication is not there, please contact your customer service representative to get the
latest copy.
Any unauthorized modifications to or use of this equipment outside its specified mechanical,
electrical, or other operating limits may cause personal injury and/or property damage, including
damage to the equipment. Any such unauthorized modifications: (i) constitute "misuse" and/or
"negligence" within the meaning of the product warranty thereby excluding warranty coverage
for any resulting damage, and (ii) invalidate product certifications or listings.
Woodward Governor Company reserves the right to update any portion of this publication at any time. Information
provided by Woodward Governor Company is believed to be correct and reliable. However, no responsibility is assumed
by Woodward Governor Company unless otherwise expressly undertaken.
© Woodward 2005
All Rights Reserved
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
Contents
Woodward i
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
Contents
ii Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
Chapter 1.
Software Tools
General Description
This manual describes the Woodward VxWorks® * RTOS (Real Time Operating
System) software tools available to remotely configure and interact with the
MicroNet™ Plus and Atlas-II™ control platforms.
*—VxWorks is a trademark of Wind River Systems, Inc.
The MicroNet Plus and Atlas-II controls are designed so that all interface,
maintenance, and troubleshooting is done via the Serial and Ethernet Ports. No
local keyboard, monitor, or mouse is available to the user, and thus “headless”
operation is accomplished using these tools.
The MicroNet Plus Cyber Secure controls are similar to the MicroNet Plus
controls. All exceptions are noted in this manual. The Secure CPU implements
Accounts that can be managed by the end user and secure file transfers using
SSh encryptions.
Your computer screens may differ slightly from those shown in this
manual due to newer software revisions.
The MicroNet Plus and Atlas-II controls are now shipped with static
IP addresses! To avoid Ethernet IP Address conflicts, read this
manual before connecting the controls Ethernet Ports to a network.
Overview
See Figure 1-1.
Service Tools are the interface programs that allow an operator to move files,
start and stop the application, configure settings, troubleshoot hardware and
software, view status, and ultimately operate the controlled machinery.
Woodward 1
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
Programming Tools
These tools are useful for creating new applications or for modifying existing
ones.
Woodward GAP
Monitor GAP
This debugging tool allows the engineer to view and tune the GAP blocks
while the application is running, see the GAP I/O values change, and edit the
application. It interfaces with the Ethernet or serial ports via the included Servlink
OPC Server tool.
2 Woodward
Manual 26
6336 VxWork
ks RTOS Sofftware Tools for MicroNe
et Plus/Atlas--II
Woodward Co
oder
Coder is the application n that checkss the GAP appplication for problems. If noo
prooblems are fo ound, it autommatically calls the assembleer, linker, and
d compiler to
creeate the file th
hat can be loaaded onto the e hardware ussing AppManager. Error
file
es are created d to help in de
ebugging if th
he Coder findss problems.
Ne
etSim
Ne
etSim is Wood dward’s Wind dows NT base ed simulator software
s usedd for testing
co
ontrol software
e. It provides a closed loop
p simulation environment
e w
when
onnected to a modeling pacckage or open loop testing
co g when run in stand alone
moode. Connecttions to ACSL L based, Matlab/Simulink, and Matrix X//Systembuild
moodeling packaages are supp ported.
etSim Contro
Ne ol Executive
his program iss an interface used for runn
Th ning simulatio
ons of equipm
ment controlled
by
y Woodward systems.
s Noww supports OP PC.
La
adder Logic
The Micro
oNet Plus andd Atlas-II con
ntrols suppo
ort only Ladd
der Logic
versions 2.10
2 or highe
er.
Service
e Tools
hese tools are
Th e useful for syystem debugg ging, variable monitoring, Tunable
T
Maaintenance, re
eal time data collection, da ata analysis, and
a Remote Control.
C See
yo
our Woodward d sales engine eer for additio
onal informatiion.
Ap
pplication Ma
anager
Woodward
d 3
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
Control Assistant
Watch Window II
(not a preferred tool, use Control Assistant WinPanel)
4 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
Monitor GAP
o License required
o Comes in GAP Editor install (on Woodward Master CD)
o Also comes in GAP Programmer install (on Woodward Master CD)
Control Assistant
o License required for graphing/trending features
o Also available on Woodward Master CD
Woodward 5
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
Chapter 2.
Ethernet Networking
Overview
These network settings will probably need to be changed; therefore, care must
be taken to understand some networking principals. Consult your Network
System Administrator and read the “Internet/Ethernet Discussion” section of this
manual for additional information. In addition, networking information can be
found on your local WinNT PC in, Start\Help – Contents\Networking.
The MicroNet Plus supports two shielded 10/100 Base-TX RJ45 female
connectors for TCP/IP sessions; the Atlas-II supports four. These connections
are used for network file sharing, application management, and remote control,
as well as other control functions like Ethernet Modbus® *. A client computer
using a Windows Operating System is required for networking with the
Woodward control.
A unique Ethernet IP address is required for every device on a particular
network in order to avoid IP address conflicts.
The control’s Computer Name is associated with its IP address when using
a network DHCP server or AppManager.
AppManager will only work on Ethernet ports #1 or #2 (MicroNet).
*—Modbus is a trademark of Schneider Automation Inc.
Multiple user Ethernet Ports should not be set to the same Network
Identifier because its Operating System may respond out of only one
port. You will need to set all ports to a different network to ensure
that it will respond. It is recommended that initially, one port be set to
the same Network as your local PC network so that you can use the
software tools described in this manual. See Figure 2-1 for an
example of two separate networks.
6 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
STEP 1:
1. The Woodward control’s Computer Name label is located on the top cover of
the control. It is unique for each control. It starts with “VXM” followed by 8
digits for the MicroNet Plus and “VXA” followed by 8 digits for the Atlas-II
control. Record the Computer Name below.
There is a page at the back of this manual for you to record Software
Setup Information for future use.
VXM________________ or
VXA__________________
To Internet
Plant Network
Workstation Network Identifier 190.14.xxx.xxx, Network Printer
Subnet Mask 255.255.0.0
DHCP Server
Mainframe
Networked PC
NT Op Sys.
Ethernet Device
Static IP, 192.168.200.4 Hub/Switch
Private Network
Network Identifier 192.168.200.xxx,
Subnet Mask 255.255.255.000
2. Are the factory set IP addresses, Subnet Mask and Default Gateway
compatible with your network? Check with your Network Administrator.
YES NO
Woodward 7
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
3. If YES, go to STEP 2.
If NO, find out what is required for your network:
Ethernet #1:
Mode: Static IP or DHCP
IP Address: ________________________
Subnet Mask: ________________________
Default Gateway: ________________________
Ethernet #2:
IP Address: ________________________
Subnet Mask: ________________________
Default Gateway: ________________________
Ethernet #3:
IP Address: ________________________
Subnet Mask: ________________________
Default Gateway: ________________________
Ethernet #4:
IP Address: ________________________
Subnet Mask: ________________________
Default Gateway: ________________________
Go to STEP 3 below.
STEP 2:
Are the factory set IP addresses being used by another device on your network?
See “Pinging the Network” section of this manual.
YES NO
STEP 3:
Connecting to the Ethernet Port
The Woodward software tool “AppManager” (version 2.5 or higher; 3.0 and
higher for Cyber Secure MicroNet Plus) is needed to change the Woodward
control’s Ethernet IP settings to make the control’s Ethernet port accessible to
your local PC. This tool can be downloaded from the Woodward website. See
Chapter 1, “Obtaining Software Tools” section.
To avoid IP address conflicts on your network, isolate the control and your PC
that you will be using for setting up the control, from the network. Figure 2-2
shows examples of two recommended methods.
1. On your PC, shut down your network applications but don’t log off.
8 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
When you have the proper connection between the Woodward control’s
Ethernet Port #1 and your PC, you will see the green “Link” LED remain on
(solid) on your PC AND on the control.
Woodward 9
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
3. Click “Control” in the top header of the AppManager window, use the pull
down menu, and select “Change Network Settings”.
4. Select the desired Ethernet port (adapter) and the desired IP Address
settings to change to. Port 1 is the only port that supports a Default Gateway,
and Port 1 is the only port that supports DHCP.
10 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
6. A message will appear stating that the control settings have been changed
and prompt to reboot the control.
You should follow this procedure for each of the network ports
that need to be configured.
Select the Control in the Control Window and press [Control Information].
Woodward 11
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
About 45 seconds after the control is powered on, messages will be displayed on
the HyperTerminal that identify the VxWorks® operating system and its version
numbers. This message will be displayed:
Press any key to stop auto-boot…
7-6-5-4-3-2-1-0
If you press any key, the auto boot is halted and the operating system is in a
system boot mode:
“[VxWorks boot]:”
12 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
2. “p” (this command lists the boot parameters including the IP address and the
Control name.)
[VxWorks Boot]: p
boot device : tffs=0,0
unit number :0
processor number :0
host name : mars
file name : /OS/System/VxWorks
inet on ethernet (e) : 10.14.140.114:ffff0000 (current static IP address)
host inet (h) : 10.14.36.132
user (u) : mpc5200
ftp password (pw) : mpc5200
flags (f) : 0x80
target name (tn) : VXM12345 (current Control name)
other (o) : bcm0
3. “c” (this command allows you to change the values of the IP address or the
control name).
When you type the “c” command, the first line will be displayed with the
current data value. To change the value, just type in the new value and hit
enter. To move on to the next line without changing the current line, just hit
enter.
To save the new settings, continue hitting enter until you get past the last
line. At this time the control will save the values and give you back the
debug prompt.
To start running the operating system, either type in “@” followed by enter
or reboot the control.
4. When you allow the CPU to boot without pausing in the debug mode, there
will be many more messages. At the end of all the messages you will be able
to login and get a “->” prompt. You can see the available commands from
this menu by typing “help” and then pressing Enter.
Network Debugging
In the following commands, bcm0 represents user network1, bcm1 represents
user network2, bcm2 represents RTN Port 1 for MicroNet Plus and user
network3 for Atlas-II, and bcm3 represents RTN Port 2 for MicroNet Plus and
user network4 for Atlas-II.
Woodward 13
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
WGNetworkConfig—Displays the network settings and allows the user to
configure the network settings for the user Ethernet ports. The network settings
will not take effect until the next reboot.
-> WGNetworkConfig
Network changes will not take effect until the next reboot
The flash file system is divided into 2 drives – OS and HD1Flash. The OS drive
holds all of the operating system files needed for the control to start. The
HD1Flash drive contains all the application related files, VxWorks log and registry
files. The application related files include - data logs, NV logs, EE files, etc. It is
recommended to always keep a backup of the applications files being used
on the control. These backup files will be needed to recover from a hard drive
corruption.
14 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
In the unlikely event that a hard drive corruption occurs, the debug port will
display a message that says –
“Formatted Flash Drive HD1Flash not found”.
The OS drive contains a copy of the needed HD1Flash files. Recovery
commands are provided to allow the user to format the HD1Flash drive.
4b) Enter the command – WGRestoreHD1Flash, this command will copy the
registry and log files needed by VxWorks.
After these steps have been completed, the network will need to be reconfigured
(see First Time Setup Instructions) and the application files need to be restored
(see Downloading and Running the Application). For Cyber Secure CPUs, the
Accounts will need to be reconfigured.
When you have multiple UDP_P blocks, each S_PORT input must be
a unique number. See the UDP_P block help.
Woodward 15
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
The recommended mechanism for transferring files between the control and the
local computer is with AppManager.
The FTP Server follows the FTP standard, so other standard FTP client
programs can be used to transfer files if required.
16 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
Network Passwords
The control Operating System enforces security by requiring the user to login
with valid permissions before the control system can be accessed.
Woodward 17
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
5. To delete an account, select the account you want deleted then select the
“Delete” button then select the “Commit” button.
6. To enter a new account, select “Add Account” and fill in the Account Name,
the Default Password, the Level, Password Duration in days, and the Fixed
Password field then select the “Commit” button.
a. Account Name must be at least 4 characters and no longer than 30
characters, and can be letter or non-letter values.
b. Default Password for the new account can use the “Default@1” value
or enter your own value. Must be at least 6 characters and no longer
than 30 characters and must be at least 2 letter characters and 2 non-
letter characters.
c. The Level defines the permissions granted to this account.
AppManager requires Level 1 for read file permission, Level 11 to write
files, start / stop Applications. The GAP application (SYS_INFO Block)
defines the Level required to read and write application variables.
d. Password duration for the account can be set to any positive integer
value for number of days until the password must be changed. The
value of 0 will set the account to have no expiration of the password.
e. If the Fixed Password is “checked” the account cannot change its own
password. This is used for shared accounts when only the
administrator is allowed to change the password.
NOTE: If the Fixed Password is “checked” and the Password duration
is set to a positive number, the account will expire in the number of
days defined by Password duration. Only the Administrator can change
this password.
7. Reset account is the same as Delete account, then Add Account. It will keep
the same settings as the selected account except for the password. Other
values can be changed at this time if desired.
18 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
NOTE: If the current account does not allow the Password to change
“Password Change Not Allowed” message will be displayed.
5. Enter the New Password and enter the same Password in the Confirm New
Password box. (New Password and Confirm New Password must match or
AppManager will not accept the change.)
Woodward 19
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
4. Click “Control” in the top header of the AppManager window, use the pull
down menu, and select “Display Account Information”.
5. The account name, level and password expiration for the current account is
displayed in AppManager.
Using AppManager, System Log files can be retrieved per the following:
1. On your PC, open AppManager.exe.
2. You should see the Woodward control’s Computer Name in the
AppManager window. Select the control’s Computer Name. If it didn’t show
up, check your connections and verify the Link lights are on.
3. Login to the Control with a valid UserName and Password.
4. Click “Control” in the top header of the AppManager window, use the pull
down menu, and select “Retrieve System Log Files”.
20 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
5. All system log files will be copied from the selected CPU to the PC where
AppManager is running in the following directory: c:\documents and
Settings\All Users\Application Data\Woodward\System Log
Files\<Application Name of Main CPU>\<Name of Main CPU>\*.log.
Woodward 21
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
5. Read the license agreement and select YES if you agree. If you select NO
AppManager will not install the Service Pack.
22 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
6. Explore to the service pack downloaded from the Woodward web site and
click install.
7. AppManager will install the new service pack on the selected CPU and then
select reboot. The CPU will boot with the new service pack installed.
8. Confirm the new service pack is installed by checking the current revision of
the footprint by using AppManager Control->Control Information screen.
Woodward 23
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
24 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
The chassis will always show 16 slots. Only the DIO4824 module and
the CPU will show up in the display. All other VME modules will show
up as “Undefined VME module”.
5. The SYSCON CPU will use the RTN Ethernet Ports to find all RTN_CPUs
on the Network and display them.
Woodward 25
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
Module
Browser
Retrieve
System Logs
6. Select the RTN_CPU you want, then select and click the left most button to
show the control information for the selected RTN_CPU.
26 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
7. Select the RTN_CPU you want, then select and click the second button from
the left to retrieve all the system logs from the selected RTN_CPU. The files
will be copied from the selected CPU to the PC where AppManager is
running in the following directory: c:\documents and Settings\All
Users\Application Data\Woodward\System Log Files\Name of Main
CPU\Name of RTN_CPU\*.log. (See section “Retrieving Log Files”.)
8. The 3rd button is used to install a new service pack on the selected
RTN_CPU. See section “Install Service Packs”.
9. The 4th button is used to browse the VME modules installed in the chassis.
See section “Managing Modules”. NOTE: Only the SYSCON RTN_CPU
can view the VME modules.
10. Select the RTN_CPU you want, then “right mouse click” on it. In the pull
down menu select “Administer Accounts” to modify the accounts in the
RTN_CPU. (See section Network Passwords). NOTE: You must login as the
Administrator to Administer Accounts.
Woodward 27
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
11. Select the RTN_CPU you want, then “right mouse click” on it. In the pull
down menu select “Change Password” to modify the password of the
current Account in the RTN_CPU. (See section Network Passwords).
While the dialog box for Managing RTNs is open, the main
AppManager screens will not be functional.
28 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
Pinging Instructions
You can “ping” a control by IP address as follows:
1. Connect the PC to the Control using a shielded Ethernet cable. Verify that
you have a green “Link” light, which indicates a good connection.
2. On your PC, select [Start]\Programs. Find the Command Prompt shortcut
and type in a ping command.
3. Example: c:> ping 190.14.98.173. See Figure 2-4.
4. Type in “ping” [Enter] to see ping options. See Figure 2-4.
5. To close the command Prompt Window, type in “exit” [Enter].
When pinging the control's Ethernet port, you should see the green
LED blink in response to each ping.
TIP—Pinging with a “-t” suffix will continually ping until you press
[CTRL]+[C].
Woodward 29
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
This module can be configured for ±10 V, ±5 V, or 4–20 mA inputs.
On each Modicon node there is a MAC address (usually some kind of sticker)
which is a unique address given to this node. This address, along with a valid IP
Address, can be obtained from the system administrator, as well as an “Entry
Name” field or description. Enter as shown, and the module will adopt this new IP
Address.
BootP Screenshot:
Chapter 3.
Application Setup and Configuration
Introduction
The application program for the control must be created and loaded before the
control will perform any useful function. This section describes what steps the
system engineer must perform to properly create, load, and maintain software on
the control.
Woodward 31
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
Once the application file (.OUT) is transferred to the control, follow these steps to
start the application:
1. Select the Control Name. The Control List displays the computer names of all
controls attached to the network. When you select a control name from the
list, the Application List (right window) is updated.
Once the application is running, the Status LEDs on the boards that are
configured in GAP will turn off, and AppManager will indicate that the application
is marked as the Auto-Start Application. This means that if the control’s power is
cycled, or if the control goes down for any reason, the current application will
automatically restart when the control comes back up. This feature eliminates the
need to connect to the control with AppManager every time the control is
powered up to get the application software running.
The first time the application is started, a .EE file is created which
holds all of the tunable values in the application program. This file is
located in the same folder as the .OUT file. See the “Tunables
Management” section at the end of this chapter.
32 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
Application files may include the following file types - .out, .ee, .ll,
.vlv.
5. After the Clear Autostart is completed the next time the CPU is reset the
Application will not start automatically. See Application Setup and
Configuration section.
6. This means that if the control’s power is cycled, or if the control goes down
for any reason, the current application will NOT automatically restart when
the control comes back up. The control will have to use AppManager after
the control is powered up to get the application software running. If the
Application is stopped then started after auto start has been disabled, auto
start will be re-enabled.
Woodward 33
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
Rebooting the CPU will cause all the I/O to go to the “IO_LOCK”
failsafe state. Do not reboot the control unless the controlled device
is in a safe non-running state and all Tunable values are saved.
1. Select the Control Name. The Control List displays the computer names of
all controls attached to the network.
34 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
2. Press [Retrieve App Files] button. AppManager may ask you to login.
3. Select Files of Type – All Files. Select all the files in the dialog box and
press Retrieve button.
Woodward 35
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
4. Navigate to the location on your computer to where you want to store the
files and press Save.
After this step has finished, the Application files have been backed up.
AppManager will ask you if you want to stop the currently running application.
Select [YES].
36 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
AppManager will ask you to login:
AppManager will ask you to confirm that you want to stop the application:
The Status Message Display and Application List will indicate when the
application has stopped and it is removed from the AutoStart list.
Woodward 37
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
Next, you will need to transfer an application to the control (skip this step if the
application is already available on the Application List). The [Transfer App Files]
button is used to move the application from your local PC to the control’s
flash memory.
Select the .OUT file of the application you want to transfer and press
Transfer. AppManager will transfer the .OUT file to the control. You will be
prompted before overwriting existing files. You cannot overwrite an
application that is currently running.
38 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
Once the application is transferred, it will be displayed on the Application
list. Highlight the one you want to start and press the blue triangle [Start
Application] button to start the selected application.
The Status Message Display will indicate that the Application is initializing and
show status of the initialization process.
Once the application is finished initializing, the Status Message Display will
indicate that the Application is running and is set to AutoStart.
If desired, the old, stopped application may now be deleted from the control’s
flash memory by selecting [Delete App Files] .
Woodward 39
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
Tunables Management
"Tunables" are the application’s variables that are changeable on-line (without
the need to modify the GAP application). The application programmer may make
certain Boolean, analog, or integer values tunable by adding an asterisk (*) in the
GAP application and defining a tunable range.
Tunable values are stored on the control as an .EE file in binary format. This file
is not transferred with the .OUT file when AppManager’s [Retrieve App Files]
or [Transfer App Files] commands are executed, but may be manually
retrieved (for archiving purposes) using AppManager’s [Retrieve App Files]
command.
To view and modify individual tunables while the application is running, use
Woodward’s Control Assistant or Monitor GAP tools.
There are several ways to capture and adjust tunables in GAP applications, and
there are two ways to view (in one document) all the tunables from an application
that have been loaded into a control.
40 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
To capture and adjust Tunables in GAP applications:
1. In GAP, select “Show Tunables” from the file menu. This allows exporting to
a “.tc” file that can be opened in Microsoft Notepad, Word, or Excel. It will
show the name, current value and the High Limit and Low Limits. You can
change the value, save it, and use Control Assistant to transfer it to the
control running this application.
2. Import tunables to GAP from a “.tc” file. If the control’s tunables have been
adjusted and now you want to get those changes into the GAP application
file, select from the GAP header, File\Import Control Assistant “.tc” file and
upload it.
Woodward 41
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
Chapter 4.
Servlink/WinPanel
Overview
WinPanel is part of Control Assistant and uses the Servlink OPC Server (SOS) to
communicate to the control. Nothing needs to be done in your GAP™ application
to support this.
To install the SOS Servlink OPC Server, it is necessary to have the Microsoft
“.NET” framework version 3.5 or greater on your PC. The “.NET” framework
install program is available from Microsoft or from the Woodward web site. When
this is installed, run the installation program for Monitor GAP, Control Assistant,
or the stand-alone SOS Servlink OPC Server. The install program will guide you
through various choices in the installation process.
42 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
If you select the options “Servlink OPC server” and “Local Server”, as above, it
will cause the SOS Servlink OPC server to run on your machine. If it was already
running from a previous use, it will use that instance.
If this is the first time the Servlink OPC Server has run on your machine, you will
see the following interface:
Most likely, you will want to use the “Connect TCP” option, because it is faster
and requires less configuration than the “Connect Serial” option. To connect
TCP, it is necessary to type in or select the IP Address of the control(s) you want
to communicate with.
Woodward 43
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
After the control has connected, you can close or minimize the Servlink OPC
server window. It will go to the system tray (probably at the bottom-right of your
PC monitor) where it looks like this:
The next time you run an application that uses the SOS Servlink OPC server, it
will attempt to resume connections to the same controls as in the previous
session.
The “New Session” command will result in a dialog (as above) that allows you to
select a new TCP or Serial connection.
The sessions that are running on the Servlink OPC server determine which
controls’ values your OPC clients (like Control Assistant and Monitor GAP) will
have access to.
44 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
SOS will establish a Secure Connection to the Control if a Valid Username and
Password is supplied and the “Enable OPC security interface” is NOT checked.
If the Enable OPC security interface IS checked, SOS will defer the Username
and Password credentials to the connecting device. Currently GAP3 and Control
Assistant 4 support this interface. For tools which are not OPC Security aware,
like old versions of Control Assistant or GAP, the Enable OPC security interface
should not be checked and a valid Username and Password must be supplied.
“Woodward.ServlinkOpcDa.1”
The HMI tool can launch Woodward’s Servlink OPC Server or it can be launched
manually by running the file “SOS.exe” from the install directory. Connections
can be managed as in the above example (“Running the SOS Servlink OPC
Server”).
The client tool should also have an interface for selecting values. The Servlink
OPC values in GAP follow the following naming pattern:
Woodward 45
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
For example: “VXM11184.EMDRP_RMP.IN_RAMP.RAMP”
46 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
To display application values select the control you want to view and open the
explorer window. Select the category on the left side and drag values to the main
window on the left side.
WinPanel Functions
“Receive debug tunable list”
Used to retrieve the current tunable values from the control.
"LockIO"
Sets the IO LOCK on the VME bus which disables all output modules.
“Reset Control”
Used to release the IO LOCK. When Reset Control is selected
“Save Values”
This saves the GAP applications “Tunable Values” to the control in its
C:\Woodward\Applications\filename.ee.
Woodward 47
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
48 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
Chapter 5.
Internet/Ethernet Information
Internet Protocol
The Internet Protocol, (IP), is a network layer Internet protocol. IP facilitates
communication from the two Transport Layer Protocols, TCP (Transmission
Control Protocol) and UDP. (User Datagram Protocol). They run on top of the IP
layer and are identified by Port Numbers.
IP Addresses
The IP address is a 32-bit number made up of four, 3-bit segments separated by
periods. The Subnet Mask controls which bits are the network identifier and
which bits are the station identifier. (The binary 1’s mark which bits of the IP
address represent the network identifier. The binary 0’s indicate which bits of the
IP address is your device ID#—for example, a Subnet Mask of 255.255.0.0 =
11111111.11111111.00000000.00000000.) The first 16 bits of the IP address
identify the network, and the last 16 bits identify the device.
The MicroNet Plus Cyber Secure CPU does not support DHCP mode.
Only fixed IP addresses are supported.
Woodward 49
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
50 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
4. In the SNTP grouping, check the Enable box, enter the IPAddress for the
SNTP Server on the network, and enter the update rate (seconds).
6. A message will appear stating that the control settings have been changed
and prompt to reboot the control.
Woodward 51
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
Internet Vocabulary
IP Internet Protocol—Designed to link networks together.
IP Address 32-bit number made up of four 3-bit segments separated
by periods.
TCP Transmission Control Protocol—Designed to link
networks together.
UDP User Datagram Protocol—Connectionless/ Host to Host
protocol in the Transport Layer of IP.
DHCP Dynamic Host Configuration Protocol—Automates the IP
address assignment.
Gateway A device or computer that forwards data to a destination
on another domain.
Subnet Mask The binary 1’s mark which bits of the IP address is the
network. The 0’s are your stations ID#.
Port A logical number that increases the number of devices
that can talk without increasing IP addresses.
MAC Media Access Control—A unique 48-bit number burned
into the hardware of the device.
Address Mapping When a host broadcasts to all MACs and associates its
IP address to its MAC address when it responds.
52 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
Chapter 6.
Service Options
OEM and Packager Support: Many Woodward controls and control devices are
installed into the equipment system and programmed by an Original Equipment
Manufacturer (OEM) or Equipment Packager at their factory. In some cases, the
programming is password-protected by the OEM or packager, and they are the best
source for product service and support. Warranty service for Woodward products
shipped with an equipment system should also be handled through the OEM or
Packager. Please review your equipment system documentation for details.
Woodward 53
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
This option allows you to call your Full-Service Distributor in the event of an
unexpected outage, or in advance of a scheduled outage, to request a
replacement control unit. If the unit is available at the time of the call, it can
usually be shipped out within 24 hours. You replace your field control unit with
the like-new replacement and return the field unit to the Full-Service Distributor.
Charges for the Replacement/Exchange service are based on a flat rate plus
shipping expenses. You are invoiced the flat rate replacement/exchange charge
plus a core charge at the time the replacement unit is shipped. If the core (field
unit) is returned within 60 days, a credit for the core charge will be issued.
Flat Rate Repair: Flat Rate Repair is available for the majority of standard
products in the field. This program offers you repair service for your products with
the advantage of knowing in advance what the cost will be. All repair work carries
the standard Woodward service warranty (Woodward Product and Service
Warranty 5-01-1205) on replaced parts and labor.
Flat Rate Remanufacture: Flat Rate Remanufacture is very similar to the Flat
Rate Repair option with the exception that the unit will be returned to you in “like-
new” condition and carry with it the full standard Woodward product warranty
(Woodward Product and Service Warranty 5-01-1205). This option is applicable
to mechanical products only.
When shipping the item(s), attach a tag with the following information:
return authorization number;
name and location where the control is installed;
name and phone number of contact person;
complete Woodward part number(s) and serial number(s);
description of the problem;
instructions describing the desired type of repair.
54 Woodward
Manual 26336 VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II
Packing a Control
Use the following materials when returning a complete control:
protective caps on any connectors;
antistatic protective bags on all electronic modules;
packing materials that will not damage the surface of the unit;
at least 100 mm (4 inches) of tightly packed, industry-approved packing
material;
a packing carton with double walls;
a strong tape around the outside of the carton for increased strength.
Replacement Parts
When ordering replacement parts for controls, include the following information:
the part number(s) (XXXX-XXXX) that is on the enclosure nameplate;
the unit serial number, which is also on the nameplate.
Engineering Services
Woodward offers various Engineering Services for our products. For these services,
you can contact us by telephone, by email, or through the Woodward website.
Technical Support
Product Training
Field Service
Technical Support is available from your equipment system supplier, your local Full-
Service Distributor, or from many of Woodward’s worldwide locations, depending
upon the product and application. This service can assist you with technical
questions or problem solving during the normal business hours of the Woodward
location you contact. Emergency assistance is also available during non-business
hours by phoning Woodward and stating the urgency of your problem.
For information on these services, please contact us via telephone, email us, or
use our website: www.woodward.com/support.
Woodward 55
VxWorks RTOS Software Tools for MicroNet Plus/Atlas-II Manual 26336
You can also contact the Woodward Customer Service Department or consult our
worldwide directory (www.woodward.com/support/directory.cfm) for the name
of your nearest Woodward distributor or service facility.
Technical Assistance
If you need to telephone for technical assistance, you will need to provide the following information.
Please write it down here before phoning:
Your Name
Site Location
Phone Number
Fax Number
Engine/Turbine Model Number
Manufacturer
Number of Cylinders (if applicable)
Type of Fuel (gas, gaseous, steam, etc)
Rating
Application
Control/Governor #1
Woodward Part Number & Rev. Letter
Control Description or Governor Type
Serial Number
Control/Governor #2
Woodward Part Number & Rev. Letter
Control Description or Governor Type
Serial Number
Control/Governor #3
Woodward Part Number & Rev. Letter
Control Description or Governor Type
Serial Number
If you have an electronic or programmable control, please have the adjustment setting positions or
the menu settings written down and with you at the time of the call.
56 Woodward
Software Setup Record
Ethernet #1:
Mode Static IP or DHCP
IP Address ________________________
Ethernet #2:
IP Address ________________________
Ethernet #3:
IP Address ________________________
Ethernet #4:
IP Address ________________________
2010/10/Colorado