background image

 

 

 
 
 
 
 
 
 

Summary of Contents for Matrix N Series

Page 1: ......

Page 2: ...mitted in any form or by any means or for any purpose without the express written permission of Datalogic S p A and or its affiliates Datalogic and the Datalogic logo are registered trademarks of Datalogic S p A in many countries including the U S A and the E U DL CODE is a trademark of Datalogic S p A and or its affiliates All other trademarks and brands are property of their respective owners Da...

Page 3: ...e Current Configuration Job 8 3 2 5 Set Startup Configuration Job 9 3 2 6 Change Current Configuration Job 9 3 2 7 Match Code Content 10 3 2 8 Send Configuration Upload Job to Device 10 3 2 9 Get Device Information 12 3 2 10 Send Images 12 3 2 11 Get Command Status 15 3 2 12 Set Focusing Pointer 17 3 2 13 Read Input 18 3 2 14 Read Output 18 3 2 15 Run X PRESS Function 19 3 3 Examples 21 4 MATRIX N...

Page 4: ...ey character byte STX means the start transmission character byte space means the whitespace character For non printable characters the decimal value of the character byte is shown between angular brackets Example 13 10 Carriage Return character byte Line Feed character byte The following representations using these three methods are equivalent ESC 27 1BH and each send character byte 0x1B to the r...

Page 5: ...o the Matrix reader on the following interfaces On board Ethernet TCP IP interface Main RS232 RS422 serial interface Auxiliary RS232 serial interface In order to send the programming strings it is necessary to switch the reader into Host Mode CAUTION DL CODE must be disconnected from all reader interfaces before entering in Host Mode By entering in Host Mode any DL CODE Monitor or X PRESS connecti...

Page 6: ...GRAMMING 2 1 1 1 COLLECTING HMP STRINGS FROM DL CODE The first thing to do is collect the application specific Programming Strings from the DL CODE Configuration Select View Configuration HMP Shortcuts from the Device Settings menu ...

Page 7: ... to select any individual branch and view only the branch specific parameters Each configurable parameter is shown with its programming string name and a list of its configuration parameter values including the default setting You can personalize the programming strings from any view in this window by clicking on the string name and entering a new name no spaces are allowed Then click the Save but...

Page 8: ...ommand the device responds with the second reply message Now you can send one or more programming strings as shown in Chapter 3 3 Exit Host Mode ESC A ESC X This command must always be transmitted to end the programming session The configuration job management depends on the commands issued prior to exit from Host Mode See 3 2 for more details If the SAVE command was issued before exit from Host M...

Page 9: ...umeric Type 1 Enumerative numeric list Type 2 BOOLEAN true false Type 3 String printable characters Integer Type 0 Range Minimum and maximum values allowed for the parameter Default Default value integer Example Exposure Time s parameter Name Exposure Time s Type 0 Range 6 to 500 depending on model Default 270 depending on model Enumerative Type 1 Item List List of the values allowed for the param...

Page 10: ...r Name Identical Codes Type 2 Value false true case sensitive Default false Disabled String Type 3 Length Minimum to maximum number of characters allowed for this parameter Default Default value String Example Wildcard parameter Name Wildcard Type 3 Length Min to Max number of allowable characters in string Value Any character from 00 to FF hex Default ...

Page 11: ...he following message and programming data will not be updated in this case NACK LF After transmitting the reply message the device then waits for another programming string or the exit from host mode programming command 3 2 2 Get Parameter Value in Current Configuration The Matrix device single parameter get string must have the following format GET space PSTR LF where GET The programming command ...

Page 12: ...following format SAVE space configuration_name LF After making changes to a configuration this command should always be transmitted before exit from programming mode If the command is correct the device confirms with the following message ACK LF If the command is wrong i e missing configuration_name or due to a transmission error the device replies with the following message NACK LF After transmit...

Page 13: ...paces and are case sensitive This command does not change the current configuration It also does not require the SAVE command to be issued 3 2 6 Change Current Configuration Job The Matrix change configuration command must have the following format CHANGE_CFG space configuration_name LF If the sequence is correct the device confirms with the following message ACK LF If programming contents are wro...

Page 14: ...a collection type previously saved on the device The code_content can contain spaces and is case sensitive This command overwrites the current Expected Code parameter value 3 2 8 Send Configuration Upload Job to Device CAUTION This command requires a dedicated program to handle file transfer protocol see below It is possible to send a dlcfg job file to the Matrix device saving it to permanent memo...

Page 15: ...ctly the device confirms with the following message ACK LF If transmission is not initiated within 10 seconds the device replies with the following message Timeout LF If programming contents are wrong i e file format content or CRC error or due to a transmission error the device replies with the following message NACK LF After transmitting the reply message the device then waits for another progra...

