background image

Introduction

This specification provides the communication protocol that
allows two-way communication between an RS-232 enabled 
controller and an Apple

®

iPod™ docked into an RS-232 enabled

enabled iPort™ model. This document specifies telegrams that
will allow for the command and control of the docked iPod in
extended interface mode and for receiving meta data from the
iPod for display on the controller’s display.

Applicable iPort Models

This specification only applies to iPort models that are two-way
communication enabled. Two-way communication is enabled in
the IW-4 and IW-5 systems, and can be added to iPort IW-2 and
IW-3 systems by adding the iPort RS-232 Upgrade Kit (sold 
separately) to the IW-3, and the iPort RS-232 and the iPort
Balanced Audio Upgrade kits (both sold separately) to the IW-2.

Summary of RS-232 Operation

This communication protocol is enabled when the iPod is in
extended interface mode, which can be determined by checking
the iPod screen. The iPort logo will be on the iPod screen when
in extended interface mode. 

NOTE: The iPod interface is disabled when in two-way
(RS-232) mode. The user will no longer be able to 
control the iPod from the iPod when in two-way mode.

There are commands to enter two way and exit two way. One
may wish to make these commands available to the customer
through the user interface. Refer to section 35 and section 36.

NOTE: If the iPod is docked while in the 

Play

mode it

will automatically enter the 

Pause

mode. This is due to

the iPod protocol. You may wish to set the RS-232 
control system to automatically send a 

Play

command to

return the iPod to the last playing song when it is
inserted in the dock.

Connection Description 

The iPort communication protocol uses an RJ-11 connector on
the Balanced Audio Wallplate or external break-out box. 
(A compatible RJ-11/DB-9 cable is supplied with RS-232 enabled
iPort systems and the iPort RS-232 Upgrade Kit.)

The pin assignments for the RS-232 cable are:

RJ-11 Pin

DB-9

Name

1

2

PC Rx

2*

5

GND

3*

5

GND

4

3

PC Tx

5

2

PC Rx

6

N/A

* Only one GND pin may be connected, if desired.

Com Port Settings:

Baud Rate = 19200 

Parity = N

Stop Bits = 1

Data Bits = 8

Packet Structure

The iPort communication packet structure is constructed using a
combination of ASCII characters and hex data. A packet consists
of seven elements described below.

Byte Number Value

Meaning

0x00

0x2A

Start character

0x01

0x49

Device type (iPort)

0x02

0xNN

Packet Length High Byte

0x03

0xNN

Packet Length Low Byte

0x04

0xNN

Packet Command Type

0x05

0xNN

Packet Command High Byte

0x06

0xNN

Packet Command Low Byte

0x07 – 0xNN

0xNN

Packet Data Bytes

0xNN

0xNN

Checksum = 2’s compliment of the
sum of all bytes excluding the start
character and checksum

Packet  Command  Type:

Code

Command Type

0x38

Two-Way

0x3C

General

0x01*

LED control

* Device type code for this command is 0x4D

Instruction Manual

iPort RS-232 Programming

1

Summary of Contents for IW-2

Page 1: ...ce Refer to section 35 and section 36 NOTE If the iPod is docked while in the Play mode it will automatically enter the Pause mode This is due to the iPod protocol You may wish to set the RS 232 control system to automatically send a Play command to return the iPod to the last playing song when it is inserted in the dock Connection Description The iPort communication protocol uses an RJ 11 connect...

Page 2: ...3C 0x23 ReturnCurrentPlayingSongIndex 0x3C 0x24 GetNumberCategorizedDBRecords 0x3C 0x25 ReturnNumberCategorizedDBRecords 0x3C 0x26 RetrieveCategorizedDBRecords 0x3C 0x27 ReturnCategorizedDBRecord 0x3C 0x28 RequestiPodName 0x3C 0x29 ReturniPodName 0x3C 0x2A ResetDBSelection 0x3C 0x2B SelectDBRecord 0x3C 0x3D Acknowledge The table below lists the valid command codes for use in packet command high an...

