AMX NI-3101-SIG manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of AMX NI-3101-SIG, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of AMX NI-3101-SIG one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of AMX NI-3101-SIG. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of AMX NI-3101-SIG should contain:
- informations concerning technical data of AMX NI-3101-SIG
- name of the manufacturer and a year of construction of the AMX NI-3101-SIG item
- rules of operation, control and maintenance of the AMX NI-3101-SIG item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of AMX NI-3101-SIG alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of AMX NI-3101-SIG, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the AMX service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of AMX NI-3101-SIG.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the AMX NI-3101-SIG item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    Operation/Reference Guide NetLinx Controllers NI-3101-SIG Signature Series NetLinx ® Integrated Controller Latest Release: 4/14/200 8[...]

  • Page 2

    AMX Limited Warranty and Disclaimer AMX warrants its products to be free of defects in material and workmanship under n ormal use for three (3) years from the date of purchase fr om AMX, with the following exceptions: • Electroluminescent and LCD Control P ane ls are warranted for three (3) years, except for the display and touch overlay componen[...]

  • Page 3

    i NI-3101-SIG Signature Series NetLinx Integra ted Controller Introduction .................. ...................................................................... ................ 1 NI-3101-SIG Specifications......... .................... ........................ ......................... .......... 2 Installation and Upgrading ....... ..........[...]

  • Page 4

    ii NI-3101-SIG Signature Series NetLinx Int egrated Controller Verifying the current version of NetLinx Master Firmware ..................................... 34 Upgrading the On-board Master Firmware via an IP ................... .................... ....... 35 Upgrading the NI Controller Firmware via IP.. ........................ .................[...]

  • Page 5

    iii NI-3101-SIG Signature Series NetLinx Integra ted Controller Server - Creatin g a Request for an SSL Certificate ........ ................. ................ ............. .. 81 Common Steps for Requesting a Certificate from a CA .... ......................... ............. 83 Communicating wi th the CA ......................... ................ [...]

  • Page 6

    iv NI-3101-SIG Signature Series NetLinx Int egrated Controller Option 3 - Add user ........ ............. ................ ............. ................ ............. ................. .... 121 Option 4 - Edit User ............... ............. ................ ............. ................ ................ ........... 122 Option 5 - Delete user [...]

  • Page 7

    Introduction 1 NI-3101-SIG Signature Series NetLinx Inte grated Controller Introduction The NI-3101-SIG Signature Series NetLinx Integrated Controller satisfies the control and automation features common in a larger area or multiple room s, which may include the integration of a larger number of de vices including VCR and DVD players, projectors, l[...]

  • Page 8

    Introduction 2 NI-3101-SIG Signature Series NetL inx Integrated Controller NI-3101-SIG Specifications The NI-3101-SIG (FIG. 1) provides support for 6 configurable RS-232/RS-422/RS-485 Ports, 8 IR/ Serial Output ports, 8 Digital Inpu t/Output ports, and 8 Relays. FIG. 1 NI-3101 NetLinx Inte grated Controller (front view) FIG. 2 NI-3101 front and re [...]

  • Page 9

    Introduction 3 NI-3101-SIG Signature Series NetLinx Inte grated Controller NI-3101-SIG Specifications (Cont.) Front Panel Components: Input/Output LED s • White Output LED blinks w hen the Controller transmits data, sets channels On/Off, sends data strings, etc. White Input LED blinks when it receives data from button pushes, strings , commands, [...]

  • Page 10

    Introduction 4 NI-3101-SIG Signature Series NetL inx Integrated Controller NI-3101-SIG Specif ications (Cont.) Digital I/O ( Port 17 ) • Eight-channel binary I/O port for contact closure • Each input is capable of voltage sensing. Input format is software selectable. • Interactive power sensing for IR ports • Channel range = 1-8 • All inp[...]

  • Page 11

    Introduction 5 NI-3101-SIG Signature Series NetLinx Inte grated Controller NI-3101-SIG Specifications (Cont.) Rear Panel Connectors (Cont.): AXlink LED • Green LED indicates the state of the AXlink connector port. • Normal AXlink activity = 1 blink/second • Abnormal AXlink activity = cycle of 3 consecutiv e blinks and then Off AXlink port •[...]

  • Page 12

    Introduction 6 NI-3101-SIG Signature Series NetL inx Integrated Controller[...]

  • Page 13

    Installation and Upgrading 7 NI-3101-SIG Signature Series NetLinx Inte grated Controller Installation and Upgrading Device:Port:System (D:P:S) A device is any hardware component that can be connected to an AXlink b us. Each device must be assigned a unique number to locate that device on the b us. Only the Device value can be set through the DIP sw[...]

  • Page 14

    Installation and Upgrading 8 NI-3101-SIG Signature Series NetL inx Integrated Controller Installation into an Equipment Rack Use the rack-mounting ears supplied with the NI-310 1-SIG controller for equipment rack installations. The device comes installed with four rubber feet for flat surface installations. 1. Discharge the static electricity from [...]

  • Page 15

    Connections and Wiring 9 NI-3101-SIG Signature Series NetLinx Inte grated Controller Connections and Wiring Setting the Configuration DIP Switch for the Configuration Port Prior to installing the Controller , use the Conf igur ation DIP switch to set the information used by the Configuration Port for communication. The DIP switchsets the starting a[...]

  • Page 16

    Connections and Wiring 10 NI-3101-SIG Signature Series NetL inx Integrated Controller Configuration Port Connections and Wiring The NI-3101 is equipped with a low-speed USB connection located on the rear of the unit. Use a standard USB cable to establish a connection between the device and your PC's USB port. This connection provides communica[...]

  • Page 17

    Connections and Wiring 11 NI-3101-SIG Signature Series NetLinx Inte grated Controller Port Assignments and Functionality The rear Port Assignments are as follows: AXlink Port and LED All NI units ha ve an AXlink port and adjacent status LED (FIG. 3). This port allo ws the NI to support AMX legac y AXlink devices such as G3 touch panels ( ex: CP4/A [...]

  • Page 18

    Connections and Wiring 12 NI-3101-SIG Signature Series NetL inx Integrated Controller Wiring Guidelines The Integrated Controllers use a 12 VDC-complian t power supply to provide po wer through the rear 2-pin 3.5 mm mini-Phoenix PWR connector, or through the 4-pin 3.5 mm mini-Phoenix (female) captiv e-wire connector used for data communication and [...]

  • Page 19

    Connections and Wiring 13 NI-3101-SIG Signature Series NetLinx Inte grated Controller Wiring a power conn ection T o use the 2-pin 3.5 mm mini-Phoenix con nector with a 12 VDC-compliant power supply , the incoming PWR and GND cables from the external source must b e connected to their corresponding location s on the connector (FIG. 4). 1. Insert th[...]

  • Page 20

    Connections and Wiring 14 NI-3101-SIG Signature Series NetL inx Integrated Controller Using the 4-pin mini-P hoenix connector for data with ex ternal power T o u se the 4-pin 3.5 mm mini-Phoenix (fe male) ca ptive-wire connector for data communication and power transfer , the incoming PWR and GND cable from the 12 VDC-compliant po wer supply must b[...]

  • Page 21

    Connections and Wiring 15 NI-3101-SIG Signature Series NetLinx Inte grated Controller DB9 Device Port: Connections and Wiring FIG. 7 shows the connector pinouts for the rear RS-232/RS-422/RS-485 (DB9) Device Ports. These ports support most standard RS-232 communication prot ocols for data transmission. This figure gi ves a visual representation of [...]

  • Page 22

    Connections and Wiring 16 NI-3101-SIG Signature Series NetL inx Integrated Controller Relay connecti ons Use A for common and B for output (FIG. 8). Each relay is isolated and normally open. A metal connector strip is also provided to common multiple relays. Input/Output (I/O) Port: Connections and Wiring The I/O port responds to either switch clos[...]

  • Page 23

    Connections and Wiring 17 NI-3101-SIG Signature Series NetLinx Inte grated Controller IR/Serial Port: Connections and Wiring Up to eight IR- or Serial-controllable d e vices may be conn ected to the IR/Serial connectors on the rear of the NI-3101 (FIG. 10). These connectors accept an IR Emitter (CC-NIRC) that mounts onto the de vice's IR windo[...]

  • Page 24

    Connections and Wiring 18 NI-3101-SIG Signature Series NetL inx Integrated Controller Ethernet/RJ-45 Port: Connections and Wiring The following table lists the pinouts, signals, and pairing for the Ethe rnet connector . FIG. 11 diagrams the RJ-45 pinouts and signals for the Ethernet RJ-45 connector and cable. Ethernet LEDs Ethernet RJ-45 Pino uts a[...]

  • Page 25

    Connections and Wiring 19 NI-3101-SIG Signature Series NetLinx Inte grated Controller Ethernet ports used by the Integrated Controllers Ethernet Ports Used by the Ne tLinx Integrated Controllers Port type Description Standard P or t # FTP The on-board Master has a built-in FTP server . 21/20 (TCP) SSH The SSH port functions using the same interface[...]

  • Page 26

    Connections and Wiring 20 NI-3101-SIG Signature Series NetL inx Integrated Controller Replacing the Timekeeper Battery The NI-3101-SIG uses a combination lithium battery and clock crystal packag e called a Timek eeper . Only one Ti m e k e e p e r unit is installed within a giv en NI-3101-SIG. The battery can be expected to ha ve up to 3 years of u[...]

  • Page 27

    Configuration and Firmware Upd ate 21 NI-3101-SIG Signature Series NetLinx Inte grated Controller Configuration and Firmware Update This section refers to steps necessary to both communicate with and upgrade the NI-3101-SIG. Bef ore beginning: 1. Set up and configure the NI-3101-SIG. Refer to the previous Installation and Upgrading section. 2. V er[...]

  • Page 28

    Configuration and Firmware Updat e 22 NI-3101-SIG Signature Series NetL inx Integrated Controller Communicating with the Master via the Program Port 1. From your computer , launch NetLinx Studio 2.x. 2. Select Settings > Master Communication Settings , from the Main menu, to open the Master Communication Settings dialog bo x (FIG. 13). 3. Click [...]

  • Page 29

    Configuration and Firmware Upd ate 23 NI-3101-SIG Signature Series NetLinx Inte grated Controller 7. Set the COM port parameters for the selected COM port used for communication to the NetLinx Master . Default parameters are: COM1 115200 8 Data Bits No Parity 1 Stop Bit No Flow Control If communication fails on a kno wn COM port, change the baud ra[...]

  • Page 30

    Configuration and Firmware Updat e 24 NI-3101-SIG Signature Series NetL inx Integrated Controller 2. Select the Change System selection box from the Syst em to Chang e section. 3. Enter both the current an d new system address v alues. 4. Click the Change Device/System Number button. This conf igures the Master to accept the new value and incorpora[...]

  • Page 31

    Configuration and Firmware Upd ate 25 NI-3101-SIG Signature Series NetLinx Inte grated Controller Changing the Device Address of a NetLinx Device 1. Access the Device Addressing dialog (FIG. 17) by either one of these tw o methods:  Right-click on any system de vice ( such as a Modero panel ) listed in the OnLine T ree tab of the W orkspace and [...]

  • Page 32

    Configuration and Firmware Updat e 26 NI-3101-SIG Signature Series NetL inx Integrated Controller Recommended NetLi nx Device numbers Using the ID Button to Change the Controller’s Device Value 1. Access the Device Addressing dialog (FIG. 18) by selecting Diagnostics > De vice Addressing from the Main menu. 2. Locate the Device f ield ( A in F[...]

  • Page 33

    Configuration and Firmware Upd ate 27 NI-3101-SIG Signature Series NetLinx Inte grated Controller 4. Press the target NI de vice’ s ID button to begin process of reading the current de vice value of the NI Controller and then assigning it to the ne w value entered in step 2.  Once the swap has been made, a red Successful Identification Made fi[...]

  • Page 34

    Configuration and Firmware Updat e 28 NI-3101-SIG Signature Series NetL inx Integrated Controller Obtaining the Master’s IP Address (using DHCP) 1. Select Diagnostics > Network Addr esses from the Main menu to access the Network Addresses dialog (FIG. 19). 2. V erify that both the System number corresponds to the System v alue pre viously assi[...]

  • Page 35

    Configuration and Firmware Upd ate 29 NI-3101-SIG Signature Series NetLinx Inte grated Controller 10. Click Reboot from the T ools > Reboot the Master Controller dialog, and wait for the System Master to reboot and retain the ne wly obtained DHCP Address. The ST ATUS and OUTPUT LEDs should be gin to blink alternately during the incorporation. W [...]

  • Page 36

    Configuration and Firmware Updat e 30 NI-3101-SIG Signature Series NetL inx Integrated Controller Assigning a Static IP to the NetLinx Master 1. Select Diagnostics > Network Addr esses from the Main menu to access the Network Addresses dialog (FIG. 20). 2. V erify that both the System number corresponds to the System v alue pre viously assigned [...]

  • Page 37

    Configuration and Firmware Upd ate 31 NI-3101-SIG Signature Series NetLinx Inte grated Controller 12. Complete the communica tion process by continuing on to the Communicating with the NI Device via an IP section on page 31. Communicating with the NI Device via an IP Whether the on-board Master’ s IP Address was Static Set (Set IP Info) or Dynami[...]

  • Page 38

    Configuration and Firmware Updat e 32 NI-3101-SIG Signature Series NetL inx Integrated Controller 6. Click the Edit Settings button ( on the Communications Settings dialog ) to open the TCP/IP Settings dialog (FIG. 23). This dialog contains a series of pre v iously entered IP Address/URLs and their associated names, all of which are stor ed within [...]

  • Page 39

    Configuration and Firmware Upd ate 33 NI-3101-SIG Signature Series NetLinx Inte grated Controller 12. Press the User Name and Password b utton to open the Master Controller User Name and Pa s s w o r d dialog box (FIG. 25). W ithin this dialog, enter a pre viously configured username and password (with suf ficient rights) before attempting to conne[...]

  • Page 40

    Configuration and Firmware Updat e 34 NI-3101-SIG Signature Series NetL inx Integrated Controller Verifying the current version of NetLinx Master Firmware All NI Controllers c ontain both an on-boa rd NI Master and an Integrated Controller .  The on-board Master sho ws up within the Online T ree as 00000 NI Master  The Integrated Controller o[...]

  • Page 41

    Configuration and Firmware Upd ate 35 NI-3101-SIG Signature Series NetLinx Inte grated Controller Upgrading the On-board Master Firmware via an IP The on-board Master firmware Kit file is not the sa me as the Integrated Controller Kit file. Belo w is a table outlining the current sets of on-board Master and Integrated Controller Kit files used by t[...]

  • Page 42

    Configuration and Firmware Updat e 36 NI-3101-SIG Signature Series NetL inx Integrated Controller 7. From within Studio, select T ools > Firmware T ransfers > Send to NetLinx Device from the Main menu to open the Send to NetLinx De vice dialog (FIG. 27). V erify the tar get’ s System number matches the va lue listed within the activ e Syste[...]

  • Page 43

    Configuration and Firmware Upd ate 37 NI-3101-SIG Signature Series NetLinx Inte grated Controller 14. Press Done once until the Master Reboot Status field reads * Reboot of System Complete* . 15. Repeat steps 5 - 9 again (the last component will now successfully be installed). 16. Click Close once the download process is complete. 17. Right-click t[...]

  • Page 44

    Configuration and Firmware Updat e 38 NI-3101-SIG Signature Series NetL inx Integrated Controller 7. From within NetLinx Studio, select T ools > Firmware T ransfers > Se nd to NetLinx Device from the Main menu to open the Send to NetLinx Device dialog (FIG. 29). V erify that the tar get’ s System number matches the value listed within the a[...]

  • Page 45

    Configuration and Firmware Upd ate 39 NI-3101-SIG Signature Series NetLinx Inte grated Controller If the connection fails to establish, a Connection Failed dialog appears. T ry selecting a different IP Address if communication fails. Press the Retry button to reconnect using the same communication parameters. Press the Change button to alter the co[...]

  • Page 46

    Configuration and Firmware Updat e 40 NI-3101-SIG Signature Series NetL inx Integrated Controller[...]

  • Page 47

    NetLinx Security within the Web Server 41 NI-3101-SIG Signature Series NetLinx Inte grated Controller NetLinx Security within the Web Server NetLinx Masters incorporate built-in secur ity for HTTPS and T erm inal sessions ( enhanced with SSL and SSH r espectively ), ICSP data verification/encryption, and Server Port conf iguration. By using bo th S[...]

  • Page 48

    NetLinx Security within the Web Server 42 NI-3101-SIG Signature Series NetL inx Integrated Controller The third layer of protection is an SSL Certificate (specif ically identif ying the target Master and using a unique ke y to encrypt data). SSL works by using a pri v at e ke y to encrypt data that's transferred ov er the SSL connection. By de[...]

  • Page 49

    NetLinx Security within the Web Server 43 NI-3101-SIG Signature Series NetLinx Inte grated Controller Accessing an Unsecured Master via an HTTP Address Refer to the Upgrading the On-board Master F irm war e via an IP section on page 35 for more deta iled information on how to do wnload the latest firmw are from ww w .amx.com . This firmw are build [...]

  • Page 50

    NetLinx Security within the Web Server 44 NI-3101-SIG Signature Series NetL inx Integrated Controller Browser Application Frames A web page (FIG. 30) can be divided into separate s ections or frames, each of which can be independent of one another and display their own information. Located on the left side of the populated Browser window is the Na [...]

  • Page 51

    NetLinx Security within the Web Server 45 NI-3101-SIG Signature Series NetLinx Inte grated Controller If a user is not currently logged-into the Master ( via the initial Login scr een ) and they attempt to access a feature wherein authentication is required, they are pr ompted with a message to log into the Master (via the Log In button) (FIG. 31).[...]

  • Page 52

    NetLinx Security within the Web Server 46 NI-3101-SIG Signature Series NetL inx Integrated Controller  The administrator user account cannot be deleted or modified with the exception of its password. Only a user with both Conf iguration access and administrator rights can alter the administrator’ s password.  The NetLinx user account was cr[...]

  • Page 53

    NetLinx Security within the Web Server 47 NI-3101-SIG Signature Series NetLinx Inte grated Controller Web Control This section of the Navig ation frame contains the Mange Connections feature which allows control of compatible devices communicat i ng with the target Master . Managing WebControl Connections This page (FIG. 32) is accessed by clicking[...]

  • Page 54

    NetLinx Security within the Web Server 48 NI-3101-SIG Signature Series NetL inx Integrated Controller The following table lists the features av ailable to an administrator or other authorized user from the Manage W ebControl Connections page: Security Features This section of the Navigation frame (FIG. 33) cont ains the NetLinx system security para[...]

  • Page 55

    NetLinx Security within the Web Server 49 NI-3101-SIG Signature Series NetLinx Inte grated Controller The follo wing table lists the NetLinx System Security options that can be granted or denied by an administrator or other authorized user: Security - System Leve l Security page T o access this page, click the Security Level link from within the Se[...]

  • Page 56

    NetLinx Security within the Web Server 50 NI-3101-SIG Signature Series NetL inx Integrated Controller  Requiring verif ication from a communicating AMX software (such as NetLinx Studio v 2.4 or TPD4 v 2.5) before accepting comm unication for file/f irmware transfers, the Configuration , ICSP Connectivity and Require Encryption options must be en[...]

  • Page 57

    NetLinx Security within the Web Server 51 NI-3101-SIG Signature Series NetLinx Inte grated Controller System Level Security Page (Cont.) F eature Description T elnet Access: This selection determines if a username and password is required for T elnet Access (see FIG . 35). • If T elnet access is enabled, a username and password is required before[...]

  • Page 58

    NetLinx Security within the Web Server 52 NI-3101-SIG Signature Series NetL inx Integrated Controller  The following graphic illustrates the Ports which can be enabled for the v alidation of rights by using a va lid username and password. When one of the above options is enabled, the Master then requires the entry of a valid username and passwor[...]

  • Page 59

    NetLinx Security within the Web Server 53 NI-3101-SIG Signature Series NetLinx Inte grated Controller 4. Click on the desired ac cess parameters and co nfi guration checkboxes necessary to require user va lidation prior to usage.  Enabling the T erminal, HTTP , and T elnet Access options require that a valid username and password be entered prio[...]

  • Page 60

    NetLinx Security within the Web Server 54 NI-3101-SIG Signature Series NetL inx Integrated Controller ICSP Authenticati on In a Master-to-Master system, the Master which accepts the IP conne ction initiates the authentication process. This configuration pro vides compatibility with existing implementations and provides more flexibility for the impl[...]

  • Page 61

    NetLinx Security within the Web Server 55 NI-3101-SIG Signature Series NetLinx Inte grated Controller Configure Group Properties Page F eature Description Configure Group Properties: T his page allows an authorized user to configure the options for either a pre-existing or new group. Configur ation on this page consists of both the options and dire[...]

  • Page 62

    NetLinx Security within the Web Server 56 NI-3101-SIG Signature Series NetL inx Integrated Controller Adding a new Group 1. Click the Group Le vel link ( fr om within the Security section of the Navigation frame ) to open the Manage Groups page. 2. Click the New button to be transferred to the Configure Group Properties page (FIG. 37). 3. From with[...]

  • Page 63

    NetLinx Security within the Web Server 57 NI-3101-SIG Signature Series NetLinx Inte grated Controller Deleting an existin g Group 1. Click the Group Le vel link ( fr om within the Security section of the Navigatio n frame ) to open the Manage Gr oups page. 2. Press the Select button ( next to the selected Gr oup name ) to open the Configur e Gr oup[...]

  • Page 64

    NetLinx Security within the Web Server 58 NI-3101-SIG Signature Series NetL inx Integrated Controller Security - User Level Security page T o access the User Lev el Security page (FIG. 38), click on the User Level link ( fr om within the Security section of the Navigation frame ). This page allo ws an authorized user to add a user account (FIG. 30)[...]

  • Page 65

    NetLinx Security within the Web Server 59 NI-3101-SIG Signature Series NetLinx Inte grated Controller Configure User Properties Page F eature Description Configure User Properties: This page allows an authorized user to configure the options for either a pre-existing or new user . Configuration on this page consists of both the options and di recto[...]

  • Page 66

    NetLinx Security within the Web Server 60 NI-3101-SIG Signature Series NetL inx Integrated Controller Adding a new User The information entered within this page can be used by Modero touch panels to verify and establish a secure connection by encrypting the data being transmitted between the Master and the panel. This information must be entered in[...]

  • Page 67

    NetLinx Security within the Web Server 61 NI-3101-SIG Signature Series NetLinx Inte grated Controller 9. Click the Back button to return to the Manage User page. Modifying the properties of an existing User 1. Click the User Level link ( fr om within the Security section of the Navigation frame ) to open the Manage Users page. 2. Click the Select b[...]

  • Page 68

    NetLinx Security within the Web Server 62 NI-3101-SIG Signature Series NetL inx Integrated Controller Deleting an ex isting User 1. Click on the User Level link ( fr om within the Security section of the Navigation frame ) to open the Manage Users page. 2. Press the Select b utton next to the selected Username to open the Configur e User Propert ie[...]

  • Page 69

    NetLinx Security within the Web Server 63 NI-3101-SIG Signature Series NetLinx Inte grated Controller System Settings - Manage System page T o view all of the available options within the right fr ame, it is r ecommended that you maximize the br owser wind ow . T o ac cess this page (FIG. 41), click on the Manage System link ( from within the Syste[...]

  • Page 70

    NetLinx Security within the Web Server 64 NI-3101-SIG Signature Series NetL inx Integrated Controller FIG. 42 System - Online Tree frame Manage System Page Components (Cont.) F eature Description Management menu op tions: These management buttons change depending on the source chosen from the Online T ree. • There are three menu grouping s availa[...]

  • Page 71

    NetLinx Security within the Web Server 65 NI-3101-SIG Signature Series NetLinx Inte grated Controller Manage System Page Components (Cont.) F eature Description Device menu buttons : The selected system number: device number are displayed below these menu buttons. Network Settings • Allows a user to configure the netw ork IP/DNS settings. URL Lis[...]

  • Page 72

    NetLinx Security within the Web Server 66 NI-3101-SIG Signature Series NetL inx Integrated Controller Manage System - System Menu Buttons These buttons appear (on the right) when a user clicks on the purple System icon from within the Online T ree. The selected system number is displayed below these System menu b uttons. System Menu - Modifying the[...]

  • Page 73

    NetLinx Security within the Web Server 67 NI-3101-SIG Signature Series NetLinx Inte grated Controller System Menu - Chan ging the System Num ber 1. Click the Manage System link ( fr om within the System Settings section of the Navigation fr ame ). 2. Click on the purple System icon from within the Online T ree to open the System menu buttons within[...]

  • Page 74

    NetLinx Security within the Web Server 68 NI-3101-SIG Signature Series NetL inx Integrated Controller 1. Click the Manage System link ( fr om within the System Settings section of the Navigation frame ). 2. Clicking on any of the Online T ree items opens menu item s with the Control/Emulate button option av ailable. 3. Click the Control/Emulate b u[...]

  • Page 75

    NetLinx Security within the Web Server 69 NI-3101-SIG Signature Series NetLinx Inte grated Controller  The De vice, Port, and System value ranges are 1 - 65535 . 7. W ithin the Channel Code section, enter a valid Ch annel number to emulate Channel messages (i.e., Push/Release, CHON, and CHOFF) for the specified <D:P:S>.  The Channel num[...]

  • Page 76

    NetLinx Security within the Web Server 70 NI-3101-SIG Signature Series NetL inx Integrated Controller Manage System - Diagnosti cs This page allows an authorized user to setup a nd monitor diagnostic messa ges coming from and going to de vices av ailable on the Online Tree. This dialog also allo ws the user to watch the ICSP commands being sent to/[...]

  • Page 77

    NetLinx Security within the Web Server 71 NI-3101-SIG Signature Series NetLinx Inte grated Controller Setting up and rem oving a Diag nostic Filter 1. Setup a diagnostic filter by scrolling down the page and clicking the Modify b utton below the f irst empty column. This action opens the De vice Configuration dialog as a secondary popup windo w . 2[...]

  • Page 78

    NetLinx Security within the Web Server 72 NI-3101-SIG Signature Series NetL inx Integrated Controller Diagnostic Configuration Dialog (Cont.) F eature Description Preset s : This list of up to 10 presets comes defau lted with Preset 0: All Devices, All Notifications • Stor e : Save the current notification selections to a Pre set profile. Pressin[...]

  • Page 79

    NetLinx Security within the Web Server 73 NI-3101-SIG Signature Series NetLinx Inte grated Controller 5. Remov e a diagnostic filter by clicking the Modif y button belo w it (from the Diagnostics dialog), then pressing the Remov e b utton to delete this filter from the Diagnostics dialog.  Once a Preset is assigned to a specific Diagnostic filte[...]

  • Page 80

    NetLinx Security within the Web Server 74 NI-3101-SIG Signature Series NetL inx Integrated Controller Setting the Master’s Port Configurations Manage System - Serv er This page allows a user to both change the port numbers ( used for various W eb services ) and configure the SSL settings used on the Master by bringing up a submenu of options such[...]

  • Page 81

    NetLinx Security within the Web Server 75 NI-3101-SIG Signature Series NetLinx Inte grated Controller  The following graphic illustrates the Ports which can be enabled for v alidation using a v alid username and password, as well as what me thod of communication is used with each. FIG. 48 Port Communic ation Settings T elnet Port ICSP P ort HTTP[...]

  • Page 82

    NetLinx Security within the Web Server 76 NI-3101-SIG Signature Series NetL inx Integrated Controller Modifying the Server Port Settings 1. From within the Server submenu, press the Por t S e t ti n g s b utton to open the Server Port Settings dialog seen above in FIG. 47. 2. Uncheck any services (and corresponding ports) to disable their functiona[...]

  • Page 83

    NetLinx Security within the Web Server 77 NI-3101-SIG Signature Series NetLinx Inte grated Controller 4. Once an authorized user has modified an y of the server port settings, press the Update button to sav e these changes to the Master . Once these ch anges are saved, the following message appears: "Unit must be rebooted for the c hange to ta[...]

  • Page 84

    NetLinx Security within the Web Server 78 NI-3101-SIG Signature Series NetL inx Integrated Controller SSL Server Certificate Creation Procedures Initially , a NetLinx Master is not equipped with any installed certif icates. In order to prepar e a Master for later use with CA ( off icially issued ) serv er certificates , it is necessary to:  Firs[...]

  • Page 85

    NetLinx Security within the Web Server 79 NI-3101-SIG Signature Series NetLinx Inte grated Controller This page allows an authorized user to display an installed certif icate, create a certificate request, self- generate, and regenerate SSL Server Certif icates. Server Certificate Entries F eature Description Ser ver Cer tificate Field Information:[...]

  • Page 86

    NetLinx Security within the Web Server 80 NI-3101-SIG Signature Series NetL inx Integrated Controller Server - Display SS L Server Certificat e Information 1. Navigate to the Server Certif icate page by clicking System Settings > Manage System > Server > Create SSL Certif icate to open the Server Certificate page. 2. Click the do wn arrow [...]

  • Page 87

    NetLinx Security within the Web Server 81 NI-3101-SIG Signature Series NetLinx Inte grated Controller Server - Regeneratin g an SSL Server Certifica te Request 1. Navigate to the Serv er Certificate page by clicking System Settings > Manage System > Server > Create SSL Certif icate to open the Server Certificate page. 2. Enter any ne w or [...]

  • Page 88

    NetLinx Security within the Web Server 82 NI-3101-SIG Signature Series NetL inx Integrated Controller 4. Enter the name of the business or organization into the Or ganization Name field. This is an alpha- numeric string, 1 - 50 characters in length. 5. Enter the name of the department using the certificate into the Or ganizational Unit field. This [...]

  • Page 89

    NetLinx Security within the Web Server 83 NI-3101-SIG Signature Series NetLinx Inte grated Controller Common Steps for Requesting a Certificate from a CA Once the request has begun, a user has the c hoice to e ither remain using their self-gene rated SSL certificate or obtain a CA created certif icate by exporting their request for the certif icate[...]

  • Page 90

    NetLinx Security within the Web Server 84 NI-3101-SIG Signature Series NetL inx Integrated Controller Server - Exportin g an SSL Certificate Request 1. First follow the procedures outlined in the Server - Cr eating a Req uest for an SSL Certificate se ction on page 81 to begin the process of requesting an SSL by creating a session-specif ic Master [...]

  • Page 91

    NetLinx Security within the Web Server 85 NI-3101-SIG Signature Series NetLinx Inte grated Controller 11. Once the return ed CA certificate has been receiv ed, follow the procedures outlined in the following section to import the returned certificate ( over a secur e connection ) to the target Master . Server - Importin g a CA created SSL Certifica[...]

  • Page 92

    NetLinx Security within the Web Server 86 NI-3101-SIG Signature Series NetL inx Integrated Controller 5. Use the Server > Cr eate SSL Certificate > Display Certificate option to confirm that the new certificate w as imported properl y to the target Master . Manage System - Device Menu Buttons The Device Menu b uttons appear when a user clicks[...]

  • Page 93

    NetLinx Security within the Web Server 87 NI-3101-SIG Signature Series NetLinx Inte grated Controller 4. Enter a ne w or updated name within the Host Name field. This entry can be 1 - 50 alphanumeric characters in length. 5. Select either the DHCP or Specify and IP Addr ess checkbox to choose the source of the IP Address information being used with[...]

  • Page 94

    NetLinx Security within the Web Server 88 NI-3101-SIG Signature Series NetL inx Integrated Controller Device Menu - Deve loping a URL List 1. Click the System Settings > Manage System link from within the System Settings section of the Navigation frame. 2. Click on a violet Device icon from within the Online Tree to open the Device menu b uttons[...]

  • Page 95

    NetLinx Security within the Web Server 89 NI-3101-SIG Signature Series NetLinx Inte grated Controller 10. Confirm that the ne wly added URLs appear within the URL List dialog (FIG. 54).  If the ne wly added URL doesn’t appear on this page, click the Re fresh button. 11. URL entries can be removed either individually or as a whole:  Remov e [...]

  • Page 96

    NetLinx Security within the Web Server 90 NI-3101-SIG Signature Series NetL inx Integrated Controller 5. Click the Update button to sa ve this ne w value to the de vice. The following message; " Device number changed to XXX. De vice must be r ebooted for the change to tak e effect. ", reminds the user that the Master must first be reboote[...]

  • Page 97

    NetLinx Security within the Web Server 91 NI-3101-SIG Signature Series NetLinx Inte grated Controller System Settings - Manage License This page (FIG. 57) displays both the currently used license keys and the pending keys.  The New button allo ws for the addition of new license k eys associated with currently used modules/products.  Adding ne[...]

  • Page 98

    NetLinx Security within the Web Server 92 NI-3101-SIG Signature Series NetL inx Integrated Controller 4. Contact the AMX Sales department with both th e product serial number (or certificate number) and the serial number of target Master to re gister your product and in turn recei ve the necessary K ey information (typically 32 to 36 dig its in len[...]

  • Page 99

    NetLinx Security within the Web Server 93 NI-3101-SIG Signature Series NetLinx Inte grated Controller System Settings - Manage NetLinx Devices T o access this page, click on the Manage NetLinx Devices link ( fr om within the System Settings section of the Navigation frame ). These pages (FIG. 59) hav e some additions that hav e been incorporated as[...]

  • Page 100

    NetLinx Security within the Web Server 94 NI-3101-SIG Signature Series NetL inx Integrated Controller Manage NetLinx Devices Page (Cont .) F eature Description Device Listings: • This page ( in addition to the target Ma ster which is typically the first entry ) lists those NetLinx Masters which have sent out NetLinx Discovery Master Announce pack[...]

  • Page 101

    NetLinx Security within the Web Server 95 NI-3101-SIG Signature Series NetLinx Inte grated Controller Manage NetLinx Devi ces - Disp laying NDP-capable devices Note that in the pre vious example (FIG . 59), the first NetLinx Master has a " + " icon next to it, which shows that this Master is indicating the presence of NDP-capable de vices[...]

  • Page 102

    NetLinx Security within the Web Server 96 NI-3101-SIG Signature Series NetL inx Integrated Controller Manage NetLinx Devic es - Obtaining NetLinx Devi ce information T o obtain more description than is provided by the listing: 1. Hover the cursor ov er a particular device within the listing to display a m ouse-over popup dialog (FIG. 61).  The p[...]

  • Page 103

    NetLinx Security within the Web Server 97 NI-3101-SIG Signature Series NetLinx Inte grated Controller System Settings - Manage Other Devices - Dynamic Device Discovery Pages T o acce ss this page, click on the Manage Other Devices link ( fr om within the System Settings section of the Navigation frame ). This page (FIG. 63) ( within build 323 or hi[...]

  • Page 104

    NetLinx Security within the Web Server 98 NI-3101-SIG Signature Series NetL inx Integrated Controller Manage Other Devices Page F eature Description Dynamic Device Discovery links: These links direct the user to additional Dynamic Device Discovery (DDD) configurat ion pages which include: • Manage Device Bindings page is used for configuring appl[...]

  • Page 105

    NetLinx Security within the Web Server 99 NI-3101-SIG Signature Series NetLinx Inte grated Controller Manage Other Devices Page (Cont.) F eature Description Configure Binding Opt ions (Cont.): Enable Subnet Match This selection allows an end-user to toggle whether or not IP devices should only be detected/ discover ed if they are on the same IP Sub[...]

  • Page 106

    NetLinx Security within the Web Server 100 NI-3101-SIG Signature Series NetL inx Integrated Controller Manage Other Devices Page (Cont.) F eature Description Delete Selected • Clicking this button deletes a selected module from the /unbound directory . Any corresponding module w ithin the /bound directory will NOT be deleted. Bound modules must b[...]

  • Page 107

    NetLinx Security within the Web Server 101 NI-3101-SIG Signature Series NetLinx Inte grated Controller What is Dynamic Device Discov ery? The Dynamic Device Detector (DDD) monitors the system for newly connected devices. New de vic es can be detected via either an external disco very protocol manager ( built into firmwar e build 320 or higher ), Mu[...]

  • Page 108

    NetLinx Security within the Web Server 102 NI-3101-SIG Signature Series NetL inx Integrated Controller What is the difference between Pr ogram and Run-time defined binding? In DDD, the device discov ery activity is always dynamic because the devices will alw ays be detected at run-time. Note that DDD splits the binding activity into two dif ferent [...]

  • Page 109

    NetLinx Security within the Web Server 103 NI-3101-SIG Signature Series NetLinx Inte grated Controller Configuring application-defined devices Elements such as DUET_DEV_TYPE_DISC_DEVICE and DUET_DEV_POLLED are def ined within the NetLinx axi. The latest version of the NetLinx.axi f ile contains both the new API def initions, as well as the pre-defi[...]

  • Page 110

    NetLinx Security within the Web Server 104 NI-3101-SIG Signature Series NetL inx Integrated Controller  Dynamic application devices specify both the Duet virtual device and its associated Device SDK with no association to a physical port. Binding of an applica tion device to a physical de vice/port occurs at run-time either v ia auto-binding or [...]

  • Page 111

    NetLinx Security within the Web Server 105 NI-3101-SIG Signature Series NetLinx Inte grated Controller its associated property information is then displayed in a mouse-over popup dialog when the cursor hov ers over the physical device ID. Each entry in the table has one of four values appear within the far right of the Manage De vice Bindings page [...]

  • Page 112

    NetLinx Security within the Web Server 106 NI-3101-SIG Signature Series NetL inx Integrated Controller Manage Other Devi ces Menu - Viewing Discov ered Devices This page (FIG. 68) provides a listing with all of the dynamic devices that ha ve been disco vered in the system. Mousing-over a listed entry presents a popup which di splays all of the prop[...]

  • Page 113

    NetLinx Security within the Web Server 107 NI-3101-SIG Signature Series NetLinx Inte grated Controller Once a list of all compatible modules is compiled, the Select Device Module page (FIG. 69) is then displayed with a listing of each module along with its calculated “match” value. The greater the “matc h” va lue, the better the match betwe[...]

  • Page 114

    NetLinx Security within the Web Server 108 NI-3101-SIG Signature Series NetL inx Integrated Controller Manage Other Devi ces Menu - Creating a new User-Defined Device This page provides the ability to both add and remov e any user -defined devices. Existing user -defined devices are listed at the bottom of the display along with a corresponding Rem[...]

  • Page 115

    NetLinx Security within the Web Server 109 NI-3101-SIG Signature Series NetLinx Inte grated Controller 6. Enter the name of the manufacturer for the device being used (up to 55 alpha-numeric characters) (ex: Son y , ONKYO, etc.) into the Make field. Either the GUID or Mak e/Model must be specified within this field . Note that spaces in the name wi[...]

  • Page 116

    NetLinx Security within the Web Server 110 NI-3101-SIG Signature Series NetL inx Integrated Controller 3. T o c onfigure a Dynamic application interface:  Add the D Y N AMIC_APPLICA TION_DEVICE AP I call to the section of the NetLinx program (FIG. 65 on page 104) con taining the Duet V irtual Device D:P:S, the Duet Device type constant, and the [...]

  • Page 117

    NetLinx Security within the Web Server 111 NI-3101-SIG Signature Series NetLinx Inte grated Controller  The installer can then select which module to use with that discovered de vice by selecting the corresponding radio box and then clicking the upper-left Save b utton. This action then returns the installer back to the V iew Discover ed Devices[...]

  • Page 118

    NetLinx Security within the Web Server 112 NI-3101-SIG Signature Series NetL inx Integrated Controller 4. The user is then presented with a Security Alert popup window and Certif icate information (FIG. 71). Problems with the certificate can result from:  The default AMX certif icate, self generated, or self-signed certificate has not been appro[...]

  • Page 119

    NetLinx Security within the Web Server 113 NI-3101-SIG Signature Series NetLinx Inte grated Controller 7. The user is then presented with a Certificate Import W izard that begins the process of adding the certificate (FIG. 72). 8. Click Next to proceed with the certif icate importation process. 9. Click Next to automatically use the default certif [...]

  • Page 120

    NetLinx Security within the Web Server 114 NI-3101-SIG Signature Series NetL inx Integrated Controller Using your NetLinx Maste r to control the G4 panel Refer to the specific panel instruction manu al for detailed information on configuring and enabling W ebCon trol. This firmware b uild enables SSL ce rtif icate identification and encryption, HTT[...]

  • Page 121

    NetLinx Security within the Web Server 115 NI-3101-SIG Signature Series NetLinx Inte grated Controller 7. This Manage W ebControl Connections pa ge (FIG. 74) is accessed by clicking on the Manage connections link ( within the W eb Control section within the Navigation frame ). Once acti v ated, this page displays links to G4 panels running the late[...]

  • Page 122

    NetLinx Security within the Web Server 116 NI-3101-SIG Signature Series NetL inx Integrated Controller 10. Some circumstances might open a Connection Details dialog (FIG. 76) requesting a VNC Server IP Address. This is not the IP of the Master but of the target touch panel. Depending on which method of communication you are using, it can be found i[...]

  • Page 123

    NetLinx Security with a Terminal Connection 117 NI-3101-SIG Signature Series NetLinx In tegrated Controller NetLinx Security with a Terminal Connection NetLinx Masters currently hav e built-in security capabilities. They require a user entering a valid username and password to access the NetLinx System’ s T e lnet, HTTP , ICSP , and FTP services.[...]

  • Page 124

    NetLinx Security with a Terminal Connection 118 NI-3101-SIG Signature Series NetL inx Integrated Controller Initial Setup via a Terminal Connection Security administration and configuration is done via a T erminal communication through the RS232/ USB Configuration Port on the NetLinx Master . If co nnecting to the target Master via the TCP/IP (W in[...]

  • Page 125

    NetLinx Security with a Terminal Connection 119 NI-3101-SIG Signature Series NetLinx In tegrated Controller 2. T ype setup security to access the Main Security Menu, shown belo w: >setup security --- These commands apply to the Security Manager and Database ---- 1) Set system security options for NetLinx Master 2) Display system security options[...]

  • Page 126

    NetLinx Security with a Terminal Connection 120 NI-3101-SIG Signature Series NetL inx Integrated Controller  If you answer y for yes, sec urity will be enabled and you will be taken to the Security Options Menu.  If you answer n for no, all security settings (e xcept FTP security) will remain disabled and you will be taken back to the Main Se[...]

  • Page 127

    NetLinx Security with a Terminal Connection 121 NI-3101-SIG Signature Series NetLinx In tegrated Controller The items in the Security Options Menu are described belo w: Option 2 - Display system secu r ity options for NetLinx Master T ype 2 and <Enter> at the Security Setup prompt (at the bottom of the Main Security Menu) to display the curre[...]

  • Page 128

    NetLinx Security with a Terminal Connection 122 NI-3101-SIG Signature Series NetL inx Integrated Controller 2. At the Enter username prompt, enter a new username (for example " techpubs "). A username is a valid character string (4 - 20 alpha-numeric characters) defining the user . This string is case sensitive . Each username must be uni[...]

  • Page 129

    NetLinx Security with a Terminal Connection 123 NI-3101-SIG Signature Series NetLinx In tegrated Controller Access Rights Menu The Access Rights Menu is accessed whenever you select Change Access Rights (option 6 ) from the Edit User Menu, or Change Access Rights from the Edit Group Menu. The Access Rights Menu is displayed as follows: Select to ch[...]

  • Page 130

    NetLinx Security with a Terminal Connection 124 NI-3101-SIG Signature Series NetL inx Integrated Controller Press <Enter> to e xit the menu and return to the previous menu. The Access Rights Menu is described in the following table: Option 5 - Delete user 1. T ype 5 and <Enter> at the Security Setup prompt (at the bottom of the Main Sec[...]

  • Page 131

    NetLinx Security with a Terminal Connection 125 NI-3101-SIG Signature Series NetLinx In tegrated Controller Option 6 - Show the l ist of authorized users 1. T ype 6 and <Enter> at the Security Setup prompt (at the bottom of the Main Security Menu) to vie w a list of currently enrolled users. 2. Press <Enter> to return to the Security Se[...]

  • Page 132

    NetLinx Security with a Terminal Connection 126 NI-3101-SIG Signature Series NetL inx Integrated Controller A single '/' is suff icient to grant access to all file s and directories in the user directory and it's sub- directory . The '*' wildcard can also be added to enable access to all files. All entries should start with[...]

  • Page 133

    NetLinx Security with a Terminal Connection 127 NI-3101-SIG Signature Series NetLinx In tegrated Controller Edit Group men u: Change Access Rights 1. At the Edit Group prompt, type 4 to c hange the current access rights for the selected group account. A sample session response is: Select to change current access right 1) Terminal (RS232) Access....[...]

  • Page 134

    NetLinx Security with a Terminal Connection 128 NI-3101-SIG Signature Series NetL inx Integrated Controller 2. Select a group from the list of curre ntly enrolled groups and press <Enter> to open the Edit Group Menu. This is the same Edit Group Menu that was access via the Add Group option: 1) Add Directory Association 2) Delete Directory Ass[...]

  • Page 135

    NetLinx Security with a Terminal Connection 129 NI-3101-SIG Signature Series NetLinx In tegrated Controller Option 12 - Display Telnet T imeout in seco nds This featur e is disabled after the installation of firmwar e build 130 or higher onto your tar get Master . 1. T ype 12 and <Enter> at the Security Setup prompt (a t the bottom of the Mai[...]

  • Page 136

    NetLinx Security with a Terminal Connection 130 NI-3101-SIG Signature Series NetL inx Integrated Controller Main Security Menu The Main Security menu is described belo w: Main Security Menu Command Description 1) Set system security options for NetLinx Master This selection will bring up the Security Options Menu that allows you to change the secur[...]

  • Page 137

    NetLinx Security with a Terminal Connection 131 NI-3101-SIG Signature Series NetLinx In tegrated Controller Default Security Configuration By default, the NetLinx Master will create the follo wing accounts, access rights, directory associations, and security options. Account 1: User Name: administrator Password: password Group: administrator Rights[...]

  • Page 138

    NetLinx Security with a Terminal Connection 132 NI-3101-SIG Signature Series NetL inx Integrated Controller  The FTP Security and Admin Change Password Security are always enabled and cannot be disabled. Help menu T ype help at the prompt in the T elnet session to display th e follo wing help topics: Help Menu Options Command Description ----- H[...]

  • Page 139

    NetLinx Security with a Terminal Connection 133 NI-3101-SIG Signature Series NetLinx In tegrated Controller Help Menu Options (Cont.) Command Description SEND_COMMAND D:P:S or NAME,COMMAND Sends the specified command to the device. T he Command uses NetLinx string syntax. • Ex: send_command 1:1:1,"'This is a test',13,10" • E[...]

  • Page 140

    NetLinx Security with a Terminal Connection 134 NI-3101-SIG Signature Series NetL inx Integrated Controller Logging Into a Session Until T elnet security is enabled, a session will begin with a welcome banner . Welcome to NetLinx v3.01.320 Copyright AMX Corp. 1999-2005 > When T erminal security is enabled, the user should type in the word login [...]

  • Page 141

    NetLinx Security with a Terminal Connection 135 NI-3101-SIG Signature Series NetLinx In tegrated Controller Logout The logout command will log the user out of the current s ecure telnet session. For a T erminal session, the user will be logged out and to access T erminal co mmands again the user will first ha ve to login. Help Security The help sec[...]

  • Page 142

    NetLinx Security with a Terminal Connection 136 NI-3101-SIG Signature Series NetL inx Integrated Controller[...]

  • Page 143

    Programming 137 NI-3101-SIG Signature Series NetLinx Inte grated Controller Programming This section describes the Se nd_Commands, Send_Strings, and Channel commands you can use to program the Integrated Controller . The examples in this section require a declaration in the DEFINE_DEVICE section of your program to work correctly . Refer to the NetL[...]

  • Page 144

    Programming 138 NI-3101-SIG Signature Series NetL inx Integrated Controller Master Send_Co mmands (Cont.) Command Description G4WC Add G4 Web Control devices to Web control list displayed by the Web server in a browser . The internal G4WC Send command (to Master 0:1:0) has been revised to add G4 WebControl devices to Web control list displayed in t[...]

  • Page 145

    Programming 139 NI-3101-SIG Signature Series NetLinx Inte grated Controller Master IP Local Port Send_Commands These commands are specific to the Master and not the Controller . These commands are sent to the DPS 0:1:0 (the Master). A de vice must first be def ined in the NetLinx programming language with v alues for the De vice: Port: System. In t[...]

  • Page 146

    Programming 140 NI-3101-SIG Signature Series NetL inx Integrated Controller Device:Port:System (D :P:S) A device is any hardware component that can be connected to an AXlink or ICSNet b us. Each de vice must be assigned a unique number to locate that device on the bus. The NetLinx programming language allows numbers in the range 1-32,767 for ICSNet[...]

  • Page 147

    Programming 141 NI-3101-SIG Signature Series NetLinx Inte grated Controller In your terminal program, type "Help" or a question mark ("?") and <Enter> to display the Configuration Port commands listed in the following table. Configuration Port Commands Command Description DATE Displays the current date and day of the week.[...]

  • Page 148

    Programming 142 NI-3101-SIG Signature Series NetL inx Integrated Controller Configuration Port Commands ( Cont.) Command Description GET DUET MEMORY Display the amount of memory allocated for Duet Java pool. This is the current Java memory heap size as measur ed in Megabytes. An example is a value of 5 = 5 MB. GET ETHERNET MODE Displays the current[...]

  • Page 149

    Programming 143 NI-3101-SIG Signature Series NetLinx Inte grated Controller Configuration Port Commands ( Cont.) Command Description OFF <D:P:S, or NAME, CHAN> T urns off a channel on a device. The device can be on any system the Master you are connected to can reach. Y ou ca n specify the device number , port, and system, or the name of the [...]

  • Page 150

    Programming 144 NI-3101-SIG Signature Series NetL inx Integrated Controller Configuration Port Commands ( Cont.) Command Description PULSE <D:P:S, or NAME, CHAN> Pulses a channel on a device on and off. The device can be on any system the Master you are connected to can reach. Y ou can specify the device number , port, and system; or the name[...]

  • Page 151

    Programming 145 NI-3101-SIG Signature Series NetLinx Inte grated Controller Configuration Port Commands ( Cont.) Command Description SET DATE Prompts you to enter the new date for the Master . When the date is set on the Master , the new date will be reflected on all devices in the system that have clo cks (i.e. touch panels). By the same token, if[...]

  • Page 152

    Programming 146 NI-3101-SIG Signature Series NetL inx Integrated Controller Configuration Port Commands ( Cont.) Command Description SET HTTP PORT Sets the IP port listened to for HTTP connections. Example: >SET HTTP PORT Current HTTP port number = 80 Enter new HTTP port number (Usually 80) (0=disable HTTP) : Setting HTTP port number to New HTTP[...]

  • Page 153

    Programming 147 NI-3101-SIG Signature Series NetLinx Inte grated Controller Configuration Port Commands ( Cont.) Command Description SET LOG COUNT Sets the number of entries allowed in the message log. Example: >SET LOG COUNT Current log count = 1000 Enter new log count (betwee n 50-10000) : Once you enter a value and press the ENT ER key , you [...]

  • Page 154

    Programming 148 NI-3101-SIG Signature Series NetL inx Integrated Controller Configuration Port Commands ( Cont.) Command Description SET THRESHOLD Sets the Master's internal message thresholds. Example: >SET THRESHOLD -- This will set the thresh olds of when particular tasks are pended. The threshold is the number of messages queued before [...]

  • Page 155

    Programming 149 NI-3101-SIG Signature Series NetLinx Inte grated Controller Configuration Port Commands ( Cont.) Command Description SHOW BUFFERS Displays a list of various message queues and the number of buffers in each queue Example: show buffers Thread TX RX Queued ----------- ---- ---- ---- Axlink 0 UDP 0 0-Sent=NO Wait ing=NO IPCon Mgr 0 Con [...]

  • Page 156

    Programming 150 NI-3101-SIG Signature Series NetL inx Integrated Controller Configuration Port Commands ( Cont.) Command Description SHOW LOG Displays the log of messages stored in the Master's memory . The Master logs all internal messages and keeps the most recent messages. The log contains:· • Entries starting with first specified or mos[...]

  • Page 157

    Programming 151 NI-3101-SIG Signature Series NetLinx Inte grated Controller Configuration Port Commands ( Cont.) Command Description SHOW MAX BUFFERS Displays a list of various message queues and the maximum number of message buffers that were ever present on the queue. Example: show max buffers Thread TX RX ----------- ---- ---- Axlink 1 UDP 1 IPC[...]

  • Page 158

    Programming 152 NI-3101-SIG Signature Series NetL inx Integrated Controller Configuration Port Commands ( Cont.) Command Description SHOW SYSTEM Provides a list of all devices in all systems currently on-line. T he systems lists are either directly connected to this Master (i.e. 1 hop away), or are referenced in the DEFINE_DEVICE section of the Net[...]

  • Page 159

    Programming 153 NI-3101-SIG Signature Series NetLinx Inte grated Controller ESC Pass Codes There are 'escape' codes in the pass mode. These codes can switch the display mode or exit pass mode. The following 'escape' codes are defined. Notes on Specific Telnet/Terminal Clients T elnet and terminal clients will have dif ferent beh[...]

  • Page 160

    Programming 154 NI-3101-SIG Signature Series NetL inx Integrated Controller LED Disable/Enable Send_Commands The following commands enable or disable the LEDs on the Inte grated Controller . In these examples: <DEV> = Port 1 of the device. Sending to port 1 of the NI-Con troller (affects all ports). RS232/422/485 Ports Channels RS232/422/485 [...]

  • Page 161

    Programming 155 NI-3101-SIG Signature Series NetLinx Inte grated Controller RS-232/422/485 Send_Commands In these examples: <DEV> = device. RS-232/422/485 Send_Commands Command Description B9MOFF Set the port's communication parameters for stop and data bits according to the sof tware settings on the RS-232 port (default). Disables 9-bit[...]

  • Page 162

    Programming 156 NI-3101-SIG Signature Series NetL inx Integrated Controller RS-232/422/485 Send_C ommands (Cont.) Command Description GET BAUD Get the RS-232/422/485 port’s current communication par am ete rs . The port sends the parameters to the device that requested the information. The port responds with: <port #>,<baud>,<parit[...]

  • Page 163

    Programming 157 NI-3101-SIG Signature Series NetLinx Inte grated Controller RS-232/422/485 Send_C ommands (Cont.) Command Description SET BAUD Set the RS-232/422/485 port's communication par am ete rs . Syntax: SEND_COMMAND <DEV>,"'SET BAUD <baud>,<parity>,<data>,<stop> [485 <Enable | Disable>]&apo[...]

  • Page 164

    Programming 158 NI-3101-SIG Signature Series NetL inx Integrated Controller RS-232/422/485 Send_String Escape Sequences This device also has some spec ial SEND_STRING escape sequences: If any of the 3 character combinations below are found anywhere within a SEND_STRING program instruction, they will be treated as commands and not the literal charac[...]

  • Page 165

    Programming 159 NI-3101-SIG Signature Series NetLinx Inte grated Controller IR / Serial Ports Channels RS-232/422/485 Send _String Escape Sequences (Cont.) Command Description 27,20,1 Set the RTS hardware handshake's output to low/inactive (< 3V). Syntax: SEND_STRING <DEV>,"27,20,1" Example: SEND_STRING RS232_1,"27,20,1[...]

  • Page 166

    Programming 160 NI-3101-SIG Signature Series NetL inx Integrated Controller IR/Serial Send_Commands The following IR and IR/Serial Send_Commands generate control signals for external equipment. In these examples: <DEV> = device. IR/Serial Send_Commands Command Description CAROFF Disable the IR carrier signal until a 'CARON' command [...]

  • Page 167

    Programming 161 NI-3101-SIG Signature Series NetLinx Inte grated Controller IR/Serial Send_Commands (Cont.) Command Description CTOF Set the duration of the Off time (no signal) between IR pulses for channel and IR function transmissions. Off time settings are stored in non-volatile memory . This co mmand sets the delay time between pulses generate[...]

  • Page 168

    Programming 162 NI-3101-SIG Signature Series NetL inx Integrated Controller IR/Serial Send_Commands (Cont.) Command Description POD Disable previously active 'PON' (power on) or 'POF' (power off) command settings. Channel 255 changes are enabled. T his command is used in conjunction with the I/O Link command. Syntax: SEND_COMMAN[...]

  • Page 169

    Programming 163 NI-3101-SIG Signature Series NetLinx Inte grated Controller IR/Serial Send_Commands (Cont.) Command Description PTOF Set the time duration between power pulses in .10-second increments. This time increment is stored in permanent memor y . This command also sets the delay between pulses generated by t he 'PON' or 'POF&[...]

  • Page 170

    Programming 164 NI-3101-SIG Signature Series NetL inx Integrated Controller IR/Serial Send_Commands (Cont.) Command Description SET MODE Set the IR/Serial ports for IR or Serial-controlled devices connected to a CardFrame or NetModule. Sets an IR port to either IR, Serial, or Data mode. Note: IR DA T A Mode works best when using both a lower baud r[...]

  • Page 171

    Programming 165 NI-3101-SIG Signature Series NetLinx Inte grated Controller IR/Serial Send_Commands (Cont.) Command Description XCHM Changes the IR output pat- tern for the 'XCH' send command. Syntax: SEND_COMMAND <DEV>,"'XCHM <extended channel mode>'" Va r i a b l e : extended channel mode = 0 - 4. Example[...]

  • Page 172

    Programming 166 NI-3101-SIG Signature Series NetL inx Integrated Controller Input/Output Send_Commands The following Send_Commands program the I/O ports on the Integrated Controller . In these examples: <DEV> = device. I/O ports: Port 17. Channels: 1 - 8 I/O channels. I/O Send_Commands GET INPUT Get the active state for the selected channels.[...]

  • Page 173

    Troubleshooting 167 NI-3101-SIG Signature Series NetLinx In tegrated Controller Troubleshooting This section describes the solutions to possible ha rdware/f irmware issues that could arise during the common operation of a NetLinx device. Troubleshooting Information Symptom Solution My NI Controller can’t obtain a DHCP Address. In requesting a DHC[...]

  • Page 174

    Troubleshooting 168 NI-3101-SIG Signature Series NetL inx Integrated Controller Troubleshooting Information (Cont.) Symptom Solution I can’t connect to my NI Controller via the rear Configuration Port using a USB cable. A USB cable is used for Serial communication between the PC and the Master . • V e rify the USB connectors ar e securely inser[...]

  • Page 175

    Troubleshooting 169 NI-3101-SIG Signature Series NetLinx Integr ated Controller[...]

  • Page 176

    4/08 © 2007 AMX. All rights reserved. AMX and the AMX logo are registered trademarks of AMX. AMX reserves the right to alter specifica tio ns withou t notice at any time. It’s Your World - Take Con trol™ 3000 RESEARCH DRIVE, RICHARDSON, TX 75082 USA • 800.222.0193 • 469.624.8000 • 469-624-7153 fax • 800.932.6993 technical support • w[...]