javastim Files

A preliminary jstim version. Requires installed java 1.6 or newer. If java is correctly installed on a windowed OS, just start the .jar file by (double) clicking. Otherwise start java with the jar file in the class path and specify the start class according to your system.

Start class is de.maramuse.jstim.jstim - you may run without arguments, in which case a GUI for up to 4 channels will show up.
The following arguments are supported:
gui1 - show a single channel GUI
gui2 - show a dual channel GUI
gui4 - show a 4 channel GUI
remoteport=stdinout - allow control via terminal commands on the keyboard. All parameters can be set on all channels, and the sound hardware can be selected via commands.

Some of the following arguments are recognized, but don't really work yet:

remoteport=<portnumber> - allow remote control via a terminal reachable on network tcp port <portnumber>
remoteport=<portname> - allow remote control via a terminal reachable over RS232 port <portname>
remoteaddr=<ipaddr:port> - use the GUI or keyboard terminal to remotely control another instance running on the machine with the mentioned IP address, listening on the mentioned port on said machine

If you have arguments but don't specify a GUI, the program runs headless (i.e. shows no GUI) and still reacts on control commands on the remote port that you specified. This allows for operation on (mostly embedded) systems that java swing GUIs aren't supported on.

The following commands are currently recognized, where <ch> is a channel number 0-3:
	TERMINATE,
	SET_ACTIVE <ch> <0/1> - activate(1)/deactivate(0) channel <ch>
	SET_AM1_FREQ <ch> <value> - set the amplitude modulation frequency 1 on channel <ch>
	SET_AM2_FREQ <ch> <value> - set the amplitude modulation frequency 2 on channel <ch>
	SET_AM1_DEPTH <ch> <value> - set the amplitude modulation depth 1 on channel <ch>
	SET_AM2_DEPTH <ch> <value> - set the amplitude modulation depth 2 on channel <ch>
	SET_AM1_SHAPE <ch> <value> - set the amplitude modulation shape 1 on channel <ch>
	SET_AM2_SHAPE <ch> <value> - set the amplitude modulation shape 2 on channel <ch>
	SET_FM_FREQ <ch> <value> - set the frequency modulator frequency on channel <ch>
	SET_FM_DEPTH <ch> <value> - set the frequency modulator depth on channel <ch>
	SET_FM_SHAPE <ch> <value> - set the frequency modulator shape on channel <ch>
	SET_PWM_FREQ <ch> <value> - set the pulse width modulator frequency on channel <ch>
	SET_PWM_DEPTH <ch> <value> - set the pulse width modulator depth on channel <ch>
	SET_PWM_SHAPE <ch> <value> - set the pulse width modulator shape on channel <ch>
	SET_FREQ <ch> <value> - set the base frequency on channel <ch>
	SET_AMPL <ch> <value> - set the base amplitude on channel <ch> 
	SET_PW <ch> <value> - set the pulse width on channel <ch>
	LINELIST - display a list of sound hardware devices
	SELECT <ch> <line> - select a sound hardware device for channel <ch> (only implemented for channel 0/1 and 2/3 as a stereo pair each, but specify only one of the affected channels)
	DUMP - dump the oscillator settings (to the remote control application, planned also: to a file)
	LOAD - not yet working, will load a dump file to the oscillators. You can already, however, create such files by copy/paste from the console, and just pasting back the content to the console reloads the dump.

On valid number values:
- a depth is always a floating point number in the range 0-1
- a shape is always one of the numbers 0-3, meaning none, up, down, updown
- base amplitude is a number in the range 0-1
- base frequency lies between 10 and 3000 (don't specify the implicit unit Hz)
- modulator frequencies are between 0.0625 and 50 (also unit is implicit and mustn't be specified)
Floating point values can be written in either English form (decimal point) or German form (decimal comma). No thousands separator is allowed.