Artist = 02
Album = 03
Genre = 04
Track = 05
Composer = 06
AudioBook = 07
Podcast = 08
This command must be used to initialize the category count before selecting a database record using the
I_SELDBRECORD command. A categories record count can change based on prior categories selected
and the database hierarchy. For example, if the database has just been reset using I_RESDBSEL, then
this command would return the total number of records for a given category. However, if this command
is sent after one or more categories have been selected, the returned record count will be a subset of the
records that are member of all the categories selected prior to this command.
Example:
--> I_GETNUMCATDBREC 02<cr>
'request the number of artists
<-- 184<cr>
'there are 184 artists
I_RETCATDBREC
Retrieves one or more database records from the iPod based on the results from the
I_GETNUMCATDBREC command. This command specifies the category type (see above), the starting
record index, and the record count. For example, using a category type of two (artist), a starting index of
zero, and a record count of five, the iPod will return the names of the first five artists in the database.
Example:
--> I_RETCATDBREC 02,0,5<cr> 'request artist names starting at record 0, get 5 artists
<-- a-ha<cr>
'5 artist names are returned
<-- Aaron Neville<cr>
<-- AC/DC<cr>
<-- Adam Ant<cr>
<-- Aerosmith<cr>
I_SELDBREC
Selects one or more records in the iPod database, based on a category relative index. For example
selecting category two (artist), and record index one results in a list of database records from the second
artist in the artist list. Selections are additive and limited by the category hierarchy. Selection of a single
record automatically passes it to the playback engine and starts its playback. This command may only be
used after a category count has been initialized by use of the command I_GETNUMCATDBREC.
Example:
--> I_SELDBREC 02,2<cr>
'(see above) Artist number 2 (AC/DC) is selected
<-- OK<CR>
I_PLYCURSEL
This command copies items from the iPod's database engine to the playbacks engine, and optionally
shuffles the tracks if shuffle is active, then starts playback at the specified track index.
1.0 01/02/10
7
