Settings

Overview

The following page is a detailed list of all of the available settings for the rMP3. Please see the Settings Command for more details on changing settings.

Communication Settings

Serial Bitrate

Setting name: D

The rMP3 communicates using asynchronous serial.

Value Bitrate
0 9600 bps
1 19200 bps
2 38400 bps
3 57600 bps
4 115200 bps
5 2400 bps
6 4800 bps
7 230400 bps
8 460800 bps

Example: Set serial bitrate to 115200 bps

ST D 4

Prompt Character

Setting name: P

This is the character that is returned when the rMP3 is ready to receive a new command. You can use this character to synchronize communications.

Range: 1 → 254

Type: ASCII character value.

Example: Set prompt to ']'

ST P 93

Response Delay

Setting name: R

This is a delay that is introduced between when a command is received by the rMP3 and when the command begins processing. This is especially useful for controllers that need time to set up their serial input (e.g. Basic Stamp).

Range: 0 → 254

Type: Time in 10 millisecond increments (e.g. 5 = 50 ms).

Example: Set response delay to 50 ms

ST R 5

Non-volatile Playback Settings

Volume

Setting name: V

Sets the start-up volume for the rMP3. You can provide both the left and right volume settings.

Range: Left: 0 → 254, Right: 0 → 254

Type: Volume attenuation in -0.5 dB increments (e.g. 16 = -8 dB).

Example: Set volume to L:0 dB, R: -4 dB

ST V 0 8

Loop Count

Setting name: O

Sets the default loop count for playback. This is the number of times a file is repeated.

Range: 0 → 254

Type: Number of repeats.

Note: 0 means infinite repeat - continuous looping of playback. A value of 1 means to play the file once.

Example: Set default loop count to 2

ST O 2

Boost

Setting name: B

Sets the default Boost value. This is an audio enhancement provided by the decoder which boosts the bass and/or treble response.

  • Treble boost can be set from -12 to +10.5 dB boost (in 1.5 dB steps) at and above frequencies ranging from 1000 to 15000 Hz (in 1000 Hz steps).
  • Bass boost can be set from 0 to 15 dB boost (in 1 dB steps) below frequencies ranging from 20 to 150 Hz (in 10 Hz steps).

