Introduction
| Sl.No. | SKU | Description | Operating temperature |
|---|---|---|---|
| 1 | NLEWR008A | LEO WR 8 Channel Web Relay Module - WR8A | -40 ℃ to 85 ℃ |
| 2 | NLEWR008A-24 | LEO WR 8 Channel Web Relay Module - WR8A-24 | -40 ℃ to 85 ℃ |
| 3 | NLEWR008B | LEO WR 8 Channel Web Relay Module - WR8B | -40 ℃ to 85 ℃ |
| 4 | NLEWR008B-24 | LEO WR 8 Channel Web Relay Module - WR8B-24 | -40 ℃ to 85 ℃ |

Numato Lab’s LEO WR8 : 8 Channel Web Relay Module is a versatile product for controlling electrical and electronic devices remotely from a PC over an Ethernet link and is designed for modern IoT, industrial, and smart automation applications.
It combines powerful data acquisition capabilities with seamless cloud connectivity and local control features. With integrated support for Wi-Fi 2.4GHz, MQTT/MQTTS (compatible with AWS, Azure, and other cloud platforms), and REST API, the Module empowers users to monitor, control, and automate processes remotely and securely. Ease of use and wider operating system compatibility are the primary goals behind this product’s design.
This simplicity allows the use of off-the-shelf Terminal Emulation programs such as HyperTerminal and TeraTerm for controlling the module with a simple set of human-readable commands through Telnet/Web page/Wi-Fi and/or REST API commands. For power users, this module can be controlled by writing programs in various programming languages. This highly versatile device allows users to create fully automated systems with minimal setup time. It is ideal for both professionals and hobbyists looking to integrate reliable automation and data acquisition into their systems.
Applications
- Industrial Automation: Monitor sensor inputs and control actuators, machines, or alarms based on configurable logic.
- Smart Home & Building Automation: Automate lighting, HVAC systems, and appliances using environmental data and remote control.
- IoT & Cloud-Based Monitoring: Stream real-time data to AWS, Azure, or private MQTT brokers for centralized dashboards and alerting.
- Environmental Monitoring: Use the onboard temperature and humidity sensor for weather stations, greenhouses, or storage rooms.
- Remote Control Systems: Operate devices from anywhere using the onboard web server or REST APIs.
- Data Logging and Analytics: Log inputs, outputs, and sensor data locally for historical analysis and compliance tracking.
- Smart Agriculture: Monitor field conditions and control irrigation or other systems based on environmental triggers.
- Test Fixtures
- DIY and Hobby
Board Features
- 8 SPDT/SPST Relay Outputs (12V/24V): Control external devices such as fans, alarms, or lighting with 8 independent relay channels, 7A maximum switching current.
- 8 Digital High Voltage Inputs supports Maximum Input Voltage of 24V.
- Relay LED indication: Each relay has individual LEDs for status indication.
- Password-protected Web console, Wi-Fi console, REST API and Telnet communication interface.
- 2-in-1 Sensor: Temperature and humidity sensing in a single device.
- Wi-Fi (2.4GHz): Provides stable wireless communication.
- DIN Rail Support: Supports standard DIN rail for easy installation.
- Cloud Integration: Supports MQTT, MQTTS for AWS, Azure, and more.
- Data Logging: Onboard Data Logging for secure, local storage of sensor and control data.
- Web Server & REST API: Built-in Web Server for configuration, monitoring, and remote control.
- Sensor and ADC Calibration: On-device calibration for accuracy.
- Configuration over USB: Simplified configuration without a network.
- RGB Indicator: Easily shows device status with a color-coded RGB LED.
Technical Specifications
| Parameter* | Value | Unit | |||
|---|---|---|---|---|---|
| Variant | NLEWR008A | NLEWR008A-24 | NLEWR008B | NLEWR008B-24 | |
| Basic Specifications | |||||
| Number of relays | 8 | 8 | 8 | 8 | |
| Number of Digital Inputs | 8 | 8 | 8 | 8 | |
| Digital circuit power supply voltage (External) | 12 | 24 | 12 | 24 | V |
| Maximum current drawn by digital circuitry | 300 | 300 | 300 | 300 | mA |
| Digital Inputs Specifications | |||||
| Maximum DI sink current | 2.05 | 2.05 | 2.05 | 2.05 | mA |
| Maximum DI sink current | 30 | 30 | 30 | 30 | mA |
| Recommended sink current | 10 | 10 | 10 | 10 | mA |
| Maximum Low Voltage (VIL) | 10.2 | 10.2 | 10.2 | 10.2 | V |
| Minimum High Voltage (VIH) | 10.5 | 10.5 | 10.5 | 10.5 | V |
| Maximum High Voltage | 24 | 24 | 24 | 24 | V |
| Relay Specifications | |||||
| Nominal relay coil voltage | 12 | 24 | 12 | 24 | V |
| Nominal coil power consumption (per relay) | 450 | 450 | 450 | 450 | mW |
| Relay contact material | Silver Alloy, silver metal-oxide | Silver Alloy, silver metal-oxide | silver metal-oxide | silver metal-oxide | |
| Contact rating | 7A 250VAC 7A 28VDC | 7A 250VAC 7A 28VDC | 7A/ 277V AC 7A/ 28V DC | 7A/ 277V AC 7A/ 28V DC | |
| Maximum switching voltage | 250VAC/30VDC | 250VAC/30VDC | 277VAC/28VDC | 277VAC/28VDC | |
| Maximum switching current | 7 | 7 | 7 | 7 | A |
| Maximum switching power | 2500VA/300W | 2500VA/300W | 2770VA/ 196W | 2770VA/ 196W | |
| Contact resistance | 100 | 100 | 100 | 100 | mΩ (at 1A 6VDC) |
| Insulation resistance | 1000 | 1000 | MΩ | ||
| Life expectancy (Electrical) | 100000 | 100000 | 100000 | 100000 | Operations (at 7A 250VAC resistive load, room temp) |
| Life expectancy (Mechanical) | 10000000 | 10000000 | 10000000 | 10000000 | Operations |
| Maximum switching on response time | 1 | 1 | 1 | 1 | second |
| Maximum switching off response time | 9 | 9 | 9 | 9 | second |
| shock resistance (Functional) | 294 | 294 | 98 | 98 | m/s2 |
| Shock resistance (Destructive) | 980 | 980 | 980 | 980 | m/s2 |
| Vibration resistance | 10Hz to 55Hz, 1.5mm DA | 10Hz to 55Hz, 1.5mm DA | 10Hz to 55Hz, 1.5mm DA | 10Hz to 55Hz, 1.5mm DA | |
* All parameters considered nominal. Numato Systems Pvt Ltd reserve the right to modify products without notice.
* SPST Variant Datasheet – HF32FV-G Relay
* SPDT Variant Datasheet – HF3FF Relay
How to use the module
The following section describes how to use this module.
Components/Tools required
Along with the module, you may need the items in the list below for easy and fast installation.
- CAT 5e Ethernet Cable(Straight through cable)
- 12V/24V 1A DC power supply, depending on the relay variant
- USB Type C Cable
- Medium-sized Philips screwdriver
Connection Details

