WiFi Relay

WiFi Relay Control

The NexGen WiFi is NCD's second generation WiFi communications module that modernizes connectivity by combining WiFi, Bluetooth, USB, and MQTT Communications into a single module.  The NexGen WiFi module includes firmware that focuses on the most needed features while retaining the flexibility to adapt to just about any application.  Using the integrated web page in Soft AP mode, users have the ability to configure the NexGen WiFi module by enabling and disabling features as needed.

Three Interface Options, ONE Module!

WiFi Communications

The NexGen WiFi module supports TCP communications, essentially converting TCP data to serial data for device control.  Configure network setting such as DHCP or a Static IP address.  Configure the network Port number and serial baud rates for connectivity to the NCD device using the integrated web page while in Soft AP mode.  The Soft AP mode is compatible with web browsers on mobile devices such as Android or IOs devices, as well as laptops and desktop computers with integrated WiFi communications.  Once configuration data is complete, exit the Soft AP mode and use the optional integrated web page to control basic relay control functions via the integrated web page (non-secure) or send data to the WiFi module using some of the optional protocols supported below.

Bluetooth Communications

The NexGen WiFi module also supports Bluetooth connectivity via the Bluetooth Classic protocol.  By implementing the Bluetooth Serial Port Profile, NCD products will appear to your computer as a standard COM port, making it easy to communicate wireless data via Bluetooth between the PC and the device.  Users have the ability to set the Bluetooth discovery name and PIN number via the integrated Web Page using Soft AP mode.

USB Communications

We also built the NexGen WiFi module to include a USB port, which may be used for direct USB communications to the device.  Simply configure the USB Virtual COM Port parameters using the Soft AP mode and the integrated web page.  The NexGen WiFi module will mount as a COM port on your computer, allowing access to the device through serial communications.

WiFi Communication Protocols

MQTT

The NexGen module supports very basic MQTT usage.  It can be configured to connect to an MQTT broker using no auth or basic auth (username/password).  Testing of this functionality was done using beebotte.com.  The NexGen WiFi module implements one subscribe topic and one publish topic.  It listens for control commands over the subscribe topic and sends command responses to the publish topic, which may be user defined using the integrated web page in Soft AP mode.

HTTP

Using WiFi communications, it's also possible to send commands to NCD devices using the HTTP API.  For example, to activate a relay on a NCD device, Simply send the HTTP command to the IP address 192.168.1.10 in any web browser using the following command structure: 192.168.1.10/sendCommand?data:[254,108,1]

Web Socket

Use a Web Socket to send commands to a NCD device.  Users can establish a web socket to the board via ws://{controller IP}/ws.  This web socket expects command bytes to be sent in the form of a JSON array, for example “[254,108,1]” (activate the first relay on a NCD relay board).  Note this array should be sent in TEXT/String format as shown with quotes.  Any data received from the host board will be sent to the web socket in the same format (JSON Array).

Discovery and Diagnostics

UDP Broadcast

The NexGen module broadcasts a UDP packet on ports 55555 and 13000 for network discovery purposes.  This allows discovery of the the NexGen WiFi module in Base Station and may be used for network discovery in your own software applications.

RGB Status LED

The integrated RGB LED displays communications and status information.  Diagnose connectivity status or communication problems with different flashing color patterns to indicate module bootup, wifi connectivity, and configuration modes.

Taralist NTP Time Sync

This option enables Network Time Protocol time syncing of the Taralist Real Time clock.  When enabled, once per day the NexGen module will sync it’s time with time.google.com, then it will update the on board Taralist Real Time clock.  Note that this feature is only valid on Taralist series relay controllers and will only work if WiFi is enabled and internet connectivity is present on the connected WiFi Network.

Compatibility

For use with 2.4GHz WiFi Networks ONLY. This module does NOT support 5GHz WiFi.

PLEASE CONSULT WITH NCD STAFF PRIOR TO RETROFITTING OLDER DEVICES WITH THIS MODULE!

ONLY NEWLY PURCHASED CONTROLLERS ARE COMPATIBLE WITH THIS MODULE!

In general, this WiFi module works with Fusion series controllers regardless of version.  However, this module is NOT COMPATIBLE with older relay boards that you may want to retrofit with WiFi communications.  This module requires more power than older devices are capable of supplying.  This device is fully compatible with any “G2” board revision, such as boards marked with Rev G2A, G2B, G2C, etc.  G2 boards are typically black in color with the exception of Taralist controllers, which are also black in color but NOT equipped with G2 revision markings (and not compatible).  If G2 is not marked on the board revision and you are not using a Fusion series controller, this module is NOT compatible.  Newly purchased controllers will include a power supply upgrade, allowing compatibility.  A service charge to upgrade the power supply on older devices may apply when retrofitting this module.

