SR-5000 Script Reference - E
SR-5000 Script Reference - E
Table of Contents
General cautions .................................................................................. 1
3-1 Calculation............................................................................................ 6
3-2 Comparison .......................................................................................... 6
3-3 Combination of condition...................................................................... 6
3-4 Character string concatenation ............................................................ 6
3-5 Pattern matching .................................................................................. 7
1 GB SR SCRIPT RM
1-1 Overview 1-3 What Script can do
Definition of Script file Examples of what the script can do
The Script explained in this manual is a simple programming language operating • Extracting arbitrary portion of read data
on the SR-5000 Series. • Appending arbitrary character strings to read data
Compared to using the setting software (AutoID Network Navigator), using the • Comparing data and outputting result data
script enables more flexible operations for the (1) Edit output data, (2) Edit image • Four arithmetic operations
file name, and (3) Control output terminals functions. • Changing image file names for FTP transmission
• Comparing data and generating output from the output terminals
Related software * "Additional information" set with AutoID Network Navigator cannot be used in
combination with the script.
AutoID Network Navigator
Software to set the SR-5000 Series
FileView
1-4 Script file configuration
Use this to send/receive the script file to/from the SR-5000 Series. This describes the configuration of the script file (FmtSet.lua).
* For detailed operation procedures for the AutoID Network Navigator and
FileView, refer to the corresponding user's manual. Script file configuration
FmtSet.lua file, the script program handled by SR-5000 consists of the following 3
FmtSet.lua file
Operations when executing the script *1 Multiple user-defined functions can be written as necessary. Skip this if not
used.
The script is executed when a code is read. For writing procedure of user-defined functions, refer to "5-7 User-defined
function" (Page 13).
[1] Reading a code [2] Executing the script when reading. [3] Sending the script execution result
GB SR SCRIPT RM 2
(1) Edit read data function readformatEvent() Comment description
This operates when "Edit data by script" is enabled on the code reader setting.
Format
Format
1-line comment
function readformatEvent() -- Comment Character strings written after -- are treated as the comment.
Variable declaration
Process
Multiple-line comment
The value entered into return is output as "Read
return(variable)
data". -- [[
end Comment Character strings surrounded with --[[ ]] are treated as the
Comment comment.
Example
]]
function readformatEvent()
local a Declares variable a.
a="successful reading!" Assigns "successful reading !" to variable a.
return(a) The value stored in a is output as "Read data".
end
Format
function nameformatEvent()
Variable declaration
Process
The value entered into return is output as "Image
return(variable)
file name".
end
Example
Reference • More than one "Variable" and "Process" can be written. For how to
define variables, refer to "2-1 Naming rules" (Page 4).
• A different function among functions can be called. "Calling the
function" (Page 13)
• Directories can be specified in file names.
To put a image file named "a" into the folder named [image] in the
root folder, specify the value such as image\\a in return.
Note if the applicable folder does not exist in the root folder, it does
not operate normally.
3 GB SR SCRIPT RM
2-1 Naming rules Characters and numerical values that can be assigned to variables
3 types of values can be assigned to variables: character string, numerical value
This describes naming rules for variables, etc. used in the script. and logical value
Text notation : "ABC", "keyence"
Naming methods Character code (decimal number) notation : "\013\010"
character string ([CR][LF])
Script file name Escape sequence : "\r"
(CR)
The script file name handled by SR-5000 is FmtSet.lua only. Integer number : 1, -1
Numerical value Decimal number : 2.0, -2.0
Names defined in the script program Hexadecimal number notation : 0x0a
Types of Name defined in the script program are as follows. True : true
Logical value
False : false
• Variable name, array variable name
• Function name * The condition that no value is assigned to the variable is called nil. If it is referred,
an error will occur. Be sure to assign a value before referring to the variable.
Definitions of variable name and table name
Start the name with a 1-byte alphabet character.
character string
1-byte alphanumeric characters and "_" (underscore) can be used. Text notation
Do not use reserved words. Expresses with the text surrounded with "". Numerical values, symbols and
For reserved words, "8-2 Reserved words/Language elements" (Page 20). character strings can be written in "".
Do not use "_" (underscore) or a number at the beginning of the Character code (decimal number) notation
NOTICE
name. It may not operate normally. Expresses the character string by specifying the ASCII code decimal number after
\.
Numerical value
Positive and negative integer (decimal number notation)
Definition of variable
This expresses positive integer and negative integer as decimal number.
Values such as numerical values, character strings or calculated results can be
Positive and negative decimal (decimal number notation)
assigned to variables.
This expresses positive decimal and negative decimal as decimal number.
Declaration of variable
Important Decimal uses double-precision floating-point number, which may
Format have a margin of error.
Assignment and initialization of variable a= 123 Assigns decimal number integer 123 to variable a.
b = -1.5 Assigns decimal number integer -1.5 to variable b.
Storing a value in a variable is called "assignment".
Assigning a value at the time of variable declaration is called "Initialization". c = 0x0f Assigns hexadecimal number f to variable c.
Example
Logical value
local a=0 Initializes with 0 when declaring variable a. Logical value shows True or False to processed results.
a=1 Assigns 1 to variable a.
Escape sequence
If this is referred with no value assigned to the variable, an error will occur when
executing the script. Pattern Meaning
\r [CR](0x0D)
\n [LF](0x0A)
\a [BEL](0x07)
\b [BS](0x08)
\f [CL](0x0c)
\t [HT](0x09)
\v [VT](0x1B)
\\ Backslash
\" Double quotation
\' Single quotation
\000 Specifies an arbitrary character code as decimal number.
GB SR SCRIPT RM 4
2-3 Table 2-4 Array
The table is the data configuration to collect multiple data. The array is a type of table and a data column that can store multiple values.
Similar to normal variables, reference and assignment can be made.
123 1001 “camera”
Table Product
3 4 5 6 7
Table b
Data (fields) such as LotNo, SerialNo and name are collected in the table (Product).
Numerical values 3,4,5,6,7 are stored in table b.
Example 2) Reference to data variables within the table Assignment and initialization of array variable
Assign values to array valuables using { } and values. Specify multiple values by
local a = 0 Declares variable a.
dividing "," (comma).
local Product ={ LotNo=123 , Serial No=1001 , name="camera"} Declares table Product.
Example
Stores the name field of
a = Product.name
the table Product in a.
local a={} Declares array a.
a = {3,4,5,6} Assigns the 4 values 3, 4, 5, and 6 to array a.
Declares array b and initializes it with the 3
local b ={16,51,55}
values 16, 51, 55.
local b[3] = 10 Assigns 10 to the third value of array b.
Assigns 11 to the fourth value of array b (adds 1
local b[4] = 11
element).
5 GB SR SCRIPT RM
3-1 Calculation 3-3 Combination of condition
This describes arithmetic operators used for general calculations. This describes logical operators used when combining conditions.
Format Format
On the left-hand side and the right-hand side of each operator, write an expression Example
using numerical values or variables of numerical values.
Examples of calculations and results
Example
Arithmetic expression Result
A=B+1 Assigns the result of variable B plus 1 to variable A. true and true true
true or true true
true and false false
Example
true or false true
Reference To obtain only the integer part of division result, use arithmetic function Concatenation operator
math.floor.(Page 11)
Format
3-2 Comparison
variable 1..variable 2
Expresses using 2 periods ".." between
variables.
This describes comparative operators used when comparing numerical values or logical values.
Example
Comparative operator
Declares variable a and initializes with character
Format local a = "Keyence"
string "Keyence".
Declares variable b and initializes with character
local b = "Auto-ID"
Comparative operator Meaning string "Auto-ID".
< smaller local c Declares variable c.
<= smaller or equal c = a..b Assigns values after a and b are connected.
> greater Value of c: "KeyenceAuto-ID"
>= greater or equal
== equal
~= different
On the left-hand side and the right-hand side of each operator, write numerical
values, variables of numerical values or arithmetic expression.
Example
GB SR SCRIPT RM 6
3-5 Pattern matching
This section describes how to search character strings with specific patterns
(Pattern matching) from character strings.
Pattern
Patterns used to search alphabets, numbers, symbols, etc. from character strings.
Meta-character
Pattern Meaning
. All characters (arbitrary 1 character)
%a Character
%c Control character (0x01 to 0x1F, 0x7F)
%d Number
%l Alphabet lowercase
%p Symbol (! " # $ % & ' ( ) * + , - . / : ; > = < ? @ [ \ ] ^ _ ` { | })
%s Space character (0x09,0x0a,0x0b,0x0c,0x0d,0x20)
%u Alphabet uppercase
%w Alphabet and number
%x Hexadecimal number (0 to 9, a to f, A to F)
%z null character
% character*1 Literal character
Quantifier
Pattern Meaning
+ Matches with 1 or more times repetitions of the previous character.
Matches with 0 or more times repetitions of the previous character.
(Longest match)
Matches with 0 or more times repetitions of the previous character.
-
(Shortest match)
? Matches with 0 or 1 time repetition of the previous character.
Range specification
Pattern Meaning
[0-9] Number (0 to 9)
[^0-9] Not number (0 to 9)
[a-z] Alphabet lowercase (a to z)
[A-Z] Alphabet uppercase (A to Z)
[a-zA-Z] Alphabet lowercase and alphabet uppercase (a to z and A to Z)
[0-9a-zA-Z] Number and alphabet (0 to 9, a to z and A to Z)
* If ^ (caret) is added to the beginning of the pattern, the match is fixed to the
beginning of the target character string.
If $ (dollar) is added to the end of the pattern, the match is fixed to the end of the
target character string.
7 GB SR SCRIPT RM
4-1 Conditional branching of Conditional expression
else else
If both "condition 1" and "condition 2" are not fulfilled, "process If type is 20 or more, assign 30 to termID.
process 3 3" is executed. termID=30
end end
No
condition 1
Yes Reference Up to 20 nests can be made for the conditional branching.
No
condition 2
Yes
Reference The "elsif condition then process" sentence can be written multiple
times.
GB SR SCRIPT RM 8
4-2 Repeat process repeat until sentence
repeat until sentences execute process at least once. After the last condition is
This section describes processes when repeating processes. checked, whether to repeat is judged.
Process
break sentence
Use break when going out in the middle of repeat process of while sentences or of
for sentences.
Example Format
while (i<=10) do
If i is 10 or less, the value for i is increased by one. while continuation
i = i+1 condition do
No
end Conditional expression Continuation condition
Yes
Process
break
for sentence Conditional expression
end No
for sentences repeat process using the counter to count the number of repetitions. end
Process
Format
Base
* break can be written only just before end.
for Initialization expression for counter, • Sets the default value to the counter To call break in the middle of the sentence, write as below.
and final value do (variable). The process is repeated until
the value exceeds the final value. Example
Process • Each time the process ends, the counter
increases by one. do
end break
Specifying "increment of counter" end
for Initialization expression for counter, final value • Sets the default value to the counter
and increment of counter do (variable). The process is repeated until
the value exceeds the final value.
• Each time the process ends, the counter
Process increases by positive and negative integer
value specified.
end
Initialization of
No
Final value of counter >= counter
Yes
Process
Addition of counter
Example
for i=1,5 do
If i is 5 or less, the value for a is increased by two.
a=a+2
end
9 GB SR SCRIPT RM
5-1 Input/Output functions 5-2 Data acquisition functions
This section describes basic functions for editing data of SR-5000. This describes the functions to obtain data of codes read by SR-5000.
readResult(idx)
Functions used in readResult(idx)
Edit read data
These functions obtain information of read data. Use as readResult(n):***
Argument idx : Index for read information array*1 Example) readResult(n):readData()
Return value return : Read value Function name Argument Return value
readData() None Read data
*1 The number of arrays can be obtained using the common function
symbolType() None Code type (Refer to "8-3 Code type" (Page 20).)
"readCount()".
Symbol identifier (3 characters) (Refer to "8-3
If idx is omitted, the first code is specified. symbolIdentifier() None
Code type" (Page 20).)
bankNo() None Bank number
regionNo() None Region number
imageResult(idx) scanTimes() None Scan count
Code top coordinates:
cornerCoordinates() None
Edit image file name "X1/Y1:X2/Y2:X3/Y3:X4/Y4"
centerCoordinate() None Code center coordinates: "X1/Y1"
Argument idx : Index for image name information array*2 eccQuality() None Unused error correction (0 to 100)
Return value return : Image file name imageFileNames() None Image file name*1
*2 The number of arrays can be obtained using the common function readingDuration() None Reading duration [ms]
ppc() None PPC
"imageCount()".
cellNum() None Number of cells:"Vertical/horizontal"*2
If idx is omitted, the first code is specified. cellSize() None Cell size (mm)*2
codeSize() None Code size (mm):"Vertical/horizontal"*2
Data entry to readResult and imageResult *1 When using the script for the edit image file name, the file name after the image
file is changed is output.
When multiple image files exist, the value of the Inter-delimiter is the same
Example 1
value set for the SR-5000.
*2 This function is designed for 2D codes.
When reading in the "Standard read mode" is performed on SR-5000 by When a barcode, not a 2D code, is read with the SR-5000, the narrow bar width
registering 3 parameter banks for which alternate reading is enabled. is stored during the execution of the cellSize() function. When a barcode is
read, cellNum() and codeSize() cannot be executed.
• Read OK • When using the SR-5000's advanced multi head, the append data of the slave is
When reading is successful with the first bank all obtained with readData().
GB SR SCRIPT RM 10
5-3 Common functions (Basic) 5-4 Common functions (Advanced)
These functions can be used in common. These functions can be used in common. Following is the more advanced functions.
Reader status acquisition functions math.acos(rad) rad: numerical value arc cos
math.atan(rad) rad: numerical value arc tan
Function name Argument Return value
time() None Time
Character string operation
readCount() None Total number of reading results*1
*1
imageCount() None Total number of saved images Function name Argument Return value
Comparison result string.len(str) str: character string Character string (str) length
result() None
0: Comparison OK, 1: Comparison NG, 2: ERROR Converts the character string (str) to
string.lower(str) str: character string
IP address (delimited by underscore) lowercase characters.
ipAddress() None
ex)192_168_100_001 Converts the character string (str) to
string.upper(str) str: character string
masterSlaveID() None Master/Slave ID uppercase characters.
masterSlaveGroupName() None Master/Slave group name str: character string Character string that repeated the character
string.rep(str,n)
n: numerical value string (str) n times
*1 When the Master/Slave function is used, result data cannot be obtained correctly.
Reverses the alignment sequence of
string.reverse(str) str: character string
character string (str).
Debug function
str: character string
Portion of character string from ith character
Function name Argument Return value string.sub(str,i,j) i: numerical value
to jth character of the character string (str)
j: numerical value
str: character Outputs character strings (str) when debug is
print(str) str: character string Returns the character code for the ith
string executed.*2 string.byte(str,i)
i: numerical value character of the character string (str)
*2 The output setting turns ON after the "SCPDBG,1" command is executed. "6-1
string.char(c1,c2,…) c1: numerical value Character string for the character code.
Debug methods" (Page 13)
str: character string Searches characters that match p among
string.find(str,p) p: character string or the character string (str), and then returns
regular expression the digit number at the head.
str: character string
Returns characters that match p among the
string.match(str,p) p: character string or
character string (str).
regular expression
Used for for loop.
str: character string
Each time the characters that match p
string.gmatch(str,p) p: character string or
among the character string (str) are called,
regular expression
the result is returned in turn.
str: character string
p: character string or Replaces characters that match p among
regular expression the character string (str) with r.
string.gsub(str,p,r,n)
r: character string If n is specified, the first n characters in the
n: numerical value (Can be character string are replaced.
omitted)
Array operation
Function name Argument Return value
tbl: array name
Character strings combined after the data
sep: character (1 character)
table.concat(tbl,sep,i,j) from tbl[i] to l[j] in the array (tbl) is delimited
i: numerical value
by sep.
j: numerical value
Inserts v into the tbl[i] position in the array
tbl: array name (tbl).
table.insert(tbl,i,v) i: numerical value Elements following the ith position are
v: numerical value moved backward by one.
No return value.
Returns the largest index value in the array
table.maxn(tbl) tbl: array name
(tbl).
Deletes the element at the tbl[i] position in
tbl: array name the array (tbl). Elements following the ith
table.remove(tbl,i)
i: numerical value position are moved forward by one.
No return value.
Sorts the elements in the array (tbl).
table.sort(tbl) tbl: array name
No return value.
11 GB SR SCRIPT RM
Bit calculations
Function name Argument Return value
5-5 Controlling output
bitAnd(a,b)
a: numerical value
b: numerical value
Logical disjunction (OR) of a and b terminals and triggers
bitNot(a) a: numerical value Negation of a
Controlling output terminals
a: numerical value
bitOr(a,b) Logical conjunction (AND) of a and b
b: numerical value Function name Argument Return value
a: numerical value Exclusive disjunction (exclusive OR) of a n: output None
bitXor(a,b) outonEvent(n)
b: numerical value and b terminal number (The corresponding output terminal turns on.)
a: numerical value
bitLeftShift(a,b) Shifts a to the left by b bits
b: numerical value
a: numerical value
Controlling triggers
bitRightShift(a,b) Shifts a to the right by b bits
b: numerical value
Function name Argument Return value
a: numerical value
bitLeftRotate(a,b) Rotates a to the left by b bits Instruction to continue capturing images
b: numerical value
invokeNextShot(n) n: bank number If n is left blank, the SR operates with a bank on which
a: numerical value alternating is enabled.
bitRightRotate(a,b) Rotates a to the right by b bits
b: numerical value
If you turn off the timing input, reading will end without capturing the next image
a: numerical value Returns the bit in position b from the lowest
bitExtract(a,b) regardless of whether this function is executed or not.
b: numerical value order position of a
a: numerical value The value in which the bit in position b from
bitReplace(a,b,c) b: numerical value the lowest order position of a is replaced
c: numerical value with bit c Timing diagrams
• Normal
Bit calculation functions are calculations performed in units of 32 bits.
Timing input
Statistical information (functions for SR WEB Monitor use)
Image capture +
Function name Argument Return value decoding
None
id: 0-63
stat.setName(id,str) Sets the name of the slot with the specified • When using invokeNextShot(n)
str: character string
ID (up to 16 characters)
None Timing input
id: 0-63
stat.setValue(id,v) Sets the value of the slot with the specified
v: 0-65535
ID Image capture +
decoding
stat.getName(id) id: 0-63 Name of the slot with the specified ID
invokeNextShot(n)
stat.getValue(id) id: 0-63 Value of the slot with the specified ID*1
*1
stat.incValue(id) id: 0-63 Value of the slot with the specified ID) + 1
Trigger status
*1 Any values that exceed 65535 are set to 65535.
Function name Argument Return value
Others Trigger status
isTriggerActive() None 0: triggers are off
Function name Argument Return value 1: triggers are on
v: judgment If v is False, mes is output. Number of times the script was called while the trigger
assert( v,mes) scriptExecNum() None
mes: character string The program is force-quit. was applied
error("",1) -
Errors (ScriptError) out explicitly and Timing diagrams
terminates the program.
• isTriggerActive
print(mes) mes: character string Outputs messages for debug.
Converts to numerical values. Timing input
tonumber(v) v: value Returns nil if value conversion is not
possible. isTriggerActive
tostring(v) v: value Converts to character strings.
1 0
type(v) v: value Variable type
• scriptExecNum()
Timing input
Script processing
scriptExecNum()
0 1 2 0 1 0
*1 This refers to the case in which the conditions for successful reading
specified with the SR-5000 are met. When using script triggers, reading is not
judged as resulting in an error.
*2 This is the color displayed by the OK/ERROR LED (green/red) of the
SR-5000 main unit. When using script triggers, this LED does not light in red.
*3 This indicates "Read Complete" or "Ext. Request Complete" when using
EtherNet/IP or PROFINET with the SR-5000.
GB SR SCRIPT RM 12
5-6 Confirmation command 6-1 Debug methods
function This section describes debug methods when the script is executed.
You can obtain the reply result of SR Series confirmation commands (RN/RP/RC/
RB/RD). Operation check procedure
For details on the command numbers and the reply details, see the user's manual
of the SR Series.
1 Send the FmtSet.lua file to SR-5000 Series using AutoID Network
Navigator.
Function name Argument Return value
n: confirmation
2 Start the AutoID Network Navigator [Terminal] and click [LON] to
execCmd("n") Confirmation command reply result
command start reading.
Applicable commands RN/RP/RC/RB/RD, KEYENCE, EMAC 3 Read with the code reader and check if the result is correctly
reflected.
* You cannot use commands other than those listed above.
• For editing read data
→ Check if the output data is correct.
5-7
• For editing image file name
User-defined function → When using the setting to send image files via FTP, check the name of
image file uploaded on the specified FTP server.
function readformatEvent() 2 "error ~~~ FmtSet.lua: ○ : ~~" is displayed. The number applied to ○
local a Declares variable a.
is the corresponding row in error.
Open FmtSet.lua with the text editor and repair the source code.
a= test_1() Stores the result of test_1() in variable a.
a = a .. "ABC" Appends character string "ABC" to variable a. print(mes) display (Page 12)
return(a) Outputs the result.
To check (debug output) the variable value in the source code of FmtSet.lua,
end use the print function.
13 GB SR SCRIPT RM
6-2 Error message list Other errors
Error message Description
Memory shortage has occurred.
After the "SCPDBG,1" command is executed, if the script file is sent to the code not enough memory
Review the program.
reader, the following error messages are displayed.
The readformatEvent function does not
attempt to call global 'readformatEvent' (a nil value) exist.
Error message list Write the readformatEvent function.
7-1
Write “)” at the correct position.
'<eof>'
4 Comparison
Execution errors
Error message Description
4-1 Comparison when specific characters are included in read data
4-2 Comparison when control characters are included in read data
Was the arithmetic expression written
FmtSet.lua:○: attempt to perform arithmetic on a 4-3 Deleting control characters when they are included in read data
with character strings?
string value
Write it correctly. 4-4 Deleting <LF>(0x) when it is included in read data
Was the arithmetic expression written 4-5 Date comparison
FmtSet.lua:○: attempt to perform arithmetic on
with character strings?
global 'a' (a string value) 5 Calculations
Write it correctly.
Concatenation failed. 5-1 Obtaining angular degrees of a tilted 2D code
FmtSet.lua:○: attempt to concatenate a nil value Check if values other than character
5-2 Obtaining angular degrees of a tilted barcode
strings are not specified.
5-3 Bit calculations
Concatenation failed.
FmtSet.lua:○: attempt to concatenate global 'a' (a
Check if values other than character 6 Editing read image file names
table value)
strings are not specified.
Undeclared functions were called. 6-1 Appending read data to the read image file name
FmtSet.lua:○: attempt to call global 'a' (a nil value) Check if the name of the function to call 6-2 Appending date and time to the read image file name
is correct. 6-3 Appending date and time and read data to the read image file name
Undeclared functions were called.
FmtSet.lua:○: attempt to call global 'a' (a number
Check if the name of the function to call 7 Controlling output terminals
value)
is correct.
7-1 Controlling output terminals (OK/NG/ERROR)
Undeclared tables were called.
FmtSet.lua:○: attempt to index global 'a' (a nil value) Check if the name of the table to call is 7-2 Preventing duplicate reading
correct.
8 Controlling triggers with scripts
Undeclared tables were called.
FmtSet.lua:○: attempt to index global 'a' (a string
Check if the name of the table to call is 8-1 Continuing reading until the character "S" is read at the start of the data
value)
correct. 8-2 Detecting timing input turning off
FmtSet.lua:○: bad argument #1 to 'cos' (number Wrong argument.
expected, got string) Specify the correct argument. 9 Confirmation commands
FmtSet.lua:○: bad argument #2 to 'max' (number Wrong argument.
9-1 MAC address confirmation command
expected, got nil) Specify the correct argument.
9-2 Reader explanation confirmation command
GB SR SCRIPT RM 14
1 Editing read data 3 Conditional branching
1-1 Extracting the first 1 character and the last 2 characters of read data. 3-1 Outputting the type of read codes
Execution result
Read data : keyence
Execution result
2 Count
Read data : keyence
15 GB SR SCRIPT RM
4 Comparison 4-5 Date comparison
4-1 Comparison when specific characters are included in read data function readformatEvent()
local year=2012
local month=12
function readformatEvent() local date=22
local o_data= "" local code_Year
if string.match(readResult():readData(),"456") then -- When "456" is included in read data local code_Month
o_data = readResult():readData() .. "_OK" -- Appends "_OK" to the end of read data. local code_Date
else -- Other cases local read_data = readResult():readData()
o_data = readResult():readData() .. "_NG" -- Appends "_NG" to the end of read if string.len(read_data) < 8 then
end data. return("reading data is not correct")
return (o_data) end
end code_Year = tonumber(left(read_data ,4)) -- Extracts date information and
code_Month = tonumber(mid(read_data,5,2)) converts it to numerical values.
code_Date = tonumber(mid(read_data,7,2))
Execution result
if code_Year < year then
Read data : 123456789 return "The year is not correct"
elseif code_Month < month then
Execution result : 123456789_OK return "The month is not correct"
elseif code_Date < date then
( "3-5 Pattern matching" (Page 7)is used.) return "The date is not correct"
end
return ("OK") -- Returns OK.
4-2 Comparison when control characters are included in read data
end
function readformatEvent()
local o_data= "" Execution result
if string.match(readResult():readData(),"%c") then -- When control characters are included in read data
o_data = "OK" -- Outputs "OK".
Read data : 22001225. 20111222
else -- Other cases
o_data ="NG" -- Outputs "NG". Execution result : OK The year is not correct
end
return (o_data) This is used to control expiration dates, etc. The date data in the barcode is
end compared with the reference date and output.
Execution result
Execution result : OK
4-3 Deleting control characters when they are included in read data
function readformatEvent()
local read_data
read_data=readResult():readData()
read_data=string.gsub(read_data,"%c","") -- Deletes control characters
read_data=string.gsub(read_data,"%z","") -- Deletes NULL<0x00>
return(read_data)
end
Execution result
function readformatEvent()
local read_data
read_data=readResult():readData()
read_data=string.gsub(read_data,"\010","") -- Deletes [LF]<0x0A>(010 in
return(read_data) decimal number)
end
Execution result
GB SR SCRIPT RM 16
5 Calculations 5-2 Obtaining angular degrees of a tilted barcode
function readformatEvent()
5-1 Obtaining angular degrees of a tilted 2D code
local o_data_u
local o_data --Output data
function readformatEvent()
if result() == 2 then -- Displays the message at read if result() == 2 then --Displays the message at read
return "READ_ERROR" error. return "READ_ERROR" error.
end end
local o_data
local data = readResult():cornerCoordinates() -- Obtains the coordinates at 4 positions of code. local data = readResult():cornerCoordinates() -- Obtains the coordinates at 4 positions of code.
local x1_y1 = field(data,1,":") -- x1/y1:x2/y2:x3/y3:x4/y4 local x1_y1 = field(data,1,":") --x1/y1:x2/y2:x3/y3:x4/y4
local x2_y2 = field(data,2,":") local x2_y2 = field(data,2,":")
local x1 = tonumber(field(x1_y1,1,"/")) local x3_y3 = field(data,3,":")
local y1 = tonumber(field(x1_y1,2,"/")) local x4_y4 = field(data,4,":")
local x2 = tonumber(field(x2_y2,1,"/")) local x1 = tonumber(field(x1_y1,1,"/")) --Converts it to numerical values
local y2 = tonumber(field(x2_y2,2,"/")) local y1 = tonumber(field(x1_y1,2,"/")) and assigns the value to the
if (x1 - x2) == 0 then local x2 = tonumber(field(x2_y2,1,"/")) variable.
o_data = "90".."[deg]_"..readResult():readData() local y2 = tonumber(field(x2_y2,2,"/"))
return (o_data) local x3 = tonumber(field(x3_y3,1,"/"))
elseif (y1 - y2) == 0 then local y3 = tonumber(field(x3_y3,2,"/"))
o_data = "0".."[deg]_"..readResult():readData() local x4 = tonumber(field(x4_y4,1,"/"))
return (o_data) local y4 = tonumber(field(x4_y4,2,"/"))
else
o_data = (y1 - y2)/(x2 - x1)
o_data = math.atan(o_data) -- Obtains arctan. if (x3 - x2) == 0 then
o_data = math.deg(o_data) -- Radian --> Converted to deg(°). if (y3 - y2) > 0 then
o_data = math.floor(o_data) -- Truncates decimals. o_data_u = 0
o_data = o_data.."[deg]_"..readResult():readData() else
return (o_data) -- Appends read data to output. o_data_u = 180
end end
end elseif (y3 - y2) == 0 then
if (x3 - x2) > 0 then
o_data_u = -90
Execution result else
o_data_u = 90
end
Read Data : else
o_data_u = (y3 - y2)/(x3-x2)
o_data_u = math.atan(o_data_u)
Execution result : 45[deg]_keyence 0[deg]_keyence o_data_u = math.deg(o_data_u)
o_data_u = math.floor(o_data_u)
Angular degrees when a workpiece is read from the front are obtained.
* If it is read from angles other than the front, correct angular degrees cannot be if (x3 > x2) then
obtained. o_data_u = -90 + o_data_u
else
* Set the "partition mark" for SR to ":" (colon).
o_data_u = 90 + o_data_u
end
end
end
Execution result
Read Data
Execution result
:
*SR* *SR*
: 30[deg]_SR 0[deg]_SR
Angular degrees when a workpiece is read from the front are obtained.
* If it is read from angles other than the front, correct angular degrees cannot be
obtained.
* Set the "partition mark" for SR to ":" (colon).
function readformatEvent()
local a ={}
a[1] = bitAnd(0,0)
a[2] = bitAnd(1,0)
a[3] = bitAnd(0,1)
a[4] = bitAnd(1,1)
return(a[1]..a[2]..a[3]..a[4])
end
Execution result
17 GB SR SCRIPT RM
6 Editing read image file names 7 Controlling output terminals
To use scripts to control the output terminals, you have to set "Enable scripts," and
6-1 Appending read data to the read image file name then configure the settings as shown below.
function nameformatEvent()
local read_data
read_data = readResult():readData() -- Obtains the code reading result.
return(read_data)
end
Execution result
* The read data is specified as the image file name. If a code with exactly the same
data contents is read, the same image file name is adopted. In this case, the old
file is overwritten.
6-2 Appending date and time to the read image file name
7-1 Controlling output terminals (OK/NG/ERROR)
function nameformatEvent()
return(time()) -- Obtains date information.
end function readformatEvent()
local r_data = result()
local data = readResult():readData()
Execution result
if r_data == 0 then --If the result is OK, turn on OUT1.
outonEvent(1)
Read data : keyence
elseif r_data == 2 then --If the result is ERROR, turn on
Execution result : 20121222120001.bmp
outonEvent(2) OUT2.
* Sending settings from AutoID Network Navigator to the SR-5000 Series else --In all other situations, turn on
synchronizes the time of the PC to that of the SR-5000 Series. outonEvent(1) OUT1 and OUT2.
outonEvent(2)
end
6-3 Appending date and time and read data to the read image file name return (data)
end
function nameformatEvent()
local read_data
read_data = readResult():readData() -- Obtains the code reading result. Execution result
read_data = time().."_"..read_data -- Appends date information.
return(read_data)
end
Read data : keyence
end
Execution result
GB SR SCRIPT RM 18
8 Controlling triggers with scripts 9 Confirmation commands
To control triggers with scripts, you have to set "Enable scripts," and then configure
the settings as shown below. 9-1 MAC address confirmation command
function readformatEvent()
local output_data
output_data=execCmd("EMAC") -Execute the command.
return(output_data)
end
Execution result
8-1 Continuing reading until the character "S" is read at the start of the data Execution result: OK,EMAC,0001FC2D8206
function readformatEvent()
local i 9-2 Reader explanation confirmation command
local read_data
local output_data You can use the SR-5000 to obtain the values set below.
for i = 1, readCount() do
read_data = readResult(i):readData()
if left(read_data,1) == "S" then
return("S data is found!")
elseif result() == 0 then
output_data = "This data isn't S"
invokeNextShot() --Continue reading.
else
output_data = "Read ERROR"
invokeNextShot() --Continue reading.
end
end
return (output_data)
end
Execution result
Execution result : 1
2 10-1 Displaying the count information in SR WEB Monitor
3
Trigger OFF
local i=0
function readformatEvent()
i=i+1
stat.setName(1,"Count")
stat.setValue(1,i)
return (readResult():readData())
end
Execution result
19 GB SR SCRIPT RM
8-1 ASCII code table Pattern matching
Pattern Meaning
High-order 4 bits . All characters (arbitrary 1 character)
Hexadecimal %a Character
0 1 2 3 4 5 6 7
number %c Control character (0x01 to 0x1F, 0x7F)
%d Number
Binary
0000 0001 0010 0011 0100 0101 0110 0111 %l Alphabet lowercase
number
%p Symbol (! " # $ % & ' ( ) * + , - . / : ; > = < ? @ [ \ ] ^ _ ` { | })
NUL DLE (SP) 0 @ P ` p
0 0000 %s Space character (0x09,0x0a,0x0b,0x0c,0x0d,0x20)
000 016 032 048 064 080 096 112
SOH DC1 ! 1 A Q a q %u Alphabet uppercase
1 0001
001 017 033 049 065 081 097 113 %w Alphabet and number
STX DC2 " 2 B R b r %x Hexadecimal number (0 to 9, a to f, A to F)
2 0010
002 018 034 050 066 082 098 114 %z null character
ETX DC3 # 3 C S c s % character*1 Literal character
3 0011
003 019 035 051 067 083 099 115
*1 Specify characters other than alphanumeric characters
EOT DC4 $ 4 D T d t
4 0100
004 020 036 052 068 084 100 116
5 0101
ENQ
005
ACK
NAK
021
SYN
%
021
&
5
053
6
E
069
F
U
085
V
e
101
f
u
117
v
8-3 Code type
6 0110
006 022 038 054 070 086 102 118
Low- 7 0111
BEL ETB ' 7 G W g w Code type list used for symbolType of readResult(idx)
007 023 039 055 071 087 103 119
order 4
bits BS CAN ( 8 H X h x
8 1000 Code type Return value of symbolType
008 024 040 056 072 088 104 120
Reading error 0
HT EM ) 9 I Y i y
9 1001 QR 1
009 025 041 057 073 089 105 121
LF SUB * : J Z j z DataMatrix 2
A 1010
010 026 042 058 074 090 106 122 PDF417/MicroPDF 3
VT ESC + ; K [ k { GS1 DataBar 5
B 1011
011 027 043 059 075 091 107 123 CODE39 6
CL FS , < L \ l | ITF 7
C 1100
012 028 044 060 076 092 108 124
2of5 8
CR GS - = M ] m }
D 1101 NW-7(Codabar) 9
013 029 045 061 077 093 109 125
JAN/EAN/UPC 10
SOH RS . > N ^ n ~
E 1110 CODE128 11
014 030 046 062 078 094 110 126
SI US / ? O _ o DEL COOP2of5 12
F 1111
015 031 047 063 079 095 111 127 CODE93 13
CC-A/B(GS1 DataBar) 14
8-2
CC-A/B(JAN/EAN/UPC) 15
Priority of operator
High ^
not # - (unary)
* / %
+ -
..
< > <= >= ~= ==
and
Low or
GB SR SCRIPT RM 20
Code type list used for symbolIdentifier of readResult(idx) 8-4 Troubleshooting
Code type Detail Symbol ID
QR : Model 1 ]Q0 The script does not operate.
: Model 2, ECI not applied ]Q1
: Model 2, ECI applied ]Q2 If codes can be read normally but the script does not operate, the script execution
: Model 2, ECI not applied, FNC1 (1st) ]Q3 setting of the SR-5000 Series may not be set to "Enable". Using the AutoID
: Model 2, ECI applied, FNC1 (1st) ]Q4 Network Navigator, set the script execution setting to "Enable".
: Model 2, ECI not applied, FNC1 (2nd) ]Q5
* For using the AutoID Network Navigator, refer to the corresponding user's
manual.
: Model 2, ECI applied, FNC1 (2nd) ]Q6
DataMatrix : ECC 200 ]d1
: ECC 200, FNC1 (1st) ]d2
Expected results cannot be achieved.
: ECC 200, FNC1 (2nd) ]d3
Debug according to "6-1 Debug methods" (Page 13)
: ECC 200, ECI applied ]d4
: ECC 200, ECI applied, FNC1 (1st) ]d5 An error occurs when executed.
: ECC 200, ECI applied, FNC1 (2nd) ]d6
CODE39 No check digit validation ]A0 See the applicable error message on "6-2 Error message list" (Page 14), and
Check digit is validated and transmitted. ]A1 revise the program.
Check digit is validated but not transmitted. ]A3
ITF No check digit validation ]I0 Barcodes/2D codes cannot be read.
Check digit is validated and transmitted. ]I1
Check digit is validated but not transmitted. ]I3 Reading setting may not be correctly made on your code reader. Using the AutoID
NW-7(Codabar) ]F0 Network Navigator, make the reading setting for the SR-5000 Series.
JAN/EAN/UPC UPC-A, UPC-E, JAN/EAN13 ]E0 * For using the AutoID Network Navigator, refer to the corresponding user's
JAN/EAN8 ]E4
manual.
8-5
UPC-A, UPC-E, JAN/EAN13
]E3
CODE128
Addon 2, addon 5
FNC1 not included. ]C0 Copyright indication
FNC1 on the first digit (GS1-128). ]C1
FNC1 on the second digit. ]C2 This software uses the following libraries:
GS1 Databar ]e0 Lua:
PDF417, Standard ]L0 Copyright (c) 1994-2017 Lua.org, PUC-Rio.
MicroPDF417 Extended channel interpretation ]L1
Basic channel interpretation ]L2
CODE93 ]G0
2of5 ]S0
COOP2of5 ]X0
Trioptic CODE39 ]A8
Postal ]X0
DotCode generic data ]J0
GS1 format (GS1 DotCode) ]J1
Application Specific ]J2
generic data + ECI ]J3
GS1 format (GS1 DotCode) + ECI ]J4
Application Specific + ECI ]J5
21 GB SR SCRIPT RM
Revision History WARRANTIES AND DISCLAIMERS
(1) KEYENCE warrants the Products to be free of defects in materials and workmanship
Date of printing Version Revision contents for a period of one (1) year from the date of shipment. If any models or samples were
April 2020 Official release shown to Buyer, such models or samples were used merely to illustrate the general
type and quality of the Products and not to represent that the Products would
necessarily conform to said models or samples. Any Products found to be defective
must be shipped to KEYENCE with all shipping costs paid by Buyer or offered to
KEYENCE for inspection and examination. Upon examination by KEYENCE,
KEYENCE, at its sole option, will refund the purchase price of, or repair or replace at
no charge any Products found to be defective. This warranty does not apply to any
defects resulting from any action of Buyer, including but not limited to improper
installation, improper interfacing, improper repair, unauthorized modification,
misapplication and mishandling, such as exposure to excessive current, heat,
coldness, moisture, vibration or outdoors air. Components which wear are not
warranted.
(2) KEYENCE is pleased to offer suggestions on the use of its various Products. They are
only suggestions, and it is Buyer's responsibility to ascertain the fitness of the
Products for Buyer's intended use. KEYENCE will not be responsible for any damages
that may result from the use of the Products.
(3) The Products and any samples ("Products/Samples") supplied to Buyer are not to be
used internally in humans, for human transportation, as safety devices or fail-safe
systems, unless their written specifications state otherwise. Should any Products/
Samples be used in such a manner or misused in any way, KEYENCE assumes no
responsibility, and additionally Buyer will indemnify KEYENCE and hold KEYENCE
harmless from any liability or damage whatsoever arising out of any misuse of the
Products/Samples.
(4) OTHER THAN AS STATED HEREIN, THE PRODUCTS/SAMPLES ARE PROVIDED
WITH NO OTHER WARRANTIES WHATSOEVER. ALL EXPRESS, IMPLIED, AND
STATUTORY WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, AND NON-INFRINGEMENT OF PROPRIETARY RIGHTS, ARE
EXPRESSLY DISCLAIMED.
IN NO EVENT SHALL KEYENCE AND ITS AFFILIATED ENTITIES BE LIABLE TO
ANY PERSON OR ENTITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, PUNITIVE,
SPECIAL OR CONSEQUENTIAL DAMAGES (INCLUDING, WITHOUT LIMITATION,
ANY DAMAGES RESULTING FROM LOSS OF USE, BUSINESS INTERRUPTION,
LOSS OF INFORMATION, LOSS OR INACCURACY OF DATA, LOSS OF
PROFITS, LOSS OF SAVINGS, THE COST OF PROCUREMENT OF
SUBSTITUTED GOODS, SERVICES OR TECHNOLOGIES, OR FOR ANY MATTER
ARISING OUT OF OR IN CONNECTION WITH THE USE OR INABILITY TO USE
THE PRODUCTS, EVEN IF KEYENCE OR ONE OF ITS AFFILIATED ENTITIES
WAS ADVISED OF A POSSIBLE THIRD PARTY'S CLAIM FOR DAMAGES OR
ANY OTHER CLAIM AGAINST BUYER. In some jurisdictions, some of the foregoing
warranty disclaimers or damage limitations may not apply.
BarcodeReader.com
http://www.barcodereader.com/
You can download technical documents useful for BL/SR/RF introduction and
operation.
GB SR SCRIPT RM 22
23 GB SR SCRIPT RM
Copyright (c) 2020 KEYENCE CORPORATION. All rights reserved.