At this point, you should have the following items complete.
- Keithley Datalogger firmware upgraded
- Initial State App installed and running
- Registered for an Initial State IoT Streaming Account
- Make sure the Keithley instrument is connected and addressable through LAN. To check this go to Menu >> Communication >> LAN on the unit.
All of the above items are one-time setup tasks. The next step may not be one-time for everyone but at least it is a setting that rarely changes for most. I am warning you - it is a little tedious :), but once it's done - you are off to the races.
Configure your Initial State Access Key on your Keithley Instrument
- Get your Initial State access key. Navigate to initialstate.com >> Sign in >> Account Menu >> My Settings >> Access Keys
- On the Keithley instrument, navigate to the Initial State home screen menu. Note: If this menu is not present you may need to go to Apps >> Initial State >> Run to make it appear on the bottom swipe-able home screen menu.
- Click Access Key.
- This is where it gets tedious... You need to transcribe the access key from Initial State exactly into the dialog box. The input here is case sensitive. Since I've personally done this a number of times during testing i'll give you a few hints.
- PRO TIP - You can send access keys through a TSP commands. On a computer go to the LXI page by typing the instrument IP address into a browser URL. On the left side of the page click "Send Command". Send the following command to the instrument initialstate.accesskey = "Your_Access_Key". This is by far the easiest way to get the Access Key loaded into the instrument.
- MANUAL TIP - Try using the Virtual Panel. To access, type the IP Address of the instrument into the your URL bar of a browser on a computer connected to the same network. I found it a little easier to have the Access Key on the same screen as the the Keithley keyboard. You do have to use the mouse to click the keyboard buttons on the virtual panel.
- MANUAL TIP - The dialog that allows input of the Access Key dismisses itself after exactly 2 minutes (120 seconds). Since the Access key is so long, try typing a subset, hitting OK, then entering the rest. It is very frustrating to be almost complete and the dialog disappears on you.
Define your Bucket Key
Give your stream a name. This is what will show up in the Initial State user interface as the name of your data. For my testing purposes I set the Bucket Key to "Keithley Test Bucket."
Set Up a Scan with "Export Destination" Set to "Initial State"
I am not going to to go into detail about setting up a scan. This is a standard concept of the Keithley datalogger. Navigate to Menu >> Channel >> Scan. From there you can set up a scan that targets Initial State. For testing purposes, I picked a few channels, and set the scan to last 10 seconds by setting the "Scan Count" to 20 and the "Scan to Scan Interval" to 500 ms. The most crucial part is to set the "Export Destination" to Initial State.
Start the Scan
There are a number of ways to begin the scan. One is the start button just below the channel groups. If everything is set properly, the scan will begin and no errors will show on the screen.
NOTE: The most common error is the instrument will report that it received a non-2xx response from the server. Most of the time, this is an indication that you have typed in the Access Key incorrectly. Remember things like capital I's and lowercase l's can look the same and skinny 0 is a zero where more circular means an O.
Check your Progress in Initial State from Anywhere
Now is the time to log in to your Initial State account and see your new data coming in. You can log in from anywhere including your phone. Initial State graphs will update in real-time. You can rename the bucket if you like, start creating a dashboard, or create derived signals from math expression on the data. All of these configurations will be respected as new data comes in. Perhaps you are doing measurements that take hours or days. Check in on things to see from the comfort of your couch at home while watching Netflix :).