Page 16: ...low Image Saving Send Image On Demand it is possible to start the FTP images transfer from the device to an FTP Server through this command The Matrix send images command must have the following format SEND_IMAGES space NodeNumber space IdStart space IdStop LF where SEND_IMAGES The programming command all caps NodeNumber mandatory Specifies the node number 0 Master 1 to 31 Slaves The asterisk char...

Page 17: ...y Both o Image Format available formats are RAW BMP PNG JPG Tiff o Remote Folder subfolder name on the FTP Server under which images will be saved o Send Image From Matrix FTP Client See the Image Saving chapter in the DL CODE User s Manual for more details SAVED IMAGE FILENAMES On the FTP Server the saved images filenames will have the following syntax IMG_nnnnnnnnnn_ss_ff_ccc ext where nnnnnnnnn...

Page 18: ...g of packs phases that are too old in the buffer may result in the reader not being able to transmit images even if returning an ACK response to be changed in future releases On IdStart IdStop errors NACK is returned After transmitting the reply message the device then waits for another programming string or the exit from host mode programming command Images can also be sent to a TCP Channel On De...

Page 19: ... have the following format GET_CMD_STATUS LF If the last command sent to the device was SEND_IMAGES the device responds with the following message SEND_IMAGES space ErrorCode space Info1 space Info2 space Info3 space Info4 LF where Error Code Meaning 0 no error 1 generic error 10 command not found syntax error 11 wrong arguments syntax semantic 20 send images in progress 21 send images ok complete...

Page 20: ... of 3 located in phase range 10 to 12 SEND_IMAGES 3 10 Host requests device to send images from phase 3 to phase 10 ACK Device accepts command GET_CMD_STATUS Host requests last command status info SEND_IMAGES 20 Device reports SEND_IMAGES is still in progress GET_CMD_STATUS Host requests last command status info SEND_IMAGES 22 0 0 1 1 Device reports SEND_IMAGES has failed 0 0 images sent For most ...

Page 21: ...ts the focusing pointer ON or OFF and confirms with the following message ACK LF If programming contents are wrong i e a typing error in the file or due to a transmission error the device replies with the following message and programming data will not be updated in this case NACK LF After transmitting the reply message the device then waits for another programming string or the exit from host mod...

Page 22: ... reply message the device then waits for another programming string or the exit from host mode programming command 3 2 14 Read Output The Matrix read output command must have the following format READ_OUTPUT space Output1 Output2 Output3 LF If the sequence is correct the device confirms with the following message ACK Output n state LF Output n state depends on the configured active state if Active...

Page 23: ...n exit the X PRESS function before its associated timeout by executing the same command a second time toggle If the associated timeout has already expired then executing the xpress command a second time will run the function again If programming contents are wrong i e a typing error or due to a transmission error the device replies with the following message NACK LF After transmitting the reply me...

Page 24: ...E PROGRAMMING 20 3 Figure 1 Connection to Device Programming and Disconnection from Device ESC C ESC B COMMAND 1 COMMAND n ESC H CR LF ESC S CR LF HOST DEVICE ACK LF or NACK LF ACK LF or NACK LF SAVE COMMAND ACK LF ESC A ESC X ...

Page 25: ...X5 X6 X7 X8 X9 X10 Data 2 The programming string is SET space GAINMULTIPLIER space 2 CR LF 3 Set Data Matrix ECC 200 Image Mirroring parameter to enabled Type 2 Item List true Enabled false Disabled Data true The programming string is SET space 2D_IMAGE_MIRRORING space true CR LF 4 Set Data Matrix ECC 200 Image Filter Placeholder character to Type 3 Item List any printable character Data The progr...

Page 26: ...r C14P00584 Device name Matrix Application version 1 4 0 1073 Current Job Phase Mode 6 Transfer all pending images from all devices in the cluster The programming string is SEND_IMAGES CR LF 7 Transfer images from slave 2 starting from pack phase 123 The programming string is SEND_IMAGES 2 123 CR LF 8 Transfer images from Master for packs phases 10 to 12 The programming string is SEND_IMAGES 0 10 ...

Page 27: ...tive strings assigned by DL CODE See par 1 1 for details 4 1 IMAGE SETUP PARAMETER TYPE STRING DATA Image Polarity Inversion 2 IMAGE_POLARITYx false Disabled true Enabled Exposure Time s 0 EXPOSURE_TIMEx M450N all models Disabled 33 to 64000 Very High Power Strobed 33 to 500 High Power Strobed 33 to 2500 Continuous High Power 33 to 400 M410N all models Disabled 10 to 64000 Always On 1000 to 64000 ...

Page 28: ...48 For M300N all models Range 4 to 48 For M410N 500 010 models Range 6 to 48 For M410N 700 010 models Range 1 to 25 For M450N all models Gain Multiplier 1 GAINMULTIPLIERx 0 X1 1 X2 2 X3 3 X4 4 X5 5 X6 6 X7 7 X8 8 X9 9 X10 Reading Distance mm 0 READING_DISTANCEx Range 40 to 120 mm For M210N 2x5 x1x models Range 22 to 452 mm For M300N 4x2 0xx models 4 2 CODE SETUP 4 2 1 2D Codes PARAMETER TYPE STRIN...

Page 29: ...Method 1 2D_DECODING_METHODx 0 Standard 1 Dot Peen Decoding Image Mirroring 2 2D_IMAGE_MIRRORINGx false Disabled true Enabled Grey Level Calibration 2 2D_GREY_LEVEL_CALIBRATIONx false Disabled true Enabled Code Color 1 2D_CODE_COLORx 0 Black 1 White 2 Both Colors Code Contrast 1 2D_CODE_CONTRASTx 0 High 1 Standard 2 Low 3 Very Low 4 Automatic PARAMETER TYPE STRING DATA MICRO QR Identical Codes 2 2...

Page 30: ... Disabled true Enabled Grey Level Calibration 2 2D_GREY_LEVEL_CALIBRATIONx false Disabled true Enabled Code Color 1 2D_CODE_COLORx 0 Black 1 White 2 Both Colors Code Contrast 1 2D_CODE_CONTRASTx 0 High 1 Standard 2 Low 3 Very Low 4 Automatic Partial Code Tx 2 2D_PARTIAL_CODE_TXx false Disabled true Enabled PARAMETER TYPE STRING DATA DOTCODE Identical Codes 2 2D_ID_CODESx false Disabled true Enable...

Page 31: ...ngth 1 character Min Number of Characters 0 2D_MIN_CHARx Range 1 to 3116 Max Number of Characters 0 2D_MAX_CHARx Range 1 to 3116 Code Quality Standard1 1 2D_CODE_QUALITY_STx 0 Overall 1 Decode 2 Contrast 3 Modulation 4 Decodability 5 Minimum Edge Contrast 6 Axial Non Uniformity 7 Unused Error Correction 9 Minimum Reflectance 10 Defects 11 Fixed Pattern Damage 12 Grid Non Uniformity Code Quality In...

Page 32: ...ode Orientation 1 1D_CODE_ORIENTATIONx 0 Horizontal 1 Vertical 2 Both Advanced Box Improvement 2 1D_ADV_BOX_IMPROVEMENTx false Disabled true Enabled Subpixel Decoding Improvement 2 1D_SUBPIXEL_IMPROVEMENTx false Disabled true Enabled PARAMETER TYPE STRING DATA CODE 128 Identical Codes 2 1D_ID_CODESx false Disabled true Enabled Grey Level Calibration 2 1D_GREY_LEVEL_CALIBRATIONx false Disabled true...

Page 33: ...Enabled Grey Level Calibration 2 1D_GREY_LEVEL_CALIBRATIONx false Disabled true Enabled Code Orientation 1 1D_CODE_ORIENTATIONx 0 Horizontal 1 Vertical 2 Both Advanced Box Improvement 2 1D_ADV_BOX_IMPROVEMENTx false Disabled true Enabled Subpixel Decoding Improvement 2 1D_SUBPIXEL_IMPROVEMENTx false Disabled true Enabled Narrow Quiet Zone 2 1D_NARROW_MARGINSx false Disabled true Enabled Character ...

Page 34: ... 0 Standard 1 Low Small Codes Improvement 2 1D_SMALL_CODES_IMPROVEMENTx false Disabled true Enabled PARAMETER TYPE STRING DATA MSI Identical Codes 2 1D_ID_CODESx false Disabled true Enabled Grey Level Calibration 2 1D_GREY_LEVEL_CALIBRATIONx false Disabled true Enabled Code Orientation 1 1D_CODE_ORIENTATIONx 0 Horizontal 1 Vertical 2 Both Advanced Box Improvement 2 1D_ADV_BOX_IMPROVEMENTx false Di...

Page 35: ...ATRIX 2 OF 5 Identical Codes 2 1D_ID_CODESx false Disabled true Enabled Grey Level Calibration 2 1D_GREY_LEVEL_CALIBRATIONx false Disabled true Enabled Code Orientation 1 1D_CODE_ORIENTATIONx 0 Horizontal 1 Vertical 2 Both Advanced Box Improvement 2 1D_ADV_BOX_IMPROVEMENTx false Disabled true Enabled Subpixel Decoding Improvement 2 1D_SUBPIXEL_IMPROVEMENTx false Disabled true Enabled Narrow Quiet ...

