User's Manual

Table Of Contents

Bome MIDI Translator: User's Manual 9 Actions

9.8 Serial Port

With the Serial Port trigger and action, you can trigger your translators from

arbitrary data received on a serial port, and send any data you like on a

serial port.

So you can easily implement a Serial-to-MIDI converter, and vice versa,

with just a few translators, or convert the serial data flow on the fly, or

control devices which only have a serial port.

9.8.1 Data Representation and Format

The serial port actions let you enter the incoming or outgoing serial port

data string in three different ways.

ASCII Text

In ASCII mode, you can enter arbitrary text into the Serial Port text field,

and it will be interpreted as a series of ASCII characters. Many terminal type

serial port devices and modems (initially) work in ASCII mode.

You should only use characters from the original ASCII type set. Special

characters and control codes can be entered by escaping them with

backslash: for ENTER, use \r\n or just \n. For entering a single backslash,

use \\. For entering an arbitrary byte, prepend the hexadecimal number

with \x. For example, to send a byte 175 ('AF' hexadecimal), use \xAF. The

hexadecimal number must have 2 digits. For entering longer binary data,

specify them byte for byte, e.g.:

\xFF\xF0Embedded Text\x00\x0A\x08\xF7

In ASCII mode, you cannot embed variables.

Data (numbers)

In this mode, you specify the serial port data as a series of bytes, separated

by a space. One byte is in the range 0 to 255. You can also specify

hexadecimal numbers by prefixing them with 0x. Local and global variables

can be embedded directly.

Example:

255 0x7F 10 20 pp g0 10