The Boost value is calculated as follows:

  • treble boost = (treble amplitude[see table below] * 16) + treble frequency/1000
  • bass boost = ((bass amplitude * 16) + (bass frequency/10)
  • boost = treble boost * 256 + bass boost

A value of 0 will turn off the audio enhancement.

Range: 0 → 65536

Note: Treble amplitude is a twos-complement value for the amplitude.

Treble amplitude value Twos-complement Binary Hexadecimal Treble boost (dB)
15 -8 1111 F -12 dB
14 -7 1110 E -10.5 dB
13 -6 1101 D -9 dB
12 -5 1100 C -7.5 dB
11 -4 1011 B -6 dB
10 -3 1010 A -4.5 dB
9 -2 1001 9 -3 dB
8 -1 1000 8 -1.5 dB
0 0 0000 0 0 dB (boost off)
1 1 0001 1 +1.5 dB
2 2 0010 2 +3 dB
3 3 0011 3 +4.5 dB
4 4 0100 4 +6 dB
5 5 0101 5 +7.5 dB
6 6 0110 6 +9 dB
7 7 0111 7 +10.5 dB

Type: Boost encoded value.

Example:

Treble boost frequency: 10 kHz (and above)
Treble boost amplitude: +10.5 dB
Bass boost frequency: 60 Hz (and below)
Bass boost amplitude: +15 dB

treble boost = (7 * 16) + 10000/1000
             = 112 + 10 = 122
bass boost   = (15 * 16) + 60/10
             = 240 + 6 = 246
Boost value  = 122 * 256 + 246
             = 31478

ST B 31478

File System Settings

These are the very same settings for the file system as found on the uMMC.

Input/Output Interface Settings

Input Style

Setting name: S

Sets the input interface style. See the Input Interface section for more information.

Value Style
0 No input style (input interface ignored)
1 8 Button/Switch interface
2 7 Bit plus Trigger interface

Example: Set input style to 7 Bit plus Trigger (2)

ST S 2

Hardware Busy Indicator

Setting name: H

Sets the “D” pin to be a hardware busy logic output (high = playing).

Range: 0 or 1

Type: Switch.

Example: Turn on Hardware Busy Indicator

ST H 1

Input File Number Offset

Setting name: N

Sets the offset for the filenames used for the input interface. For example, if the Button/Switch interface is being used, and the Input File Number Offset is set to 200, then all filenames will be offset by 200. i.e. The filename for Button/Switch 2 will be B0202.MP3.

Range: 0 → 9872

Type: Offset.

Example: Set offset to 100

ST N 100

Input Non-stop Control

Setting name: U

In 8 Button/Switch mode, this 8 bit mask indicates which buttons will be considered non-stop (a 1 in the mask indicates non-stop). In 7 Bit mode, anything > 0 will indicate non-stop playback.

Range: 0 → 255

Type: 8 bit mask.

Example:

Set input pins 0 and 5 as non-stop (“uninterruptible”):

Binary Mask Hex Decimal
00100001 21 33

ST U 33

Input Polarity Control

Setting name: A

Used only in 8 Button/Switch mode, this 8 bit mask indicates the polarity of input for each individual input pin (a 1 in the mask indicates positive edge triggering).

Range: 0 → 255

Type: 8 bit mask.

Example:

Set input pins 0 and 6 as positive edge triggered (the rest are negative edge triggered):

Binary Mask Hex Decimal
01000001 41 65

ST A 65

Switch Input Debounce Mode

Setting name: M

Used only in 8 Button/Switch mode, this setting will turn on a simple 40 ms debounce algorithm for the inputs.

Range: 0 or 1

Type: Switch.

Example: Turn on debounce algorithm

ST M 1

  • Bookmark at
  • Bookmark "Settings" at del.icio.us
  • Bookmark "Settings" at Digg
  • Bookmark "Settings" at Google
  • Bookmark "Settings" at StumbleUpon
  • Bookmark "Settings" at Technorati
  • Bookmark "Settings" at Facebook
  • Bookmark "Settings" at Twitter
  • Bookmark "Settings" at Slashdot
  • Bookmark "Settings" at Yahoo! Bookmarks
  • Bookmark "Settings" at Furl
  • Bookmark "Settings" at Reddit
  • Bookmark "Settings" at Ask
  • Bookmark "Settings" at BlinkList
  • Bookmark "Settings" at blogmarks
  • Bookmark "Settings" at Ma.gnolia
  • Bookmark "Settings" at Netscape
  • Bookmark "Settings" at ppnow
  • Bookmark "Settings" at Rojo
  • Bookmark "Settings" at Shadows
  • Bookmark "Settings" at Simpy
  • Bookmark "Settings" at Socializer
  • Bookmark "Settings" at Spurl
  • Bookmark "Settings" at Tailrank
  • Bookmark "Settings" at Live Bookmarks
  • Bookmark "Settings" at Wists
  • Bookmark "Settings" at Yahoo! Myweb
  • Bookmark "Settings" at BobrDobr
  • Bookmark "Settings" at Memori
  • Bookmark "Settings" at Faves
  • Bookmark "Settings" at Favorites
  • Bookmark "Settings" at Newsvine
  • Bookmark "Settings" at myAOL
  • Bookmark "Settings" at Fark
  • Bookmark "Settings" at RawSugar
  • Bookmark "Settings" at LinkaGoGo
  • Bookmark "Settings" at Mister Wong
  • Bookmark "Settings" at Wink
  • Bookmark "Settings" at BackFlip
  • Bookmark "Settings" at Diigo
  • Bookmark "Settings" at Segnalo
  • Bookmark "Settings" at Netvouz
  • Bookmark "Settings" at DropJack
  • Bookmark "Settings" at Feed Me Links
  • Bookmark "Settings" at funP
  • Bookmark "Settings" at HEMiDEMi
rmp3/documentation/settings.txt · Last modified: 2010/05/17 16:10 by bhagman
Valid CSS Recent changes RSS feed Valid XHTML 1.0