login

online now

We have 87 guests and no members online

search

 

2_tweakerlets start tweaking

To get tweaking, you just need to follow a couple of simple steps. The tweaker program itself is a java application that runs on your PC and uses the PCLink application running on your Arduino to connect it to the GinSing shield. Due to an implementation limitation on the Arduino, you will need to place a capacitor in two of the header pins when running PCLink to maintain a stable serial link.

installation steps

1. download and install the latest software

2. load and run PCLink on the Arduino

3. insert a capacitor

4. launch the tweaker program


InstallIconstep 1. download and install the latest software

GinSing Tweaker is now packaged as part of the standard software distribution as of Version 4.0. If you are running an earlier version of GinSing, you should begin by downloading the latest software from the download page and install it. When you do, you will get updated libraries, updated sample programs (including PCLink) and a desktop folder that contains the tweaker program. To install the software, follow the instructions on the download page.


download GinSing Software


PCLink Load LoResstep 2. load and run PCLink on the Arduino

The PCLink program must be active on the Arduino to allow the tweaker and the GinSing board to talk to each other. To get the program installed and running on the Arduinio, first launch the Arduino IDE and select the menu option:

File -> Sketchbook -> GinSing -> PCLink

A window will appear that contains the source code for the PCLink application. Next, click the upload button ( the arrow pointing to the right ). The appplication will first compile, and then download and start on the Arduino. You should be able to hear the PCLink program speak some simple instructions on the next step ( installing the capacitor ). Take note at the bottom of the IDE window as to what port you are using to program the Arduino - this will be used to initialize the tweaker on the same port.


consoledongle

step 3. insert a 10 uF capacitor ( UNO Arduinos )

The USB serial interface provided on the Arduino does not support the DTR function that is required for proper operation with the tweaker console program. Without this capacitor, the tweaker will not find the GinsSing board.

The required 10 uF electrolytic capacitor is commonly available at most electronic parts stores such as Radio Shack.  The capacitor is inserted into the board header as pictured here on pin 1 (RESET) and pin 3 (5V). The orientation of the capacitor should placed such that the negative lead is in the RESET pin on the header. You can identify the negative lead as it will have a light colored banner on the case next to the pin and will be denoted with a (-) sign.

Note that while this capacitor is inserted, you will NOT be able to load programs down to the Arduino - it should be removed when not running the tweaker program!


Tweaker Comm Selstep 4. launch the tweaker program

The Ginsing intallation will create a folder on your desktop that contains the tweaker program. On a PC, the program appears on the form of an executable file that you can simply double-click to launch. On the Mac, it appears as a Java file that you also double-click to launch. Once the program is launched, you will be provided with onscreen instructions that will prompt you to ask to select the communication port, which should be selected as the same one you used to install the PCLink.

You can now begin exploring the interface - its mostly self explanitory (with tooltips), but if you get stuck you can refer to the user guide referenced at the top of this page.

Now that you're hopefully up and running, check out the tweaker users guide.