BlueTiger™ Connected Optical Drive Family CD-80 CD Player ... · tags exchanged), max. 20 tracks CD text added to chapter 1.8.1 19-11-2007 V.0.11 WGR CD text character code added

Copyright © 2008 Anagram Technologies SA and StreamUnlimited Optical Storage

All rights reserved. Reproduction in whole or in part is prohibited without the prior consent of the copyright owner. The information presented in this document does not form part of any quotation or contract, is believed to be accurate and reliable and may be changed without notice. No liability will be accepted by the publisher for any consequence of its

use. ANAGRAM, BlueTiger, Q5, and Sonic2 are trademarks or registered trademarks of ANAGRAM Technologies. All other trademarks included herein are the property of their respective owners.

BlueTiger™ Connected Optical Drive Family

CD-80 CD Player

Module Command Interface Specification v1.09

March 2009

StreamUnlimted Optical StorageGmbH

Gutheil-Schoder-Gasse 10 1100 Vienna

Austria

Phone: +43 1 60101 4998 Fax: +43 1 60101 4401

BlueTiger CD-80 SW Command Interface

Page 2 of 41

Abstract Describes the BlueTiger CD-80 software command interface. Document History No. Primary Author(s) Description of Version Date Completed

v.0.1 MJi Initial revision 11-06-2007 v.0.3 WGR Rework 18-09-2007 v.0.4 WGR For SW Version 0.6 27-09-2007 v.0.5 WGR For SW Version 0.8 04-10-2007 v.0.6 THU For SW Version 0.13 04-10-2007 v.0.7 WGR Bugfixes for SVN 04-11-2007 v.0.8 THU CD text corrections,

chapter 1.4.1 I2C timing parameters 14-11-2007

V.0.9 WGR TOC reading: CDROM flag added 16-11-2007 V.0.10 THU Small correction for CD text (album, track

tags exchanged), max. 20 tracks CD text added to chapter 1.8.1

19-11-2007

V.0.11 WGR CD text character code added 21-11-2007 V.0.12 WGR I2C Address, Power Off, CD text 29-11-2007 V.0.13 WGR Initialisation, AC_Set_Loader_Type added 20-12-2007 V.1.0 WGR Text corrections 16-01-2008 V.1.01 WGR inner switch error added (SW Version 36) 24-01-2008 V.1.02 WGR update of I2C timing 26-02-2008 V.1.03 WGR update for slot loader 24-04-2008 V.1.04 WGR cd text corrections 14-05-2008 V.1.05 WGR EV_Tray_Closing, EV_Tray_Opening,

EV_Loader_Type_Ok added 12-06-2008

V.1.06 WGR EV_Disc_Stopped detail added 08-08-2008 V.1.07 WGR search – pause connection removed 25-09-2008 V.1.08 WGR state changes in more detail 01-10-2008 V.1.09 MJI Add toploader 09-03-2009 Related Documentation Part Number Description

BT-CD-80-PB BlueTiger CD-80 Product Brief BT-CD-80-CO BlueTiger CD-80 Connectors


Page 3 of 41

Ordering Information Part Number Description Package

BT-CD-80 CD-80 CD servo and DSP board N/A Release Notice This document is under configuration control and updates will only be issued as a replacement document with a new version number. Confidentiality Notice The information contained in this document is confidential information property of StreamUnlimited Optical Storage GmbH. No part of this document may be used or reproduced without written permission. Copyright Notice All rights reserved. No part of this work covered by the owners copyright may be reproduced or copied in any form or by any means (graphic, electronic or mechanical, including photocopying, recording, taping or information retrieval systems) without the written permission.


Page 4 of 41

Preface About This Manual This document provides the information needed to communicate to the BlueTiger CD-80 CD player board via a software command interface. For a more detailed description of this product, please refer to the product data briefs available from the StreamUnlimited Optical Storage website at http://www.streamunlimited.com. Support documents are listed in the section of this guide entitled Additional Documentation. Company Addresses StreamUnlimted Optical StorageGmbH Gutheil-Schoder-Gasse 10 1100 Vienna Austria Phone +43 1 60101 4998 Fax +43 1 60101 4401 Warnings and Restrictions It is important to operate the BlueTiger CD-80 within the specified input and output ranges described in this document. Exceeding the specified input/output ranges may cause unexpected operation and/or irreversible damage to your development system. If there are questions concerning the input/output ranges, please contact a company representative prior to connecting the input power. Applying loads outside of the specified output range may result in unintended operation and/or possible permanent damage to your development system. Document Structure Chapter 1 Introduction Chapter 2 Message Overview Chapter 3 Action Description Chapter 4 Event Description Chapter 5 PC Interface Tool Chapter 6 Abbreviations and Acronyms


Page 5 of 41

Information About Cautions and Warnings

Note

A NOTE provides additional or special information to assist operation. Disregarding a NOTE may cause inconvenience but will not result in personal injury or equipment damage.

Caution

A CAUTION is provided in a procedure whenever electrical or mechanical damage may occur. Failure to heed a CAUTION may result in some form of damage to the equipment; however, personal injury is unlikely.

If You Need Assistance If you have questions regarding either the use of this software command interface or the information contained in the accompanying documentation, please contact the StreamUnlimited Optical Storage. Copyright © 2008 StreamUnlimited Optical Storage GmbH. All right reserved Contents of this publication may be not reproduced in any form without the written permission. Reproduction and / or reverse engineering of copyrighted software is prohibited.


Page 6 of 41

Table of Contents

1 List of Figures .........................................................................................................................................................9

1 List of Tables.........................................................................................................................................................10

I. Introduction ..........................................................................................................................................................11

A. Communication Interface...................................................................................................................................11 A. Message Types ...................................................................................................................................................12 A. Message Syntax..................................................................................................................................................12 A. Timings...............................................................................................................................................................12

