The "GR-PEACH_Audio_Playback_Sample" is a sample code that can provides high-resolution audio playback of FLAC format files. It also allows the user to audio-playback control functions such as play, pause, and stop by manipulating key switches.

Dependencies:   R_BSP TLV320_RBSP USBHost_custom

Note

For a sample program of with LCD Board,
please refer to GR-PEACH_Audio_Playback_7InchLCD_Sample.

Introduction

The "GR-PEACH_Audio_Playback_Sample" is a sample code that can provides high-resolution audio playback of FLAC format files. It also allows the user to audio-playback control functions such as play, pause, and stop by manipulating key switches.

1. Overview of the Sample Code

1.1 Software Block Diagram

Figure 1.1 shows the software block diagram.

/media/uploads/dkato/audioplayback_figure1_1x.png

1.2 Pin Definitions

Table 1.1 shows the pins that this sample code are to use.

/media/uploads/dkato/audioplayback_table1_1.png

2. Sample Code Operating Environment

This sample code runs in GR-PEACH + the Audio/Camera shield for the GR-PEACH environment. This section explains the functions of the ports that are used by this sample code.

2.1 Operating Environment

Figure 2.1 shows the configuration of the operating environment for running this sample code.

/media/uploads/dkato/audioplayback_figure2_1.png /media/uploads/1050186/figure2_2.png /media/uploads/dkato/audioplayback_figure2_3.png

2.2 List of User Operations

A list of user operations on the command line, TFT touch keys, and switch key that the user can perform for this sample code is shown in. Table 2.1.

/media/uploads/dkato/audioplayback_table2_1x.png

3. Function Outline

The functions of this sample code are summarized in Table 3.1 to Table 3.3.

/media/uploads/dkato/audioplayback_table3_1.png /media/uploads/dkato/audioplayback_table3_2.png /media/uploads/dkato/audioplayback_table3_3.png /media/uploads/dkato/audioplayback_figure3_1.png

3.1 Playback Control

The playback control that the sample code supports include play, pause, stop, skip to next, and skip to previous.

3.2 Trick Play Control

Manipulating "Repeat" alternates between "Repeat mode On" and "Repeat mode Off". The default mode is "Repeat mode On". When the repeat mode is on, the playback of the first song starts after the playback of the last song is finished. When the repeat mode is off, the sample code enters the stopped state after the playback of the last song is finished.

3.3 Acquisition of the Song Information

The information of the song being played is obtained by operating the "Play info" during the playback of the song. Table 3.4 lists the items of information that can be obtained by the "Play info" operation.

/media/uploads/dkato/audioplayback_table3_4.png

3.4 How the Folder Structure is Analyzed

The sample coded analyzes the folder structure in the breadth-first search order. The order in which files are numbered is illustrated in Table 3.5. The sample code does not sort the files by file or folder name.

/media/uploads/dkato/audioplayback_table3_5.png

4.Others

The default setting of serial communication (baud rate etc.) in mbed is shown the following link.
Please refer to the link and change the settings of your PC terminal software.
The default value of baud rate in mbed is 9600, and this application uses baud rate 9600.
https://developer.mbed.org/teams/Renesas/wiki/GR-PEACH-Getting-Started#install-the-usb-serial-communication

