Linortek Fargo G2 and Koda User Manual
For Fargo G2, Koda
TCP/IP Web Based Relay Controller
Rev C 04/2022
Website: www.linortek.com
Introduction
Thank you for purchasing a Linortek Fargo G2 or Koda TCP/IP Controller. These devices can control various applications such as lighting, security, sprinkler systems, access control, industrial equipment, building automation, and HVAC.
This manual covers the following models:
- FARGO R8 G2
- FARGO R4DI G2
- FARGO R4ADI G2
- KODA 100
- KODA200
These models will be referred to as SERVER.
For instructional videos, FAQs, and technical support, please visit: www.linortek.com/technical-support
Getting Started
The Fargo SERVER is a bare board product operating on low voltage. Handle with care to prevent electrostatic discharge. Always touch a grounded surface before handling.
The KODA SERVER is a housed unit with a DIN rail mountable enclosure. It can be mounted on a DIN rail, flat surface, or wall.
Wiring the Server
Caution: These units are ground isolated. Do not use external ground connections, as this may damage the SERVER or POE originating device.
- Connect the 12VDC power supply or use POE. The GREEN/Boot LED will indicate bootload mode, then the RED LED will indicate server mode.
- Plug an Ethernet cable into the RJ45/NET connector. The "Connection" LED indicates network availability, and the "Activity" LED indicates network activity.
Fargo G2 Relay Connections
The FARGO R8 G2 has 8 relays, and the FARGO R4 G2 has 4 relays. These are dry contact relays designed for low voltage control (up to 48 volts). Relays have Normally Open (NO), Common (C), and Normally Closed (NC) terminals.
Koda Relay Connection
The KODA 100 has 2 relays, and the KODA 200 has 4 relays. Relays can be set to supply 10VDC or function as dry contacts.
Important: Do not apply voltage greater than 48 volts to the relays.
Digital Input Connections (Fargo R4 and Koda)
Digital inputs detect external on/off states. They can be used for counting events or measuring frequency/period.
Modes of operation:
- PULL UP: Connects a 1K resistor to an internal voltage, allowing use of a simple switch.
- ISOLATED: Drives the SERVER's optoisolator with an external voltage (5V to 24V, minimum 2mA). An external resistor may be required for 12VDC-24VDC circuits.
The ISO/PU switch on the SERVER selects the mode. The factory default is ISO.
Use 20 AWG shielded wire for push buttons up to 500 feet, and 16 AWG for up to 5,000 feet.
Caution: Ensure the input switch is set to ISO before applying external voltage in isolated mode.
Analog Input Connections (Fargo R4ADI)
The Fargo R4ADI has 2 analog inputs for reading external equipment values. These can be used for temperature, pressure sensors, or AC current monitoring (using a 3.5mm stereo input with a current sensor).
Inputs are non-isolated 0-5V current sensors. The SERVER provides ground and power connections.
Accessing your SERVER
Once powered and connected to the network, the SERVER obtains an IP address via DHCP. Enter this IP address into your web browser to access the web interface. The default login credentials are 'admin'/'admin'.
Finding your IP Address with Linortek Discoverer
The Linortek Discoverer program (Java-based) can locate your SERVER on the network. Download it from Linortek's website.
Connecting your SERVER Directly to Your PC
If no network connection is available, connect the SERVER directly to your PC's Ethernet port. The default IP address is 169.254.1.1.
Server Configuration
Logging In
The login page prompts for username and password. These are retained by the browser until it is closed. You can disable password requirement in the Settings page.
Home Page
The Home page displays system information and allows you to locate the physical device. Key information displayed includes:
- TIME: Current time (12-hour or 24-hour format).
- DATE: Current date.
- VOLTS: Input voltage (12-48vDC range).
- TEMPERATURE: Board temperature (°C or °F).
- LEDs: RED (system pulse), GREEN (bootloader), BLUE (clickable for locate function).
Services Tab
The Services tab allows control of inputs, outputs, sensors, and other specialty controls. Depending on the SERVER model, it may display 'In/Out' or 'Relays'.
Relay Control
Allows manual control of relays. Each relay can be named, and its NO, C, and NC connections identified. Status LEDs indicate relay state (GREEN for ON, RED for OFF).
Status LEDs:
- Email: Indicates if an email is sent upon relay switch.
- Pulse: Indicates if a pulse width and multiplier are set.
- Sched.: Indicates if a schedule is set to trigger the relay.
- Timed: Indicates the relay is currently operating on a timer.
Clicking the 'Edit' icon takes you to the 'Set Relay' page.
Inputs
The In/Out or Inputs page displays information from each input (digital or analog). Input labels turn green when enabled. A red dot indicates the state of a linked relay, turning green when the relay is activated.
Clicking the 'Edit' icon takes you to the 'Set Digital Input' or 'Set Analog Input' page.
Set Relay Page
Allows configuration of individual relay properties:
- Relay Select: Identifies the relay being edited.
- Name: Up to 15 characters for relay identification.
- NO Name, Com Name, NC Name: 7-character names for relay connections.
- Pulse Width: Sets the ON duration for the relay (0 for no timed event).
- Pulse Width Multiplier: Defines the unit for Pulse Width (mS, Sec, Min).
- Relay Type: Selects relay source (Normal, Latched, Remote, Zigbee, or combinations).
- Location ID: Identifies a remote location.
- Relay at Location: Specifies the relay or device at the location.
- Send Email: Enables email notification when the relay is turned on or off.
Set Digital Input Page
Configures digital inputs for various readouts and associations with relays.
- Digital Input Selected: Identifies the digital input being edited.
- Name: Up to 15 characters for input identification.
- Label: 7-character label for the display.
- Corrector: Allows mathematical operations (+, -, *, /) on the input value.
- USE: Activates the input.
- Type: Defines how the input data is used (State, CounterNR, CounterR, Frequency, Period).
- Display: Selects the display format (Dot, Values, Meter, VBar).
- Relay L/T: Links input state to a relay (L) or triggers a relay (T).
- Command Z/N/I: Commands for the digital input controller (Zero counter, Normal input, Invert input).
- Value: Sets Min/Max values for display or VBar.
- Yellow/Red/Green: Defines color ranges for display values.
Set Analog Input Page
Configures analog inputs for various readouts and associations with relays.
- Analog Input Selected: Identifies the analog input being edited.
- Name: Up to 15 characters for input identification.
- Label: 7-character label for the display.
- Corrector: Allows mathematical operations (+, -, *, /) on the input value.
- USE: Activates the input.
- Type: Defines the analog input source (Analog 1/2, AC Current 1/2, Volts, Current, Temp, Humidity, Accelerometer).
- Display: Selects the display format (Dot, Values, Meter, VBar).
- Relay: Links input state to a relay.
- Value: Sets Min/Max values for display or VBar.
- Yellow/Red/Green: Defines color ranges for display values.
Tasks Page
Allows programming of up to 16 automatic events using IF...THEN statements. Tasks can be enabled/disabled via a state dot (green for ON, red for OFF). The 'Edit' icon leads to the 'Set Schedule' page.
Schedules
Provides an overview of scheduled tasks. The 'Edit' icon allows modification of schedule settings.
Each schedule can include:
- Schedule Select: Identifies the schedule.
- Schedule Name: Up to 15 characters.
- Use: Enables the schedule.
- Log: Logs the schedule's execution.
- Email: Sends an email upon execution.
- IF: Condition statement (Device A, Data A, Logic, Device B, Data B).
- THEN: Action statement (Device C, Data C, Action).
Data types for conditions include Minute, Hour, Day, DayofWeek, Time, Date, Relay, Button, Flag, Temp, Volts, Analog, Digital.
Logic options include AND, OR, NOT.
Actions include ON, OFF, TGL (toggle), RESET, REMOTE, COUNTER, BLUE LED, eMAIL, NOTIFY.
Logs Page
Displays over 10,000 log entries of SERVER and user actions. Logs can be filtered by source and downloaded.
User and Admin Credentials Page
Allows setup of up to 3 users with individual credentials. Default is 'admin'/'admin' for User 1. Users can be set as Active or Admin. Admin users can save data on most pages.
Time/Date Page
Configures the system's time and date settings:
- Time: hh:mm:ss format.
- Date: yy/mm/dd format.
- Time Zone: Sets the time zone.
- Use Daylight Savings Time: Automatic adjustment for daylight saving.
- Use MIL Time: 24-hour format.
- Use NTP Update: Synchronizes SERVER time with an NTP server.
- NTP Web Site: Specifies the NTP server.
- NTP Interval: Sets the update interval in minutes.
- Log NTP Event: Logs NTP events for debugging.
Settings Page
Enables various features in the SERVER:
- Use Active Main: No longer used.
- Require Login: Enforces login credentials.
- Use IP Ranges, Use RESTFUL IP Ranges, Use Remote IP Ranges: Not implemented.
- Use RESTful Authentication: Requires username/password for RESTful access.
- Extend Relay Range: Enables 8 relays.
- Use Relay Radio Buttons: Turns off other relays when one is turned on.
- SSL Port No.: Not supported.
- Use System emails: Enables additional email messages.
- Use Fahrenheit: Selects Celsius or Fahrenheit.
- PGM Dynamic Relays: Changes relay properties in task schedules.
- CLR PGMs on Start: Reinitializes tasks on startup.
- RTC Temperature Compensation: Adds Temperature and Humidity sensor support (Koda boards).
- Use AM2302: Uses AM2302 Temperature and Humidity sensor.
- Java Report: Sends data to HourCollector app (IoTMeter only).
- Use Metric: Not supported.
- UART Usage: Configures UART for Netbell-NTG or Netbell clock.
- Switch Bypass (1/2): Ignores physical inputs.
- Setting 19, Setting 24: Not supported.
- Use Audio File System: Activates SD card reader (Netbell-NTG).
- WiFi Report: Enables WiFi data transfer (WiFi IoTMeter only).
- Active Landing Page: Not supported.
- Invert Relay Control: Inverts relay control (default NO to NC).
Dynamic DNS Page
Allows assignment of dynamic DNS settings for global access to a device behind a NAT router or firewall. Requires a static IP address and port forwarding. Supports DynDNS.
- Use DDNS: Enables the service.
- DDNS Service: Selects the DDNS provider (e.g., DynDNS).
- User Name: DDNS account username.
- Password: DDNS account password.
- Host: IP name registered at the DDNS service.
Remote Devices Page
Allows the SERVER to remotely control relays on another SERVER. Up to 8 remote locations can be configured.
- Device Name: Text name for the remote device.
- IP Address: IP address of the remote device (including port number).
- User Name: Basic Authentication username.
- Password: Basic Authentication password.
Kodalert Page
Provides an interface for alerts of Internet-connected devices. Kodalert is a cloud-based platform for monitoring and alerting. It supports sending alerts via text, email, or push notifications.
- Alert Number
- Test
- Use
- Rule
The Alarm Notification page allows changing relay states and editing alarm settings.
Specifications
FARGO R8G2
- 10M/100M RJ45 Internet interface
- 8 Relay outputs, 1FORMC 48 Volt Max (24VAC/DC 3A)
- Status LEDs
- Ethernet Bootloader
- PoE or 12VDC @500mA
- On-board temperature and voltage sensors
- Web interface w/basic authentication
- Reset/Locate pushbutton
- Working Temperature: 0 to +70 Celsius
- Storage Temperature: 40 to +125 Celsius
- Humidity: 10% to 80% noncondensing
- Dimensions: 74mm x 100mm x 20mm
- Supported Protocols: HTTP/SMTP/SNTP
FARGO R4G2
- 10M/100M RJ45 Internet interface
- 4 1FormC relays 48 Volt Max (24VAC/DC 3A)
- 2 optically isolated digital inputs
- 2 Analog 0-5VDC Inputs
- Status LEDs
- Ethernet Bootloader
- PoE or 12VDC @500mA
- On-board temperature and voltage sensors
- Reset/Locate pushbutton
- Working Temperature: 0 to +70 Celsius
- Storage Temperature: 40 to +125 Celsius
- Humidity: 10% to 80% noncondensing
- Dimensions: 74mm x 100mm x 20mm
- Supported Protocols: HTTP/SMTP/SNTP
KODA100
- 10M/100M RJ45 Internet interface
- 2 1-Form-A relay 48VAC@8A Max
- 2 optically isolated digital inputs
- Status LEDs
- Ethernet Bootloader
- PoE or 12VDC @500mA
- On-board temperature and voltage sensors
- Reset/Locate pushbutton
- Working Temperature: 0 to +70 Celsius
- Storage Temperature: 40 to +125 Celsius
- Humidity: 10% to 80% noncondensing
- Dimensions: 70mm x 100mm x 25mm
- Supported Protocols: HTTP/SMTP/SNTP
KODA200
- 10M/100M RJ45 Internet interface
- 4 1FormA relays 48 Volt Max 1A dry contact or drive 10V ±10% 50mA
- 2 optically isolated digital inputs
- Status LEDs
- Ethernet Bootloader
- PoE or 12VDC @500mA
- On-board temperature and voltage sensors
- Reset/Locate pushbutton
- Working Temperature: 0 to +70 Celsius
- Storage Temperature: 40 to +125 Celsius
- Humidity: 10% to 80% noncondensing
- Dimensions: 70mm x 100mm x 25mm
- Supported Protocols: HTTP/SMTP/SNTP
Board Reference Layout
Fargo R8
1. 8 Relay outputs
2. RJ45 Connector
3. Power Connector (12VDC)
4. Reset Button
5. Locate Button
Fargo R4
1. 3.5mm Inputs for AC Current Sensor (R4ADI Only)
2. Analog Inputs (R4ADI Only)
3. 4 Relay outputs
4. Digital Inputs
5. Digital Input Switches (Input 1: UP=Pullup, Down=Isolated)
6. RJ45 Connector
7. Reset Button
8. Locate Button
9. Power Connector (12VDC)
Koda 100
1. Digital Inputs (5VDC-48VDC)
2. Relay Outputs (8A@48VAC Max)
3. Digital Input Switches (IN 1: UP=Isolated, Down=Pullup)
4. Relay Switches (Up=dry contact, Down=10V/50mA)
5. Reset Button
6. Reload Button (identifies on Discoverer)
7. RJ45 Connector
8. Power Connector (12VDC)
9. USB Mini Connector for Temp/Humidity Sensor
Koda 200
1. Digital Inputs (5VDC-48VDC)
2. Relay Outputs (48 Volt Max 1A dry contact or drive 10V ±10% 50mA)
3. Digital Input Switches (IN 1: UP=Isolated, Down=Pullup)
4. Relay Switches (Up=dry contact, Down=10V/50mA)
5. Reset Button
6. Reload Button (identifies on Discoverer)
7. RJ45 Connector
8. Power Connector (12VDC)
9. USB Mini Connector for Temp/Humidity Sensor
Factory Reset
To perform a factory reset, push the Reset button. When the green LED turns on, push and hold the Reload button until the flashing red LED turns off and then turns on solid. Refer to the Board Reference Layout section for button locations.
User Manual Supplements
This manual supplements documentation for the following Linortek products:
- Netbell-2
- Netbell-8
- Netbell-K (and variants)
- iTrixx-NHM
For more information and videos, visit Linortek.com/downloads.
Appendix 1: How to Send SSL Emails Using a 3rd Party SMTP Service
This appendix explains how to configure Linortek Fargo and Koda devices to send emails using a 3rd party SMTP service like SMTP2GO.
Step 1. Create the SMTP2GO account.
Sign up for a free plan at smtp2go.com. A corporate email address is required.
Step 2. Add a user.
In SMTP2GO, navigate to "Settings" > "SMTP Users" and click "Add SMTP user".
Step 3. Configure the Linortek device.
Navigate to Configure > Email setup page on your Linortek device:
- SMTP Server: mail.smtp2go.com
- Port: 2525
- Use SSL: Unchecked for 3rd party SMTP servers.
- User Name: Your SMTP2GO username.
- Password: Your SMTP2GO password.
- To Address: Recipient email address(es).
- Subject: Email subject line.
Click "Save/Test" to send a test email.
Step 4. Set the task for automatic Email notifications.
To set up condition logic notifications, go to the Tasks page, click the 'Edit' icon of a Schedule, and refer to the 'Set Schedule Page' for details.
Example: Setting up a task to receive Network Hour Meter reports daily at 11:52 AM.