WiFi Bluetooth USB 3 in 1 Module with MQTT Support

Control NCD devices using standard WiFi TCP/IP communications or use the integrated Bluetooth for simple wireless computer to device interface using a wireless virtual COM port.  Use the USB port for control over a virtual COM port for easy connectivity.  Integrated web server allows control of select NCD relay controllers using a built-in non-secure web page.  This is a low-cost solution that lets you try different solutions with easy setup using a integrated Web Page User Interface for all Configuration settings.  Connect to a MQTT Server over WiFi for remote operation over the internet.

The ProXR Lite SPST Relay Board

ProXR Lite Relay

In this tab we'll take a look at the board design itself.  The ProXR Lite series controllers are machine manufactured for a highly accurate and reliable design.  Fully tested before they leave the production facility each ProXR Lite controller is ready to stand up to rigorous demands from heat, cold or vibration.  The best test of all is the numerous boards in the field from customers all over the world in all sorts of conditions.  Take it from us, these controllers will hold up!

Not Expandable

Unlike it's big brother, the ProXR Series, the ProXR Lite series controllers are NOT expandable. The firmware still thinks 256 relays are available but the relay portion of the controller only responds to the first 1, 2, 4 or 8 relays in Bank 1.

Full ProXR Enhanced Firmware Installed

This board has ProXR Firmware installed that responds to the full ProXR Command Set - it's just not expandable.  The ProXR Firmware is the industry leading firmware for controlling relays with more commands and functionality than any other board on the market.  The list of commands and parameters this board is capable of is extensive.  ProXR Enhanced is the newly released enhance version of the ProXR Firmware with more commands, more functionality and better control than ever before!  For a detailed list of all the commands with descriptions see our ProXR Enhanced Command Set.

Base Station Software

Base Station Software was designed to help you learn the ProXR command set.  Explore ProXR features using it's Graphical User Interface.  Watch data bytes flow to and from the board, so you easily understand the command execution process.  There is no faster or easier way to learn how to automate than Base Station, as it was designed to work with the complete array of communication modules.  Base Station software supports every feature of this device - no other controller manufacturer even comes close to offering this type of software. 

Easy Software Development

Most of our customers write their own program for controlling these relays.  Since you can use almost any programming language, you can use one that is most familiar to you so you don't have to learn a new language.  These boards support the Serial Port Profile, meaning they will mount to the computer as a virtual com port. This makes it very easy to send commands to the board.  Not a programmer, check out N-Button!  Software that allows you to configure buttons to control relays and read the status of those relays without programming using point-and-click action.  Click Here for More

Essential Power Requirements

Applying Good clean power to the board is essential for the operation of the board.  Not only for the switching of the relays but the firmware that processes the commands.  Without good steady clean power from a regulated power supply the board simply will not function correctly.  All boards on the site require 12 VDC power.  The PWR12 US power supply is a 120VAC to 12VDC 1.25A 60Hz regulated power supply and it plugs into the barrel connector on the board.  The output connector is a 2.1mm I.D. x 5.5mm O.D. x 9.5mm Female R/A barrel connector.  We also carry an international power supply with interchangeable adapters for international customers. Learn More

Read Analog Sensors

All ProXR Lite controllers offer a 8-Channel 8/10-Bit Analog to Digital Converter in addition to relay control.  Read and control from 8 sensors per board from 0 to 5 volts (0 being a dry contact)!  A/D inputs are ideal for reading the on/off status of switches, connect a switch between input and ground and software may then be used to monitor the contact closure status of the switch.  AD inputs can also be used for reading variable resistance signals, the board will then will return a value between 0-255.  Click the grey Data Sheets tab above and look for the AD8 Quick Start Guide to see the full AD command set.

SPST Relay Installed

This board has SPST relays installed.  SPST Single Pole Single Throw Relays simply connect two wires together.  The Common (COM) is the moving part of the relay that comes in contact with the Normally Open (NO) when the coil to the relay is energized.  Wiring is done directly to the Relay terminals using a common 1/4" quick disconnect terminal.  To the right is a picture of the connector that will connect to the relay.

2-Million Cycles

ProXR series controllers are designed for long life, you should expect to get years of service from your controller and literally 2-million cycles from the relays on board.  With a 5-year warranty and a money back guarantee you have nothing to loose!  Place your order now, while everything is in front of you.

Essential Power Requirements

Applying Good clean power to the board is essential for the operation of the board.  Not only for the switching of the relays but the firmware that processes the commands.  Without good steady clean power from a regulated power supply the board simply will not function correctly.  All boards on the site require 12 VDC power.  The PWR12 US power supply is a 120VAC to 12VDC 1.25A 60Hz regulated power supply and it plugs into the barrel connector on the board.  The output connector is a 2.1mm I.D. x 5.5mm O.D. x 9.5mm Female R/A barrel connector.  We also carry an international power supply with interchangeable adapters for international customers. Learn More

This Board is RoHS Compliant

This board is led free and RoHS Compliant.  If your requirements are for RoHS compliant parts this board is manufactured with RoHS compliant led free parts and solder.

Break-A-Way Tabs for a Smaller Design

The ProXR Lite relays have a great feature where space is a premium - Break-A-Way Tabs. The Break-A-Way Tabs allow most boards to fit in an optional undrilled plastic enclosure.  Snap off the Break-A-Way Tabs and you have a controller with a smaller profile when you need to fit in a tight space.

30-Day Warranty/Money Back Guarantee

ProXR Lite series controllers are guaranteed against manufacturing and functionality defects for a full 30 days!  Not to mention a 30-day money back guarantee!  If for any reason you are not happy with a relay purchased from Relay Pros, simply return it within 30 days and we will give you your money back!  Controllers that are damaged by our customers will not of course be warranted under any circumstances. 

Induction Suppression

Perhaps the most overlooked aspect of relay control is proper handling of inductive loads. Inductive loads can best be defined as anything with a magnetic coil, such as a motor, solenoid, or a transformer.  Controlling a inductive load using this relay board requires an induction suppression capacitor for each relay being used.  The purpose of this capacitor is to absorb the high voltages generated by inductive loads, blocking them from the contacts of the relay.  Without this capacitor, the lifespan of the relay will be greatly reduced.  Induction can be so severe that it interferes with the logic of the board, causing relay banks to shut down unexpectedly.  For more information view our Induction Suppression Video.

Shipping

The boards sold are brand new units shipped from our office conveniently located in Missouri.  These boards are completely tested before they are released for shipping  With so many boards on our site it is impossible to stock boards, please allow two to three days production time for your order to ship.  If you have any questions please feel free to call our office at 800-960-4287 or e-mail us at sales@relaypros.com.

ProXR Lite Is Here!

A more streamlined manufacturing process brings a more durable, reliable and better relay board to the market.  Here's a lists of great features:

User Friendly Board Design
• Single Pole Single Throw Relays Installed
    - Wire to the Normally Open Position
• Break-A-Way Tabs Lets you Decide the Board's Size
• Wire Directly to the Relay Using 1/4" Quick Disconnect Terminal
• RoHS Compliant

ProXR Lite Features
• Industry Leading ProXR Command Set
• 8-Channel 8/10-Bit Analog to Digital Converter
• Highly Reliable Board
• Assign up to 16 Programmable Timers

ProXR Lite Limitations
• This Board Cannot be Expanded

The ProXR Command Set

Introduction

The ProXR Series Controllers allow you to control up to 2048 relays depending on your controller model.  Relays are divided into groups of 8 called banks, and are addressed by their bank number.  For instance, a ProXR series controller with 32 on-board relays has four on-board banks, the on-board relays respond to bank values of 1-4.  If you use the XR Expansion port to add another bank of 24 relays, then you will need to specify bank values of 5-7 to control the extra relays.  The firmware doesn’t actually know how many relays are attached to the relay controller, it is up to the user to define how many relays are attached to the controller using Base Station Software.  The ProXR CPU will assume you have connected the maximum number of supported relays to your controller.  In the ProXR Quick Start Guide, you will see two commands that appear to do the same thing, for example:

  254 0-7 Turn Off Individual Relays
  254 100-107 Bank# Turn Off Individual Relays in Bank
  254 8-15 Turn On Individual Relays
  254 108-115 Turn On Individual Relays in Bank
  254 16-23 Get the Status of an Individual Relay
  254 116-123 Bank# Get the Status of an Individual Relay in Bank
While the outcome is the same, these commands function in slightly different ways.

For instance:
  254 8 Turn On Relay 1
To make this command work, you will send a 254, then a 8 to activate a relay. By default, relay bank 1 will be affected by this command. However, you can redirect this command to a different relay bank using the following command:
  254 49 2  Direct Commands to Relay Bank 2
Then you can send:
  254 8 Turn On Relay 1 in Bank 2

