The MidiShare WAN Driver provides real-time
network communication to MidiShare client applications over the
Internet. Remote host connection is controlled by the user using
the msWANDriver.ini file. Once connected to a remote host, it
will appear as a MidiShare port.
At connection time, the driver establish both a TCP and a UDP
socket between the local and the remote host.
Real-time transmission of the MidiShare events stream relies on 2 mechanisms :
- a grouping period : the period during which events are accumulated before being transmitted on the network. It is intended to optimize network transmissions. This parameter controls the transmission behavior.
- a maximum latency : represents the maximum transmission time (from sender to receiver) allowed to ensure a correct time rendering of the transmitted events. It is intended to compensate for the network latency and the transmission time variations. This parameter controls the receiver behavior.
The total delay introduced by the network transmission is equal to the grouping period + the maximum transmission delay + the initial transmission delay.
These parameters can be adjusted using the msWANDriver.ini file.
The Net Params section :
- UDP port : represents both the udp and tcp port number. Default value is 4951
- Grouping time : represents the grouping period (see above). Default value is 200 mls.
- Maximum latency allowed : (see above). Default value is 1500 mls.
- Maximum input connections count : represents the total number of simultaneous incoming connections allowed. Default value is 20.
- Hosts target : should contain remote host addresses (in the form 'computer.somedomain.com' or IP address). At initialization time, the driver setup a connection for every host specified on the host target line. Default value is empty.
- Hosts unused : intended only to disable automatic connection to one host.
The 'Hosts input connections' section :
written by the driver, this section contains IP numbers followed by a list of ports numbers representing input ports connections. When the corresponding host appears, these connections are restored by the driver. Uses the msDriver application to modify the connections state.The 'Hosts output connections' section :
written by the driver, this section contains IP numbers followed by a list of ports numbers representing output ports connections (see above).
The msWANDriver logs all the connections and possible problems to the msWANDriver.log file which is written in your $HOME/MidiShare folder.
The MidiShare WAN Drivers is part of the MidiShare project. It has been developped by the Grame's Computer Music Research Laboratory, in collaboration with the company Mil-Productions.