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:
2:d9fca8cd7f03
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 DECODE_H
dkato 0:ee40da884cfc 25 #define DECODE_H
dkato 0:ee40da884cfc 26
dkato 0:ee40da884cfc 27 #include "r_typedefs.h"
dkato 0:ee40da884cfc 28 #include "USBHostMSD.h"
dkato 0:ee40da884cfc 29 #include "R_BSP_Scux.h"
dkato 0:ee40da884cfc 30
dkato 0:ee40da884cfc 31 /*--- Macro definition ---*/
dkato 0:ee40da884cfc 32 #define DEC_STACK_SIZE (2048u) /* Stack size of Decode thread */
dkato 0:ee40da884cfc 33 #define DEC_MIN_BLOCK_SIZE (192u) /* Minimum block size */
dkato 0:ee40da884cfc 34 #define DEC_MAX_BLOCK_SIZE (16384u) /* Maximum block size */
dkato 0:ee40da884cfc 35 #define DEC_16BITS_PER_SAMPLE (16u) /* Bit count per sample */
dkato 0:ee40da884cfc 36 #define DEC_24BITS_PER_SAMPLE (24u) /* Bit count per sample */
dkato 0:ee40da884cfc 37 #define DEC_MAX_CHANNEL_NUM (2u) /* Maximum number of channel */
dkato 0:ee40da884cfc 38 #define DEC_OUTPUT_PADDING_BITS (8u) /* Padding of lower 8 bits */
dkato 2:d9fca8cd7f03 39 #define DEC_SCUX_READ_NUM (9u) /* The number of buffuer for SCUX read */
dkato 0:ee40da884cfc 40
dkato 0:ee40da884cfc 41 /* Minimum sampling rate in Hz of input file */
dkato 0:ee40da884cfc 42 #define DEC_INPUT_MIN_SAMPLE_RATE (SAMPLING_RATE_22050HZ)
dkato 0:ee40da884cfc 43 /* Maximum sampling rate in Hz of input file */
dkato 0:ee40da884cfc 44 #define DEC_INPUT_MAX_SAMPLE_RATE (SAMPLING_RATE_96000HZ)
dkato 0:ee40da884cfc 45 /* Sampling rate in Hz of audio output */
dkato 2:d9fca8cd7f03 46 #define DEC_OUTPUT_SAMPLE_RATE (SAMPLING_RATE_96000HZ)
dkato 0:ee40da884cfc 47 /* Channel number of audio output */
dkato 0:ee40da884cfc 48 #define DEC_OUTPUT_CHANNEL_NUM (DEC_MAX_CHANNEL_NUM)
dkato 0:ee40da884cfc 49 /* Bit count per sample of audio output */
dkato 0:ee40da884cfc 50 #define DEC_OUTPUT_BITS_PER_SAMPLE (DEC_24BITS_PER_SAMPLE)
dkato 0:ee40da884cfc 51
dkato 0:ee40da884cfc 52 /*--- User defined types ---*/
dkato 0:ee40da884cfc 53 typedef void (*DEC_CbOpen)(const bool result,
dkato 0:ee40da884cfc 54 const uint32_t sample_freq, const uint32_t channel_num);
dkato 0:ee40da884cfc 55 typedef void (*DEC_CbClose)(void);
dkato 0:ee40da884cfc 56
dkato 0:ee40da884cfc 57 /** Decode Thread
dkato 0:ee40da884cfc 58 *
dkato 0:ee40da884cfc 59 * @param argument Pointer to the thread function as start argument.
dkato 0:ee40da884cfc 60 */
dkato 0:ee40da884cfc 61 void dec_thread(void const *argument);
dkato 0:ee40da884cfc 62
dkato 0:ee40da884cfc 63 /** Instructs the decode thread to open the decoder.
dkato 0:ee40da884cfc 64 *
dkato 0:ee40da884cfc 65 * @param p_handle File handle
dkato 0:ee40da884cfc 66 * @param p_cb Callback function for notifying the completion of open processing
dkato 0:ee40da884cfc 67 * typedef void (*DEC_CbOpen)(const bool result,
dkato 0:ee40da884cfc 68 * const uint32_t sample_freq, const uint32_t channel_num);
dkato 0:ee40da884cfc 69 * When calling callback function specified in p_cb, specify the following
dkato 0:ee40da884cfc 70 * in the callback function arguments result, sample_freq, and channel_num:
dkato 0:ee40da884cfc 71 * result : Execution result; true = Open is successful, false = Open fails
dkato 0:ee40da884cfc 72 * sample_freq : Sampling frequency of the file to be played back
dkato 0:ee40da884cfc 73 * channel_num : Number of channels for the file to be played back.
dkato 0:ee40da884cfc 74 *
dkato 0:ee40da884cfc 75 * @returns
dkato 0:ee40da884cfc 76 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 77 * This function fails when:
dkato 0:ee40da884cfc 78 * The argument p_handle is set to NULL.
dkato 0:ee40da884cfc 79 * The argument p_cb is set to NULL.
dkato 0:ee40da884cfc 80 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 81 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 82 */
dkato 0:ee40da884cfc 83 bool dec_open(FILE * const p_handle, const DEC_CbOpen p_cb);
dkato 0:ee40da884cfc 84
dkato 0:ee40da884cfc 85 /** Instructs the decode thread for playback.
dkato 0:ee40da884cfc 86 *
dkato 0:ee40da884cfc 87 * @returns
dkato 0:ee40da884cfc 88 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 89 * This function fails when:
dkato 0:ee40da884cfc 90 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 91 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 92 */
dkato 0:ee40da884cfc 93 bool dec_play(void);
dkato 0:ee40da884cfc 94
dkato 0:ee40da884cfc 95 /** Instructs the decode thread for pause.
dkato 0:ee40da884cfc 96 *
dkato 0:ee40da884cfc 97 * @returns
dkato 0:ee40da884cfc 98 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 99 * This function fails when:
dkato 0:ee40da884cfc 100 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 101 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 102 */
dkato 0:ee40da884cfc 103 bool dec_pause_on(void);
dkato 0:ee40da884cfc 104
dkato 0:ee40da884cfc 105 /** Instructs the decode thread to exit the pause state.
dkato 0:ee40da884cfc 106 *
dkato 0:ee40da884cfc 107 * @returns
dkato 0:ee40da884cfc 108 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 109 * This function fails when:
dkato 0:ee40da884cfc 110 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 111 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 112 */
dkato 0:ee40da884cfc 113 bool dec_pause_off(void);
dkato 0:ee40da884cfc 114
dkato 0:ee40da884cfc 115 /** Instructs the decode thread to stop processing.
dkato 0:ee40da884cfc 116 *
dkato 0:ee40da884cfc 117 * @returns
dkato 0:ee40da884cfc 118 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 119 * This function fails when:
dkato 0:ee40da884cfc 120 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 121 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 122 */
dkato 0:ee40da884cfc 123 bool dec_stop(void);
dkato 0:ee40da884cfc 124
dkato 0:ee40da884cfc 125 /** Instructs the decode thread to close the decoder.
dkato 0:ee40da884cfc 126 *
dkato 0:ee40da884cfc 127 * @param p_cb Callback function for notifying the completion of close processing
dkato 0:ee40da884cfc 128 * typedef void (*DEC_CbClose)(void);
dkato 0:ee40da884cfc 129 *
dkato 0:ee40da884cfc 130 * @returns
dkato 0:ee40da884cfc 131 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 132 * This function fails when:
dkato 0:ee40da884cfc 133 * The argument p_cb is set to NULL.
dkato 0:ee40da884cfc 134 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 135 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 136 */
dkato 0:ee40da884cfc 137 bool dec_close(const DEC_CbClose p_cb);
dkato 0:ee40da884cfc 138
dkato 0:ee40da884cfc 139 /** Issues a read request to the SCUX driver.
dkato 0:ee40da884cfc 140 *
dkato 0:ee40da884cfc 141 * @param p_data Buffer for storing the read data
dkato 0:ee40da884cfc 142 * @param data_size Number of bytes to read
dkato 0:ee40da884cfc 143 * @param p_data_conf Asynchronous control information
dkato 0:ee40da884cfc 144 *
dkato 0:ee40da884cfc 145 * @returns
dkato 0:ee40da884cfc 146 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 147 * This function fails when:
dkato 0:ee40da884cfc 148 * The argument p_data is set to NULL.
dkato 0:ee40da884cfc 149 * The argument data_size is set to 0.
dkato 0:ee40da884cfc 150 * The argument p_data_conf is set to NULL.
dkato 0:ee40da884cfc 151 */
dkato 0:ee40da884cfc 152 bool dec_scux_read(void * const p_data, const uint32_t data_size,
dkato 0:ee40da884cfc 153 const rbsp_data_conf_t * const p_data_conf);
dkato 0:ee40da884cfc 154
dkato 0:ee40da884cfc 155 #endif /* DECODE_H */