This is part one of the installation tutorial on getting Goldsprints FX installed and running on your OS of choice.
First we need to get Serproxy running. Serproxy is a Serial to Socket Server and is required to get GFX up and running. There are a few serial to proxy servers out there but Serproxy is the one I recommend. Serproxy sits on the other side of the USB port and gives us a way to communicate with the OpenSprints hardware. In the case of GFX we are giving Flash a way to get and send data to the OpenSprints hardware.
There is no installation process for Serproxy, simply download the Serproxy archive, and then unpack it somewhere readily accessible on your computer. The location doesn’t matter as long as you remember where it is. You’ll find an executable as well as a configuration file called “serproxy.cfg”.
Open the “serproxy.cfg” file using a text editor. Take a look at the different parameters. This is what my cfg file looks like on my OS X machine.
Start editing the file to match my settings you see in the screen shot above. Everything should be the same except maybe the “serial_device1” at the bottom. Serproxy needs to know where to find your USB port on the machine that is connected to the OpenSprints hardware.
To find what USB port you have the OpenSprints hardware connected to make sure your OpenSprints hardware is connection to your computer. Then depending on what OS you are running do one of the following:
OS X: Open Terminal and enter “ls /dev/cu.usb*”. You’ll probably only find one entry listed, and this is the label that your machine gives the USB port to which the OpenSprints hardware is connected.
Windows: [coming soon] – I don’t have a Windows machine so I am not sure how to get the label. Look for an update soon.
Ubuntu: You might have to do this as root. Open Terminal and enter “ls /dev/ttyUSB*”. You’ll probably only find one entry listed, and this is the label that your machine gives the USB port to which the OpenSprints hardware is connected. Most likely it will be ‘/dev/ttyUSB0’.
Enter the lable into the “serial_device1” line in your cfg filie. That should do it. Save and close the cfg file. Now launch the serproxy executable. You should see something like this. Again, this is on OS X and about the same as Ubuntu.
Anytime you run GFX you need to have Serproxy running. Otherwise GFX cannot communicate with the OpenSprints hardware.
Check out the second part of this tutorial to get GFX installed.