Communications Protocol

Description

The Protocol for the rMP3 employs a simple but robust asynchronous serial control protocol. A command prompt ”>” (“greater than” symbol, ASCII 62, HEX 0x3E) indicates that the rMP3 is ready to accept a command. A command can be sent, a response will be returned, and the command prompt will be sent again.

Example:

FC F«cr»

1>

If an error occurs while processing a command, an error is returned in the format ”Enn”. See the table of error codes.

Example:

>PC F /MP3/MISSING.MP3«cr»

EF2>

Command Format

CC«sp»Parameter1«sp»Parameter2«sp»…«cr»

Where:

  • CC is the command character(s).
  • «sp» is a single space character (ASCII 32, HEX 0x20).
  • Parameter1, Parameter2, … are parameters associated with the command
  • «cr» is a carriage return character (ASCII 13, HEX 0x0d)

Command Listing Format

CC Parameter1 [Parameter2 [Parameter3]]…

  • CC is the command character(s).
  • Parameter1 is the first parameter for the command. Often, this is a sub-command.
  • Parameter2 is the second parameter for the command. If it is listed inside of square brackets [ ] then the parameter is optional.

Any parameters listed inside of square brackets [ ] are optional. Most commands that have optional parameters will require the previous parameter to be given.

Command Response Format

In general, responses are of the format:

[[«sp»][data]] | [Enn]

Error codes are returned as Enn, where nn is a hexadecimal code indicating the error. See the table of error codes.

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