1. I²C..................................................................................................................................................................12 A. BT-CD-80 States ................................................................................................................................................13 A. Scenarios............................................................................................................................................................14

1. Tag Reading...................................................................................................................................................15 1. Power Off ......................................................................................................................................................15

A. Play Modes.........................................................................................................................................................16 A. Limitations and General Remarks .....................................................................................................................16

1. No Text Available .........................................................................................................................................16 1. Amount of Tracks..........................................................................................................................................16 1. CD Text .........................................................................................................................................................16 1. Copy Protected Discs.....................................................................................................................................16 1. Attribute Requests in a not allowed State......................................................................................................16 1. Module reset ..................................................................................................................................................17

I. Message Overview ................................................................................................................................................18

A. Actions µP to BT-CD-80....................................................................................................................................18 A. Events BT-CD-80 to µP .....................................................................................................................................19

I. Actions – µP to BT-CD-80 ...................................................................................................................................21 1. Navigation .....................................................................................................................................................21

a) AC_Play ....................................................................................................................................................21 a) AC_Play_Track_XY .................................................................................................................................22 a) AC_Pause..................................................................................................................................................23 a) AC_Stop....................................................................................................................................................23 a) AC_Next_Track ........................................................................................................................................23 a) AC_Previous_Track ..................................................................................................................................24 a) AC_Search_Forward.................................................................................................................................24 a) AC_Search_Backward ..............................................................................................................................24 a) AC_Goto_Time.........................................................................................................................................25 a) AC_Set_Track _XY ..................................................................................................................................25 a) AC_Add_Program_XY.............................................................................................................................25 a) AC_Clear_Program...................................................................................................................................26

1. Get Attributes ................................................................................................................................................26 a) AC_Get_State............................................................................................................................................26


Page 7 of 41

a) AC_Get_Disc_Contents ............................................................................................................................26 a) AC_Get_Play_Mode .................................................................................................................................27 a) AC_Get_Track_ Name_XY......................................................................................................................27 a) AC_Get_Track_Length_XY .....................................................................................................................27 a) AC_Get_Tag_XY .....................................................................................................................................28 a) AC_Get_Current_Track_Folder_Number.................................................................................................28 a) AC_Get_Current_Time.............................................................................................................................29 a) AC_Get_BLER (option for future applications) .......................................................................................29 a) AC_Get_FW_Version...............................................................................................................................29

1. Tray Operation...............................................................................................................................................29 a) AC_Tray_Open .........................................................................................................................................29 a) AC_Tray_Close.........................................................................................................................................30 a) AC_Set_Loader_Type...............................................................................................................................30

1. Audio .............................................................................................................................................................30 a) AC_Set_Audio_Output .............................................................................................................................30 a) AC_Audio_Mute.......................................................................................................................................31

1. Firmware Update ...........................................................................................................................................31 a) AC_Firmware_Update_Start.....................................................................................................................31 a) AC_Firmware_Update_Data.....................................................................................................................31 a) AC_Firmware_Update_Validate...............................................................................................................31

1. Miscellaneous ................................................................................................................................................32 a) AC_Prepare_Power_Down .......................................................................................................................32 a) ........................................................................................................................................................................32

II. Events – BT-CD-80 to µP ................................................................................................................................33

A. EV_State.............................................................................................................................................................33 A. EV_Playmode.....................................................................................................................................................33 A. EV_FW_Version ................................................................................................................................................33 A. EV_Tag_XY........................................................................................................................................................34 A. EV_Track_Length_XY........................................................................................................................................34 A. EV_Current_Time ..............................................................................................................................................35 A. EV_Absolute_Time.............................................................................................................................................35 A. EV_Current_Track_Folder_Number .................................................................................................................36 A. EV_TOC_Ready.................................................................................................................................................36 A. EV_Disc_Stopped ..............................................................................................................................................37 A. EV_Tray_Opened...............................................................................................................................................37 A. EV_Tray_Closed ................................................................................................................................................37 A. EV_Tray_Opening .............................................................................................................................................37 A. EV_Tray_Closing...............................................................................................................................................37 A. EV_BLER ...........................................................................................................................................................38 A. EV_Invalid_Data_Received ...............................................................................................................................38 A. EV_Display_Info_Changed ...............................................................................................................................38 A. EV_Module_Off .................................................................................................................................................38 A. EV_Disc_Error ..................................................................................................................................................39 A. EV_Tray_Error ..................................................................................................................................................39 A. EV_Loader_Type_Ok.........................................................................................................................................39 A. EV_Send_Buffer_Full ........................................................................................................................................39


Page 8 of 41

A. EV_Program_Details.........................................................................................................................................40

I. CDControlTool - PC Interface Tool ...................................................................................................................41

I. Abbreviations and Acronyms..............................................................................................................................41


Page 9 of 41

1 List of Figures

Figure 1: I2C Communication Interface.....................................................................................................................11

Figure 2: I²C Read Operation ......................................................................................................................................12

Figure 3: States of the BT-CD-80 Module ..................................................................................................................13

Figure 4: Basic Message Passing on the Bus...............................................................................................................14

Figure 5: Reading three Attributes of CD text info ..................................................................................................15

Figure 6: Preparing the module for Safe Power Off..................................................................................................15


Page 10 of 41

1 List of Tables

Table 1: Message Types ................................................................................................................................................12

Table 2: Timing Values.................................................................................................................................................12

Table 3: Playback Modes .............................................................................................................................................16

Table 4: Overview of Navigation Messages ................................................................................................................17

Table 5: Overview of Get-Attribute Messages ...........................................................................................................17

Table 6: Overview of Tray Operation Messages ........................................................................................................17

Table 7: Overview of Audio Control Messages ..........................................................................................................18

Table 8: Overview of Firmware Update Messages.....................................................................................................18

Table 9: Overview of Miscellaneous Messages ...........................................................................................................18

Table 10: Overview of Event Messages .......................................................................................................................18


Page 11 of 41

I. Introduction

This document specifies the interface from set level microcontroller to the CD-80 DSP module as part of the BlueTiger platform.

A. Communication Interface The following signals are used for communication between the set µP and the CD-80 DSP module:

• Bidirectional data line (SDA) • Clock line (SCL) • I²C Slave Interrupt line (INT)

BlueTigerCD-80

SDA

SCL

INT

Figure 1: I2C Communication Interface

The BlueTiger CD-80 DSP module is an I2C slave with an additional interrupt line. A negative pulse on this line indicates the master that there is data ready to be fetched. Please refer to the Philips I2C bus specification for interface definition. I2C bus speed: Standard mode (max. 100kHz). I2C ADDRESS: 0x31 (excluding the read / write bit)


Page 12 of 41

A. Message Types

Table 1 explains the message types available on the bus. Table 1: Message Types

MESSAGE type Description action Sent from the µP to the module requesting some

action of the module. event Response to a previously sent action or

information about an independent event occurred in the BT-CD-80.

A. Message Syntax <message byte> <parameters length> [parameters (length bytes)] The message is delivered when the module reads the message byte, the parameters length byte and the optional parameters (when length > 0). Parameters must be given in the same order as defined in the detailed message description. The maximum parameter length is not defined.

A. Timings

1. I²C Table 2: Timing Values ITEM MIN MAX t1 Message transmission time + 0 Message transmission time + 150

ms (After 150 ms the message will be discarded and the next message will be transmitted)

t2 0s 10ms (up to 5 messages can be kept in the transmit buffer of the CD80 uP. )

t3 Refer to I2C specification Refer to I2C specification


Page 13 of 41

Figure 2: I²C Read Operation

The internal buffer for reading and writing is limited. So sending too many actions to the CD80 Module can lead to a loss of data. A delay of at least 20ms between 2 actions is proposed to allow message processing and sending of a reply. It is suggested to start reading from the CD80 Module within 20 ms after the INT line goes low to avoid discarding of messages due to the limited internal buffer.

A. BT-CD-80 States

Figure 3: States of the BT-CD-80 Module

The module responds with a EV_State to any action which leads to a state change. Module Initialisation: After startup or reset, wait for 300ms and then send AC_Set_Loader_Type. The Command AC_Set_Loader_Type must be the first command sent to the module, otherwise, the module


Page 14 of 41

cannot work properly, as no other commands will be accepted. (see also EV_Tray_Error). When the selection is ok, the module reponds with EV_Loader_Type_Ok. The module will respond to AC_Get_FW_Version. Stopping a disc: After sending AC_Get_Disc_Content, it is possible to send AC_Stop to stop the disc before receiving the TOC information. The module will than stay in IDLE mode. Make sure to receive EV_Disc_Stopped before sending AC_Get_Disc_Content again or opening the tray. When in PLAY state, sending AC_Stop will stop the disc. Make sure, that you receive EV_Disc_Stopped before sending AC_Play or AC_Play_Track_XY again. Getting the information about the STOP state in not enough. Tray operations are only possible after receiving EV_Disc_Stopped, to avoid putting a rotating disc on the tray. When sending AC_Stop while the disc is accelerating or checking the focus, it may take up to 5 second before receiving EV_Disc_Stopped. Tray operations: In IDLE state, or in STOP state after receiving EV_Disc_Stopped, the tray can be opened by sending AC_Tray_Open. The module will respond with EV_Tray_Opening and send EV_Tray_Opened, once the tray is fully open. For closing an open tray, or for checking if the tray is closed, you can send AC_Tray_Close. The module will report EV_Tray_Closing once the tray starts moving and send EV_Tray_Closed once the tray is fully closed. You can also manually push the tray in, which will lead to a EV_Tray_Closing. In case the tray jams, an EV_Tray_Error is reported. AC_Tray_Open or AC_Tray_Close are still possible after the error to continue with tray operations and to check that the tray jam is gone.

A. Scenarios Figure 4 shows the passing of actions and events described in section A. Events can occur independently of some previously sent action or as a response of such an action. Actions or events may happen asynchronously at each of the communicating modules and, therefore, be sent at any time. The master must generate the clock and retrieve the message. The master is notified that a message can be retrieved via the I²C interrupt line.

Figure 4: Basic Message Passing on the Bus

µP BT-CD-80

action

event

event


Page 15 of 41

1. Tag Reading Figure 5 shows an example of a µP, requesting the track name and track artist of a CD-TXT info, specified by the tracknumber in the AC_Get_Tag_XY message. The BT-CD-80 responds with one event per requested attribute. Attention: Only 2 CD text tags can be requested at once (additional ones will just be ignored).

Figure 5: Reading three Attributes of CD text info

1. Power Off The module should be prepared for powering off via the message AC_Prepare_Power_Down as shown in Figure 6. After a certain time (max. 2,5 seconds) the module will reply an event EV_State ( READY_FOR_POWER_OFF). Now the power supply of the module may be switched off.

Figure 6: Preparing the module for Safe Power Off

In case no powering down indication is available in the set (tact switches etc.) it is also allowed to skip the procedure mentioned above. If doing so it can happen that the lens is knocking during switching off the module. Powering Off is only possible in IDLE or STOP state. When in play mode (or TOC reading), send CD_STOP and wait for EV_DISC_STOPPED before sending AC_Prepare_Power_Down for a safe power off.


Page 16 of 41

A. Play Modes Table 3: Playback Modes

NORMAL PLAY 0x00 SHUFFLE ALL 0x01 SHUFFLE REPEAT ALL DISC 0x02 SHUFFLE FOLDER 0x03 SHUFFLE REPEAT ALL FOLDER 0x04 REPEAT DISC 0x05 REPEAT FOLDER 0x06 REPEAT TRACK 0x07 PROGRAM_PLAY 0x08 PROGRAM_SHUFFLE 0x09 PROGRAM_REPEAT 0x0A PROGRAM_SHUFFLE_REPEAT 0x0B For CD80, only the CDDA parts apply (i.e. Commands for folders are ignored).

A. Limitations and General Remarks

1. No Text Available In case certain text info is requested by the µP and no text is available in the module an empty string will be returned.

1. Amount of Tracks Up to 99 tracks are supported.

1. CD Text CD text of up to 33 tracks + album + artist can be stored by the module. The current maximum string length is 32 characters. To allow future extension of the CD80 module, please be sure, that the front software does not depend on these number. Use an appropriate algorithm to check the string size. The CD TEXT standard does not define a maximum string length.

1. Copy Protected Discs MIDBAR, KEY2AUDIO, MEDIACLOQ, STARFORCE, SAFEAUDIO (investigation + testing is in progress !!)

1. Attribute Requests in a not allowed State The delivered return value will be 0x00 in any case.


Page 17 of 41

1. Module reset In case of unexpected behaviour of the module (e.g. no responses to actions due to ESD), the set is responsible for resetting the module and restart the module with the initialisation sequence.


Page 18 of 41

I. Message Overview

A. Actions µP to BT-CD-80 Table 4: Overview of Navigation Messages

Message Code Send-Parameter(s) AC_Play 0x11 Mode AC_Play_Track_XY 0x12 Track_Number, 0HFF, Mode AC_Pause 0x13 - AC_Stop 0x14 - AC_Next_Track 0x15 - AC_Previous_Track 0x16 - AC_Next_Folder 0x17 - AC_Previous_Folder 0x18 - AC_Search_Forward 0x19 Search_Speed AC_Search_Backward 0x1a Search_Speed AC_Set_Track_ XY 0x1b Track_Number, 0HFF AC_Add_Program_XY 0x1c Track_Number, 0HFF AC_Clear_Program 0x1d - AC_Goto_Time 0x1f Minute, Second, Frame Table 5: Overview of Get-Attribute Messages

Message Code Send-Parameter(s) AC_Get_State 0x20 State AC_Get_Disc_Contents 0x21 - AC_Get_Play_Mode 0x22 - AC_Get_Track_Folder_Name_XY 0x23 Track_Number, 0HFF AC_Get_Track_Length_XY 0x25 Track_Number AC_Get_Tag_XY 0x26 Track_Number, 0HFF,Tag_Type AC_Get_Current_Track_Number 0x27 AC_Get_Current_Time 0x28 Relative, Absolute AC_Get_BLER 0x2c AC_Get_FW_Version 0x2d AC_Get_Program_Details 0x2e Table 6: Overview of Tray Operation Messages


Page 19 of 41

Message Code Send-Parameter(s) AC_Tray_Open 0x31 Speed AC_Tray_Close 0x32 Speed Table 7: Overview of Audio Control Messages

Message Code Send-Parameter(s) AC_Set_Audio_Output 0x41 DAC Format, 0H00, Enable bit AC_Audio_Mute 0x43 Mute Table 8: Overview of Firmware Update Messages

Message Code Send-Parameter(s) AC_Firmware_Update_Start 0x51 Signature AC_Firmware_Update_Data 0x52 Length, data AC_Firmware_Update_Validate 0x53 CRC Table 9: Overview of Miscellaneous Messages

Message Code Send-Parameter(s) AC_Prepare_Power_Down 0x61 - AC_Set_Loader_Type 0x65 Type

A. Events BT-CD-80 to µP Table 10: Overview of Event Messages Event Code Receive-Parameter(s) EV_Display_Info_Changed 0xa0 Change_Indicator EV_State 0xa1 State EV_Playmode 0xa2 Playmode EV_FW_Version 0xa3 FW_Version

EV_Tag_XY 0xa4 Track_Number, Text item, CD text (Tracktitle or Trackartist, Albumtitle or Artist)

EV_Track_Length_XY 0xa5 Track_Length EV_Track_Num_ XY 0xa6 Tracks_In_Folder, Folder_Number EV_Current_Track _Folder_Number 0xab Track_Number, Index, 0HFF EV_Current_Time 0xac RelTime EV_Disc_TOC_Ready 0xad Toc_Info EV_Disc_Stopped 0xae - EV_Absolute_Time 0xaf AbsTime EV_Tray_Opened 0xb1 - EV_Tray_Closed 0xb2 -


Page 20 of 41

EV_BLER 0xb3 BLER EV_Invalid_Data_Received 0xb4 - EV_Module_Off 0xb5 - EV_Disc_Error 0xb6 Error_Number EV_Tray_Error 0xb7 Error_Number EV_Send_Buffer_Full 0xb8 - EV_Program_Details 0xba Program Count, Program Time EV_Tray_Opening 0xbb - EV_Tray_Closing 0xbc - EV_Loader_Type_Ok 0xbd -


Page 21 of 41

I. Actions – µP to BT-CD-80

1. Navigation

a) AC_Play

Purpose : Play the disc depending on the included mode parameter. Parameters : Mode (1 Byte) See Table Precondition : TOC_READING, STOP, PLAY (PAUSE on or off) state Postcondition : STATE = TOC_READING:

The playback will be started with the requested mode when TOC_READING is finished and a valid disc is detected. When Mode = {000, 005, 007} the 1st track will be selected for playback. If Mode = {001 or 002 } a new track will be shuffled. ----------------------------------------------------------------------------------------------- STATE = STOP: The playback will be started with the requested mode. If Mode = [000,005, 007} the 1st track will be selected for playback. If Mode = {001 or 002} the track will be shuffled. ----------------------------------------------------------------------------------------------- STATE = PLAY: The playback will continue with the requested mode. PAUSE ACTIVE --> The module resumes playback at the current position in the requested mode.