Page 3: ...a category type index and sort order Category Type Code Code Category Type 0x01 Playlist 0x02 Artist 0x03 Album 0x04 Genre 0x05 Song 0x06 Composer Sort Order Code Code Sort Order 0x00 Genre 0x01 Artist 0x02 Composer 0x03 Album 0x04 Song 0x05 Playlist 0xFF Default Packet structure Byte Number Value Meaning 0x00 0x2A Start character 0x01 0x49 Device type iPort 0x02 0x00 Packet Length High Byte 0x03 ...

Page 4: ...ying songs and current playing song index respectively NOTE This command is only usable when the iPod is in a playing or paused state The command will fail if the iPod is stopped Packet Structure Byte Number Value Meaning 0x00 0x2A Start character 0x01 0x49 Device type iPort 0x02 0x00 Packet Length High Byte 0x03 0x07 Packet Length Low Byte 0x04 0x38 Packet Command Type 0x05 0x3C Packet Command Hi...

Page 5: ...current iPod shuffle mode state is returned Shuffle Mode Code Code Category Type 0x00 Shuffle Off 0x01 Shuffle Songs 0x02 Shuffle Albums Packet Structure Byte Number Value Meaning 0x00 0x2A Start character 0x01 0x49 Device type iPort 0x02 0x00 Packet Length High Byte 0x03 0x04 Packet Length Low Byte 0x04 0x38 Packet Command Type 0x05 0x3C Packet Command High Byte 0x06 0x11 Packet Command Low Byte ...

Page 6: ...ction Song Record Index byte 2 0x0B 0xNN Selection Song Record Index byte 1 0x0C 0xNN Checksum 12 PlayControl 0x3C 0x15 PlayControl Direction Controller iPort Description Sets the new play state of the iPod Play Control Command Code Code Category Type 0x01 Toggle Play Pause 0x02 Stop 0x03 Next Track 0x04 Previous Track 0x05 StartFF 0x06 StartRew 0x07 EndFFRew Packet Structure Byte Number Value Mea...

Page 7: ...ue to send PlayStatusChangeNotificaiton telegrams until this telegram is sent again with the disable notification option Play Status Change Notification Mode Code Code Category Type 0x00 Disable All 0x01 Enable All Packet Structure Byte Number Value Meaning 0x00 0x2A Start character 0x01 0x49 Device type iPort 0x02 0x00 Packet Length High Byte 0x03 0x04 Packet Length Low Byte 0x04 0x38 Packet Comm...

Page 8: ...te 0x08 0x02 New Status Playback Forward Seek Stop 0x09 0x22 Checksum Playback Backward Seek Stop 0x03 Byte Number Value Meaning 0x00 0x2A Start character 0x01 0x49 Device type iPort 0x02 0x00 Packet Length High Byte 0x03 0x04 Packet Length Low Byte 0x04 0x38 Packet Command Type 0x05 0x3C Packet Command High Byte 0x06 0x1B Packet Command Low Byte 0x08 0x03 New Status Playback Backward Seek Stop 0x...

Page 9: ...aying song index is invalid Packet Structure Byte Number Value Meaning 0x00 0x2A Start character 0x01 0x49 Device type iPort 0x02 0x00 Packet Length High Byte 0x03 0x07 Packet Length Low Byte 0x04 0x38 Packet Command Type 0x05 0x3C Packet Command High Byte 0x06 0x1E Packet Command Low Byte 0x08 0xNN Database Song Record Index byte 4 0x09 0xNN Database Song Record Index byte 3 0x0A 0xNN Database So...

Page 10: ...um 23 GetCurrentPlayingSongIndex 0x3C 0x22 GetCurrentPlayingSongIndex Direction Controller iPort Description Requests the database index of the currently playing song NOTE The song index returned is only valid if the iPod is currently playing or paused a song Packet Structure Byte Number Value Meaning 0x00 0x2A Start character 0x01 0x49 Device type iPort 0x02 0x00 Packet Length High Byte 0x03 0x03...

