11 Backing up settings 12 Firmware upgrade 13 Date/time 14 AutoPing 15 System log 16 Locking down the controller 17 Resetting settings to defaults 18 Specifications 19 Open source code 20 Technical support 21 Limited one year warranty DLI DIN4 User’s Guide: 20170809T111540Z...
CONTENTS 1 Overview Congratulations on selecting the DLI DIN relay, an industrial Ethernet controlled relay. Check out the main product features. Some more technical specifications are available as well. Be sure to check the package contents when unpacking the unit, then follow the instructions for basic setup and if you are a first-time user.
2 Product features 2 Product features Congratulations on selecting the DLI DIN Relay, an industrial Ethernet-controlled relay. Its features include: • 8 SPDT Relay Outputs Eight sets of single-pole double-throw contacts are provided. Screw terminals are rated at 6-10 amps over commercial temperature range.
• DIN Relay 4. • RP-SMA WiFi Antenna. Please contact the freight carrier immediately if your package appears opened or damaged in transit. Call DLI at (408) 330-5599 for tech support, service, and hardware upgrades. DLI DIN4 User’s Guide: 20170809T111540Z...
IP, such as 192.168.0.50. 4.3.1 Windows IP setup Before adding an IP, close all programs and browsers. After the link is established, you can enable DHCP. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 7
• Enter a compatible static IP such as 192.168.0.50. • Click Apply and close windows. • Ping the power switch to confirm the connection. • Point your browser to 192.168.0.100 • Log in. Detailed instructions are at http://digital-loggers.com/ip_setup.html DLI DIN4 User’s Guide: 20170809T111540Z...
Page 8
9. Press the "Add" button; this new IP is added the list. 10. Close all windows for the configuration to take effect. 11. Start your Browser and type 192.168.0.100 in the URL field. The default user name and password are "admin" (lower case) and "1234". DLI DIN4 User’s Guide: 20170809T111540Z...
Page 9
Note that in this and many other pages, logical blocks can be collapsed by clicking in their right-hand corner, and later expanded by clicking 4.6 Common page layout You can navigate the menu links to access the controller's features: DLI DIN4 User’s Guide: 20170809T111540Z...
Page 10
"refresh" button to update the on-screen status display after changing settings. A screen refresh setting is provided on the Setup page. 4.8 Logout Browser logout is automatic when a session is closed or after a time-out period. You can use a menu link to log-out in advance. DLI DIN4 User’s Guide: 20170809T111540Z...
• (OFF). During normal operation, the DIN4 LCD and keypad interface can be in one of the following modes: • Relay mode, which displays status of and allows to manipulate the unit's relays; • Network mode, which displays and allows to configure network settings.
Page 12
Pressing saves the current value and starts network reconfiguration if needed. The display isn't updated in- stantly, and you need to refresh it by pressing . You can cancel editing at any time by pressing DLI DIN4 User’s Guide: 20170809T111540Z...
Assign a separate name to each relay, such as "Missile Launcher" or "Email Server" to make identification of each circuit simple. 6.2 Delays Delay Wrong password lockout minutes. (0-60) ON sequence delay seconds. (1-255) Cycle delay seconds. (1-255) Brown-out re-latch delay seconds. (1-255) Refresh screen every minutes. (1-255) Enable screen refresh Submit Delays DLI DIN4 User’s Guide: 20170809T111540Z...
Page 14
You may link to other power controllers, your own web pages, or remote web sites by entering up to four URLs and descriptions in the Setup page. For example, enter "Site Two Power Controller" in the description field with a URL of "http://192.168.0.250/". These links appear on every page of the main web UI. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 15
NET WILL CONNECT AFTER ENABLING THIS. If connectivity is lost, use a local connection such as a laptop with a crossover cable to restore your original network settings; you can also use the LCD and keypad for that. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 16
DNS servers; rather, after the unit obtains a DHCP lease, the parameters will be displayed for reference. It is recommended to configure the DHCP server to provide a static lease for the DIN4 using its MAC address (also displayed).
Page 17
You may press the "protect" button to lock the network settings (this will also affect the external API settings). Once locked, the network settings cannot be changed except by pressing the physical reset button on the front of the unit. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 18
OFF / ON CYCLE Relay 4OFF Switch ON Relay 7OFF Switch ON Relay 8OFF Switch ON Logout Help 3 sec. User relay control screen Individual relays can be manipulated as usual. The top links allow switching all accessible relays on, off or cycling them. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 19
Basic authentication over HTTP, but relies solely on TLS for security, which is considered risky by some experts. DLI Ethernet Sender should not require this setting. The "Hide user passwords" and "Hide WiFi password" settings configure whether clients should be able to read back the relevant values;...
On its own, a power switch isn't very smart. Programmers can easily add custom functionality by using the built-in Lua-based scripting language in power controllers. 7.1 Hardware requirements Lua-based scripting is available in all DIN4 controllers. Beeper, backlight, LCD, voltage and current monitoring functions are limited to products with appropriate hardware installed. 7.2 Entering scripts...
Page 21
You can use and even freely mix them as you wish, but only the modern API will receive further development atten- tion. Some features are exposed only via the modern API because they had no corresponding legacy commands. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 22
- synchronize time with server specified by IP address or hostname in quotes; you can TIME "server" TIME() without arguments to synchronize with "pool.ntp.org" if the DNS is configured correctly. You still need to enclose the function contents in a function name() ... as explained above. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 23
(reflects the current state of the relay) and locked (read-only field telling if the relay is locked). The variable name is chosen to match AC products. Global constants true false , respectively, useful to make scripts more readable, like outlet[1].state=on DLI DIN4 User’s Guide: 20170809T111540Z...
Page 24
: the run-time status of the N'th AutoPing item; • autoping.ping_interval : ping interval; • : ping timeout; autoping.ping_timeout • autoping.post_reboot_delay : post-reboot delay; • autoping.max_reboot_count : maximum reboot count; • autoping.pings_before_enabling : pings before enabling. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 25
Even with the scripting step delays, it is possible to create a script which will rapidly cycle a relay. This rapid cycling could result in a over current condition, tripped breaker, or stress to the power controller or attached equipment. Please be reasonable! DLI DIN4 User’s Guide: 20170809T111540Z...
Page 26
LCD or changes to the relay state (leave empty to have the messages forcefully displayed indefinitely). • Start on reboot at - the scripting function to start at cold boot. • Trace script - enable diagnostic output about script progress to system log. DLI DIN4 User’s Guide: 20170809T111540Z...
Their numeric values are defined so that a higher severity is larger, so condition like severity =CRITICAL behaves like what you'd expect. core Lua functions are accessible from the context as well, should you need them. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 28
• server port (usually 465, 587 or 25 for unencrypted operations); • username (for authenticating to the server); • password (for authenticating to the server); • transport encryption: – "smtps" for SMTP wrapped completely in TLS; – "starttls" for SMTP+STARTTLS command; DLI DIN4 User’s Guide: 20170809T111540Z...
Page 29
Its OID is 1.3.6.1.4.1.45770.0.1; this can be specified directly for SNMPv2c or SNM Pv3, or as an enterprise-specific (generic trap type=6) DLI ("enterprise OID"=45770) trap #1 (specific trap type=1). DLI DIN4 User’s Guide: 20170809T111540Z...
Page 30
• default specific trap type (number 0..2147483647). SNMP v1 accepts snmp_enterprise_oid snmp_generic_trap_type snmp_specific_ trap_type event properties to override the trap OID; they must be integers or string representations thereof. It also accepts the snmp_values event property as described above. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 31
JSON-encoded (regardless of the content type). If present, the headers event property is used to add HTTP headers to the request being sent. If present, the message_short event property is used for the message; otherwise, message is used. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 32
This is notably distinct from a condition, which will match all false not auth_allowed sorts of messages which don't have an auth_allowed property. Tricks which allow running code in the condition (as opposed to the action) are possible but discouraged. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 33
INFO auth_login@auth_ip session closed id="dli.auth.session_closed" Notification event types Underlined items (both in the message and in the 'extra properties' column) specify properties which can be checked for. You can hover them for more detailed descriptions. DLI DIN4 User’s Guide: 20170809T111540Z...
Custom logo dimensions may be supplied if needed. The logo URL may be absolute or relative (e.g. /my_ company.png ), in which case the related file should be placed in the /www/static/ subdirectory of the unit's filesystem (probably via SSH). Company name affects the alternative text for the logo image. DLI DIN4 User’s Guide: 20170809T111540Z...
"relax ... checks" checkboxes to skip the checks in cases where the method or content type indicates that the request couldn't have been sent by a browser without JavaScript. 10.2 REST-like API Name (view detailed description) User-visible relay name string DLI Controller represents a value in persistent storage write is denied if not administrative user no synchronization requirements Up to Relay object Allowed methods: PATCH REST-like API demo DLI DIN4 User’s Guide: 20170809T111540Z...
Page 37
('.'). A leading dot may be used to emphasize that it's an absolute OID; however, all of the OIDs configurable in DIN4 are absolute unless otherwise stated explicitly, and the leading dot is not needed, therefore, it's not supported.
Page 38
10.6 SNMP energy object MIB support overview The Net-SNMP agent included in DIN4 has built-in support for several well-known MIBs, but none of them deal with power control. The power-control-related ENERGY-OBJECT-MIB is described in RFC 7460, and is supported in the following manner: •...
Page 39
, so now you know the relay is physically off. ieee1621Off An SNMPv3 SET to turn relay #5 on: $ snmpset -On -v 3 -u powerAdmin -l authPriv -a SHA -x AES \ -A powerAdminPassword -X powerAdminPassword 192.168.0.100 \ 1.3.6.1.2.1.229.1.2.1.8.5 i 259 DLI DIN4 User’s Guide: 20170809T111540Z...
Page 40
1.3.6.1.2.1.229.1.2.1.9.6 = INTEGER: 257 1.3.6.1.2.1.229.1.2.1.9.7 = INTEGER: 257 1.3.6.1.2.1.229.1.2.1.9.8 = INTEGER: 257 You see that relays 3 and 5 are on, and all others are off ; you can change relay states as described above. DLI DIN4 User’s Guide: 20170809T111540Z...
Modified files are highlighted in green. Choose the setting files you want to save (unknown files are shown as "File "+filename) and click "Download". You may protect the security-sensitive parts of the configuration from being stored in a backup. Pressing the hardware reset button will be required to unlock. DLI DIN4 User’s Guide: 20170809T111540Z...
You may protect the current firmware from modification. Pressing the hardware reset button will be required to unlock. 12.2 Committing the firmware upgrade After the firmware has been uploaded, you are presented with a form to perform the upgrade. Firmware check OK Upgrading from 1.3.1.0 to 1.3.2.0. Perform firmware update Update Cancel Firmware upgrade page DLI DIN4 User’s Guide: 20170809T111540Z...
Page 43
Further activity is indicated by a cycling pattern of signs. Firmware upgrade progress indication After an upgrade has been completed, the unit is rebooted. The first boot may take longer than usual due to configuration updates. Post-firmware upgrade initialization indication DLI DIN4 User’s Guide: 20170809T111540Z...
Internally, the time zone is stored in a format different from the display (it has a different meaning for ). You should take that into account when interpreting related REST API values and log output. DLI DIN4 User’s Guide: 20170809T111540Z...
10 minutes after reboot. If a script is to be triggered, any delays contained in the code being executed should be considered in determining the delay setting here so that the thread completes before the delay elapses. This timer starts at the execution of the thread started. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 46
This has happened 2 times so far. Monitoring a group of several external spatially separated reliable IP addresses (in this example they belong to Google and Digital Loggers respectively) may become very useful to detect a stuck ADSL modem or some other no-Internet condition. DLI DIN4 User’s Guide: 20170809T111540Z...
Page 47
Several failures in a row trigger AutoPing actions which are reported with corresponding events: • item ... (addresses...) failed [failures/max] • item ... (addresses...) failed over (max) times in a row, disabling DLI DIN4 User’s Guide: 20170809T111540Z...
Page 48
(when an outage occurred after a request has been sent) The events associated with item trial before enabling are self-explanatory: • item ... (addresses...) enable approved • item ... (addresses...) enable cancelled • item ... (addresses...) trial restarted due to address list changes DLI DIN4 User’s Guide: 20170809T111540Z...
Note that the system log buffer has a fixed size, and old entries are removed automatically as new ones appear. The display is periodically updated. You can use the logread command to read the same data in an SSH session. logread -f will display new entries in real time. DLI DIN4 User’s Guide: 20170809T111540Z...
— some protection bits active; • — all protection bits active. Clicking on the icon gives more detailed info: Firmware protection is disabled Notification settings protection is disabled Private configuration protection is enabled but ineffective: SSH is enabled, which could be used to bypass protection Firmware upload is allowed, specially crafted firmware could be used to bypass protection Administrator credentials protection is disabled Maintenance mode lock is enabled but ineffective: SSH is enabled, which could be used to bypass protection Firmware upload is allowed, specially crafted firmware could be used to bypass protection Protection from restore from backup is enabled but ineffective: SSH is enabled, which could be used to bypass protection Firmware upload is allowed, specially crafted firmware could be used to bypass protection Network settings protection is disabled Protection status details DLI DIN4 User’s Guide: 20170809T111540Z...
Page 51
CONTENTS 16.4 Unlocking protection You should use the reset button and select the "Clear lock bits" reset mode to clear protection bits. This, of course, requires physical access to the unit. DLI DIN4 User’s Guide: 20170809T111540Z...
ONLY MACHINES IN THE SAME SUBNET WILL BE ABLE TO CONNECT A FTER RESETTING TO DEFAULTS. If connectivity is lost, use a local connection such as a laptop with a crossover cable to restore your original network settings. DLI DIN4 User’s Guide: 20170809T111540Z...
Bare unit 2.7 lbs, Ship wt. 3.6 lbs WiFi Atheros 9331 2.4G 802.11n RP-SMA FCC Note: The DIN4 may only be used with • the manufacturer supplied antenna (Gain: 2.0dBi),or • a 50 Ohm antenna of equal or lesser gain. DLI DIN4 User’s Guide: 20170809T111540Z...
Purchasing a TLA and signing an NDA from Atheros are highly recommended before attempting any custom devel- opment; however, they aren't required to build the firmware (only the bootloader). DLI cannot provide warranty or technical support for modified units; this includes units with custom firmware. DLI DIN4 User’s Guide: 20170809T111540Z...
• A description of the Ethernet devices connected to your unit, for example, a 10/100 PC and crossover cable. • A description of the WiFi devices connected to your unit, i.e. their manufacturers and model numbers. DLI DIN4 User’s Guide: 20170809T111540Z...
DLI. DLI's entire liability and exclusive remedy as to defective hardware shall be, at DLI's option, either (a) return of the purchase price or (b) replacement or repair of the hardware that does not meet DLI's quality control standards and has been returned through proper RMA procedures. DLI's liability for repair or replacement is to DLI's customer ONLY.
Need help?
Do you have a question about the DIN4 and is the answer not in the manual?
Questions and answers