It has come to my attention recently that there are some LCD display modules on sale that are ‘Common Cathode’ types (e.g. this one from SparkFun) , rather than the more common ‘Common Anode’ type (e.g. this one from Adafruit).
Why would you care about this?
Because the two types of display essentially operate with ‘inverted’ logic signals relative to each other, you will probably find that your LCD display is very dark after you upload the ‘wrong’ Automation code. Essentially the ‘common cathode’ type is insisting that white is black and black is white – just like some people we know!
If you’re got an RGB display then all the other colours will not appear as intended either and they won’t match what’s stated in the User Guide.
As a result I’m now providing two versions of the Automation code on the Updates page so make sure you use the correct one for your LCD type.
If, after uploading, your screen is very dark then try the other version.
A handy feature I’ve added to the code (thanks to Eric Thacker for prompting me to implement it), the unit now ‘remembers’ the last preset or user patch that you used and starts up with this when it’s next switched on, rather than always defaulting to Preset 0: Apache. This is actually very convenient if there is a favourite patch you use a lot 🙂
This is a minor improvement to the Automation firmware (software) for the Arduino in your EchoTapper. Taking up a useful suggestion from my Finnish friend Rolf Holmberg, I have changed the number range displayed for the Mix, Program and Feedback knobs, when editing a patch in either the Basic Editor or Advanced Editor modes..
Previously the values were displayed using a range of 0-255 but now the values are shown in a 0-100 range. This should make it a little easier to ‘translate’ from a patch setting to a knob position on a non-automated eTap2HW and vice versa. For example if someone says “I set Feedback to 3.5 for that tune” you can use a value of 35 when setting up a similar patch.
Firmware Version 3.21
Thanks to Rolf and Steve for testing Librarian on Windows XP and Windows 7. We discovered a problem in that if there was only a single enabled COM port on the user’s computer the Librarian failed to connect to the attached EchoTapper. This has been resolved in the latest Version 2.50 of the Librarian and we can confirm that it works on Win XP and Win 7.
Click here to download the Windows (32 bit) Librarian version 2.50. The package should be unzipped to any convenient location on your computer where you will then find a folder called application.windows32. Open this and double click the .exe file to run the Librarian.
- If the Librarian only detects a single active COM port when it starts it will attempt to connect to it. If this is your Arduino then it will reset the Arduino and contact will be established. You can hit the EchoTapper’s Down button (or turn the encoder CCW) during the Welcome message or just wait and hit the Librarian’s Get Patches button to transfer patches from the Arduino to the Librarian.
- Of course it’s possible that you haven’t connected your Arduino yet so there may be a COM port but not the Arduino’s port. In this case the attempted connection will obviously fail. To update the list of COM ports hit the new orange Re-scan button (see screenshot) and you should now see a new port in the list which will be the one that your Arduino is attached to. Now select it from the drop down list and the connection will be established between the Librarian and the Arduino. As in 1, you can hit the EchoTapper’s Down button (or turn the encoder CCW) during the Welcome message or just wait and hit the Librarian’s Get Patches button. Please ensure you do not click the Re-scan button while your Arduino is still starting up after plugging it in as this may cause problems. Wait until the Welcome message has disappeared and the Arduino is then ready to rock and roll 😀
- If the Arduino is connected when you start the Librarian and you have more than one COM port, the Librarian will not attempt to make contact as it won’t know which COM port it should use. In this case you must select the correct COM port yourself from the Drop down list and this will initiate contact with the EchoTapper and you can then proceed as before.
Version 2.40 of the EchoTapper Patch Editor/Librarian software is now available for download (see links below) and is regarded (by me :-D) as the final release version with all planned features now included.
The big addition in this finished version (is software ever ‘finished’ though? ;-)) is the ability to re-arrange the order of your patches. This requested feature will be very useful for example if you need to create set-lists for gigs, making it easier to group the patches together and in the best order for the tunes in the set-list.
Version 2.40 – 27/10/2013 (Release Version)
– Added patch number field. Changing it will allow the order of patches to be re-arranged.
– Added error checking for bad patch number being entered and other user goof ups!
– Fixed bug that failed to update patch name, knob values labels after use of Get Patches.
– Re-coded the file input routine to use the embedded patch number (location).
Updated Librarian User Guide
Librarian Software 2.40: Windows 32, MacOSX, Linux 32, Linux 64
Automation Firmware 3.20 (required), Updated Firmware User Guide
Please use the Latest Updates Here link in the banner above, rather than the out of date links below.
Update 24th October 2013: Some bug fixes and extra features added. The links below now point to the latest Version (2.3) of the Editor/Librarian. The EchoTapper Version 3.20 Arduino code has not been changed so there’s no need to update your eTap2HW hardware. I’m looking for anyone using my Automation software with their eTap2HW-based echo units to try out this preliminary release of a software application which I am calling the EchoTapper Patch Editor/Librarian. I have written it in response to a number of requests from users of my automation code to enable them to back-up and re-arrange their User Patches, for example to create personal set lists. Although not yet having all the planned features included, the current version allows patches to be transferred to and from the eTap2HW via the USB connector on the Arduino Uno, and it also allows them to be saved to and loaded from disc. In it’s Editor role the software allows patches to be renamed and fully edited, for example, by changing the echo model and adjusting the echo parameters. It simulates the three main knobs on the ‘real’ eTap2HW control panel. In order to use the Librarian with your eTap2HW you will need to upgrade the EchoTapper automation software to version 3.20 or later. The Librarian requires you to have Java installed on your computer and versions of the Librarian are available for Windows 32, MacOS X and Linux. As I don’t have access to MacOS X or Linux, these versions have not been tested yet and the Windows version has only been tested on Windows XP Professional. I would appreciate feedback on the software running on any of these operating systems so if you are able to help please download the relevant version and leave your feedback in a comment, remembering to state what OS you are using and details of your experiences and suggestions for improvements, if any. Thanks and enjoy 🙂 Philip Librarian User Guide Automation Software Version 3.20 (There seems to be a problem with the old upload tool I previously recommended so please try XLoader which is available here and is very simple to use.) Librarian Windows Version Librarian Mac OS X Version (NB Please read the readme file for important information to enable it to run on the Mac) Librarian Linux 32 Version Librarian Linux 64 Version
Steve Mitchell and I have been evaluating the presets that we supplied based on suggestions from Dave Robinson and we have concluded that, due to a difference in the scales on Dave’s early EchoTapper unit (1-12) and that on our own designs (0-10), that we needed to adjust our presets. This version 2.50 addresses that issue and we think the presets now sound much better (and probably closer to what Dave intended). We hope you agree 🙂
Download the Version 2.50 code here
Also check this post for how to upload the code to your Arduino.
Click the link below to download the latest compiled Arduino hex code (Currently version 2.40).
Get Code (you will need to unzip the code before you can upload it to your Arduino).
Note: if you are using an RGB (colour) LCD display you should connect pin D4 on the Arduino to ground (GND), otherwise leave D4 floating if using a mono LCD display. The code checks this pin at power-up and will use the colour features of the display, if it finds one, to highlight the different operating modes of the EchoTapper unit.
To upload this code to your Arduino you need a suitable uploader. Update 20/10/2013: I previously recommended the Arduino Uno Uploader tool but it seems to no longer work so now please use XLoader which can be downloaded here.
By using this tool you don’t need to know how to compile source code, just connect the USB port on your EchoTapper’s Arduino UNO to your Windows PC and use the tool to upload the hex code to the Uno. The Uno will automatically reset and start running the new code. You can check it worked by looking at the version number given in the start-up message.