The purpose of this tutorial is to walk a new user through the basics of setting up an instrument for use with the GradientOne platform. This tutorial will cover the following steps:
Overview of supported deployment options Step 1. Connect Your Instrument Step 2. Download the GradientOne Configuration File Step 3. Download and Install the GradientOne Client Confirm the GradientOne cloud recognizes the instrument Acquire screenshot Perform a quick test of instrument configuration and data acquisition
Overview of supported deployment options
Overview of supported deployment options GradientOne deployments require the following: • Internet access • Instrument (for this tutorial, it will be an oscilloscope) • Host computer • An Ethernet cable (for Mode 2)
Deployment Mode 1: Embedded Windows OS (Fig. 1)
In the Embedded Windows OS mode, an oscilloscope runs on a Windows based OS. The Windows functionality is available to the user just like any other computer. Example models include Keysight Infiniuum or Tektronix MSO5000 series. The GradientOne Client is installed on the oscilloscope’s Windows OS. In this mode the oscilloscope is connected to the Internet via an Ethernet cable.
In the Remote Host mode, an oscilloscope runs an OS that does not allow the user to install a GradientOne client. The oscilloscope is connected to a remote computer via an Ethernet cable.
The remote computer may run Windows or Unix. The GradientOne client is installed on the remote computer. Internet access is via Wifi on the remote computer.
Step 1. Connect Your Instrument (Fig. 2)
The first step requires Registering the instrument for use in your GradientOne instance. This will ensure proper recognition of your instrument as a unique device for processing commands and collecting data. To register your instrument, open a web browser on the host computer. GradientOne will supply you with a link to your web portal. An example would be: https://acme.gradientone.com. Navigate to the Assets page (https://acme.gradientone.com/assets) and click "Getting Started" (Fig.3).
The next step asks what you would like to do with this asset, in this case you will be using the GradientOne Instrument Control features, so click "Instrument Control" (Fig. 4).
The next step in Fig. 5 directs you to connect your instrument. Review the guidance provided here, and click "Done" when the instrument is connected and you are ready to move on to the next step.
Step 2. Download the GradientOne Configuration File
The next step (Fig. 6) directs you to Download the GradientOne Configuration File. The Configuration file is used by the host computer (Gateway) to establish the basic settings for the host computer to communicate successfully to the GradientOne cloud platform. By clicking “Download”, the file is downloaded and placed in the Downloads folder.
Step 3. Download and Install the GradientOne Client The 3rd step completes the registration and setup. Download and install the GradientOne client. Click the correct installer for your Operating System. (Fig. 7) and follow the install wizard procedure. It will prompt you to reboot your system and then navigate to the Assets page to see your instrument ready for use.
Confirm the GradientOne cloud recognizes the instrument After installing the GradientOne client and rebooting the host computer, the client should automatically start and be operational. You can confirm the successful operation of the client and instrument by navigating to the Assets Catalog page and viewing the table of Assets. You should see your instrument with a ‘Online’ status in the status column.
Feel free to enter specific details for Location and Lab, in this case, the location is San Francisco, and the lab is the HW lab.
6. Acquire screenshot Next to the ‘Online’ status you should see a “Screenshot” link. By clicking this link you will send a command to your oscilloscope that will result in fetching the screenshot and rendering it in your web browser. This is a quick test that confirms end to end functionality.
7. Perform a quick test of instrument configuration and data acquisition
Step 6 confirms the GradientOne cloud can communicate with the scope and acquire a screenshot. Next, attempt a more robust confirmation of functionality. Click on the Instrument from the Assets page and it should take you to the Controls page.
You should see the Instrument with “Ready” signifying it is available for use. Steps: i. Enable channel 1 using the front panel of your scope and connect it to a signal. On some scopes, such as a Rigol scope, on the right hand side of the front panel is a built in waveform lead. You may use that or any signal appropriate for your scope. ii. Click the menu on the right hand side and select Quickset. Quickset executes the instruments built in Autoscale functionality, yet configures a minimum point count for rapid confirmation of functionality. iii. Click Get Trace. This will send commands to your Gateway to configure the scope and then acquire the waveform, settings, and screenshot. iv. A successful Quickset should result in:
a. Waveform: A fully interactive visualization of the waveform that was just captured. With full zoom, commenting, and marker functionality.
b. Metadata: Includes measurements, scope settings, and other information pertinent to the acquisition.
c. Screenshot: Includes a screenshot of the test that was just performed. It is rendered side by side the waveform capture to confirm accurate and successful rendering of the data.
GradientOne provides features that detect the existence of a registered instrument.
Automated Instrument Discovery: If a properly working instrument is connected to an online gateway machine when the client is started, the instrument will automatically be detected and marked as Ready. If the instrument needs to be power cycled or disconnected/reconnected to the gateway for any reason, the gateway will automatically discover the instrument and mark it as Ready if it is functioning properly.
For instruments that also function as a gateway such as the Keysight/Tektronix instruments running on an embedded Windows OS, if the instrument is running the client and communicating with GradientOne servers then it is marked as Ready.
Manual Instrument Discovery:
There may be cases where a registered instrument is connected to a gateway that is already operating. A common example would be a laptop that is serving as a gateway is taken from one lab bench to another for use with a different instrument. In these cases, the user can click Discovery (Fig. 10) where the gateway performs the following functions:
Network broadcast check for VXI11 IP addresses over the gateway Ethernet port
*IDN? check on VXI11 based IP addresses
Mark as Ready the instruments that respond correctly
This section highlights a few of the common options for setting up network connectivity for your instrument and gateway machine.
1. Ethernet cable connecting the computer running GradientOne software to the instrument. In this example, the gateway computer is connected directly to the instrument via an ethernet cable and has internet access via its wifi connection.
Instrument configuration - instruments have different configuration menu options for users depending upon the vendor. Typically the user has the ability to configure a static IP address manually. In this example, the user would select the manual IP option and enter "192.168.5.2".
Windows configuration - the gateway machine in this example also has a static IP address set up manually. 1. Go to the Control Panel and click "View network status and tasks".
2. Click Change adapter settings.
3. Right click Local Area Connection and click Properties.
4. Select Internet Protocol Version 4 and click Properties. Enter the correct IP address information.
After entering the correct information and clicking 'OK', your instrument and gateway machine will be networked for proper communication.
2. Ethernet cable connecting the instrument to a network device that is on the same network as the gateway machine. In this example, the gateway computer is connected a network via wifi (shown below) or an ethernet cable and the instrument is connected via an ethernet cable to the same network.
Instrument configuration - in this case you we suggest you configure the instrument to use DHCP. If you are familiar with your LAN settings, manual configuration may also work.
OUR MISSION - GradientOne’s mission is to improve the work of engineers, manufacturing organizations, technical support teams, and scientists, by using cloud computing to streamline instrument management, data collection, analysis, reporting and search.