USB Interface
Onboard USB port is available; the onboard USB Interface helps to communicate and configure this module seamlessly. This module is detected as a COM port, and the user can configure the module with widely available serial terminal applications, no specialised software required.
It is compatible with most common terminal tools, including:
- Windows
- Tera Term
- PuTTY
- Linux
- GNU Screen
- PuTTY
- MAC OS X
- Screen Command
- CoolTerm
Note: The device is not limited to the above tools and can be used with any standard serial terminal software.
Use a USB-A to USB-C/ USB-C to USB-C cable to connect to a PC. Please visit accessories to buy cables and accessories for this product.
Ethernet Interface
The onboard Ethernet port supports Ethernet 100 Mbps transmission speed that helps a computer to communicate and control this module easily.
You can connect the module to a Local Area Network(LAN) via a common straight-through Ethernet cable.
Eg: Connecting the module to a switch in a network.
Wi-Fi Interface
The LEO WR8 : 8-channel Web Relay Module offers effortless wireless connectivity with built-in 2.4GHz Wi-Fi, ensuring smooth and reliable network integration. Wi-Fi STA mode can be configured quickly and hassle-free over USB, with no additional hardware required. Once connected, the device efficiently transmits data to the cloud using MQTT/MQTTS, enabling real-time monitoring across multiple platforms. In STA Mode, once the device is configured, it will stay connected to the specified network and continuously publish data to the cloud, ensuring seamless data communication without the need for manual intervention. Secure access is provided through HTTP REST APIs, allowing for robust and real-time data communication. For added convenience, the module features a secure, built-in web interface that can be accessed directly from any browser for easy configuration and monitoring.
Relay Contacts
SPDT Variant [WR8A, WR8A-24]
This module has 8 SPDT relays (12V/24V), capable of switching up to 7A of current. All relay contacts are available externally through screw terminals for easy user access. The relays are rated for AC switching applications. Please refer to the electrical parameter table for detailed specifications.
Each SPDT relay provides three contacts: COM (Common), NO (Normally Open), and NC (Normally Closed). When the
relay is OFF, COM is connected to NC. When the relay is ON, COM is connected to NO. The table below summarizes the possible relay contact positions.
| Relay State | Connection between NC and C | Connection between NO and C |
|---|---|---|
| OFF | Close | Open |
| ON | Open | Close |
SPST Variant [WR8B, WR8B-24]
This module has 8 SPST relays (12V/24V), capable of switching up to 7A of current. All relay contacts are available externally through screw terminals for easy user access. The relays are rated for AC switching applications. Please refer to the electrical parameter table for detailed specifications.
Each SPST relay provides two contacts: IN and OUT. When the relay is ON, the connection is established between the IN and OUT contacts. When the relay is OFF, the connection is disconnected. The table below summarizes the possible relay contact positions.
| Relay State | IN to OUT Connection | Load Condition |
|---|---|---|
| OFF | Open | Load Disconnected |
| ON | Closed | Load Energized |
DC Power Supply
This board can be operated using a single DC power supply. Depending on the relay variant, connect either a 12V DC, 1A or 24V DC, 1A power supply to the DC jack on the board. The power supply provides power to both the logic circuitry and the relays.
Connecting the power supply incorrectly can cause damage to the module and/or other devices.
LED Indication
This module has a multifunctional RGB LED Indicator. The device indicates the Power status, Configuration mode, Network status, MQTT connectivity, and Multipurpose switch state.
| LED Indication | Status |
|---|---|
| Solid Red | USB configuration mode |
| Blinks in Blue Colour | Trying to connect to network |
| Solid Purple | Connected to Ethernet network |
| Solid Turquoise Blue | Connected to Wi-Fi network |
| Solid Blue | Connected to both Ethernet and Wi-Fi |
| Blinks in Red Colour | Factory reset in progress |
Multipurpose Switch
The LEO WR8 : 8-channel Web Relay Module is equipped with a versatile multipurpose switch that enables a range of device management functions:
| Action | LED Indication | Function |
|---|---|---|
| Single Click | The Red LED briefly turns OFF and ON, indicating that the device is restarting. | Device Reset: Resets the device and reinitializes. |
| Press for 7-10 seconds | The Red LED blinks continuously while the factory reset process is in progress. | Factory Reset: Device erases all the settings and restores to factory defaults. |
Important: Use the Factory reset feature only to recover the Username/Password/Hostname. A factory reset will erase all Network, MQTT, and other settings, restoring the board to its default configuration. After resetting, access the board using the default credentials listed in the table below.
Factory Reset
The LEO WR8 – 8 Channel Web Relay Module provides a factory reset feature to restore all settings to their original default values.
How to Perform a Factory Reset
You can initiate a factory reset using either of the following methods:
- Using the Multipurpose Switch: Press and hold the RESET switch for 7 – 10 seconds.
- Using Command Interface: Execute the factory reset command via the USB console.
Important Notes
- This operation will reset all user-configured settings, including:
- Username and Password
- Device ID
- Smart Actions and Timer configurations
- All other user-configured parameters.
- After reset, the device will revert to factory default credentials, as listed in the table below.
Factory Default Settings
The default configuration after a factory reset is provided in the table below.
| User name | admin |
| Password | admin1234 |
| Host Name | *Factory set default unique Hostname. |
| Device ID | 00000000 |
| net0 IP Address | 169.254.1.1 |
| Telnet Authentication | ON |
| Telnet Port | 23 |
| net1 IP Address | 169.254.1.1 |
| Access IP - both net0 and net1 | Disabled |
| IP0 to IP9 | 255.255.255.255 |
| DHCP Status - both net0 and net1 | Enabled |
| Smart Action | Disabled |
| Relay Power-On | Disabled |
| GPIO Notify Feature | Disabled |
Configure LEO WR8 : 8 Channel Web Relay Module
Connect a DC power supply and power up the device as mentioned in the DC Power Supply section above. A red LED (PWR) will glow, which indicates active power. For configuration over USB, connect a USB-A to USB-C/USB-C to USB-C cable to the module, and also connect the module to a PC or a Switch/Router as mentioned in the Ethernet Interface section above. Run the Hyper Terminal program or any serial terminal program like PuTTY, TeraTerm, etc.
NB: By default, the module is configured with factory settings. To log in to USB configuration settings, users need to send a ‘reboot’ command from telnet or do a factory reset.
Select the module’s COM port and use the default settings, similar to the images below and connect.

Users will be prompted to enter the User name and Password. The default User name is ‘admin‘ and Password is ‘admin1234‘. You may change the User name and Password once logged in.
If the user name and password are correct, we will be able to see the login success message.
Configuration Command Set
| No. | Command | Example | Description |
|---|---|---|---|
| 1 | usr | usr set xxxxxxxx | Sets the new username for telnet, where x can be any alphanumeric character. The username can be 1-8 characters long. |
| usr get | Read the current username of telnet. The default username is "admin". | ||
| 2 | pass | pass set xxxxxxxx | Sets the new password for telnet, where x can be any alphanumeric character. The password can be 1-8 characters long. |
| pass get | Read the current password of telnet. The default password is "admin1234". | ||
| 3 | telnet | telnet auth on/off | Enable and disable the telnet authentication. telnet auth on enabling the telnet authentication and telnet off disabling the telnet authentication. |
| telnet auth get | Read the status of telnet authentication. | ||
| telnet port set xx | Sets the telnet port, where xx can be in the range of 00 to 99. The default value of telnet port is 23. |
||
| telnet port get | Shows the telnet port. | ||
| 4 | net0 access | net0 access ip on/off | Enable or disabling the IP based access to the module, this command adds filtering. Once the command is enabled, the stored IP using the access ip set command will be able to access the module. By default access IP is disabled. |
| net0 access ip set N xxx.xxx.xxx.xxx | Set the acceptable IP in the network and save the same. Where N is the number 0-9, maximum 10 IP we can store in the non-volatile memory. Eg: net0 access ip set 0 192.168.0. 2 |
||
| net0 access ip get | Read the stored IP in the memory. | ||
| 5 | net0 dhcp | net0 dhcp on/off | Enable or disable the DHCP of the Ethernet Interface |
| net0 dhcp get | Shows the DHCP status of the Ethernet Interface | ||
| 6 | net0 ip | net0 ip set xxx.xxx.xxx.xxx | Sets the static IP to the Ethernet Interface. Eg: net0 ip set 192.168.5.48 |
| net0 ip get | Read the status of DHCP and the static IP of the Ethernet Interface. If DHCP is enabled it will display the DHCP status and if it is disabled it will display the static IP too | ||
| 7 | net0 sm | net0 sm set xxx.xxx.xxx.xxx | Sets the Subnet Mask to the Ethernet Interface. Eg: net0 sm set 255.255.255.0 |
| net0 sm get | Read the Subnet Mask of the Ethernet Interface. If DHCP is enabled it will display the DHCP status and if it is disabled it will display the Subnet Mask value. | ||
| 8 | net0 gw | net0 gw set xxx.xxx.xxx.xxx | Sets the gateway to the Ethernet Interface. Eg: net0 gw set 192.168.5.48 |
| net0 gw get | Reads the Gateway of the Ethernet Interface. If DHCP is enabled it will display the DHCP status and if it is disabled it will display the Gateway value. | ||
| 9 | net1 dhcp | net1 dhcp on/off | Enable or disable the DHCP of the WiFi Interface |
| net1 dhcp get | Shows the DHCP status of the WiFi Interface | ||
| 10 | net1 ip | net1 ip set xxx.xxx.xxx.xxx | Sets the static IP to the WiFi Interface. Eg: net0 ip set 192.168.5.48 |
| net1 ip get | Read the status of DHCP and the static IP of the WiFi Interface. If DHCP is enabled it will display the DHCP status and if it is disabled it will display the static IP too | ||
| 11 | net1 sm | net1 sm set xxx.xxx.xxx.xxx | Sets the Subnet Mask to the WiFi Interface. Eg: net0 sm set 255.255.255.0 |
| net1 sm get | Read the Subnet Mask of the WiFi Interface. If DHCP is enabled it will display the DHCP status and if it is disabled it will display the Subnet Mask value. | ||
| 12 | net1 gw | net1 gw set xxx.xxx.xxx.xxx | Sets the gateway to the WiFi Interface. Eg: net0 gw set 192.168.5.48 |
| net0 gw get | Reads the Gateway of the WiFi Interface. If DHCP is enabled it will display the DHCP status and if it is disabled it will display the Gateway value. | ||
| 13 | mac id get | mac id get | Read the MAC id of the module. |
| 14 | reboot | reboot | Does a soft-reset. |
| 15 | app mode | app mode | Exit the configuration interface and enter to the application mode and start the telnet communication. |
| 16 | fact reset | fact reset | Does the factory reset to the module. Configure the module to factory default. |
Configuration command Images
Example commands and results after executing the commands.
Powering Up LEO WR8 : 8 Channel Web Relay Module
Connect a DC power supply and power up the device as mentioned in the DC Power Supply section above. An RGB LED will glow Red for 2 seconds, which indicates active power. Connect the module to a Switch/Router as mentioned in the Ethernet Interface section above. Run Numato Lab Device Discoverer.jar, and click on Discover Devices. The window will display the IP address, Host Name, MAC Address, and Other information.

IP Address and MAC Address can be seen in the command prompt also, only after connecting the module through the web page. Open the command prompt and type the command ‘arp -a‘. This will display the available network interfaces and connected devices along with the MAC address and IP address of each device. Look for the IP address that corresponds to your device’s MAC address. The MAC address for each Relay Module is printed on a label on the board for your convenience. Use the IP address obtained to access the device.

Accessing the module
The module can be monitored and controlled by using the interfaces below.
- Through HTML/Web Page served from the device – Ethernet interface.
- Through HTML/Web Page served from the WI-Fi interface.
- Through a Serial terminal Emulator that supports TELNET (Eg: Hyper Terminal, TeraTerm, PUTTY…).
- Through REST API commands.
Accessing the module using Ethernet web interface
The easiest method for controlling the module is through web page served from the device. To open the administration web page, type in the IP address in to the address bar of any web browser and press enter.

You will be prompted to enter your Username and Password. The default username is ‘admin,’ and the default password is “admin1234”. Once logged in, you may change the Username and Password.
Enter the default User name and Password, then click Sign In.

