|
@@ -1 +1,83 @@
|
1
|
1
|
# Picadea control and monitor shell
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+Shell commands:
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+key | Function | Arguments | Notes
|
|
9
|
+----|------------------|--------------------------------------------|----------------------------------------------------------
|
|
10
|
+q | quit | |
|
|
11
|
+? | print usage | |
|
|
12
|
+w | write | (i2c_addr) (reg_addr) (data0) ... (dataN) |
|
|
13
|
+r | read | (i2c_addr) (src) (reg_addr) (byteN) | See [Memory Source Id Table](#memory-source-id-table).
|
|
14
|
+v | note-on | (pitch) (vel) |
|
|
15
|
+u | note-on | (pitch) (usec) (div) | See [Pulse Timer Divisor Table](#pulse-timer-divisor).
|
|
16
|
+o | note-off | (pitch) |
|
|
17
|
+T | set table | (pitch) (vel) (usec) |
|
|
18
|
+t | get table | (pitch) (vel) |
|
|
19
|
+D | set duty | (pitch) (percent) {(hz) {(div)}} |
|
|
20
|
+d | get duty | (pitch) |
|
|
21
|
+H | set hold delay | (pitch) (usec) |
|
|
22
|
+h | get hold delay | (pitch) |
|
|
23
|
+F | set pwm freq | (pitch) (hz) | 254=~123Hz
|
|
24
|
+f | get pwm freq | (pitch) |
|
|
25
|
+I | set pwm div | (pitch) (div) | See [PWM Divisor Table](#pwm-divisor).
|
|
26
|
+i | get pwm div | (pitch) |
|
|
27
|
+A | set flags | (pitch) (flags) |
|
|
28
|
+a | get flags | (pitch) |
|
|
29
|
+W | write table | (pitch) |
|
|
30
|
+N | note w/ duration | (pitch) (atkUs) (durMs) |
|
|
31
|
+S | seq | (pitch) (atkUs) (durMs) (deltaUs) (noteN) |
|
|
32
|
+L | log | (level) (0-1) |
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+## PWM Divisor
|
|
37
|
+
|
|
38
|
+Value | Div | Frequency | Period
|
|
39
|
+------|------|-------------|-------
|
|
40
|
+ 1 | 1 | 16 M | 62.5 n
|
|
41
|
+ 2 | 2 | 8 M | 125 n
|
|
42
|
+ 3 | 4 | 4 M | 250 n
|
|
43
|
+ 4 | 8 | 2 M | 500 n
|
|
44
|
+ 5 | 16 | 1 M | 1 u
|
|
45
|
+ 6 | 32 | 500 K | 2 u
|
|
46
|
+ 7 | 64 | 250 K | 4 u
|
|
47
|
+ 8 | 128 | 125 K | 8 u
|
|
48
|
+ 9 | 256 | 62500 Hz | 16 u
|
|
49
|
+10 | 512 | 31250 Hz | 32 u
|
|
50
|
+11 | 1024 | 15625 Hz | 64 u
|
|
51
|
+12 | 2048 | 7812.5 Hz | 128 u
|
|
52
|
+13 | 4096 | 3906.25 Hz | 256 u
|
|
53
|
+14 | 8192 | 1953.125 Hz | 512 u
|
|
54
|
+15 |16384 | 976.6625 Hz | 1024 u
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+## Pulse Timer Divisor
|
|
58
|
+
|
|
59
|
+Value | Divisor | Frequency | Period
|
|
60
|
+------|---------|------------|--------------
|
|
61
|
+ 1 | 1 | 16000000 | 62.5n
|
|
62
|
+ 2 | 8 | 2000000 | 500.0n
|
|
63
|
+ 3 | 64 | 250000 | 4.0u
|
|
64
|
+ 4 | 256 | 62500 | 16.0u
|
|
65
|
+ 5 | 1024 | 15625 | 64.0u
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+## Memory Source Id Table
|
|
69
|
+
|
|
70
|
+Id | Memory | Note
|
|
71
|
+---|----------------|-------------------------------
|
|
72
|
+ 0 | Register file | See register table file
|
|
73
|
+ 1 | Velocity table | MIDI velocity to pulse ticks lookup table
|
|
74
|
+ 2 | EEPROM | EEPROM data memory
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+## Memory Destination Id Table
|
|
78
|
+
|
|
79
|
+Id | Memory | Note
|
|
80
|
+---|----------------|-------------------------------
|
|
81
|
+ 4 | Register file | See register table file
|
|
82
|
+ 5 | Velocity table | MIDI velocity to pulse ticks lookup table
|
|
83
|
+ 6 | EEPROM | EEPROM data memory
|