PKP
VS1000 P
ROGRAMMER
’
S
G
UIDE
VSMPG
7.3
Adjusting the Player User Interface
The ROM code implements a Vorbis player with a user interface that has 6 buttons:
•
Power/Play/Pause
•
Previous/Rewind
•
Next/Fast Forward
•
Volume -
•
•
EarSpeaker (spatial processing) setting change
In addition to the 6-button interface the ROM contains alternative default key mappings
for a 5-button and 4-button user interfaces.
If these are not sufficient, there are two alternatives:
•
Create a custom key
→
event mapping
•
Take full control of the player
The VS1000 ROM function
void KeyEventHandler(enum keyEvent event)
can handle
17 pre-defined player control events, the 12 first are common with VS1000A.
VS1000B Pre-defined Player Control Events
Value
Event
Function
0
ke_null
Do nothing
1
ke_previous
Play Previous song
2
ke_next
Play Next song
3
ke_rewind
Rewind
4
ke_forward
Fast Forward
5
ke_volumeUp
Volume Up
6
ke_volumeDown
Volume Down
7
ke_earSpeaker
Switch EarSpeaker processing (4 settings)
8
ke_earSpeakerToggle
Toggle EarSpeaker processing (2 settings)
9
ke_randomToggle
Random Play on/off
10
ke_randomToggleNewSong
Play random song
11
ke_pauseToggle
Pause on/off
12
ke_powerOff
Close and power down
13
ke_ff_faster
increase play speed
(needs ke_ff_off as release event)
14
ke_ff_slower
decrease play speed
(needs ke_ff_off as release event)
15
ke_ff_off
back to normal play speed
16
ke_volumeUp2
increase volume by 1.0 dB
17
ke_volumeDown2
decrease volume by 1.0 dB
A
KeyMapping
structure controls the relationship between key-presses, long key-presses
and events. The structure is an array of pairs
struct KeyMapping {
u_int16 key;
// Key Mask
enum keyEvent event; // Event
}
Rev. 0.20
2011-10-04
Page