Page 11: ...2A Start character 0x01 0x49 Device type iPort 0x02 0x00 Packet Length High Byte 0x03 0x07 Packet Length Low Byte 0x04 0x38 Packet Command Type 0x05 0x3C Packet Command High Byte 0x06 0x25 Packet Command Low Byte 0x07 0xNN Database Record Count byte 4 0x08 0xNN Database Record Count byte 3 0x09 0xNN Database Record Count byte 2 0x0A 0xNN Database Record Count byte 1 0x0B 0xNN Checksum 27 RetrieveC...

Page 12: ...06 0x28 Packet Command Low Byte 0x07 0x18 Checksum 30 ReturniPodName 0x3C 0x29 ReturniPodName Direction iPort Controller Description In response to the RequestiPodName command returns the name of the user s iPod NOTE If the iPod name is undefined will return iPod Packet Structure Byte Number Value Meaning 0x00 0x2A Start character 0x01 0x49 Device type iPort 0x02 0xNN Packet Length High Byte 0x03 ...

Page 13: ...abase Record Index byte 1 0x0C 0xNN Checksum 33 Acknowledge 0x3C 0x3D Acknowledge Direction iPort Controller Description This telegram acknowledges the receipt of a command received and returns the command status Command Result Status Code Code Category Type 0x00 Success OK 0x01 Error Unknown Database Category 0x02 Error Command Failed 0x03 Error Out of Resources 0x04 Error Bad Parameter 0x05 Erro...

Page 14: ...acket Command High Byte 0x06 0x39 Packet Command Low Byte 0x07 0x03 Checksum 36 ExitRemoteUIMode 0x3C 0x3A ExitRemoteUIMode Direction Controller iPort Description Command to force the iPod to exit two way communication mode Packet Structure Byte Number Value Meaning 0x00 0x2A Start character 0x01 0x49 Device type iPort 0x02 0x00 Packet Length High Byte 0x03 0x03 Packet Length Low Byte 0x04 0x3C Pa...

Page 15: ... an iPod is docked into the iPort LED Mode Code Code LED Mode 0x00 OFF 0x01 ON Packet Structure Byte Number Value Meaning 0x00 0x2A Start character 0x01 0x4D Device type iPort Micro 0x02 0x00 Packet Length High Byte 0x03 0x04 Packet Length Low Byte 0x04 0x01 Packet Command Type 0x05 0x00 Packet Command High Byte 0x06 0x01 Packet Command Low Byte 0x07 0xNN LED Mode Code 0x08 0xNN Checksum 40 LED_ON...

Page 16: ...0x08 0xNN Checksum 42 LED_Brightness_Undocked 0x00 0x04 LED_Brightness_Undocked Direction Controller iPort Description Command to adjust the brightness of the LEDs when an iPod is not docked into the iPort LED Brightness Mode Code Code LED Brightness Mode 0x01 Dim 0x02 Medium 0x03 Bright Packet Structure Byte Number Value Meaning 0x00 0x2A Start character 0x01 0x4D Device type iPort Micro 0x02 0x0...

Page 17: ...PodName My iPod Value Meaning 0x2A Start character 0x49 Device type 0x00 Packet Length H 0x0A Packet Length L 0x38 Command Type 0x3C Packet Command H 0x29 Packet Command L 0x4D ASCII M 0x79 ASCII y 0x20 ASCII space 0x69 ASCII i 0x50 ASCII P 0x6F ASCII o 0x64 ASCII d 0x00 ASCII null 0x9E Checksum 17 Instruction Manual iPort RS 232 Programming Detailed Example The following example is a ReturniPodNa...

Page 18: ... are trademarks of Dana Innovations iPod is a registered trademark of Apple Computer Inc Decora is a registered trademark of Leviton Manufacturing Co Inc Instruction Manual iPort RS 232 Programming 07 05 san clemente ca 888 45 iPort www iportmusic com ...

Reviews: