README.txt
----------
Quick Ultra-player notes.
The emulation layer controls the oscillators tightly to allow
effects.

/Daniel Kahlin (aka tlr)


Emulation Layer
---------------
- enable
- 15-bit period (9-bit effective)
- 8-bit pwm    (6-bit effective)


Arp Table
---------
arp_step <time>,<transp>
  encoding: 0000tttt, oooooooo
    t: time-1
    o:   7=ABSPERIOD
         6=ABSNOTE
       5-0=Note offs -32 to 31
       5-0=Note $01 to $26
       6-0=Period value 0 to 127
       $80 is MUTE

arp_wave <wave>,<transp>
  encoding: 0001wwww, oooooooo
    w: wave
    o:   7=ABSPERIOD
         6=ABSNOTE
       5-0=Note offs -32 to 31
       5-0=Note $01 to $26
       6-0=Period value 0 to 127
       $80 is MUTE

arp_jmp <offs|addr>
  encoding: 11111111, oooooooo

arp_end
  encoding: 11111111, 00000000


Pulse Width Table
-----------------
pw_set <pw 0-255>
  encoding: 10000000, wwwwwwww

pw_mod <time 1-128>,<amount>
  encoding: 0ttttttt, aaaaaaaa
    t: time-1
    a: amount to add (signed)

pw_jmp <offs|addr>
  encoding: 11111111, oooooooo
    o: table offset to jump to.

pw_end
  encoding: 11111111, 00000000


Vibrato Table
--------------
vib_set <offs -128 to 127 nibswapped>
  encoding: 10000000, oooooooo

vib_mod <time 1-128>,<amount nibswapped>
  encoding: 0ttttttt, aaaaaaaa
    t: time-1
    a: amount to add (signed)

vib_jmp <offs|addr>
  encoding: 11111111, oooooooo
    o: table offset to jump to.

vib_end
  encoding: 11111111, 00000000


*Tempo Table
------------
* not yet implemented.

tempo_set <tempo>
  encoding: 0ttttttt

tempo_jmp <offs|addr>
  encoding: 1ooooooo
    o: table offset to jump to.

tempo_end
  encoding: 10000000


Sequencer
---------
rest <time 1-32>
  encoding: ttttt000
    t: time-1

note <time 1-32>, <note> [| NOTRIG][| NOTRANS]
  encoding: ttttt001, nnnnnnnn
    t:   time-1
    n:   7=NOTRANS
         6=NOTRIG
       5-0=NOTE  $01 (C0) to $26 (Cs3)


cmd <cmd>,<param>
  encoding: ccccc010, pppppppp
    c: command
    p: parameter

snd <num|addr>
  encoding: sssss011
    s: sound number

srts
  encoding: 00000100

sjmp <addr>
  encoding: aaaaa101, bbbbbbbb
    a: address MSB shifted up 3 bits 
    b: address LSB

sjsr <addr>
  encoding: aaaaa110, bbbbbbbb
    a: address MSB shifted up 3 bits 
    b: address LSB

cmds:
  noeffect
    encoding: 00000 010, 00000000

  port <offs>
    encoding: 00001 010, oooooooo

  setpitch <val>  (nibswapped)
    encoding: 00010 010, vvvvvvvv

  setviboffs <val>  (nibswapped)
    encoding: 00011 010, vvvvvvvv

  setpw <pw 0-255>
    encoding: 00100 010, wwwwwwww

  transpose <val>
    encoding: 00101 010, vvvvvvvv

  arptable <offs|addr>
    encoding: 00110 010, oooooooo

  pwtable <offs|addr>
    encoding: 00111 010, oooooooo

  vibtable <offs|addr>
    encoding: 01000 010, oooooooo

  setshift <val>
    encoding: 01001 010, vvvvvvvv

  setlimit <val>
    encoding: 01010 010, vvvvvvvv

  tempo <val>
    encoding: 01011 010, vvvvvvvv


eof