You will be presented with the device home page that shows the status of Relays and GPIOs
GPIO, Relay Status and Control
8 Relays on the board can be controlled over Ethernet/WiFi. The Relay Index shows the corresponding relay on board. Relays on the board can be turned on/off by clicking the Toggle Relay button next to the corresponding relay index. The Status of the relays change automatically for easy identification.
This board has 8 general-purpose high-voltage inputs. The status of GPIOs is shown on the home page.
Device Settings
The device Settings page displays the current firmware version, Device ID, Account Settings, and Basic Network Settings. A logged-in user can change and save the Device ID, User name, Password, and network settings.
The user can change and save the Device ID, User name, and Password as explained in the command set or by changing the appropriate field on this page and clicking on the save button on the right side, and reboot the page from the Device Management section. The User name and Password can be reset to factory defaults via Factory Reset explained elsewhere in this document. The Basic Network Settings shows the Device’s MAC address, Host Name, DHCP Status, IP Address, Subnet Mask and Gateway. The default hostname and IP Address can also be changed according to the user’s wish. After saving changes, and rebooting the board will reboot with the new network settings.
Accessing the module using Wi-Fi web interface
The easiest method for controlling the module is through web page served from the device. To open the administration web page, type in the IP address in to the address bar of any web browser and press enter.
You will be prompted to enter Your username and Password. The default username is ‘admin,’ and the default password is “admin1234”. Once logged in, you may change the Username and Password.
Enter the default User name and Password then click Sign In.

You will be presented with the device home page where you can monitor the sensor data.
Device Settings
Device Info
The Device Info section provides detailed information about your device. This section is read-only, which means you cannot modify the device information here, but you can refer to it when needed.

| Field | Description |
|---|---|
| Device ID | Displays Device ID. |
| Firmware Version | Displays the current version of the firmware installed on your device. |
| Device Serial Number | The serial number specific to your device. This number is used for identification and support purposes. |
These details are displayed in a simple, easy-to-read format.
User Account
In the User Account section, you can manage your web login, including updating your Username and Password. This is important for keeping your account secure and ensuring only authorized users can access the device settings.

| Field | Description |
|---|---|
| Username | You can change your username by entering a new one in the provided field. Make sure to choose a unique and memorable username for easy access. |
| Password | Enter your new password here. Please follow the password strength requirements to ensure your password is strong and secure. |
| Confirm Password | Re-enter the new password here to confirm that both entries match. If they do not match, an error message will appear to help you correct it. |
Important Note: Your password will only be updated if both the New Password and Confirm Password fields match exactly. If there is a discrepancy, a Warning message will be displayed, and you will need to correct it before proceeding.
Important Update Information: Once you update the User Account Password, the web login password will be updated simultaneously. This means that the new password will be used for the web login to your device’s dashboard. Make sure to remember this new password for all future logins to your device.
NET1 OTA Firmware Update
The Firmware Update section allows you to keep your device up to date with the latest features, improvements, and bug fixes. Firmware updates can be performed only through the NET1 (Wi-Fi) interface.
Important: Do not upload any unauthorized images via OTA. Doing so may permanently damage the device.
Device Management
In the Device Management section, you can perform essential actions to manage your device, including rebooting the device and restoring it to its factory settings.