Committer:
Osamu Nakamura
Date:
Fri Mar 31 14:00:23 2017 +0900
Revision:
6:df19c3e787ca
Parent:
0:ee40da884cfc
Introduced mbedOS 5 instead of mbedOS 2 (classic)

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dkato 0:ee40da884cfc 1 /*******************************************************************************
dkato 0:ee40da884cfc 2 * DISCLAIMER
dkato 0:ee40da884cfc 3 * This software is supplied by Renesas Electronics Corporation and is only
dkato 0:ee40da884cfc 4 * intended for use with Renesas products. No other uses are authorized. This
dkato 0:ee40da884cfc 5 * software is owned by Renesas Electronics Corporation and is protected under
dkato 0:ee40da884cfc 6 * all applicable laws, including copyright laws.
dkato 0:ee40da884cfc 7 * THIS SOFTWARE IS PROVIDED "AS IS" AND RENESAS MAKES NO WARRANTIES REGARDING
dkato 0:ee40da884cfc 8 * THIS SOFTWARE, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
dkato 0:ee40da884cfc 9 * LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
dkato 0:ee40da884cfc 10 * AND NON-INFRINGEMENT. ALL SUCH WARRANTIES ARE EXPRESSLY DISCLAIMED.
dkato 0:ee40da884cfc 11 * TO THE MAXIMUM EXTENT PERMITTED NOT PROHIBITED BY LAW, NEITHER RENESAS
dkato 0:ee40da884cfc 12 * ELECTRONICS CORPORATION NOR ANY OF ITS AFFILIATED COMPANIES SHALL BE LIABLE
dkato 0:ee40da884cfc 13 * FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR
dkato 0:ee40da884cfc 14 * ANY REASON RELATED TO THIS SOFTWARE, EVEN IF RENESAS OR ITS AFFILIATES HAVE
dkato 0:ee40da884cfc 15 * BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
dkato 0:ee40da884cfc 16 * Renesas reserves the right, without notice, to make changes to this software
dkato 0:ee40da884cfc 17 * and to discontinue the availability of this software. By using this software,
dkato 0:ee40da884cfc 18 * you agree to the additional terms and conditions found by accessing the
dkato 0:ee40da884cfc 19 * following link:
dkato 0:ee40da884cfc 20 * http://www.renesas.com/disclaimer*
dkato 0:ee40da884cfc 21 * Copyright (C) 2015 Renesas Electronics Corporation. All rights reserved.
dkato 0:ee40da884cfc 22 *******************************************************************************/
dkato 0:ee40da884cfc 23
dkato 0:ee40da884cfc 24 #ifndef AUDIO_OUT_H
dkato 0:ee40da884cfc 25 #define AUDIO_OUT_H
dkato 0:ee40da884cfc 26
dkato 0:ee40da884cfc 27 #include "r_typedefs.h"
dkato 0:ee40da884cfc 28
dkato 0:ee40da884cfc 29 /*--- Macro definition ---*/
dkato 0:ee40da884cfc 30 #define AUD_STACK_SIZE (2048u) /* Stack size of Decode thread */
dkato 0:ee40da884cfc 31
dkato 0:ee40da884cfc 32 /*--- User defined types ---*/
dkato 0:ee40da884cfc 33 typedef void (*AUD_CbDataOut)(const bool result);
dkato 0:ee40da884cfc 34 typedef void (*AUD_CbAudioData)( const bool result, uint16_t * const p_buf,
dkato 0:ee40da884cfc 35 const uint32_t buf_num, const uint32_t * const p_audio, const uint32_t audio_num);
dkato 0:ee40da884cfc 36
dkato 0:ee40da884cfc 37 /** Audio Output Thread
dkato 0:ee40da884cfc 38 *
dkato 0:ee40da884cfc 39 * @param argument Pointer to the thread function as start argument.
dkato 0:ee40da884cfc 40 */
dkato 0:ee40da884cfc 41 void aud_thread(void const *argument);
dkato 0:ee40da884cfc 42
dkato 0:ee40da884cfc 43 /** Requests the audio out thread to read the SCUX conversion results and output data.
dkato 0:ee40da884cfc 44 *
dkato 0:ee40da884cfc 45 * @param p_cb Callback function for notifying the completion of data output preparation
dkato 0:ee40da884cfc 46 * typedef void (*AUD_CbDataOut)( const bool result );
dkato 0:ee40da884cfc 47 * When calling callback function specified in p_cb, specify the following
dkato 0:ee40da884cfc 48 * in the callback function argument result:
dkato 0:ee40da884cfc 49 * result : Execution result; true = Success; false = Failure
dkato 0:ee40da884cfc 50 * * Since the SCUX's asynchronous SRC function is used, an overflow error will occur
dkato 0:ee40da884cfc 51 * if the data read from the SCUX is delayed. For this reason, the callback function
dkato 0:ee40da884cfc 52 * must be set up to notify the completion of processing after making settings
dkato 0:ee40da884cfc 53 * for reading SCUX data. The decode thread starts writing data to the SCUX upon
dkato 0:ee40da884cfc 54 * receipt of the completion notification through the callback function.
dkato 0:ee40da884cfc 55 *
dkato 0:ee40da884cfc 56 * @returns
dkato 0:ee40da884cfc 57 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 58 * This function fails when:
dkato 0:ee40da884cfc 59 * The argument p_cb is set to NULL.
dkato 0:ee40da884cfc 60 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 61 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 62 */
dkato 0:ee40da884cfc 63 bool aud_req_data_out(const AUD_CbDataOut p_cb);
dkato 0:ee40da884cfc 64
dkato 0:ee40da884cfc 65 /** Requests the audio out thread to stop reading the SCUX conversion results and to generate silent output.
dkato 0:ee40da884cfc 66 *
dkato 0:ee40da884cfc 67 * @returns
dkato 0:ee40da884cfc 68 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 69 * This function fails when:
dkato 0:ee40da884cfc 70 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 71 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 72 */
dkato 0:ee40da884cfc 73 bool aud_req_zero_out(void);
dkato 0:ee40da884cfc 74
dkato 0:ee40da884cfc 75 /** Gets the audio data from the output thread.
dkato 0:ee40da884cfc 76 *
dkato 0:ee40da884cfc 77 * @param p_cb Callback function for notifying the completion of data acquisition
dkato 0:ee40da884cfc 78 * typedef void (*AUD_CbAudioData)( const bool result,
dkato 0:ee40da884cfc 79 * int16_t * const p_buf, const uint32_t buf_num,
dkato 0:ee40da884cfc 80 * const int32_t * const p_audio, const uint32_t audio_num);
dkato 0:ee40da884cfc 81 * When calling callback function specified in p_cb, specify the following
dkato 0:ee40da884cfc 82 * in the callback function arguments result, p_buf, buf_num, p_audio, and audio_num:
dkato 0:ee40da884cfc 83 * result : Execution result; true = Success; false = Failure
dkato 0:ee40da884cfc 84 * p_buf : Pointer to the buffer for storing audio data
dkato 0:ee40da884cfc 85 * * Although the audio data output is 24 bits long, 16 bits of the data
dkato 0:ee40da884cfc 86 * are used for display.
dkato 0:ee40da884cfc 87 * * The data that is specified in the second argument p_buf of this function
dkato 0:ee40da884cfc 88 * must be placed in p_buf of the callback function as is.
dkato 0:ee40da884cfc 89 * buf_num : Array size of the area pointed to by p_buf
dkato 0:ee40da884cfc 90 * * The data that is specified in the third argument buf_num of
dkato 0:ee40da884cfc 91 * this function must be placed in buf_num of the callback function as is.
dkato 0:ee40da884cfc 92 * p_audio : 10 ms equivalent of audio data (88200 Hz, 2ch, 24 bits)
dkato 0:ee40da884cfc 93 * audio_num : Array size of the area pointed to by p_audio
dkato 0:ee40da884cfc 94 * @param p_buf Pointer to the buffer for storing audio data
dkato 0:ee40da884cfc 95 *
dkato 0:ee40da884cfc 96 * @returns
dkato 0:ee40da884cfc 97 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 98 * This function fails when:
dkato 0:ee40da884cfc 99 * The argument p_cb is set to NULL.
dkato 0:ee40da884cfc 100 * The argument p_buf is set to NULL.
dkato 0:ee40da884cfc 101 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 102 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 103 */
dkato 0:ee40da884cfc 104 bool aud_get_audio_data(const AUD_CbAudioData p_cb, uint16_t * const p_buf);
dkato 0:ee40da884cfc 105
dkato 0:ee40da884cfc 106 #endif /* AUDIO_OUT_H */