octoBox_quadAtten_Users_Guide

octoBox_quadAtten_Users_Guide
 octoBox quadAtten User’s Guide octoScope, Inc. Jun-­‐2014 Contents Introduction ................................................................................................................................................. 3 Interfacing with quadAtten ......................................................................................................................... 3 quadAtten API .............................................................................................................................................. 4 Exit codes ..................................................................................................................................................... 4 Example code ............................................................................................................................................... 5 Troubleshooting .......................................................................................................................................... 6 Support ........................................................................................................................................................ 7 2 www.octoscope.com octoBox quadAtten User’s Guide Introduction octoBoxTM quadAtten module contains 4 programmable RF attenuators. The module can be powered and controlled either via USB or via Ethernet/PoE. Each attenuator can be individually assigned an attenuation value from 0dB to 63dB via USB control, IP Sockets, or a web based interface. Interfacing with quadAtten USB: •
When plugged into a USB port, quadAtten will appear as a Serial COM port when the octoScope USB driver has been installed. • Once installed, the ‘QuadAttenuatorControl.exe’ command line tool can be used to send commands and configure the device. Ethernet: • Once the IP settings of the device have been set using the USB control, quadAtten can be addressed via IP. • Once configured, navigating to the device’s IP address in a browser will bring up a web form to view and set the attenuation values for each channel. Alternatively, you can use the ‘-­‐d’ option on the ‘QuadAttenuatorControl.exe’ to select the IP address of the device you would like to work with. 3 www.octoscope.com octoBox quadAtten User’s Guide quadAtten API Command Example Description -­‐d -­‐d COM11 -­‐d QuadName -­‐d 192.168.15.56 -­‐d QA40516-­‐02 -­‐a 14.5 –c 1 -­‐a 14.5 -­‐a 14.5 –c 1 Selects the device to use either the com port, name, IP address, or serial number. If –d is not specified will look for a QuadAtten that is connected via USB. Specifies the channel to set. Sets the attenuation value. If no channel is specified will set all channels equal to this value. Sets the IP address of the device. Will take several seconds before takes effect. Sets the Gateway address of the device. Will take several seconds before takes effect. Sets the subnet mask of the device. Will take several seconds before takes effect. Sets a custom name used to help identify and address Attenuators. (Max 20 characters no spaces) Returns information settings of the device. (Name, serial, firmware, IP address, subnet, gateway, MAC address, Ch1/2/3/4 settings) -­‐c -­‐a -­‐i -­‐i 192.168.15.56 -­‐g -­‐g 192.168.15.1 -­‐s -­‐s 255.255.255.0 -­‐n -­‐n SignalAtten1 -­‐z -­‐z Exit codes Exit Code Description 0 Success 1 2 3 No device found Connection timeout Invalid Parameters 4 www.octoscope.com octoBox quadAtten User’s Guide Example code Command Prompt Set IP settings (Note, each command should be done individually and with time allowed for device to configure itself): IP Address: >QuadAttenuatorControl.exe –i 192.168.15.56 Gateway: >QuadAttenuatorControl.exe –g 192.168.15.1 Subnet Mask: >QuadAttenuatorControl.exe –s 255.255.255.0 Set device name: Sets the device name >QuadAttenuatorControl.exe –n SignalAtten1 Set attenuation: Set all channels to 14.5dB attenuation >QuadAttenuatorControl.exe –a 14.5 Set channel 2 to 14.5dB attenuation: >QuadAttenuatorControl.exe –a 14.5 –c 2 Set all channels on IP address 192.168.15.56 to 14.5dB attenuation >QuadAttenuatorControl.exe –d 192.168.15.56 –a 14.5 Device Selection/Display information: Automatically select the Attenuator connected via USB and display information: >QuadAttenuatorControl.exe –z Select the Ethernet device at IP address 192.168.15.56 >QuadAttenuatorControl.exe –d 192.168.15.56 –z Select the USB device on COM port 11: >QuadAttenuatorControl.exe –d COM11 –z Select the USB device with serial “QA40516-­‐02”: >QuadAttenuatorControl.exe –d QA40516–z Select the USB device with name “SignalAtten1”: >QuadAttenuatorControl.exe –d SignalAtten1 –z 5 www.octoscope.com octoBox quadAtten User’s Guide TCL: Example code to set attenuation values: #Designate quadAtten device set device 192.168.15.56 set device COM11 set device NA #will automatically find a device to send via USB set device SignalAtten1 set device QA40516-­‐02 #Set the attenuation values set atten 45.5 #Define the channel (optional) set channel 1 set result [exec QuadAttenuatorControl.exe -­‐d $device -­‐a $atten –c $channel] Troubleshooting QuadAttenuatorControl.exe command line tool does not launch: - The command line tool requires network access and access to connected devices, so make the command line program has been launched with administrative privileges. o To do this , goto: “Start Menu – type ‘cmd’ in the search field – right click and open as administrator – navigate to command line tool directory and launch tool. - QuadAttenuatorControl.exe program uses .NET 4.0 client. Please ensure this file has been installed. http://www.microsoft.com/en-­‐us/download/details.aspx?id=24872 Device is not responding (USB): - If QuadAtten appears as an unrecognized device, please install drivers: o Navigate to device manager: “Start – type ‘Device Manager’ in search field” o Check both “Other” and “Ports (COM&LP)” section for a device called “OctoScope QuadAtten”. o Right click on device and click update driver. o Select “Browse computer for driver”/”Manually select driver” o Navigate to folder containing ‘QuadAttenuatorDriver.inf’ in the installer. (Default path octoscope\Installers\) o Press ok to install drivers. o Reconnect QuadAtten 6 www.octoscope.com octoBox quadAtten User’s Guide If QuadAtten appears as a COM port but is not responding to ‘QuadAttenuatorControl.exe’ please ensure that no other programs are accessing the COM port resource (ie, putty, other scripts running) and retry. Device is not responding (Ethernet): - Use the ‘–z’ command while device is plugged in via USB to view and verify IP settings. - Check for a ping response (open command line prompt, type “ping xxx.xxx.xxx.xxx” where xxx is the IP address of the device. o If no response or there is a timeout, then check the following list: ! Device is powered ! Network path is resolved ! Gateway/Subnet Mask/IP are set properly o If no response, but settings are ok. Then cycle power (remove both POE and USB power) and try again. - If device settings are correct and responds to ping requests, then ensure that port 80 is open on the network (for web form interface) and port 5025 is open (for socket commands via the command line tool). -
Support For support, please call +1.978.222.3114 or email support@octoscope.com Visit us online at www.octoscope.com 7 www.octoscope.com octoBox quadAtten User’s Guide 
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising