Whisker.io® is designed to be the easiest to use IIoT solution platform on the market. In this article, we will select the proper Whisker.Block™ sensors for a simple application, create an account at www.whisker.io, add a new location, and provision the selected sensors.
Sample Project
The Whisker.io® IIoT ecosystem includes a wide variety of components that can be used in almost any application.
For the purposes of this walk-through, our application will be remote monitoring of a tank battery, two pumps and a PLC. We will select the proper Whisker.io® products to monitor:
- Tank 1 Level - this is measured with a pressure transducer that outputs 4-20mA
- Tank 2 Level - this is measured with a pressure transducer that outputs 4-20mA
- Pump 1 Run - this is a digital output to indicate the pump's actual running status
- Pump 2 Run- this is a digital output to indicate the pump's actual running status
- PLC Tags - several internal tags (mode, speed settings, etc) to be read via Modbus RTU (RS-485)
This is a very simple application where our only goal is to monitor these values in the cloud based IoT platform so that technicians and operators can see this data remotely using a computer or mobile device. Our Smart.Hub™ is capable of communicating sensor data to other endpoints using MQTT, Modbus TCP, and Ignition|SparkPlugB, but for this application we will only be using the MQTT protocol to communicate to our Whisker.io®
The Whisker.Block® is a wireless IoT sensor that can have as many as 16 I/O channels per device. It collects data from the connected sensors and periodically forwards that data to the cloud via a Smart.Hub. Triggers can be set on the Whisker.Block™ to cause instantaneous transmission if a digital or analog input meets user defined requirements.
In this simple application, the two pumps and the tank battery are located about 2 miles from the cabinet that houses the PLC, so we will need one Whisker.Block to monitor the pumps and tanks, and another to monitor the PLC. The Smart.Hub™ will be located with the PLC because a 20 foot pole already exists for mounting.
All of our products can be purchased from our online store: www.d6labs.com/store. We have conveniently grouped our products by category and available I/O, making it easy to quickly identify the components we need.
The remainder of this article is a step-by-step walk-through of the entire process of selecting and buying the required devices, setting up an account, adding a location to an account, and adding and provisioning devices.
Step 1 - Select a Smart.Hub
The first thing we need to do is select a Smart.Hub™ IIoT gateway. When you select the Smart.Hub category you will see that several options are available:
The Smart.Hub™ Pro gateway is designed for indoor, commercial applications. It is powered by an external 5V wall transformer and is not IP67 rated. This hub does not support Modbus TCP or Ignition|SparkPlugB and is typically not used in industrial applications.
The Smart.Hub™ Industrial gateway is designed for outdoor, industrial applications. It can be configured with multiple power and communication options:
- Power supply:8-30V DC - 110/220VAC - PoE options
- Communications:Ethernet or 4G wireless
For our application, we will use the Smart.Hub™ Industrial -DC, 4G (sku WH1-9-00-IDNCN-N) model because it will be powered from the same power supply that the existing automation is using and it needs a cellular connection because there is no Internet available at the location. Let's add that to our cart.
Step 2 - Select Whisker.Block Sensors
For this application, we need a Whisker.Block™ that has two 4-20mA inputs (water tower) and two dry contact inputs (pump run statuses). Returning to the home page of the store, we need to select the Whisker.Block IoT Sensors category, which will show variety of options:
To make things easier, click on Search Products and type "20mA" in the search filter to get a listing of all of the Whisker.Blocks with 4-20mA inputs. The lowest cost option is the WB1-9-00-DCDCA4A4-0000-XR, which has the required inputs. It is battery powered, so external power is not required, and it has an external antenna to improve range.
We also need a Whisker.Block® to monitor the PLC. Type "Modbus RTU" in the search filter to find the WB1-9-0D-MBNNNNNN-0000-XR. This device is powered from 8-30V DC (not internal battery power) and also has an external antenna for improved range.
Add both of these devices to your card.
Step 3- Checkout
The checkout process is simple and intuitive, but if you have any problems, please feel free to call us at 1-844-365-8647 or email us at [email protected] for help.
All products include the 1st year monitor for free. After the first year, you will be charged a small annual fee for each monitored device. Annual monitoring fees vary with the I/O configuration and are clearly identified on each product page.
Once your order is placed, our team will create a custom "self install kit" that contains the Whisker.Hub™, Whisker.Blocks®, and any required accessories. Every kit is assigned a unique serial number which greatly simplifies installation and provisioning.
If we have the products in stock, a kit usually ships within 24-48 hours.
Step 4 - Create Account at www.whisker.io
In order to use the Whisker.io™ IoT portal, you will need to create an account. Using any browser, open www.whisker.io and click 'Register for one' on the login screen.
This will take you to the account registration form:
The registration form will ask for your company information and your personal contact information. The company information is used for billing and support purposes and your contact information is used by our alerting system to send text and email alerts.
Once you have completed the registration form, you will receive an email with your temporary password. Return to the login screen at www.whisker.io and enter your email address and temporary password to login.
When you login for the first time (or if our subscription agreement changes), you will be asked to review and accept the Subscription Agreement as follows:
Once you have read the agreement and accept its terms, click the checkbox in the bottom left of the form.
Next, you will be asked for a credit card that will be used to pay your monitoring fees. The first year's fees are waived for new products, so you will not be charged for 12 months. We do not keep your credit card information in our database. It is validated through Authorize.net and we are given a token we can use to charge your card in the future. This protects your credit card information from being obtained in the unlikely even our servers were compromised.
Enter your credit card information and click 'Next'.
Since you were assigned a temporary password at the start, the last step is to create a permanent password for your account.
Once you have reset your password, your account is ready to use.
Step 5 - Login and add a new location
You should now be logged in and your screen should look something like this:
This is called the Enterprise View. Once your locations and devices are setup, it will show a color coded icon for every location in your enterprise, with the color indicating the status of the devices at that location.
To add a new location, you need to center the map on the place where you want the new location to be. Click 'Center Map' and then click 'Address/Coordinates' to enter your location's address. When you are finished, the map should be centered on that address.
Click 'New Location' and then click on the place on the map where you want the location to be. Once you click on the map, a dialog box will open and ask for a name for the location. For this example, I am using the name 'Site 1'. Now you will see a blue circle (blue means the location is new) representing your location.
With the location created and configured, we can now add devices to the location. Click on the blue circle and then click the link in the pop-up to drill down to the Location View.
Step 6 - Add Devices to New Location
You will need the Self Install Kit to complete the next step. Once you have that in hand, login and drill down to the location as explained in the previous steps.
The Location View provides several different ways to visualize sensor data as well as the tools to provision and configure Whisker.Block™ devices.
Before you can visualize sensor data from our recently purchased devices, you must first provision new sensors in the Location View.
Once you have your devices provisioned, you can setup the map view and start building HMI views.
The following video provides a complete walk-through of this process.