Here are a few more Bank Specified Examples:
  254 49 1 Direct Commands to Relay Bank 1
  254 8 Turn On Relay 1 in Bank 1
  254 49 2 Direct Commands to Relay Bank 2
  254 8 Turn On Relay 1 in Bank 2
  254 9 Turn On Relay 2 in Bank 2
  254 10 Turn On Relay 3 in Bank 2
  254 49 3 Direct Commands to Relay Bank 3
  254 8 Turn On Relay 1 in Bank 3
  254 11 Turn On Relay 4 in Bank 3
  254 12 Turn On Relay 5 in Bank 3
  254 13 Turn On Relay 6 in Bank 3
  254 14 Turn On Relay 7 in Bank 3
  254 49 0 Direct Commands to All Relay Banks
  254 8 Turn On Relay 1 in All Relay Banks

This command structure has the advantage of being very fast and efficient. However, if power to the controller is ever lost, commands will automatically be directed to bank 1 when power to the controller has been restored. This command methodology is generally advisable for ProXR controllers with 8 or fewer relays. When working with more than 8 relays, we generally advise users to use Bank Directed commands as shown in the following examples.

Turns Off Relays in the Currently Selected Relay Bank

This command will control the Off status of specified relays in the Currently Selected Relay Bank.  This command has optional parameters <1-7> for controlling the Off status of the remaining relays, 1 being the next relay in sequence, 2-7 being all possible subsequent relays in the selected relay bank.  A value of 0 refers to the first relay in the specified relay bank, 7 being the 8th and final relay of the selected Relay Bank. This command sends byte value 85 back to the user when the operation has been completed.

Send Bytes:	Byte 1:	Byte 2:	Byte 3:
Function:	Command	Command	Optional Parameters
Decimal Values:	254	0-7	1-7
Hex Values	0xFE	0x00 - 0x07	0x01 - 0x07
Receive Byte:	Decimal:	85
	Hex:	0x55

Turns On Relays in the Currently Selected Relay Bank

This command will control the On status of specified relays in the Currently Selected Relay Bank.  This command has optional parameters <1-7> for controlling the On status of the remaining relays, 1 being the next relay in sequence, 2-7 being all possible subsequent relays in the selected relay bank.  A value of 0 refers to the first relay in the specified relay bank, 7 being the 8th and final relay of the selected Relay Bank.  This command sends byte value 85 back to the user when the operation has been completed.

Send Bytes:	Byte 1:	Byte 2:	Byte 3:
Function:	Command	Command	Optional Parameters
Decimal Values:	254	8-15	1-7
Hex Values	0xFE	0x08 - 0x0F	0x01 - 0x07
Receive Byte:	Decimal:	85
	Hex:	0x55

Read the Status of Relays in the Currently Selected Relay Bank

This command will report the On/Off status of Relays 0-7 in the Currently Selected Relay Bank.  This command sends byte value of 0 of 1 back to the user when the operation has been completed, 0 reporting an Off status and 1 reporting an On status.

Send Bytes:	Byte 1:	Byte 2:
Function:	Command	Command
Decimal Values:	254	16-23
Hex Values	0xFE	0x10 - 0x17
Receive Byte:	Decimal:	0 or 1
	Hex:	0x00 or 0x01

Full Command Set

These are only a few examples from the ProXR Command set so you can get an idea of the command structure.  Download the ProXR Quick Start Guide to view the full command set ProXR Quick Start Guide.

Base Station Software

Base Station Software was designed to help you learn the ProXR command set!  No other relay board manufacturer even comes close to offering this type of software!  Explore ProXR features using it's Graphical User Interface.  Watch data bytes flow to and from the board, so you easily understand the command execution process.  There is no faster or easier way to learn how to automate than Base Station, as it was designed to work with all the communication modules we offer!  You only need a Windows 8 or 10 Computer to Run Base Station. 

Base Station Features

There are some useful features to look for when using Base Station Software to control, test, or configure your device:

• At the bottom left corner of each window there is a link to relevant documentation for your device
• In the Control Command Set Window, and many others, there is a MORE or LESS option at the top right corner.  Selecting MORE allows you to view specific communication details.
• All the functions of the command set are available as a point-and-click interface plus you can see the command that is being sent to the board!

The AD8 Command Set

Reading Switches/Variable Resistance Signals

This board is equipped with 8-Channels of 8/10-Bit Analog to Digital Converters, capable of reading analog voltages from 0 to 5 Volts DC.  The ADCs on this controller allow monitoring of external sensors or contact closure input detection.  Connect external temperature sensors, light sensors, current sensors, buttons, switches, or anything else that generates a 0-5VDC analog or contact closure output.  With 8-bit resolution, analog inputs will convert 0-5 Volt signals into a value from 0 to 255.  With 10-bit resolution, values of 0 to 1023 may be measured.  Input resolution is software selected.  Simply ask the controller for the analog value of each input, and the controller instantly responds.

