Omron NS - User manual

Cat. No. V075-E1-08
Macro Reference
NS-Series
REFERENCE MANUAL
Cat. No. Z264-E1-06A Note: Specifications subject to change without notice.
Authorized Distributor:
Printed in Europe
Cat. No. Z264-E1-06A Smart Sensor ZFX-C USER´S MANUAL

Section 1 Outline of Macro Function
1-1
NS series Macro Referenc
e
Section1 Outline of Macro Function
This section describes execution conditions and programming procedure for using macro.
1-1What is Macro?…………………………………………………………………….1 – 1
1-2Macro Execution Condition……………………………………………………….1 – 2
1-3Macro Programming…………………………………………………… …………1 – 8

Section 1 Outline of Macro Function
1-2
NS series Macro Referenc
e
1-1 What is Macro?
Macro is the function which can be executed by users original program. User can add functions,
such as arithmetic operations and distinction of conditions, which are not supported by standard
functions in CX-Designer. This function allows the PT to process screen display or data, which
is performed by PLC before. It is also possible to reduce a load of PLC. In this manual, the
timing for executing macro is called “Macro Execution Condition”. Macro can be made by
roughly divided three execution conditions as shown below.
-Execution condition for the project
-Execution condition for the screen
-Execution condition for the functional objects
There is no restriction on the number of macros for 1 project/1screen.
Up to 3000 characters can be used for one macro. Line feed is counted as two characters.
There is also no restriction on the number of lines.
Example:
‘Number of inputting characters 11 characters+line
b feed (2characters), including comment
$W0=10; 7characters+line feed (2characters)
STRCPY($W10”,ABCDE”); 21characters
In this case, 43 characters are used.

Section 1 Outline of Macro Function
1-3
NS series Macro Referenc
e
1-2 Macro Execution Condition
Macros can be created for each project, screen, and functional objects. Also they can be
created for the following execution conditions.
Executing conditions for the project
Macro execution conditions that can be made for the project are indicated below.
Select [PT]-[Project Properties]-[Macro] tab in CX-Designer, then set execution condition and
record macro.
For details on registering macros, refer to the online CX-Designer Help ‘System Settings and
Project Properties’.
Execution condition Explanation
When Loading a Project Execute just before loading the first screen after
starting up NS-Hardware
ON timing Alarm/Event
occurred Execute when alarm is occurred
ON timing Alarm/Event is
canceled Execute when alarm is cancelled
When a bit changed Set macro to execute when the address of specified
bit type is changed. Up to 10 macros can be set.
When a value changed Set macro to execute when the address of specified
word type is changed. Up to 10 macros can be set.
Execution conditions for the screen
Macro execution conditions that can be made for each screen are indicated below.
Select [PT]-[Screen/Sheet Properties]-[Macro] tab screen in CX-Designer, then set execution
condition and record macro.
For details on registering macros, refer to the online CX-Designer Help ‘Creating Screens’
Execution condition Explanation
When Loading a Screen Execute immediately after reading screen data to
display the next
When Unloading a Screen Execute immediately after closing the current screen

Section 1 Outline of Macro Function
1-4
NS series Macro Referenc
e
Reference
Macros are executed by the timing as shown below.
NS series, NSJ series and NSH series
When loading a screen
(Execute at the destination
screen)
When unloading a screen
(Execute at the destination
screen)
User screen->User screen Executed Executed
User screen->Transfer screen Not Executed Executed
User screen->System menu Not Executed Executed
System menu->User screen Executed Not Executed
User screen->Screen Saver Not Executed Not Executed
Screen Saver->User screen Not Executed Not Executed
NS-Runtime
When loading a screen
(Execute at the destination
screen)
When unloading a screen
(Execute at the destination
screen)
User screen->User screen Executed Executed
User screen->Transfer screen Not Executed Executed
User screen->System menu Not Executed Executed
System menu->User screen Executed Not Executed
User screen->Screen Saver Not Executed Not Executed
Screen Saver->User screen Not Executed Not Executed
When exiting NS-Runtime - Executed