Page 36: ...lse Disabled true Enabled Grey Level Calibration 2 1D_GREY_LEVEL_CALIBRATIONx false Disabled true Enabled Code Orientation 1 1D_CODE_ORIENTATIONx 0 Horizontal 1 Vertical 2 Both Advanced Box Improvement 2 1D_ADV_BOX_IMPROVEMENTx false Disabled true Enabled Subpixel Decoding Improvement 2 1D_SUBPIXEL_IMPROVEMENTx false Disabled true Enabled PARAMETER TYPE STRING DATA GS1 DATABAR LIMITED Identical Co...

Page 37: ...ue Enabled Subpixel Decoding Improvement 2 1D_SUBPIXEL_IMPROVEMENTx false Disabled true Enabled NOTE GS1 DataBar option also enables GS1 DataBar Truncated symbology while GS1 DataBar Stacked option also enables GS1 DataBar Stacked Omni directional symbology PARAMETER TYPE STRING DATA CODE 93 Identical Codes 2 1D_ID_CODESx false Disabled true Enabled Grey Level Calibration 2 1D_GREY_LEVEL_CALIBRATI...

Page 38: ... Subpixel Decoding Improvement 2 1D_SUBPIXEL_IMPROVEMENTx false Disabled true Enabled Narrow Quiet Zone 2 1D_NARROW_MARGINSx false Disabled true Enabled PARAMETER TYPE STRING DATA UPCA UPCE Identical Codes 2 1D_ID_CODESx false Disabled true Enabled Grey Level Calibration 2 1D_GREY_LEVEL_CALIBRATIONx false Disabled true Enabled Code Orientation 1 1D_CODE_ORIENTATIONx 0 Horizontal 1 Vertical 2 Both ...

Page 39: ...Decodability 5 Minimum Edge Contrast 6 Axial Non Uniformity 7 Unused Error Correction 9 Minimum Reflectance 10 Defects 11 Fixed Pattern Damage 12 Grid Non Uniformity Code Quality Index 1 1D_CODE_QUALITY_INDEXx 0 Any 1 Grade A 2 Grade B 3 Grade C 4 Grade D 2 Values depend on Code Type and Code Quality Standard Not all parameters are valid for a given code ...

Page 40: ...alse Disabled true Enabled PARAMETER TYPE STRING DATA KIX Code Identical Codes 2 POSTAL_ID_CODESx false Disabled true Enabled Image Mirroring 2 POSTAL_IMAGE_MIRRORINGx false Disabled true Enabled PARAMETER TYPE STRING DATA Japan Post Identical Codes 2 POSTAL_ID_CODESx false Disabled true Enabled Image Mirroring 2 POSTAL_IMAGE_MIRRORINGx false Disabled true Enabled PARAMETER TYPE STRING DATA PLANET...

Page 41: ...e Disabled true Enabled PARAMETER TYPE STRING DATA Swedish Postal Identical Codes 2 POSTAL_ID_CODESx false Disabled true Enabled Image Mirroring 2 POSTAL_IMAGE_MIRRORINGx false Disabled true Enabled PARAMETER TYPE STRING DATA POSTAL CODE FILTER Wildcard 3 POSTAL_WILDCARD_CHARx Length 1 character Placeholder 3 POSTAL_PLACEHOLDERx Length 1 character Min Number of Characters 0 POSTAL_MIN_NUM_CHARx Ra...

Page 42: ...On 3 External Ill Strobed Number of Events 0 LOCOUT_NUM_OF_EVENTS_x Range 1 to 255 Line Type 1 LOCOUT_LINE_TYPE_x 0 NPN 1 PNP 2 Push Pull 4 2 5 LEDs PARAMETER TYPE STRING DATA GREEN SPOT Active State 1 OUT_ACTIVE_STATE_1 0 Active Closed 1 Active Open Number of Events 0 OUT_NUM_OF_EVENTS_1 Range 1 to 255 RED SPOT Active State 1 OUT_ACTIVE_STATE_2 0 Active Closed 1 Active Open Number of Events 0 OUT...

Page 43: ... 100 64 DLE 16 10 58 3A e 101 65 DC1 17 11 59 3B f 102 66 DC2 18 12 60 3C g 103 67 DC3 19 13 61 3D h 104 68 DC4 20 14 62 3E i 105 69 NAK 21 15 63 3F j 106 6A SYN 22 16 64 40 k 107 6B ETB 23 17 A 65 41 l 108 6C CAN 24 18 B 66 42 m 109 6D EM 25 19 C 67 43 n 110 6E SUB 26 1A D 68 44 o 111 6F ESC 27 1B E 69 45 p 112 70 FS 28 1C F 70 46 q 113 71 GS 29 1D G 71 47 r 114 72 RS 30 1E H 72 48 s 115 73 US 31...

Page 44: ......

Reviews: