The Zaber Console is an application that lets you send commands to your Zaber devices, adjust their settings, and create simple scripts of commands.
Installing the application
- Microsoft Windows (any operating system that is compatible with Microsoft.NET Framework 4.0 or higher)
- Microsoft .NET Framework (Microsoft Common Language Runtime version 4.0 or higher)
- For other platforms, see section on Using Zaber .NET Library on Other Operating Systems.
- Available at the Release notes page
|Installation||Link||Receives Updates||Supported Operating Systems||Notes|
|ClickOnce||ZaberConsole.application||Yes||Windows XP, Vista, 7, 8, 10||Recommended|
|setup.exe||Use this if browser does not support .application links|
|Windows Installer||ZaberConsoleSetup.msi||No||Windows Vista, 7, 8, 10||Includes the ScriptRunner program|
|Source Code only||ZaberCSDemo.zip||-||-||-|
Using the Zaber Console
Open the port
To use the console, the first thing to do is to connect your Zaber devices to the serial port. Then start the Zaber Console application, select a serial port, and click the Open button. At that point, you should see a list of your connected devices. If some are missing, you may need to send a renumber command (see below).
- The top left contains the serial port connection and a list of connected devices.
- The top right contains the log. Every message to and from the devices shows up here, along with some other messages.
- The bottom half of the screen has a series of tabs:
- The commands tab lists all the available commands along with the details of how to use them. To execute a command, select the device in the list above, type a data value next to the command, and hit enter. Some commands don't require a data value.
- The device settings tab lists all the available settings along with the details of how to use them. To see the current settings, select a device in the list above, and click the Refresh Settings button. To change a setting, select the device in the list above, type a new value next to the setting, and hit enter.
- The scripts tab contains a list of scripts that you can run against the current device. You can create your own scripts by clicking on the Script Editor button. It will ask you to create a folder for your scripts, "My Documents\Zaber Scripts" is a good choice. Later sections describe how to write scripts.
- The advanced tab lets you send any command you like to any device number. It also lets you adjust some options.
- The help tab contains a description of the Zaber Console.
Sending a renumber command
All devices default to device number 1. If you are connecting more than one device, you will have to assign them new numbers with the renumber command. The simplest way is to select device number 0 and send the renumber command with data value 0.
Scripts can be used to send sequences of instructions to Zaber devices in order to automate a positioning application. You can also perform conditional actions and repeat the same actions multiple times using loop structures. Even if you're not a programmer, you can use scripts that someone else has already written.
Starting with Zaber Console v1.4.7 and firmware v6.18, you can download and apply firmware updates to compatible devices without having to RMA them. Full instructions can be found here.
Writing Custom Applications with Zaber .NET Library
If you want to write your own applications on the Microsoft.NET platform, Zaber Console includes a class library that you can use to talk to Zaber devices. You can also write your own plug ins that add new tabs to the Zaber Console.
- See subpage on source code for information on compiling Zaber .NET Library
- See subpage on plug ins for notes on Zaber Console plug ins
Using Zaber .NET Library on Other Operating Systems
- Make sure that the Mono runtime is installed. For example:
sudo apt-get install mono-complete
- Download Zaber Console source code and unzip it.
- Copy the scripts into the bin folder.
cp -R ../src/ZaberConsole/ZaberConsole/Scripts/* .
- Get ScriptRunner to list all serial ports. If you're using a USB-to-serial adapter, it should look something like
mono ScriptRunner.exe /showports
- Get ScriptRunner to list all its options by running
mono ScriptRunner.exe /help, or read ScriptRunner's documentation. Here's a simple example that runs one of the sample scripts.
mono ScriptRunner.exe /port /dev/ttyUSB0 /device 1 "Current device - move forward 10000.cs"
You can also use the Zaber library in your own projects written with MonoDevelop. See our source code page for more details.