Description : NOTE 1: To be used for changing the play mode in PLAY state. NOTE 2: If shuffle is activated during non-shuffle play and a new track will be shuffled immediatly. NOTE 3: When sending AC_Play – AC_Stop – AC_Play, make sure that you received EV_Disc_Stopped before sending AC_Play again.


Page 22 of 41

a) AC_Play_Track_XY

Purpose : Any track of the disc can be selected for playback. Parameters : Track_Number (2 Bytes) Byte 1 = 0H00

Byte 2 = Low Byte 1...99 0 = invalid

Folder_Number (1Byte) 255 = CDDA tracks Mode (1Byte) See Table Precondition : TOC_READING, STOP, PLAY, PAUSE, SEARCH Postcondition : STATE = TOC_READING

The module will select the requested track and play mode if TOC_READING is finished and a valid disc is detected. When Mode = {000,005, 007} and the Track_Number is not available the 1st track will be played. If Mode = {001 or 002} a new track will be shuffled. ----------------------------------------------------------------------------------------------- STATE = STOP If Mode = {000,005,007} the requested Track_Number will be played. If the track is not available the 1st track of the disc is played. If Mode = {001 or 002} a new track will be shuffled and playback starts in the requested mode. ----------------------------------------------------------------------------------------------- STATE = PLAY: If Mode = {000,005,007} the requested Track_Number will be played. If the track is not available the message will be ignored. If Mode = {001 or 002} a new track will be shuffled and the requested play mode will be selected. PAUSE ACTIVE --> Everything described above is still valid and the module will remain in PAUSE after selecting the new track.

Description : NOTE 1: MESSAGE WITH MODE = {001,002} --> The Track_Number is not relevant and a new track will be shuffled.


Page 23 of 41

a) AC_Pause

Purpose : Sets the module to pause mode. Parameters : None Precondition : PLAY (PAUSE on or off) state Postcondition : STATE = PLAY:

PAUSE NOT ACTIVE --> The module will enter the PAUSE state at the current position. PAUSE ACTIVE --> No effect.

Description : The µP has to send AC_Play(Mode) to release the pause mode.

a) AC_Stop

Purpose : Sets the module to stop mode. Parameters : None Precondition : TOC_READING, PLAY, PAUSE, SEARCH Postcondition : The module enters the STOP state. Description : Note:

The currently selected play mode is not changed. When the disc has stopped, the module reports EV_Disc_Stopped.

a) AC_Next_Track

Purpose : The module will jump to the begin of the next track. Parameters : None Precondition : STOP, PLAY, PAUSE, SEARCH state Postcondition : STATE = STOP:

The next track will be selected. If the last track is active it will wrap around to the first track. ----------------------------------------------------------------------------------------------- STATE = PLAY: The next track will be selected. If the last track is active it will wrap around to the first track. PAUSE ACTIVE --> The module will remain in PAUSE after selecting the new track.

Description : -


Page 24 of 41

a) AC_Previous_Track

Purpose : The module will jump to the beginning of the current track when the timeoffset to the track’s beginning is >3 seconds. Otherwise it will jump to thebeginning of the previous track.

Parameters : None Precondition : STOP, PLAY, PAUSE, SEARCH state Postcondition : Wrap around if the the first track is selected.

If PAUSE is on: The module will remain in PAUSE. Description : -

a) AC_Search_Forward

Purpose : Activates the search forward mode. Parameters : Search_Speed (1 Byte) 000 = speed 1 (slow)

001 = speed 2 (fast) Precondition : PLAY, PAUSE state Postcondition : Module enters search forward mode with the requested speed. Description : The search process will be stopped automatically after the following

messages: AC_Stop AC_Next_Track, AC_Previous_Track AC_Play AC_Play_Track_XY In “NORMAL PLAY” or “REPEAT DISC” the search continues to the next track. At last track, send AC_Stop to stop the disc. In all other playmodes, search can only be done in the current track.

a) AC_Search_Backward

Purpose : Activates the search backward mode. Parameters : Search_Speed (1 Byte) 000 = speed 1 (slow)

001 = speed 2 (fast) Precondition : PLAY, PAUSE state Postcondition : Module enters search backward mode with the requested speed. Description : The search process will be stopped automatically after the following

messages: AC_Stop AC_Next_Track, AC_Previous_Track AC_Play AC_Play_Track_XY In “NORMAL PLAY” or “REPEAT DISC” the search continues to the previous track. At first track, send AC_Play to start playing again. In all other playmodes, search can only be done in the current track.


Page 25 of 41

a) AC_Goto_Time

Purpose : Direct Access of a specific position of the currently playing track Parameters : Minutes (1 Byte)

Seconds (1 Byte) Frames (1 Byte)

Precondition : PLAY state Postcondition : PLAY state Description : Jumps to the specified position and continues playback, e.g. can be used

for (A-B) repeat function, the time has to be within the length of thecurrently playing track (CDDA only)

a) AC_Set_Track _XY

Purpose : Direct preselection of a specific track in STOP state. Parameters : Track_Number (2 Bytes) Byte 1 = 0H00


Folder_Number (1Byte) 255 = CDDA tracks Precondition : STOP, PLAY, PAUSE, SEARCH state Postcondition : EV_Display_Info_Changed Description : In case the requested track is not available or it is already selected it will

be ignored.

a) AC_Add_Program_XY

Purpose : Adds a specific track to the program. Parameters : Track_Number (2 Bytes) Byte 1 = 0H00


Folder_Number (1Byte) 255 = CDDA tracks Precondition : STOP, PLAY, PAUSE, SEARCH state (TOC available) Postcondition : a track has been added to the program Description : Adds the specified track to the program. The maximum program count is

30 tracks. In case the requested track is not available or the maximum program count has been reached, it will be ignored.


Page 26 of 41

a) AC_Clear_Program

Purpose : Clears the program Parameters : Precondition : STOP, PLAY, PAUSE, SEARCH state Postcondition : the program is empty Description : when clearing the program in program play mode, the play mode is

automatically reset to NORMAL_PLAY.

1. Get Attributes

a) AC_Get_State

Purpose : Returns the state of the module. Parameters : State (1 Byte) 000 = READY_FOR_POWER_OFF

001 = IDLE (no TOC available) 002 = TOC_READING 003 = STOP 004 = PLAY 005 = PAUSE 006 = SEARCH_FORWARD 007 = SEARCH_BACKWARD 008 = not used 009 = FIRMWARE_UPDATE

Precondition : Any state Postcondition : - Description : -

a) AC_Get_Disc_Contents

Purpose : The module will try to read the TOC of the curently inserted disc. Parameters : None Precondition : STOP or IDLE Postcondition : EV_TOC_Ready Description : Note 1:

ALL PREVIOUS TOC INFORMATION WILL BE LOST. Note 2: The play mode will always be reset to "000 = NORMAL PLAY" in case a message AC_Read_TOC is sent.


Page 27 of 41

a) AC_Get_Play_Mode

Purpose : Returns the currently active PLAY mode. Parameters : - Precondition : STOP, PLAY state Postcondition : - Description : -

a) AC_Get_Track_ Name_XY

Purpose : Requests the name of the track or folder defined through the parameters Track_Number and Folder_Number.

Parameters : Track_Number (2 Bytes) Byte 1 = 0H00 Byte 2 = Low Byte 1...99

Folder_Number (1 Byte) 255 = CDDA tracks Precondition : STOP or PLAY state Postcondition : EV_Track_ XY Description : In case an invalid Track_Number, Folder_Number is requested, an empty

string will be returned via the event.

a) AC_Get_Track_Length_XY

Purpose : Returns the total play time of the track defined through the parametersTrack_Number.

Parameters : Track_Number (2 Bytes) Byte 1 = 0H00 Byte 2 = Low Byte � 1...99

Folder_Number (1 Byte) 255 = CDDA tracks Precondition : STOP or PLAY state Postcondition : - Description :


Page 28 of 41

a) AC_Get_Tag_XY

Purpose : Requests the module to return the CD-Text info of the file defined through Track_Number.

Parameters :: Track_Number (2 Bytes) Byte 1 = 0H00 Byte 2 = Low Byte 1...99

Folder_Number (1 Byte) 0HFF = CDDA tracks Tag_Type (1 Byte) Bit0: TRACK NAME

Bit1: TRACK ARTIST Bit2: ALBUM NAME Bit3: ALBUM ARTIST Bits 4-7 : reserved Setting a bit to ‘1’ will request the selected information. For each type a separate EV_Tag_XY event will be issued

Precondition : STOP or PLAY Postcondition : The module will immediately return the requested information since the

CD text data has been prepared during toc reading. If no info is available the string will be empty.

Description : The resulting TAG information can be retrieved via the event EV_Tag_XY. For each selected tag type in the TAG_Type a separate event is issued. If the requested track is not available on the disc the command will be ignored. Attention: Up to 2 tag infos can be requested at once ! If the maximum is exceeded the request of the additional tag_infos will be dropped.

a) AC_Get_Current_Track_Folder_Number

Purpose : Returns the track number and the index of the currently playing or selected track.

Parameters :

Precondition : PLAY, STOP state Postcondition : - Description : -


Page 29 of 41

a) AC_Get_Current_Time

Purpose : Returns the track time of the currently playing track. Parameters : Time_Type 0H00 = Time in Track

0H01 = Time on Disc Precondition : STOP, PLAY state Postcondition : - Description : PAUSE area:

In case of playing in a pause area the time info is negative -> the information whether the time is negative or not is coded in byte 3 / Bit 7. TRACK SEARCH active: In case a track search is active byte 3 = "255". This info can be used to clear the time info on the display in case a search process is active (example: "--:--" on display). STOP state: "00:00" will be replied.

a) AC_Get_BLER (option for future applications)

Purpose : BLER describes the count of uncorrectable frames per second

Parameters : Precondition : PLAY state Postcondition : - Description : returns the BLER value using EV_BLER

a) AC_Get_FW_Version

Purpose : Returns the module firmware version number. Parameters : Precondition : Any state Postcondition : - Description : see also EV_FW_Version

1. Tray Operation

a) AC_Tray_Open

Purpose : Opens the CD Tray Parameters : Speed 0H00 SLOW

0H01 MEDIUM 0H02 HIGH

Precondition : STOP state, IDLE state Postcondition : The module opens the tray (EV_Tray_Opening) and enters an IDLE state

The EV_Tray_Opened event will be issued on success EV_Tray_Error will report an error

Description : speed selection is not available for slot loader


Page 30 of 41

a) AC_Tray_Close

Purpose : Closes the CD Tray Parameters : Speed 0H00 SLOW

0H01 MEDIUM 0H02 HIGH

Precondition : IDLE state Postcondition : The module closes the tray (EV_Tray_Closing) and enters an IDLE state

The EV_Tray_Closed event will be issued on success EV_Tray_Error will report an error

Description : speed selection is not available for slot loader

a) AC_Set_Loader_Type

Purpose : This sets the type of the used loader (slot loader or tray loader) and pickupParameters : Type (1 Byte) 0H00 = JPL-Tray (default), Sony KHM313

0H02 = JPL-Tray, Sanyo SF-HD850 0H20 = top loading, KHM313 0H22 = top loading, Sanyo SF-HD850 0H40 = slot loader, Sony KHM313 0H42 = slot loader, Sanyo SF-HD850

Precondition : Reset Postcondition : IDLE state Description : This command has to be the first command after reset. The module

reponds with EV_Loader_Type_Ok when the selection is valid, or reports an error (EV_Tray_Error).

1. Audio

a) AC_Set_Audio_Output

Purpose : Select Output Parameters Parameters : Format (1 Byte) I2S interface format:

0: I2S (default) 1: Left Justified

Frequency_Sampling (1 byte)

I2S output frequency sampling [kHz]: 0: 44.1 1: 176.4

Precondition : Processing disabled Postcondition : Description : for CD80 fixed to I2S, 44.1 kHz


Page 31 of 41

a) AC_Audio_Mute

Purpose : CoMuting the output channels Parameters : Audio Muting enabled (1

Byte) Bit 0: SPDIF output mute Bit 1: I2S output mute Bits 2-7: Reserved (set to 0) SPDIF and DAC output mute: 0 = mute OFF (default) 1 = mute ON

Precondition : Any State Postcondition : - Description :

1. Firmware Update

Firmware update is currently not supported. Reserved for future extension.

a) AC_Firmware_Update_Start

Purpose : Enter firmware update mode Parameters : Signature (4 Byte) Byte 1: MSB, …, Byte 4: LSB

Always set to 424C5545 (hex) Precondition : Postcondition : Processing disabled Description : Disable all processing and erase a free flash block to prepare firmware

update. Command execution can takes several seconds. Do not erase the running firmware (power fail safe).

a) AC_Firmware_Update_Data

Purpose : Write a firmware data packet to the flash memory. Parameters : Length (1 Byte) Length in bytes of the data packet Data (0..128 Bytes) Data packet Precondition : Firmware update mode Postcondition : Description : Do not erase the running firmware (power fail safe).

a) AC_Firmware_Update_Validate

Purpose : Validate firmware sent. Parameters : CRC (4 Bytes) Byte1=MSB, Byte4=LSB Precondition : Firmware update mode Postcondition : DSP reboot Description : Check firmware CRC and validate the new firmware.


Page 32 of 41

1. Miscellaneous

a) AC_Prepare_Power_Down

Purpose : The module will be prepared for a following power off process. Thismessage prevents that the lens is knocking when the module is poweredoff.

Parameters : None Precondition : STOP or IDLE state Postcondition : EV_Module_Off will be triggered when ready. Description : -

a)


Page 33 of 41

II. Events – BT-CD-80 to µP

A. EV_State Purpose : Delivers the current state of the module. Parameters : State (1 Byte) 000 = READY_FOR_POWER_OFF

001 = IDLE (no TOC available) 002 = TOC_READING 003 = STOP 004 = PLAY 005 = PAUSE 006 = SEARCH_FORWARD 007 = SEARCH_BACKWARD 008 = not used 009 = FIRMWARE_UPDATE

Precondition : Any state Postcondition : The returned state is active. Description : The EV_State is sent automatically when a action command leads to a

state change

A. EV_Playmode Purpose : Returns the currently active PLAY mode. Parameters : Mode (1 Byte) See Table: 3 Precondition : STOP, PLAY state Postcondition : - Description : -

A. EV_FW_Version Purpose : Returns the module firmware version number. Parameters : Version_Number (1 Byte) 0..255 Precondition : Any state Postcondition : - Description : -


Page 34 of 41

A. EV_Tag_XY Purpose : Delivers the CDText information that was read from the disc during TOC

reading. Requested via the message AC_Get_Tag_XY. Parameters : Track_Number (2 Bytes) Byte 1 = High Byte

Byte 2 = Low Byte � 1...99

Folder_Number (1 Byte) 0HFF = CDDA tracks Tag_Type (1 Byte) 001 = TRACK NAME

002 = TRACK ARTIST NAME 004 = ALBUM NAME 008 = ALBUM ARTIST NAME

Text [30]+ null terminator byte

Coded as described in EV_TOC_READY

Precondition : EV_State = STOP or PLAY received after state TOC_READING and Disc_Type = CDDA.

Postcondition : - Description : The maximum string size = 32 characters.

Text is always null-terminated If no text is available an empty string will be returned (text data = 0). To allow future extension of the CD80 module, please be sure, that

the front software does not depend on the maximum string length.

A. EV_Track_Length_XY Purpose : Returns the total play time of the track defined through the parameters

Track_Number and Folder_Number. Parameters : Track_Number (2 Bytes) Byte 1 = 0H00e

Byte 2 = Low Byte --> 1...99

Folder_Number (1 Byte) 0HFF = CDDA tracks Track_Length (3 Bytes) Byte 1 = 0H00

Byte 2 = LowByte Minutes --> 0..99 Byte 3 = Seconds --> 0..59

Precondition : STOP or PLAY state Postcondition : - Description :


Page 35 of 41

A. EV_Current_Time Purpose : Returns the track time of the currently playing track. Parameters : Time (3 Bytes) Byte 1 = 0H00

Byte 2 = LowByte Minutes valid range {0..99} Byte 3 = Seconds valid range { 0..59} and {255} Bit 7 will be set to "1" if the time is

negative Precondition : STOP, PLAY state Postcondition : - Description : PAUSE area:


A. EV_Absolute_Time Purpose : Returns the absolute time of the currently playing track. Parameters : Time (3 Bytes) Byte 1 = 0H00

Byte 2 = LowByte Minutes valid range {0..99} Byte 3 = Seconds valid range { 0..59} and {255} Bit 7 will be set to "1" if the time is

negative Precondition : STOP, PLAY state Postcondition : - Description : PAUSE area:



Page 36 of 41

A. EV_Current_Track_Folder_Number Purpose : Returns the track number and the index number of the currently playing or

selected track. Parameters : Track_Number (2 Bytes) Byte 1 = 0H00

Byte 2 = Low Byte valid range {1...99}

Index_Number (1 Byte) 1..99 Folder_Number (1 Byte) 255 = CDDA tracks Precondition : PLAY, STOP state Postcondition : - Description : -

A. EV_TOC_Ready Purpose : Delivers the information of the disc contents after reading the disc. Parameters : Disc_Type (1 Byte) Bit0 = CDDA tracks available

Bit1 = reserved Bit2 = reserved Bit3 = NO DISC (no focus) Bit4 = reserved Bit5 = reserved Bit6 = reserved Bit7 = CDROM

Number_Folders (1 Byte) 255 = CDDA tracks Number_Tracks (2 Bytes) Byte 1 = 0H00

Byte 2 = Low Byte 1...99

Minutes (2 Bytes) Byte 1 = 0H00 Byte 2 = LowByte Minutes valid range {0..99}

Seconds (1 Byte) 0..59 FirstTrackNumber (1 Byte) 0..99 (valid for CDDA only) CD Text Character Code As described in CD Text standard

0H00 = ISO 8859-1 0H01 = ISO 646, ASCII 0H80 = Music Shift-JIS Kanji 0H81 = Korean Character Code 0H82 = Mandarin Chinses Character Code

Precondition : TOC_READING Postcondition : STOP state Description : Bit7 (CDROM) is set, when a TOC is available, but consists of only of data

tracks


Page 37 of 41

A. EV_Disc_Stopped Purpose : Indicates that the disc has stopped turning. Parameters : None Precondition : TOC_READING, STOP, PLAY, PAUSE, SEARCH state Postcondition : STOP state, play allowed again Description : after sending AC_Stop, you must wait for this event before sending

AC_Play again. The tray can be opened.

A. EV_Tray_Opened Purpose : Indicates that the tray is opened Parameters : None

Precondition : STOP, IDLE state Postcondition : IDLE state Description : -

A. EV_Tray_Closed Purpose : Indicates that the tray is closed Parameters : -

Precondition : IDLE state Postcondition : IDLE state Description : -

A. EV_Tray_Opening Purpose : Indicates that the tray is opening – tray starts to move Parameters : None

Precondition : AC_Tray_Open Postcondition : - Description : -

A. EV_Tray_Closing Purpose : Indicates that the tray is closing – tray starts to move. Parameters : None

Precondition : AC_Tray_Close Postcondition : - Description : When manually pushing the tray, the module reports this to the front using

this event


Page 38 of 41

A. EV_BLER Purpose : BLER describes the count of errors per second Parameters : BLER 2( Bytes) Byte 1 = High Byte

Byte 2 = Low Byte Value range: 0...7350

Precondition : PLAY state Postcondition : - Description : BLER rate of the last played second

A. EV_Invalid_Data_Received Purpose : Indicates that an invalid message was received. Parameters : None Precondition : Any state Postcondition : - Description : This event can either be issued if a communication error occured or a not

valid message was sent. Currently not used

A. EV_Display_Info_Changed Purpose : Delivers an indicator what type of display info has changed Parameters : Change_Indicator (1 Byte) Bit0 = time changed

Bit1 = new track Bit2 = new index Bit3 = not used Bit4 = not used Bit5 = reserved

Precondition : STOP or PLAY state Postcondition : - Description : Changes of more than one specific info can also be reported within one

EV_Display_Info_Changed event --> coded as bit info in the returned parameter

A. EV_Module_Off Purpose : Indicates that the module is ready for power off Parameters : None Precondition : STOP, IDLE, TOC_READING state Postcondition : POWER_DOWN state Description : After EV_Module_Off it is safe to turn of the power


Page 39 of 41

A. EV_Disc_Error Purpose : Indicates that a disc error was detected. Parameters : Errornumber (1 Byte) 000 = non recoverable error while playing -->

the module is set to stop mode Precondition : TOC_READING or PLAY state Postcondition : - Description : -

A. EV_Tray_Error Purpose : Indicates that a tray error was detected. Output : Errornumber (1 Byte) 000 = error when closing the tray--> the

module is set to stop mode 001= error when opening the tray� the module is set to stop mode 002 = inner switch error 254 = wrong loader type selected 255 = no loader type selected

Precondition : - Postcondition : STOP state Description : When receiving this command after startup, the AC_Set_Loader_Type

with the correct loader type has not sent. Please resend AC_Set_Loader_Type.

A. EV_Loader_Type_Ok Purpose : Indicates that the loader selection was ok Parameters : None Precondition : Reset Postcondition : IDLE state Description : After selecting the correct loader (AC_Set_Loader_Type), this event

indicates, that the module is ready for CD operation.

A. EV_Send_Buffer_Full Purpose : This event will be issued in case the send buffer of the module is full.

This message is used for debug reasons only and should not come up in afinal system.

Parameters : None Precondition : Any state Postcondition : - Description : The µP has to poll the module on regular basis (see chapter 1.3 Timings)

otherwise the send buffer may get full. If the send buffer is full the module stops saving new events to the buffer and continues as soon as some free space gets available in the send buffer.


Page 40 of 41

A. EV_Program_Details Purpose : Returns the details of the programmed tracks Parameters : Program_Number (2 Bytes) Byte 1 = 0H00

Byte 2 = Low Byte valid range {1...99}

Program_Length (3 Bytes) Byte 3 = HighByte Minutes Byte 4 = LowByte Minutes Byte 5 = Seconds --> 0..59

Precondition : PLAY state STOP state

Postcondition : - Description : No program available: returns 0


Page 41 of 41

I. CDControlTool - PC Interface Tool The CDControlTool PC-Software allows to test the CD80 I2C interface using a PC and the TotalPhase Aardvark I2C/SPI Host Adapter to support set software development. Please see CDControlTool documentation for details. Please contact StreamUnlimited for details.

I. Abbreviations and Acronyms AC Action DSP Digital Signal Processor ESD electrostatic discharge EV Event µP set microprocessor - controlling the module

Documents

BlueTiger™ Connected Optical Drive Family CD-80 CD Player ... · tags exchanged), max. 20 tracks CD text added to chapter 1.8.1 19-11-2007 V.0.11 WGR CD text character code added