pic2osc is the router software between USB serial and OSC.
pic2osc is written by Java. So Windows version and Mac OS X
version are designed by common source code. Also, to enable the
processing of virtual com port and the mediation of communication,
OS : Mac OS X 10.5 Leopard, 10.6 Snow Leopard or 10.7 Lion
Windows XP, Vista or 7(both 32bit and 64bit)
Java : Java Runtime Environment(JRE) 6
(you need to install Java for Mac OS X 10.5 Update 6, Java for Mac OS X 10.6 Update 1 or Java for OS X Lion)
Etc : LoopBe30(Only Windows and MIDI)
Please download here.
for Mac OS X Users
After downloading pic2osc-ver-macosx.dmg, the disk image wil
appear on your desktop. Please open the disk image and put
pic2osc.app in /Application folder.
for Windows XP/Vista/7 Users
You download pic2osc-ver-windows.zip and extract it.
Please put extracted folder in arbitrary place(for example,
0. Only Mac OS X Users
To use pic2osc on Mac OS X, you need to initialize. Please download
the following zip file and uncompress it.
You double-click “init-setup” and then Terminal.app is launched.
if [Process completed] message appear on terminal, The initialization
If you want to configure manually, please look at the following procedure.
A. Make /var/spool/uucp and /var/lock if there aren’t these.
sudo mkdir /var/spool/uucp
sudo mkdir /var/lock
B. Change the permission and group of made directories.
sudo chmod 775 /var/spool/uucp
sudo chmod 775 /var/lock
sudo chgrp uucp /var/spool/uucp
sudo chgrp uucp /var/lock
C. Confirm the permission and group of made directories.
The output is shown as follows if your operation is correct.
ls -l /var/spool/ | grep uucp
> drwxrwxr-x 2 _uucp _uucp 68 5 19 03:15 uucp
ls -l /var/ | grep lock
> drwxrwxr-x 20 root _uucp 680 10 7 14:26 lock
D. Confirm the USER ID.
Your USER ID is shown on taro.
who -H am i
|> taro||ttys000||Oct 7 15:28|
E. Append your account to the membership of the UUCP group.
Please change taro to your USER ID.
(For Max OS X 10.4)
sudo niutil -appendprop / /groups/uucp users taro
(For Mac OS X 10.5 or 10.6)
sudo dscl . -append /Groups/uucp GroupMembership taro
F. Comfirm the setting of UUCP group.
dscl . -read /Groups/uucp | grep GroupMembership
> GroupMembership: taro
0. Only Windows XP/Vista Users
When PICnome/PICratchBOX_OSC is connected at first, your PC
will make a request to install inf file. There is tkrworks-PICnome.inf
(or tkrworks-PICratchBOX.inf) with hex files in
and please install to your PC. If you use 64bit OS, please select “_x64.inf”.
Also, you open the property of the COM port for PICnome assigned
by OS in the device manager and change the baud rate from 9600
(default) to 115200.
1. I/O Protocol
※For ONLY Mac OS X 10.7(Lion) Users
If you haven’t installed Java runtime for Lion before launching
pic2osc, you get asked for the installation of Java runtime.
Please follow the instruction on screen and install it.
Please launch pic2osc after connecting device to your PC.
First, you select the the protocol from “I/O Protocol” dropdown
1.1. Open Sound Control
If you use the OSC protocol, basically you don’t need to change
“Host Address”, “Host Port” and “Listen Port”.
Please refer this page about OSC protocol.
Before setting MIDI protocol on pic2osc, please install
“LoopBe30″(for Windows) or configure the IAC Driver
on “Audio MIDI Setup”(for Mac OS X) and then you need to select both
“MIDI In” and “MIDI Out” from dropdown menu.
Please refer this page about MIDI protocol.
PICnome or PICratchBOX_OSC pads and LEDs are controled by OSC and then
the external ports output MIDI CC value.
It’s convenient to assign some potentiometers, faders or sensors
connected to the external ports to some parameters by Ableton Live
MIDI map mode
2. Device Select
Your PICnome/PICratchBOx is shown as a
“tkrworks-PICnome(or PICratchBOX)-***”(for Mac OS X)
or “tkrworks-PICnome(or PICratchBOx)-COM*”(for Windows)
Also, if you connect two PICnomes/PICratchBOXes on your PC,
you can change them from “Device” dropdown menu.
3. Cable Orientation
You can turn PICnome64/128/PICratchBOx_OSC around by configuring “Cable Orientation”.
4. Device-Specific Protocol Settings
4.1. Address Pattern Prefix
this is used when you configure the prefix of osc messages. Please
push the enter key after typing prefix string and activate. Also, you
can directly change the prefix by sending osc message “/sys/prefx”.
4.2. Starting Column / Row
You can configure the offset values of column and row position for
buttons and LEDs when two PICnomes is connected on your PC or
Mac and you want to use as a PICnome 128(8×16 or 16×8).
For example, if the first of two PICnomes is set “Starting Column”
to “0” and “Starting Row” to “0”. the other PICnome is set “Starting
Column” to “8” and “Starting Row” to “0”, you’ll be able to use as a
5. Analog Input Settings
1.1. Analog In. Enable
You can configure whether the analog inputs are
enabled or not. Also these can be set by osc message
“[prefix]/adc_enable” or “[prefix]/adc/enable”.
1.2. Input Type
It’s possible to select the correction type of
inputs. For example, “I/F” is suited for input fader of DJ mixer.
Similarly, “C/F” is cross fader and also “M/A” is better used as
the acceralation sensor.
Also, you can change these setting by sending “[prefix]/adc/type”.
1.3. Fader Curve
The input curve is possible to adjust in eight steps.
Also, you can change curve by sending “[prefix]/adc/curve”.