| Action | Description |
|---|---|
| Reboot | This option allows you to reset the device. Rebooting the device can be useful for applying new configurations and settings. |
| Mode | This option allows you to switch the device to USB Configuration mode |
| Factory reset | This option restores the device to its original factory settings, erasing all user-configured settings and data. After a factory reset, the device will return to its default configuration. |
Important Note: Factory Reset is a permanent action. Once performed, all user-set data and logged sensor data will be erased. This action cannot be undone, make sure to back up any important data before performing a factory reset.
Network Settings
The Network Settings section allows you to configure the network connection of the device. This includes the :
- Ethernet Network Settings
- Wi-Fi Station Settings
Ethernet Network Settings
The Ethernet Network Settings section allows you to configure the device’s wired network connection.
| Field | Description |
|---|---|
| MAC Address | Displays the unique MAC address assigned to the device. This address is used to identify the device on the network. |
| Host Name | Specifies the hostname of the device. The hostname can be customized to easily identify the device on the network. |
| Enable DHCP | When enabled, the device automatically obtains its IP address and other network parameters from a DHCP server. |
| IP Address | Displays or specifies the IP address assigned to the device. When DHCP is enabled, this address is assigned automatically. |
| Subnet Mask | Specifies the subnet mask used to determine the network address range. |
| Default Gateway | Specifies the gateway address used to communicate with devices outside the local network. |
After entering the required network parameters, click Submit to apply the settings.
Wi-Fi Station Settings
The Wi-Fi Station Settings section allows the device to connect to an existing Wi-Fi network.
| Field | Description |
|---|---|
| SSID | Enter the name of the Wi-Fi network to which the device should connect. |
| Username | Enter the username if the Wi-Fi network requires authentication. This field may be left blank when authentication is not required. |
| Password | Enter the password for the selected Wi-Fi network. |
| Host Name | Specifies the hostname used to identify the device on the network. |
| MAC Address | Displays the MAC address of the Wi-Fi interface. |
| Enable DHCP Client | When enabled, the device automatically obtains its IP address and other network parameters from the network's DHCP server. |
| IP Address | Displays or specifies the IP address assigned to the Wi-Fi interface. |
| Subnet Mask | Specifies the subnet mask for the Wi-Fi network. |
| Default Gateway | Specifies the gateway address used for communication with other networks or the Internet. |
| Primary DNS | Specifies the primary DNS server used to resolve domain names into IP addresses. |
| Secondary DNS | Specifies an optional secondary DNS server to be used if the primary DNS server is unavailable. |
After entering the required network parameters, click Update WiFi Station Settings to apply the settings.
After a reboot or a power reset, the module can be accessed via the DNS Hostname or the IP Address.
- Accessing via DNS Hostname:
- The device will be accessible via its DNS hostname. By default, the device will be configured with a device specific unique hostname. The device can be accessed with the postfix “.local” example: hostname.local.
- Accessing via IP address:
-
If the device was configured with a static IP address, you can access it directly by entering the static IP address into your browser.
-
If the device was set to use dynamic IP (DHCP), you can either check the IP address assigned to the device through your router’s DHCP table or use a “arp -a” on command tool and check the IP assigned to your device MAC.
-
MQTT Settings
The MQTT/MQTTS Settings section allows you to configure the communication between your device and the MQTT broker. You can choose to use either MQTT (unencrypted) or MQTTS (secure, encrypted MQTT).
| Setting | Description | Mandatory for MQTT | Mandatory for MQTTS |
|---|---|---|---|
| Broker | Enter the MQTT broker address (IP or domain) with the appropriate protocol prefix (mqtt:// or mqtts://). For example, mqtt://broker.example.com or mqtts://broker.example.com. | YES | YES |
| Publish Interval (ms) | Set the publish interval in milliseconds. This defines how often the device will send data. | YES | YES |
| Client ID | Enter a unique Client ID for the device. This ID is used to identify the device on the MQTT broker. | YES | YES |
| Publish Topic | Define the topic for publishing data to the broker. Devices subscribing to this topic will receive the data. | YES | YES |
| Message Format | Specify the format of the message being sent to the broker. For example: {Temperature: ~t0_val~, Humidity: ~h0_val~}. The values ~t0_val~ and ~h0_val~will be replaced by the actual temperature, humidity, and CO2 data from the device. | YES | YES |
| Username | Enter the Username for authentication if the MQTT broker requires security. | YES, If security is required. | YES, If security is required. |
| Password | Enter the Password for authentication if the MQTT broker requires security. | YES, If security is required. | YES, If security is required. |
| CA Certificate | Upload the CA certificate used to verify the broker’s identity. This is required for secure MQTT communication (MQTTS). | NO | YES |
| Client Certificate | Upload the client certificate used to authenticate the device to the broker in secure communication (MQTTS). | NO | YES |
| Client Key | Upload the client key associated with the client certificate for encrypted communication (MQTTS). | NO | YES |
Controlling the module through TELNET interface
The simple set of ASCII based human readable command sets supported by this module makes controlling relays easy via TELNET protocol very easy. The following sections give examples of how to use the module with PuTTY and TeraTerm.
To use this module with PuTTY, please follow the steps below.
- Connect the module to the LAN.
- Open PuTTY and enter the IP address corresponding to the module, leaving the port number as 23.
- Click Open.

- If everything goes well, you should be presented with a screen as below.
- Type in the TELNET User name and Password when asked and press enter key.
- Commands listed in the table in section “Sending Commands” can be entered here now. For example, here is the response for “ver” command.
- Using the relay module with TeraTerm is just as easy. Please follow the steps below.
TeraTerm is an open source software. A free copy can be downloaded from http://en.sourceforge.jp/projects/ttssh2/releases/
- Run TeraTerm and type in the IP address corresponding to the module in the “New connection” dialog and click OK.

- Then select the terminal setup from the setup button and make sure the settings are as shown below, and press OK.

- Type the User name and Password when asked.
- Press ENTER key and the command prompt should appear. Commands listed in the table in section “Sending Commands” can be entered here now. For example, here is the response for “ver” command.
Controlling through REST API commands
This module supports REST API commands.
Refer to the ‘REST API Command Set‘ knowledge base to know more.
Below is the example image related to controlling these modules through REST API commands.

fig 1: Displays device ID
Sending Commands
One of the most powerful features of this module is the simple easy to use command set it supports. This command set allows for a very simple interface to access the features of the module through TELNET protocol. The following sections give details of the command set and how to use the command set.
The command set
This product supports a very simple command set that is designed to be less cryptic and easy to use manually (using terminal emulation programs that support TELNET) or through a program written in one of the many supported languages
List of currently supported commands.
| No. | Command | Parameters | Example | Description |
|---|---|---|---|---|
| 1 | usr | get/set xxxxxxxx | usr get, usr set admin | Reads/Sets User name |
| 2 | pass | get/set xxxxxxxx | pass get, pass set admin | Reads/Sets Password |
| 3 | relay | on/off/status [relay number]/ on all/off all/ write [relay_group] [relay_map]/ pwron [relay_group] [relay_map]/ tmr get [relay_number]/disable [relay_number]/[relay_number] [mode] [delay_seconds] | relay on 000,relay off 000, relay status 000, relay on all, relay off all, relay write A 00ff, relay pwron A 00ff, relay tmr get 000, relay tmr disable 000, relay tmr 000 M0 2 | Relay Control |
| 4 | reset | none | reset | Reset relays to default state (all relays turned off) |
| 5 | gpi | gpi read [input number], gpi notify on/off/get | gpi read 000, gpi read, gpi notify on, gpi notify off. gpi notify get | Monitor General Purpose Input |
| 6 | info | none | info | Display information about the module including Smart Action and Power-on status |
| 7 | power | reset | power reset | Power reset does a soft-reset. |
| 8 | reboot | none | reboot | Exit the application mode and enter to the configuration interface and start the configuration via USB. |
| 9 | fact | reset | fact reset | Perform device factory reset Configure the module to factory default. |
| 10 | smart | get/-i/-r/disable/ [input] [mode] [target_output] [value] | smart get 000, smart -i 000, smart -r 000, smart disable, smart 000 L 000 1 | Read configured data, clear configured input, clear configured relay, disable entire smart action feature, configure smart feature |
| 11 | fs | get input_number/reset/disable/ [input] [mode] [relay_group] [relay_map] | fs get 000, fs reset, fs disable, fs 000 L A 0012 | Read status of IO failsafe, Manual Reset Failsafe, Disable Failsafe, Configure Failsafe |
The table below has more detailed information about available commands.
| No. | Command | Example | Description |
|---|---|---|---|
| 1 | ver | ver | This command returns the current firmware version of the device. Command Format verResponse Format xxxxxxxx – Firmware version string Description Returns the firmware version currently running on the device. Example ver Returns firmware version Notes The version format may vary depending on the firmware release. |
| 2 | id | id get id set xxxxxxxx | Id get reads the module ID. Id set will assigThis command is used to read and configure the device ID. Command Format id get id set xx – New device ID (exactly 8 characters) Description id get returns the current device ID. id set x updates the device ID to the specified value.Example id get Returns the current device ID id set DEV12345 Sets the device ID to "DEV12345"Notes The device ID must be exactly 8 characters in length. Changing the device ID may affect identification in connected systems or applications.n a new ID to the module. “x” stands for alphanumeric characters including symbols. The new ID must be exactly 8 characters in length. |
| 3 | usr | usr get usr set xxxxxxxx | This command is used to read and configure the device username. Command Format usr get usr set xx – New username (1 to 8 characters) Description usr get returns the current username configured on the device. usr set x updates the username to the specified value.Example usr get Returns the current username usr set admin Sets the username to "admin"Notes Username length must be between 1 and 8 characters. Changing the username affects authentication over the USB interface. |
| 4 | pass | pass get pass set xxxxxxxx | This command is used to read and configure the device password. Command Format pass get pass set xx – New password (9 to 31 characters, alphanumeric and symbols supported are !, @, ^, (, ))Description pass get returns the current password configured on the device. pass set x updates the device password to the specified value.Example pass get Returns the current password pass set admin1234 Sets the password to "admin1234"Notes Password length must be between 9 and 31 characters. Use a strong password to ensure secure access to the device. Changing the password affects authentication over the USB interface. |
| 5 | relay | relay on xxx | This command turns ON a specific relay channel. Command Format relay on xxxxxx – Relay number (Range: 000 to 007, numbering starts from 0) Description Turns ON the selected relay channel. Example relay on 000 Turns ON Relay 0Notes Ensure the relay number is within the valid range (000–007). The command immediately updates the relay state. If a relay is mapped to smart action or relay timer, manual control will be restricted |
| relay off xxx | This command turns OFF a specific relay channel. Command Format relay off xxxxxx – Relay number (Range: 000 to 007, numbering starts from 0) Description Turns OFF the selected relay channel. Example relay off 000 Turns OFF Relay 0Notes Ensure the relay number is within the valid range (000–007). The command immediately updates the relay state. If a relay is mapped to smart action or relay timer, manual control will be restricted |
||
| relay status xxx | This command returns the current status of a specific relay channel. Command Format relay status xxxxxx – Relay number (Range: 000 to 007, numbering starts from 0) Response Format on or offon – Relay is ON off – Relay is OFF Description Returns the current state of the selected relay channel. Example relay status 000 Returns status of Relay 0Notes Ensure the relay number is within the valid range (000–007). The response reflects the real-time state of the relay at the moment of execution. |
||
| relay status | This command reads the current status of all relays in a single operation. Command Format relay statusResponse Format A:XXXXXXXX – Current relay state (hexadecimal value) Description The returned value represents the state of all relays in the selected group. Each bit corresponds to one relay channel. 0 – Relay OFF 1 – Relay ON Example A:0000 – All relays are OFF A:00FF – All relays are ON Group Representation A – Group A (first 16 relays) Each bit represents one relay channel Value Range CR8: 0000 to 00FF (8-bit) CR16: 0000 to FFFF (16-bit) |
||
| relay writeall xx | This command reads the current status of all relays in a single operation. Command Format relay status Response Format A:XXXX XXXX – Current relay state (hexadecimal value) Description The returned value represents the state of all relays in the selected group. Each bit corresponds to one relay channel. 0 – Relay OFF 1 – Relay ON Example A:0000 – All relays are OFF A:00FF – All relays are ON Group Representation A – Group A (first 16 relays) Each bit represents one relay channel Value Range CR8: 0000 to 00FF (8-bit) CR16: 0000 to FFFF (16-bit) |
||
| relay on all | This command turns ON all relay channels. Command Format relay on allDescription Turns ON all relays in a single operation, regardless of their current state. Example relay on all Turns ON all relaysNotes This command immediately sets all relay outputs to ON. It overrides any previously set relay states. If a relay is mapped to smart action or relay timer, manual control will be restricted |
||
| relay off all | This command turns OFF all relay channels. Command Format relay off allDescription Turns OFF all relays in a single operation, regardless of their current state. Example relay off all Turns OFF all relaysNotes This command immediately sets all relay outputs to OFF. It overrides any previously set relay states. If a relay is mapped to smart action or relay timer, manual control will be restricted |
||
| relay write A 00xx | This command controls all relays in a single operation using a hexadecimal value. Command Format relay write G xxxxG – Relay group identifier A – Group A (relays 0 to 15) xxxx – Relay state value (hexadecimal) Description Sets the state of multiple relays simultaneously. Each bit in the hexadecimal value represents one relay in the group. Bit Representation 0 – Relay OFF 1 – Relay ON Example relay write A 00FF – Turns ON all relays in Group AValue Range CR8: 0000 to 00FF (8-bit) CR16: 0000 to FFFF (16-bit)Notes Each bit position corresponds to a relay channel within the group. Ensure correct bit mapping to avoid unintended relay switching. If a relay is mapped to smart action or relay timer, manual control will be restricted |
||
| relay pwron A 00xx | This command sets the relay power-on state for the module. Command Format relay pwron G xxxxG – Relay group identifier A – Group A (first 16 relays) xxxx – Relay state value (hexadecimal) Description Defines the relay states that will be applied when the device powers on or resets. Each bit in the hexadecimal value represents the state of a relay. Bit Representation 0 – Relay OFF 1 – Relay ON Example relay pwron A 0003 0000 0000 0000 0011 → Relays 0 and 1 ON, all others OFF Value Range CR8: 0000 to 00FF (8-bit) CR16: 0000 to FFFF (16-bit)Notes The configured state is applied on device power-up or reset. Ensure correct bit mapping to avoid unintended relay activation. If a relay is mapped to smart action or relay timer, manual control will be restricted |
||
| relay tmr get xxx | This command returns the current configuration and status of a specific relay timer. Command Format relay tmr get xxxxxx – Relay number (Range: 000 to 007, numbering starts from 0) Response Format Mx D:yyyyM:Mx – Timer mode (M0 [Delayed ON], M1 [Delayed OFF], M2 [Toggle]) D:yyyy – Delay value in seconds Description Returns the timer configuration for the selected relay. Includes the configured timer mode and delay value. Example relay tmr get 000 Returns timer status for Relay 0Notes Ensure the relay number is within the valid range (000–007). If no timer is configured, the response will indicate "timer not active". |
||
| relay tmr get | This command returns the list of relays with timer configurations. Command Format relay tmr getResponse Format Active timers: xxx xxx xxxxxx – Relay numbers with timer configured Description Returns a list of relay channels for which timer functionality is currently configured. Only relays with active timer settings are included in the response. Example relay tmr get Active timers: 000 002 005 Indicates that relay timers are configured on Relay 0, 2, and 5. Notes If no relay timers are configured, the response may indicate an empty or default state. Use relay tmr get xxx for detailed timer configuration of a specific relay. |
||
| relay tmr disable xxx | This command disables the relay timer configuration for the specified relay channel. Command Format relay tmr disable xxxxxx – Relay number (Range: 000 to 007) Description Disables the timer configured for the selected relay. Once disabled, the relay will no longer operate based on timer settings. Example relay tmr disable 000 Disables timer for Relay 0Notes Ensure the relay number is within the valid range (000–007). |
||
| relay tmr disable | This command disables the Relay Timer feature for all relay channels. Command Format relay tmr disableDescription Disables all configured relay timers. Once disabled, no relay will operate based on timer settings. Example relay tmr disable Disables all relay timer operationsNotes Use the timer configuration command to re-enable timer-based behavior. |
||
| relay tmr [relay_number] [timer_mode] [timer_delay] | This command configures the timer behavior of a specific relay channel, enabling precise control over relay operation based on time. Command Format relay tmr xxx mode delayxxx – Relay number (Range: 000 to 007) mode – Defines the operating mode of the relay timer M0 – Delayed ON M1 – Delayed OFF M2 – Toggle Timer delay – Time delay in seconds (Range: 1 to 3600 seconds) Description Configures time-based behavior for the selected relay channel. The relay action depends on the selected mode and delay value. Examples relay tmr 000 M0 1 – Turns ON Relay 0 after a delay of 1 second relay tmr 000 M1 4 – Turns OFF Relay 0 after a delay of 4 seconds relay tmr 000 M2 10 – Toggles Relay 0 every 10 seconds Notes Timer configurations are persistent and remain active even after a power reset. A configured timer continues to operate until it is explicitly disabled or the device is factory reset. If a relay is already mapped to smart action, relay timer cannot be configured |
||
| 6 | reset | reset | This command performs a soft reset of the device. Command Format rebootDescription Restarts the device without altering any stored configuration. All settings, including Smart Action, Timer, Failsafe, and credentials, remain unchanged. Example reboot Performs a device soft resetNotes The device will briefly disconnect and restart after execution. Use this command to recover from temporary issues or apply configuration changes. |
| 7 | gpi | gpi read xxx | This command reads the current state of a specific digital input (GPI). Command Format gpi read xxxxxx – Digital input number (Range: 000 to 007) Response Format 0 or 10 – Input is LOW 1 – Input is HIGH Description The command returns the instantaneous logic level of the selected digital input. Example gpi read 000 Returns 0 or 1 depending on the current state of GPI 0Notes Ensure the input number is within the valid range (000–007). The response reflects the real-time state of the input at the moment of execution. |
| gpi read | This command reads the current status of all digital inputs in a single operation and returns the values grouped by input channels. Command Format gpi readResponse Format A:XXXXXXXX – Current digital input state (hexadecimal value) Description The returned value represents the state of all digital inputs in the selected group. Each bit corresponds to one input channel. 0 – GPI LOW 1 – GPI HIGH Example A:00FF – All inputs in Group A are HIGH A:0001 – GPI 0 is HIGH, all other inputs are LOW Group Representation A – Group A (first 16 digital inputs) Each bit represents one input channel 0 – GPI LOW 1 – GPI HIGH Value Range CR8: 0000 to 00FF (8-bit) CR16: 0000 to FFFF (16-bit) |
||
| gpi notify on | This command enables digital input (GPI) change notifications. When enabled, the device monitors input state changes and sends a notification to the host whenever a change is detected. Command Format gpi notify onNotification Format A:XXXX/YYYYXXXX – Current input state YYYY – Previous input state Description A notification is sent only when a change is detected in any input bit. The value represents the state of all inputs in the group using hexadecimal format. Example A:00FE/00FF Previous state: 00FF Current state: 00FE This indicates that GPI 0 changed from HIGH (1) to LOW (0), triggering the notification. Group Representation A – Group A (first 16 digital inputs) Each bit represents one input channel 0 – GPI LOW 1 – GPI HIGH Value Range CR8: 0000 to 00FF (8-bit) CR16: 0000 to FFFF (16-bit) |
||
| gpi notify off | This command disables the GPI change notification feature. Command Format gpi notify offResponse Format Gpi Notify DisabledDescription Disables automatic notifications for digital input state changes. Once disabled, the device will no longer send updates to the host when input states change. Example gpi notify off Disables GPI change notifications |
||
| gpi notify get | This command returns whether the GPI change notification feature is enabled or disabled. Command Format gpi notify getResponse Format Gpi Notify Enabled or Gpi Notify DisabledDescription Returns the current status of the gpi change notification feature. Example gpi notify get Returns Gpi Notify Enabled or Gpi Notify Disabled |
||
| smart | smart get xxx | This command returns the current Smart Action configuration for a specific digital input channel. Command Format smart get xxxxxx – Digital input number (Range: 000 to 007) Response Format M:L R:000:HM – Input mode (L: LOW, H: HIGH, F: FOLLOW) R – Relay number H / L – Trigger value (HIGH / LOW) Description Returns the Smart Action settings configured for the selected digital input Includes operating mode, mapped relay outputs, and configured trigger values Example smart get 000 Returns Smart Action configuration for Digital Input (GPI) 0Notes
|
|
| smart get xxx raw | This command returns the current Smart Action configuration for a specific digital input channel in raw bit format. Command Format smart get xxx rawxxx – Digital input number (Range: 000 to 007) Response Format M:XM – Input mode (L: LOW, H: HIGH, F: FOLLOW) R – Relay mapping in bit format V – Trigger values in bit format Description Returns the Smart Action configuration for the selected digital input in raw bit representation. Each bit in R corresponds to a relay, and each bit in V defines the trigger value for the corresponding relay. Bit Mapping Bit 0 (Least Significant Bit) corresponds to Relay 0 Bit 7 (Most Significant Bit) corresponds to Relay 7 Example smart get 000 raw Returns Smart Action configuration for Digital Input (GPI) 0 in raw formatM:LDigital Input 0 is configured in LOW mode. Relay 0 is mapped with trigger value HIGH (1). Notes Ensure the input number is within the valid range (000–007). If no Smart Action is configured, the response will indicate I:000 not mapped. |
||
| smart get | This command returns the list of digital inputs that have Smart Action configured. Command Format smart getResponse Format Mapped IOs: xxx xxx xxxxxx – Digital input numbers with Smart Action configured Description Returns a list of digital input channels for which Smart Action is currently configured. Only mapped inputs are included in the response. Example smart get Mapped IOs: 000 001 007 Indicates that Smart Action is configured on Digital Inputs 0, 1, and 7. Notes If no Smart Action is configured, the response may indicate an empty or default state. Use smart get xxx for detailed configuration of a specific input. |
||
| smart -i xxx | This command disables the configured digital input for the specified channel. Command Format smart -i xxxxxx – Digital input number (Range: 000 to 007) Description Disables the selected digital input channel. Example smart -i 000 Disables Smart action mapped on digital Input (GPI) 0Notes Ensure the input number is within the valid range (000–007). |
||
| smart -r xxx | This command disables the configured relay for the specified channel. Command Format smart -r xxxxxx – Relay number (Range: 000 to 007) Description Disables the selected relay channel mapped to smart action. Example smart -r 000 Disables Relay 0 mapped to smart actionNotes Ensure the relay number is within the valid range (000–007). |
||
| smart disable | This command disables the Smart Action feature for all input channels. Command Format smart disableDescription Disables all configured Smart Actions. Once disabled, no digital input will trigger any relay output based on Smart Action logic. Example smart disable Disables Smart Action feature for all inputs |
||
| smart [input] [mode] [target_output] [value] | This command configures the Smart Action feature. Smart Action maps digital inputs to relay outputs and automates relay control based on input state. Command Format smart xxx mode target_output valuexxx – Digital input number (Range: 000 to 007) mode – Defines the trigger condition for the relay L – Trigger when input is LOW H – Trigger when input is HIGH F – Follow mode (relay follows input state) target_output – Relay to be controlled by the selected digital input (Range: 000 to 007) value – Relay output state when triggered 0 – Relay OFF 1 – Relay ON Not required in F (Follow) mode Description Each command links a digital input (same index as xxx) to a relay output. The relay action depends on the selected mode and trigger condition. Examples smart 000 L 000 1 – When digital input 0 goes LOW, Relay 0 turns ON smart 001 H 002 0 – When digital input 1 goes HIGH, Relay 2 turns OFF smart 003 F 003 – Relay 3 follows digital input 3 (LOW - OFF, HIGH - ON)Notes Digital input index corresponds to the input used in the command. Follow mode (F) continuously mirrors input state without delay. If a relay is mapped to relay timer, the same relay cannot be configured with smart action feature One relay can be mapped to only one input, One input can have multiple relays mapped to it |
||
| fs | fs get | This command returns the IO Failsafe configuration for the specified digital input. Command Format fs getResponse Format I:xxx M:X G:X V:xxxxI:xxx – Digital input number M:X – Trigger mode (L: LOW, H: HIGH) G:X – Relay group (e.g., A) V:xxxx – Relay state value (hexadecimal) Description Returns the configured failsafe settings for the selected digital input. Includes trigger mode, relay group, and relay output value. Example fs get Returns failsafe configuration for Digital Input 0Notes If no failsafe is configured, the response will indicate "FS Not Configured". |
|
| fs reset | This command performs a manual reset of the IO Failsafe condition to resume normal device operation. Command Format fs resetDescription Clears the active failsafe state triggered by a digital input. Restores normal operation of relay outputs and system behavior. Example fs reset Clears the failsafe condition and resumes operationNotes Use this command after resolving the condition that triggered the failsafe. If the trigger condition still exists, the failsafe may be reactivated immediately. |
||
| fs disable | This command disables the IO Failsafe feature completely. Command Format fs disableDescription Disables all configured IO Failsafe behavior. Once disabled, digital inputs will no longer trigger failsafe actions. Example fs disable Disables IO Failsafe featureNotes Use the configuration command to reactivate failsafe behavior. |
||
| fs [input] [mode] [relay_group] [relay_value] | This command configures the IO Failsafe feature, enabling the module to automatically set relay states based on a defined digital input condition. Command Format fs xxx mode G xxxxxxx – Digital input number On CR8, only Digital Input 0 is supported mode – Defines the trigger condition L – Trigger when input is LOW H – Trigger when input is HIGH G – Relay group identifier A – Group A (first 16 relays) xxxx – Relay state value (hexadecimal) Description Defines the relay output state when the specified digital input reaches the configured condition. Each bit in the hexadecimal value represents one relay. Bit Representation 0 – Relay OFF 1 – Relay ON Example Value 0003 – 0000 0000 0000 0011 Relays 0 and 1 ON, all others OFF Value Range CR8: 0000 to 00FF CR16: 0000 to FFFF Examples fs 000 L A 0012 When Digital Input 0 goes LOW, relays are set according to 0012 Relay 1 and Relay 4 turn ON, all others turn OFF fs 000 H A 0012 When Digital Input 0 goes HIGH, relays are set according to 0012 Relay 1 and Relay 4 turn ON, all others turn OFF |
||
| 8 | fact reset | fact reset | This command performs a factory reset of the device. Command Format fact resetDescription Restores the device to factory default settings. All configurations, including Smart Action, Timer, Failsafe, credentials, and other user-defined parameters, will be erased. Example fact reset Performs a device factory resetNotes The device will briefly disconnect, the LED will blink during the reset process, and the device will restart upon completion. Use this command to recover the device or reset all configurations. This action cannot be undone. |
| 9 | info | info | This command displays module information, including Smart Action status, Power-on configuration, and IO Failsafe status. Command Format infoDescription Returns a summary of key module configurations in a single response. Helps in quickly verifying system setup and operational status. Example info Returns module configuration summaryNotes The response format may vary based on firmware version. Use individual commands for detailed configuration of each feature. |
| 10 | power reset | power reset | Power reset does a soft-reset. |
| 11 | reboot | reboot | This command helps to exit the application mode and enter to the configuration interface and start the configuration via USB. |
Additional Information
Using GPIO's with switches
It is possible to read the position of a switch that is connected to a GPIO. A SPST or SPDT switch is recommended to use with GPIO’s. Push switches do maintain the contacts closed only for a very short time so using them is
discouraged. The fundamental idea of using a switch with GPIO is to have the switch cause a voltage level change at the GPIO pin when pressed. Usually this is achieved by using an external pull-up resistor along with the switch. The pull up resistor is connected between the GPIO and VDD and the switch is connected between the GPIO and ground. When the switch is not pressed, the pull-up resistor will cause the GPIO to stay at VDD voltage level. When the switch is pressed, the GPIO is short circuited to ground and stays at zero voltage. This change in voltage and thus the position of the switch can be read using “gpio read” command. Please see the recommended connection diagram below
Using relay modules with inductive loads
It is important to take additional care when using relays with inductive loads. An inductive load is pretty much anything that has a coil and works based on magnetic principles like Motors, Solenoids and transformers. Inductive loads produce back emf when the magnitude of the load current changes. The back emf can be in the order of tens or even hundreds of voltage (See this Wikipedia article http://en.wikipedia.org/wiki/Counter-electromotive_force). This effect is most severe when power is disconnected from inductive load because the rate of change of current is maximum at that point. Even though the back emf lives only for a very short time (a few milliseconds) it can cause sparks between the relay contacts and can deteriorate the contact quality over time and reduce the life span for the relays considerably.
So it is important to take countermeasures to suppress the back emf to acceptable levels to protect relay contacts.
Usually this requires connecting electronic devices in parallel with the load such that they absorb the high voltage components generated by the load. For solenoids, connecting a diode (fast switching diode is recommended) in parallel to the load (in reverse direction to the load current) is very effective. A diode used for this purpose is usually called a freewheeling diode. Please see the diagram on the right for connection details.
A capacitor with proper rating is recommended for protecting the relay contacts when a motor is used as load. The capacitor should be rated enough to withstand the back emf that is generated by the motor. Please see the diagram below for connection details.
Please note that the relay modules are NOT shipped with back emf suppression devices pre-installed. The exact kind of suppression device and the parameters of the selected device can vary depending on the load itself. Some of the parameters that affects the suppression device selection are the inductance of the load, power supply voltage, load current, physical size/structure of the load etc.. It is obvious that it is impossible for us to predict these parameters and design required back emf suppression device and incorporate that on the board. So we believe this is a task best left to the module user. There is an excellent article on designing back emf suppression on Wikipedia at http://en.wikipedia.org/wiki/Flyback_diode
FAQ
Q. I need a customized version of this product, can Numato do the customization for me?
A. Yes, we can definitely do customization but there may be minimum order requirements depending on the level of customization required. Please write to sales@numato.com for a quote.
Q. Where can I buy this product?
A. All Numato products can be ordered directly from our web store http://www.numato.com. We accept major credit cards and Paypal and ship to almost all countries with a few exceptions. We do have distributors in many countries where you can place your order. Please find the current list of distributors here.
Mechanical Dimensions

