Eventide Remote Control

Overview

Eventide Remote Control (ERC) is a multi-platform application to send control messages to the Eventide Harmonizer and to receive and publish information from the Harmonizer. A simple macro language is provided to automate repetitive tasks.

Release Goals

In order to gain momentum and to get user feedback, ERC will be released as soon as possible with the minimum function required to be useful. Planned release roadmap:

The first release will have a simple user interface - an array of buttons and a display area for screen dumps from the harmonizer.
Customizations for different Harmonizers - display a graphic of each harmonizer and provide appropriate buttons.
Multiple document interface - control multiple Harmonizers from one instance of ERC. (NOTE: Will MIDI connection be fast enough for screen dumps?)
VST/AU interface.
Integration into combination editor/librarian/remote/routing control program.

Macro Language

The first version of the ERC macro language will only provide commands to send keypress values and to request screen dumps from the Harmonizer.

Subsequent versions will add global variables (e.g. quiet vs. verbose operation - not updating the screen dump between keypresses) and simple math functions ("for(patch=1;patch<1024; patch++) get patch;").

In order to provide the maximum flexibility, the ERC macro language is being designed to allow stand-alone command line use.

Macro Commands

Comments: comments are preceded by the character "#" and continue to the end of that line.

Functions: functions are named group of commands with variable substitution.

Numbers: To distinguish them from math and script control commands, all keys on the numeric keypad will be referred to by their text name ("one", "two", etc).

Press command: keypresses will be preceded by the command "press" - for example, to tell the Harmonizer that the first soft key should be used, the command is "press soft1".

Send command: for non-keypress commands "send" is used.

send patch - uploads patch to Harmonizer. If a file name is specified on the command line, the patch will be loaded from that file. If no name is specified, the patch is sent from the memory buffer.
send sysex - sends sysex string to Harmonizer. If a file name is specified on the command line, the sysex will be loaded from that file.

Get command: to retrieve information from the harmonizer, use the "get" command.

get screen - retrieves screen dump from Harmonizer. If a file name is specified on the command line, the screen dump will be saved to that file. If no name is specified, the dump is displayed on screen.
get version - retrieves firmware information from the Harmonizer.
get patch - gets currently loaded patch. If a file name is specified on the command line, the patch will be stored in that file. If no name is specified, the patch is loaded into the memory buffer.

Appendix: Keypress Numbers

(Taken from Technical Notes 94 and 98.)

Common Keys

4-BYPASS/MUTE	9	FFFFFDFF
8-BYPASS		FFFFFDFF

4-SOFT1		26	FBFFFFFF
8-SOFT1			FBFFFFFF
4-SOFT2		18	FFFBFFFF
8-SOFT2			FFFBFFFF
4-SOFT3		10	FFFFFBFF
8-SOFT3			FFFFFBFF
4-SOFT4		2	FFFFFFFB
8-SOFT4			FFFFFFFB

4-PROGRAM	27	F7FFFFFF
8-PROGRAM		F7FFFFFF
4-PARAMETER	19	FFF7FFFF
8-PARAMETER		FFF7FFFF
4-SELECT	8	FFFFFEFF
8-SELECT		FFFFFEFF
4-SETUP		11	FFFFF7FF
8-SETUP			FFFFF7FF

4-ONE		31	7FFFFFFF
8-ONE			7FFFFFFF
4-TWO		23	FF7FFFFF
8-TWO			FF7FFFFF
4-THREE		15	FFFF7FFF
8-THREE			FFFF7FFF
4-FOUR		30	BFFFFFFF
8-FOUR			BFFFFFFF
4-FIVE		22	FFBFFFFF
8-FIVE			FFBFFFFF
4-SIX		14	FFFFBFFF
8-SIX			FFFFBFFF
4-SEVEN		29	DFFFFFFF
8-SEVEN			DFFFFFFF
4-EIGHT		21	FFDFFFFF
8-EIGHT			FFDFFFFF
4-NINE		13	FFFFDFFF
8-NINE			FFFFDFFF
4-ZERO		20	FFEFFFFF
8-ZERO			FFEFFFFF
4-DOT		28	EFFFFFFF
8-DOT			EFFFFFFF
4-ENTER		4	FFFFFFEF
8-ENT			FFFFFFEF
4-CXL		5	FFFFFFDF
8-CXL			FFFFFFDF
4-MINUS		12	FFFFEFFF
8-MINUS			FFFFEFFF

Changed labels

4-RIGHT >	24	FEFFFFFF
8-NEXT			FEFFFFFF
4-< LEFT	16	FFFEFFFF
8-PREVIOUS		FFFEFFFF
4-DOWN		6	FFFFFFBF
8-DEC			FFFFFFBF
4-UP		7	FFFFFF7F
8-INC			FFFFFF7F

Changed bits

4-LEVELS	0	FFFFFFFE
8-LEVELS	1	FFFFFFFD

4000 only?

4-PATCH		3	FFFFFFF7
8-PATCH			FFFFFFF7
4-USER1		25	FDFFFFFF
8-USER1			FDFFFFFF
4-USER2		17	FFFDFFFF
8-USER2			FFFDFFFF

8000 only

8-DOWN			FFFEFDFF
8-UP			FEFFFDFF
8-MACHINE (A/B)		FDFFFDFF

Bit Patterns

0 is key pressed.