Analog Inputs Controlling Relays

ProXR AD8 controllers allow you to map analog inputs for direct control of on-board relays.  Inputs can be configured to flash relays, turn relays on or off, toggle the relay state, send push notification data, and much more.

Analog to Digital Connections

AD8 Series controllers allow users to monitor sensors and switches.  A/D inputs should never be left “floating,” which simply means all inputs MUST connect to something (such as a voltage or ground).  To prevent inputs from floating, a 10K Resistor connects each input to +5 or Ground using the pull up/down jumper.  While this 10K resistor does slightly interfere with the signal, its benefits far outweigh the consequences of leaving inputs floating.

AD8 Command Set

The AD8 Command Set is used to read analog voltages on controllers equipped with an 8-Channel 8/10-Bit Analog to Digital Converter.  The AD8 Command Set converts a Voltage from 0 to 5 Volts DC into numeric value.  The AD8 Command Set supports 8-Bit Analog to Digital Conversion, which converts 0-5VDC to a numeric value from 0 to 255.  The AD8 Command Set also supports 10-Bit Analog to Digital Conversion, which converts 0-5VDC to a numeric value from 0 to 1023.  Since 10-Bit Values must be communicated using two bytes, the following formula must be used to reconstruct the 10-Bit Value:
10BitValue = (MSB*256)+LSB 'Converts 2 Bytes into a Value from 0 to 1023

Reads the 8-Bit Analog Input of Channels

This command will read the Analog Input of Channels 1-8 and return an 8-bit value for each.

Send Bytes:	Byte 1:	Byte 2:
Function:	Command	Parameter (Channel 1-8)
Decimal Values:	254	150-157
Hex Values	0xFE	0x96 - 0x9D
Receive Byte:	Decimal:	0-255
	Hex:	0x00-0xFF

Full Command Set

These are only a few examples from the AD8 Command Set so you can get an idea of the command structure.  Download the AD Quick Start Guide to view the full command set AD Quick Start Guide.

Base Station Software for AD8

Base Station

Base Station will allow you to read the inputs and will even show you the commands being sent from Base Station so you can use them in your own programming. 

Relay Activator and Analog Inputs

The Relay Activator control panel allows analog inputs to directly control relays!  Simply connect the analog inputs to buttons or switches and trigger basic relay on or off functions to take manual control of the on-board relays.  The Relay Activator control panel allows you to define 8 functions for each of the 8 inputs.  Functions include turning relays on or off, toggling the state of relays, momentarily flash a relay, momentarily toggle the flashing function of a relay, turn all relays on, turn all relays off, and push notification events.  When push notification events are configured, the controller generates a packet of data every time the inputs change state.

Relay Activator for Manual Control

Relay Activator is great for applications where computer control is used but manual control is necessary at times.  Buttons or switches can be used to take manual control of any of the relays.  You will have the ability to turn a relay on with a computer and turn the relay off with the manual switch!  Download the Relay Activator Quick Start Guide here: in the AD8 Relay Activator Quick Start Guide.

Create Desktop Meters

Using N-Button software desktop Meters can be created for real time level readings of a sensor connected to the AD8 inputs!  "It's like having a meter right on your desk for constant monitoring".  Meters can be created for temperature sensors, moisture sensors, light meters and others as long as their output is between 0 and 5 volts.  Create a live at-a-glance determination of the sensor.  There are 8 inputs on the board so you can create a meter for each of the input and label them, our meter here is labeled Soil Moisture.  Best of all the increments on the meter can be fully customized to fit your needs.  N-Button Lite and N-Button Pro can be purchased at checkout.
Visit our N-Button Page

Power & More

20/30 Amp Relay Board Specifications

This table covers all NCD boards with 20 or 30 amp relays installed.  All ratings assume 12VDC operation at 70°F (21°C).  Please note that most ratings are estimated and may be subject to periodic revision.  Some ratings represent stock controller settings without performance enhancement optimizations.  The estimated processing time can be impacted by background services and choice of commands.  Standby power consumption assume no communications module is installed and no relays are active on the controller.  Please add the power consumption of the activated relays and communications module to obtain a better estimation of power consumption.

SPDT Relay Specs