Section 1 Outline of Macro Function
1-5
NS series Macro Referenc
e
Execution conditions for the functional objects
Macro execution conditions that can be made for each functional object are described in the
following table.
Open property dialog for each functional object and select [Macro] tab page, then set the
execution condition and create macro.
For details on registering macros, refer to the online CX-Designer Help ‘Creating Functional
Objects’.
Execution condition Explanation
Touch on Timing Execute when functional object is pressed.
Touch off Timing Execute when functional object is released
Before Inputting numeral or character
string Execute just before display tenkey pad or virtual keyboard for inputting values or strings
Before Writing numeral or character
string Execute just before notice numeral and character string to the host.
When changing numeral and character
string and comparing numeral Execute when changing the value of address.
When Processing Display Area Execute when display area for alarm display is
pressed.
When Selecting an Alarm/Event Execute just after select each alarm/event displayed
on Alarm/Event Summary
When selecting a list Execute just after select a list displayed on the List
Selection.
Note
If the password is set for functional objects, the following macros are executed after
inputting the password. If the password has been cancelled for inputting, macros will not
be executed.
- Touch on/Touch off timing
- Before inputting Numeral/Character string
- When pressing Display Area
- When selecting an Alarm/Event
- When selecting a list

Section 1 Outline of Macro Function
1-6
NS series Macro Referenc
e
The following conditions can be selected for functional objects.
Functional Object
Touch on Timing
Touch Off Timing
When changing
Numeral/String
and comparing
Numeral
Before inputting
Numeral/String
Before writing
Numeral/String
List Selection
ON/OFF Button OK OK - - - -
Word Button OK OK - - - -
Command Button OK OK - - - -
Bit Lamp - - OK - - -
Word Lamp - - OK - - -
Numeral Display & Input - - OK OK OK -
String Display & Input - - OK OK OK -
Thumbwheel Switch - - OK - OK -
Text - - - - - -
List Selection - - - - - OK
Level Meter - - - - - -
Broken-line Graph - - - - - -
Bitmap - - - - - -
Analogue Meter - - - - - -
Video Display - - - - - -
Date - - - - - -
Time - - - - - -
Data Log Graph - - - - - -
Data Block Table - - - OK OK -
Temporary Input - - - - - -
Consecutive line
drawing - - - - - -
Document Display - - - - - -
Multifunction Object OK OK OK - - -
Contents Display - - - - - -
[Alarm/Event object]
Functional Object When Pressing a Display Area When selecting an Alarm/Event
Alarm/Event Display OK -
Alarm/Event Summary - OK

Section 1 Outline of Macro Function
NS series Macro Referenc
e
Reference
When a command button is set in the following functions, macros that are set at
the touch on will be executed at the touch off. Macros that are set at the off will
not be executed.
Switch screen
Control pop-up screen
Display system menu
Data block control
When functions other than above are selected, macros will be executed at the
specified timing.
Document Display is a functional object that can be used only with NS-Runtime.
1-7

Section 1 Outline of Macro Function
1-8
NS series Macro Referenc
e
1-3 Macro Programming
This section describes macro creation procedures and programming terms.
The Method for Writing a Macro
Delimiter of the Program
Put a semicolon (;) at the end of each program as a delimiter. However, it is not
necessary for IF (), ELSEIF (), ELSE(),ENDIF.
Example;
$W0=2;
IF ($W0>=10)
$W5=$W0-$W2;
ELSE
$W5=$W0+$W2;
ENDIF
Comment
Put single quotation mark at the beginning of the sentence when you add the comment
for each program. From single quotation mark (‘) to the end of character sting will be
regarded as a comment.
Example:
$W0 = 100; ‘Comment
‘Comment
IF ($W1==200)
···
Writing Programming Terms
Both uppercase and lowercase can be used for programming macros because they are
not classified.
Example:
-MovePopwDown () and MOVEPOPWDOWN() are regarded as same function.
-[Host1:DM0]and [host1:dm0] are regarded as same host address.