Changes

Jump to navigation Jump to search
m
Fix formatting in OSC section.
Line 1: Line 1:  
== Network Connection ==
 
== Network Connection ==
   −
The easier way of connecting your Zynthian is to use the Ethernet RJ45 connector with a CAT-5 cable to connect your unit to your local network or directly to your computer (Ethernet to Ethernet). Your Zynthian box uses the link-local name "zynthian.local" and its files can be accessed with '''sftp''' and '''scp''' (If you are using Windows, get '''Winscp''' - free software needed to communicate using this Internet protocol).  
+
The easier way of connecting your Zynthian is to use the Ethernet RJ45 connector with a CAT-5 cable to connect your unit to your local network (DHCP) or directly to your computer (Ethernet to Ethernet, aka link-local). Your Zynthian box uses the link-local name "zynthian.local" and its filesystem can be accessed with '''sftp''' and '''scp''' (If you are using Windows, use '''Winscp''' - free software needed to communicate using this Internet protocol).  
   −
You can also login with '''ssh''' to access the Linux console. see [[Command_Line_User_Guide]] (use '''PuTTY''' software for Windows). The username and password are:
+
You can also login with '''ssh''' to access the Linux console. see [[Command_Line_User_Guide]] (use '''PuTTY''' software for Windows). The username and default password are:
    
  user=root
 
  user=root
 
  password=raspberry
 
  password=raspberry
   −
If the link-local address (zynthian.local) is not found, test that the link-local feature is enabled in your system. Sometimes is disabled and local names are not recognized (i.e. on Windows).
+
If the link-local address (zynthian.local) is not found, test that the link-local feature is enabled in your system. Sometimes is disabled and local names are not recognized (i.e. on Windows). Instead, you can use the Zynthian's IP address.  Find out what that is using the "Network Info" utility in the Zynthian's Admin menu. or See: [[Finding your IP address]]
Instead, you can use the Zynthian's IP address.  Find out what that is using the "Network Info" utility in the Zynthian's Admin menu. or See: [[Finding your IP address]]  
      
== Accessing the Web Configuration Tool ==
 
== Accessing the Web Configuration Tool ==
Line 31: Line 30:     
Wifi credentials can be set via the web config tool: System - Wifi - Add Network. Wifi must be enabled in the Zynthian Gui: press the Back button until you are in the Admin menu. Then select 'Start WIFI'.
 
Wifi credentials can be set via the web config tool: System - Wifi - Add Network. Wifi must be enabled in the Zynthian Gui: press the Back button until you are in the Admin menu. Then select 'Start WIFI'.
  −
==Audio Configuration==
  −
  −
[[Configuring_Audio_Devices]]
      
== Accessing the MOD-UI web interface ==
 
== Accessing the MOD-UI web interface ==
Line 95: Line 90:  
== Copying your presets/soundfonts to Zynthian ==
 
== Copying your presets/soundfonts to Zynthian ==
   −
You can copy your presets/soundfonts/pedalboards in the next forlder:
+
You can copy your presets/soundfonts/pedalboards in the next folder:
    
  /zynthian/zynthian-my-data
 
  /zynthian/zynthian-my-data
Line 127: Line 122:  
  user=pi
 
  user=pi
 
  password=raspberry
 
  password=raspberry
 +
 +
==CUIA Callable UI Actions==
 +
 +
The Zynthian may be controlled by MIDI messages applied to the Master MIDI Channel (default 16) defined in The Webconf Interface
 +
 +
The Interface allows applying on MIDI IN commands on channel 16 (default) that mimic various zynthian gui interface commands with some functional short cuts also provided ('POWER_OFF', ALL_NOTES_OFF').
 +
 +
The Message is sent as a Note on Message (0x9)
 +
 +
So To Power Off a zynthian one sends
 +
0x9F  ( Channel 16 Note ON)
 +
0x00  ( Note code for POWER_OFF as below )
 +
0x00  (Velocity/parameter)
 +
 +
This is why you should operate secure networks  . . . :-D
 +
 +
 +
 +
"0": "POWER_OFF",
 +
"1": "REBOOT",
 +
"2": "RESTART_UI",
 +
"3": "RELOAD_MIDI_CONFIG",
 +
 +
"10": "ALL_NOTES_OFF",
 +
"11": "ALL_SOUNDS_OFF",
 +
"12": "ALL_OFF",
 +
 +
"51": "SELECT",                    D#3/Eb3
 +
"52": "SELECT_DOWN",                E3
 +
"53": "SELECT_UP",                  F3
 +
 +
"64": "SWITCH_BACK_SHORT",          E4
 +
"63": "SWITCH_BACK_BOLD",          D#4/Eb4
 +
"62": "SWITCH_BACK_LONG",          D4
 +
 +
"65": "SWITCH_SELECT_SHORT",        F4
 +
"66": "SWITCH_SELECT_BOLD",        F#4/Gb4
 +
"67": "SWITCH_SELECT_LONG",        G4
 +
 +
"60": "SWITCH_LAYER_SHORT",        C4
 +
"61": "SWITCH_LAYER_BOLD",          C#4/Db4
 +
"59": "SWITCH_LAYER_LONG",          B4
 +
 +
"71": "SWITCH_SNAPSHOT_SHORT",      B5
 +
"72": "SWITCH_SNAPSHOT_BOLD",      C5
 +
"73": "SWITCH_SNAPSHOT_LONG"        C#5/Db5
 +
 +
[[File:2Oct_Keyboard_CUIA.png|400px|Keyboard]]
 +
 +
 +
== OSC ==
 +
 +
Open Sound Control (OSC) is a protocol for networking sound synthesizers, computers, and other multimedia devices for purposes such as musical performance or show control.
 +
 +
Zynthian implements OSC in various ways.
 +
 +
=== CUIA ===
 +
The CUIA features described above may be controlled using OSC on port 1370 using UDP datagrams. The OSC path for CUIA messages is
 +
/cuia
 +
Example:
 +
/cuia/reboot
 +
Note: CUIA paths are case insensitive, e.g.
 +
/cuia/reboot
 +
is interpreted the same as
 +
/CUIA/REBOOT
 +
 +
=== TouchOSC ===
 +
TouchOSC protocol is supported if the option is enabled on the Zynthian admin menu. This accepts OSC on port 12101 using UDP datagrams and includes raw MIDI data interpretation on OSC path
 +
/midi
 +
This path accepts an OSC MIDI type message. An example Python script to send MIDI note on / off messages:
 +
import liblo
 +
import time
 +
 +
cmdNoteOn = 0x90
 +
cmdNoteOff = 0x80
 +
note = 60
 +
vel = 100
 +
 +
liblo.send(('zynthian.local', 12101), "/midi", ('m', (vel,note,cmdNoteOn,0)))
 +
time.sleep(1)
 +
liblo.send(('zynthian.local', 12101), "/midi", ('m', (0,note,cmdNoteOff,0)))
334

edits

Navigation menu