Scribd
Upload
50 views

Rtmidistart

This document describes how to load code patches into the VS1053B audio decoder chip using different methods. It explains an RLE compressed format for plugin files, and how to decode and write the data to registers. It also describes an older loading method that uses separate address and data tables to write values to registers to apply a patch. The document provides C code examples for both loading approaches.

Uploaded by

ribeiro220
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
50 views

Rtmidistart

This document describes how to load code patches into the VS1053B audio decoder chip using different methods. It explains an RLE compressed format for plugin files, and how to decode and write the data to registers. It also describes an older loading method that uses separate address and data tables to write values to registers to apply a patch. The document provides C code examples for both loading approaches.

Uploaded by

ribeiro220
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 4

VLSI Controlled Document

Solution y

VS1053B RtMidi Start

VSMPG “VLSI Solution Audio Decoder”

Project Code:
Project Name: VSMPG

Revision History
Rev. Date Author Description
1.0 2009-01-12 PO Initial version

Rev. 1.0 2009-01-12 Page 1(4)


VLSI VS1053B RtMidi Start VSMPG
Solution y
PO 1. DESCRIPTION

1 Description

This patch allows you to start the rtmidi code from SCI. Configure CLOCKF and MODE
first to set the appropriate clock and possible earspeaker setting, then start the RTMIDI
mode by sending the patch.

The patch uses IRAM 0x50..0x59, so give a software reset first if you have other code
loaded into those addresses.

Rev. 1.0 2009-01-12 Page 2(4)


VLSI VS1053B RtMidi Start VSMPG
Solution y
PO 2. HOW TO LOAD A PLUGIN

2 How to Load a Plugin

A plugin file (.plg) contains a data file that contains one unsigned 16-bit array called
plugin. The file is in an interleaved and RLE compressed format. An example of a
plugin array is:
const unsigned short plugin[10] = { /* Compressed plugin */
0x0007, 0x0001, 0x8260,
0x0006, 0x0002, 0x1234, 0x5678,
0x0006, 0x8004, 0xabcd,
};

The vector is decoded as follows:


1. Read register address number addr and repeat number n.
2. If (n & 0x8000U), write the next word n times to register addr.
3. Else write next n words to register addr.
4. Continue until array has been exhausted.

The example array first tells to write 0x8260 to register 7. Then write 2 words, 0x1234
and 0x5678, to register 6. Finally, write 0xabcd 4 times to register 6.

Assuming the array is in plugin[], a full decoder in C language is provided below:


void WriteVS10xxRegister(unsigned short addr, unsigned short value);

void LoadUserCode(void) {
int i = 0;

while (i<sizeof(plugin)/sizeof(plugin[0])) {
unsigned short addr, n, val;
addr = plugin[i++];
n = plugin[i++];
if (n & 0x8000U) { /* RLE run, replicate n samples */
n &= 0x7FFF;
val = plugin[i++];
while (n--) {
WriteVS10xxRegister(addr, val);
}
} else { /* Copy run, copy n samples */
while (n--) {
val = plugin[i++];
WriteVS10xxRegister(addr, val);
}
}
}
}

Rev. 1.0 2009-01-12 Page 3(4)


VLSI VS1053B RtMidi Start VSMPG
Solution y
PO 3. HOW TO USE OLD LOADING TABLES

3 How to Use Old Loading Tables

Each patch contains two arrays: atab and dtab. dtab contains the data words to write,
and atab gives the SCI registers to write the data values into. For example:

const unsigned char atab[] = { /* Register addresses */


7, 6, 6, 6, 6
};
const unsigned short dtab[] = { /* Data to write */
0x8260, 0x0030, 0x0717, 0xb080, 0x3c17
};

These arrays tell to write 0x8260 to SCI WRAMADDR (register 7), then 0x0030, 0x0717,
0xb080, and 0x3c17 to SCI WRAM (register 6). This sequence writes two 32-bit instruc-
tion words to instruction RAM starting from address 0x260. It is also possible to write
16-bit words to X and Y RAM. The following code loads the patch code into VS10xx
memory.

/* A prototype for a function that writes to SCI */


void WriteVS10xxRegister(unsigned char sciReg, unsigned short data);

void LoadUserCode(void) {
int i;
for (i=0;i<sizeof(dtab)/sizeof(dtab[0]);i++) {
WriteVS10xxRegister(atab[i]/*SCI register*/, dtab[i]/*data word*/);
}
}

Patch code tables use mainly these two registers to apply patches, but they may also
contain other SCI registers, especially SCI AIADDR (10), which is the application code
hook.

If different patch codes do not use overlapping memory areas, you can concatenate the
data from separate patch arrays into one pair of atab and dtab arrays, and load them
with a single LoadUserCode().

Rev. 1.0 2009-01-12 Page 4(4)

You might also like