Specs of NCD SPDT Relay Boards	Minimum	Nominal	Maximum	Notes
Operational Voltages	10VDC	12VDC	15VDC
Standby Power Consumption	35mA	100mA	200mA	No Active Relays, No Com Module
Relay Power Consumption	28mA	35mA	60mA	Consumption of Each Activated Relay
Operational Temperature Range	-40°F (-40°C)	70°F (21°C)	185°F (85°C)	Theoretical Component Limits Shown
Storage Temperature Range	-67°F (-55°C)	70°F (21°C)	185°F (85°C)	Theoretical Component Limits Shown
Operational Ambient Air Humidity	0%	50%	70%	Non-Condensing Humidity Values Shown
Relay Activation Time			15ms	Needs Further Validation
Relay Deactivation Time			10mS	Needs Further Validation
Operational Life Mechanical	10,000,000			Component Operation Rating
Operational Life Electrical	100,000			Component Rating at Maximum Load

Communication Module Specifications

This table covers all NCD Communication Modules.  While NCD communication modules operate at 3.3VDC, the ratings below highlight the effect they will have on the master controller operating at 12VDC at 70°F (21°C).  Maximum ratings should be used for power budget planning purposes and may reflect short term absolute maximum peak current consumption.  Some ratings are estimated and subject to periodic revision.

Communication Module Power Consumption

Specs of NCD Communication Modules	Minimum	Nominal	Maximum	Notes
Operational Temperature Range	-40°F (-40°C)	70°F (21°C)	185°F (85°C)	Theoretical Component Limits Shown
Storage Temperature Range	-67°F (-55°C)	70°F (21°C)	185°F (85°C)	Theoretical Component Limits Shown
Operational Ambient Air Humidity	0%	50%	70%	Non-Condensing Humidity Values Shown
USB Module Power Consumption	N/A	N/A	N/A	USB Modules are Powered by the USB Port Do Not Consume Device Current
RS-232 Module Power Consumption		10mA	20mA
Ethernet Module Power Consumption	58mA	82mA	100mA
WiFi Bluetooth USB Module Power Consumption	37mA	50mA	100mA	Up to 300 Foot Indoor Wireless Range, Unobstructed. Up to 50 Foot Range Through Walls
900MHz Wireless Module Power Consumption	13mA	30mA	50mA	Up to 1,000 Foot Indoor Wireless Range, up to 2 Mile Outdoor Wireless Range using Included Antennas. Up to 28 Miles Outdoor Wireless Range using High-Gain Antennas.
KFX Wireless Key Fob	11mA	15mA	25mA	Up to 200 Feet Outdoor Wireless Range using 1, 2, 3, 4, or 5 Button Key Fobs. Up to 700 Feet Outdoor Wireless Range using 8-Button Remotes

AD8 Analog Input Usage Notice

Analog Inputs should not have a voltage present when powered down.  Use a 220 Ohm current limiting resistor on each input to prevent damage to the controller if voltage will be present on the analog input when this controller is powered down.  Do not exceed 0 to 5VDC on any analog input or the on-board CPU will be damaged.  Most analog inputs include a 10K Pull Up/Down resistor to help keep the inputs quiet when not in use.  This 10K resistor may slightly bias the readings of some sensors.

NexGen Module Setup

The NexGen module implements all the same functionality from our previously supplied WiFi, Bluetooth and USB modules but adds additional functionality including a simple web interface for configuration, Bluetooth interface, USB interface, we built in web interface for rudimentary control of select relay products, and MQTT compatibility.  We will now cover the configuration of the module.

Configuring the NexGen module

To configure a new NexGen module make sure it is installed in a Host board(Relay controller or other product) and it’s LED is flashing Blue.  A Blue flashing LED indicates it is in configuration mode.  In this mode the module will appear as a WiFi Access point and should show up as an available WiFi network on your computer called NCD_WiFi.  Connect to the NCD_WiFi network and enter NCDBeast as the password.

Your computer may now automatically pop up a browser window where you can configure the module. If not simply open your web browser and enter 172.217.28.1

You should now see the Configuration Web Interface. We will now cover those options.

WiFi

Here we will cover the WiFi options section of configuration.  These are configuration options for associating the WiFi module with your WiFi network.  Note that the NexGen module will scan for networks on initial power up and these will be displayed.  If you have a hidden network(does not broadcast an SSID) please contact support.

Enabled

This setting configures whether or not the module should attempt to associate with a WiFi Network.

Network

This Setting indicates the SSID of the network the module should associate with on power up.

Password

This Setting indicates the password which should be used to associate with the network configured through the Network setting.

DHCP Enabled

