Instructions

The OpenSoundModule has two channels: A and B. Each channel has a trigger input and output, and a CV (control voltage) input and output.
The module also has a bicolour LED pushbutton: the WiFi button.

WiFi Button

Pressing the WiFi button will broadcast an OSC status message. Any device on the network will be able to receive the status message on the configured port.

The WiFi button normally indicates the status of the WiFi connection:

  • Green: AP Mode, configured as Access Point
  • Yellow: Client Mode, connected to a local WiFi network
To change between local network and access point modes, hold the pushbutton down for approximately 6 seconds.

Access Point Mode

By default, the OSM will create a soft Access Point (AP) with the following network details (password and SSID are printed on a label on the back of the module)

SSID: OpenSound-ABCD
Password: ********
Authentication: WPA2
Local IP: 192.168.0.1
Gateway IP: 192.168.0.1

If the OSM doesn’t have any WiFi credentials stored or the stored networks can’t be connected, it will fall back on Access Point mode. You can also switch from local WiFi to AP mode by pressing down the WiFi button for approximately 6 seconds.

In AP mode, the module is fully functional with OSC and web interfaces.

Local WiFi Mode

Once the OSM is configured with the right credentials it will be able to connect to a local WiFi network, as long as the network is within range.
While a local network connection is being established, the WiFi button will flash yellow slowly. If the connection is lost or can’t be established the WiFi button flashes rapidly before trying again. After a certain number of attempts it will give up and revert to AP mode.

Establishing the IP Address

In local WiFi mode, the OSM will be allocated an IP address by a DHCP server, which is usually the network router. To find out what IP address has been assigned there are several methods.
  1. Listen to status messages
  2. Service Discovery using mDNS / Bonjour

When the WiFi button is pressed the OSM will broadcast a status message containing its IP address and input port. By listening to messages on the output port (default: 9000) you can find out the OSM IP address.

You can also configure your software using Zeroconf or mDNS / Bonjour. This is a service discovery protocol supported by many software makers. The OSM will reply to mDNS queries and advertise itself as an OSC service.