This setting indicates whether the NexGen module should obtain an IP address from a DHCP managed router or if it should use following static IP address settings.  Checked indicates to utilize DHCP(Recommended for most applications).

Default Gateway

This setting indicates the default gateway the module should communicate through(IP of router).  This setting is only applicable if DHCP is not checked.

Subnet Mask:

This setting indicates the subnet mask which should be utilized on the network.  This setting is only applicable if DHCP is not checked.

DNS Primary

This setting indicates the default DNS server to utilize for internet connection to host URLs.  This setting is only applicable if DHCP is not checked.  If DHCP is checked the default DNS server of the network router will be used.

DNS Secondary

This setting indicates the backup DNS server to utilize for internet connection to host URLs.  This setting is only applicable if DHCP is not checked.  If DHCP is checked the backup DNS server of the network router will be used.

Static IP

This setting indicates the Static IP address the NexGen module should utilize once connected to the host network.  This setting is only applicable if DHCP is not checked.

Soft AP

In configuration mode the NexGen module is broadcasts and SSID which devices can connect to.  This Soft AP is configurable.  It is possible to change the broadcast SSID network name, the password for authenticating, and the default web interface which should be displayed to the user upon initial connection.  We will cover those settings here.

Soft AP SSID

The SSID the NexGen Module should broadcast while in configuration mode.

Soft AP Password

The authentication password required for associating with the NexGen Module’s network.

Default HTML Page

Some devices support captive gateways.  This setting determines the web interface to display to the user through the captive portal upon initial connection.

UDP Broadcast

The NexGen module broadcasts a UDP packet on ports 55555 and 13000 for network discovery purposes.&NBSP; These settings enable this broadcast, forward the broadcast to link.signalswitch.com and alter the name in the discovery packet.

UDP Broadcast

This setting indicates whether or not the WiFi module should send out a network discovery UDP packet on interval.

Link.SignalSwitch Broadcast

This setting indicates whether or not the WiFi module should send a discovery packet to link.signalswitch.com on interval or not.

UDP Discovery Name

This setting configures the Name field to be send in UDP broadcast packets. This can be used to differentiate multiple devices on the same network.

Serial

The WiFi module technically has two serial interfaces.&NBSP; One which communicates through the USB port on the module and a second that communicates to the host board.&NBSP; These settings apply to those ports.&NBSP; Keep in mind most Host boards manufactured by NCD have a default baud rate of 115200.

Board Baud Rate

Baud rate of the NexGen module’s serial interface connected to the Host board.  Most NCD boards have a default baud rate of 115200.  This setting must match the baud rate of the host board.

USB Baud Rate

The baud rate for WiFi module’s USB connection. Software connected to the board via USB must match this baud rate.

Bluetooth

The NexGen module supports Bluetooth connectivity via the Bluetooth Classic protocol.  It implements the functionality of a Bluetooth Serial Port Profile device(SPP).  It does not implement Bluetooth 4.0 or LE functionality and thus is not compatible with all devices such as iOS.

Bluetooth Enabled

This setting indicates whether or not the NexGen Module should implement bluetooth connectivity.

Bluetooth Discovery Name

This is the name which will appear in Bluetooth device scans.

Bluetooth Pairing Code

Pairing code required for Bluetooth pairing with the device.

TCP

The NexGen module implements the functionality of a TCP server.  In this implementation the module opens a socket which clients(software) can connect too.  These settings configure this TCP Server functionality.

TCP Server Enabled

Whether or not to allow TCP clients to connect.

TCP Listen Port

The port on which to listen and allow for TCP Client connections.

HTTP Control

The NexGen module supports a rudimentary web interface for manually turning relays on and off.  This interface only supports ProXR, ProXR Lite, Fusion, and Taralist relay controllers with 8 or fewer relays.  This interface is available at {device IP address}/Control.

HTTP Control Enabled

Whether or not to display the HTTP control interface.  Select this option if you want to activated the built-in web page to control the relay.  Below select how many relays you have on the board, compatible on boards with up to 8 relays installed.

Number of Relays

This setting determines the number of relay control sets to display on the control interface.  Match this to the number of relays on the board.  This ferature is only compatible with boards with 8 relays or less.

MQTT

The NexGen module supports very basic MQTT usage.  It can be configured to connect to an MQTT broker using no auth or basic auth(username/password).  Testing of this functionality was done using beebotte.com

The module only implements one subscribe topic and one publish topic.  It listens for control commands over the subscribe topic and sends command responses to the publish topic.  Commands should be published to the subscribe topic in a JSON packet.  The JSON packet must contain one key value pair with a key of sendCommand and the value for that pair must be a JSON array of command bytes.  Example: {“sendCommand”:[254,108,1]}.  The WiFi module will publish data received from the host board to the Publish topic.  This Publish payload will contain a JSON packet.  The format of the packet is a single key value pair with the key of data and the value will be an array of bytes.  Example: {“data”:[170,1,85,1]}

MQTT Enabled

Whether or not to implement MQTT functionality and establish connection to an MQTT broker on boot.

HOST

The Host URL for The MQTT broker.

Host Port

The port on which to connect to The MQTT broker.

Client ID

The Client ID to use for The MQTT connection.

Username

The user name to use for basic authentication with The MQTT broker.

Password

The password to use for basic authentication with The MQTT broker.

Subscribe Topic

The Topic to subscribe to for host board control commands

Publish Topic

The Topic which to publish data to when data is received from the Host board.

HTTP API

The NexGen module supports HTTP GET requests for sending commands to the host board.  There are a few different end points for the HTTP Get requests:

/relayCount

- A Get request to this end point will return the number of relays on the board(this is configured under Number of relays setting under HTTP Control. - Example: 192.168.1.10/relayCount

/relayON

- A GET request to this end point will turn the specified relay on. This GET request requires one arg with the key relay and the value of the relay which to control(valid range for relay number is 1-256) - The board should respond to this GET request with an 85. - Example: 192.168.1.10/relayON?relay=1

/relayOFF

- A GET request to this end point will turn the specified relay off. This GET request requires one arg with the key relay and the value of the relay which to control(valid range for relay number is 1-256) - The board should respond to this GET request with an 85. - Example: 192.168.1.10/relayOFF?relay=1

/sendCommand

- A GET request to this end point allows the user to send any command to the board they wish. This GET request requires one arg with the key of data and a value of an array of bytes which to send to the host board. - Once the host board has processed the command this GET request will respond with the data returned from the host board. - Example: 192.168.1.10/sendCommand?data:[254,108,1]

Web Socket

The NexGen module supports web sockets. Users can establish a web socket to the board via ws://{controller IP}/ws

This web socket expects command bytes to be sent in the form of a JSON array, for example “[254,108,1]”. Note this array should be sent in TEXT/String format as shown with quotes.

Any data received from the host board will be sent to the web socket in the same format (JSON Array).

RGB status LED

The NexGen module has an RGB status LED which is used to indicate the current state of the module to the user visually.  Possible statuses are:

Flashing Green

The module is running normally but no connections to it have been established.

Solid Green

The module is running normally and a connection has been established with the board via software.  This will happen when a TCP socket is connected to the board.

Flashing Blue

Module is in configuration mode and should appear as a network in WiFi Scans.

Flashing Yellow<

Module is booting.

Orange Flash

The LED will flash Orange any time data is received over any connection (USB, TCP, Bluetooth, MQTT, etc).

Flashing Red

Indicates the module is unable to connect to the WiFi network.

Taralist

Taralist NTP Sync Enabled

This option enables Network Time Protocol time syncing of the Taralist Real Time clock.  When enabled, once per day the NexGen module will sync it’s time with time.google.com, then it will update the on board Taralist Real Time clock.  Note that this feature is only valid on Taralist series relay controllers and will only work if WiFi is enabled and internet connectivity is present on the connected WiFi Network.

UTC Timezone Offset

This setting determines the timezone for NTP clock syncing.  Set it to your particular timezone’s UTC offset not factoring in DST.  For instance Central Standard Time’s UTC offset is -6, Eastern Standard Time is -5, etc.

Enable Daylight Savings Time

When enabled the controller will offset it’s clock during Daylight savings time.

Viewing the NexGen Module’s NTP time and the on board Taralist Real Time Clock Time.

After Taralist settings have been entered and WiFi settings have been entered and saved to the NexGen module it should connect to your WiFi network and the RGB LED should be flashing green indicating everything is functional.  On a computer on the same network as the controller open a web browser and enter the controller’s IP address followed by /Taralist for example: 192.168.0.2/Taralist.  The returned HTML page will display both the NTP clock time and the on board Taralist real time clock time.  This time is updated nearly once per second.  If everything looks valid go ahead and close the page, Taralist is now fully functional.  Note do not leave this page open as it taxes the processor to update the web page once per second.

Software Options

Not a programmer and think these boards look great, not to worry we have software to help get you connected and even control the relays with a button on your desktop or by a time schedule!

---

---

---

---

Data Sheets & Quick Start Guides

Below are the Data Sheets and Quick Start Guides for this board.  These are the guides that will help you communicate and configure this board.