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:
dkato
Date:
Fri Oct 16 04:28:07 2015 +0000
Revision:
0:ee40da884cfc
Child:
2:d9fca8cd7f03
first commit

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 DISPLAY_H
dkato 0:ee40da884cfc 25 #define DISPLAY_H
dkato 0:ee40da884cfc 26
dkato 0:ee40da884cfc 27 #include "r_typedefs.h"
dkato 0:ee40da884cfc 28 #include "system.h"
dkato 0:ee40da884cfc 29
dkato 0:ee40da884cfc 30 /*--- Macro definition ---*/
dkato 0:ee40da884cfc 31 #define DSP_STACK_SIZE (2048u) /* Stack size of display thread */
dkato 0:ee40da884cfc 32
dkato 0:ee40da884cfc 33 /* The maximum length of display character string. */
dkato 0:ee40da884cfc 34 #define DSP_DISP_STR_MAX_LEN (64)
dkato 0:ee40da884cfc 35 /* The maximum length of input character string by the command-line. */
dkato 0:ee40da884cfc 36 #define DSP_CMD_INPT_STR_MAX_LEN (63)
dkato 0:ee40da884cfc 37
dkato 0:ee40da884cfc 38 /* The baud rate of the serial port for PC communication. */
dkato 0:ee40da884cfc 39 #define DSP_PC_COM_BAUDRATE (9600)
dkato 0:ee40da884cfc 40
dkato 0:ee40da884cfc 41 /*--- User defined types ---*/
dkato 0:ee40da884cfc 42 typedef enum {
dkato 0:ee40da884cfc 43 DSP_MAILID_DUMMY = 0,
dkato 0:ee40da884cfc 44 DSP_MAILID_CYCLE_IND, /* Cyclic notice */
dkato 0:ee40da884cfc 45 DSP_MAILID_CMD_STR, /* Notifies display thread of input string. */
dkato 0:ee40da884cfc 46 DSP_MAILID_PRINT_STR, /* Notifies display thread of output string. */
dkato 0:ee40da884cfc 47 DSP_MAILID_PLAY_TIME, /* Notifies display thread of playback time. */
dkato 0:ee40da884cfc 48 DSP_MAILID_PLAY_INFO, /* Notifies display thread of playback information. */
dkato 0:ee40da884cfc 49 DSP_MAILID_PLAY_MODE, /* Notifies display thread of repeat mode. */
dkato 0:ee40da884cfc 50 DSP_MAILID_FILE_NAME, /* Notifies display thread of file name. */
dkato 0:ee40da884cfc 51 DSP_MAILID_NUM
dkato 0:ee40da884cfc 52 } DSP_MAIL_ID;
dkato 0:ee40da884cfc 53
dkato 0:ee40da884cfc 54 /* These data are used in all display modules. */
dkato 0:ee40da884cfc 55 typedef struct {
dkato 0:ee40da884cfc 56 uint32_t disp_mode; /* Display mode */
dkato 0:ee40da884cfc 57 SYS_PlayStat play_stat; /* Playback status */
dkato 0:ee40da884cfc 58 uint32_t track_id; /* Track number */
dkato 0:ee40da884cfc 59 uint32_t play_time; /* Playback time (sec) */
dkato 0:ee40da884cfc 60 uint32_t total_time; /* Total playback time (sec) */
dkato 0:ee40da884cfc 61 uint32_t samp_freq; /* Sampling frequency (Hz) */
dkato 0:ee40da884cfc 62 uint32_t channel; /* Channel number */
dkato 0:ee40da884cfc 63 bool repeat_mode; /* Repeat mode */
dkato 0:ee40da884cfc 64 char_t file_name[DSP_DISP_STR_MAX_LEN];/* Character string of file name */
dkato 0:ee40da884cfc 65 char_t dspl_str[DSP_DISP_STR_MAX_LEN]; /* Display character string */
dkato 0:ee40da884cfc 66 } dsp_com_ctrl_t;
dkato 0:ee40da884cfc 67
dkato 0:ee40da884cfc 68 /* These data are used only in the terminal-output module. */
dkato 0:ee40da884cfc 69 typedef struct {
dkato 0:ee40da884cfc 70 bool edge_fin_inpt; /* Completion status of the input by the command-line.*/
dkato 0:ee40da884cfc 71 /* [true = input completion, false = input now] */
dkato 0:ee40da884cfc 72 char_t inpt_str[DSP_CMD_INPT_STR_MAX_LEN];/* Input character string by the command-line. */
dkato 0:ee40da884cfc 73 } dsp_trm_ctrl_t;
dkato 0:ee40da884cfc 74
dkato 0:ee40da884cfc 75 /* These data are used only in the TFT module. */
dkato 0:ee40da884cfc 76 typedef struct {
dkato 0:ee40da884cfc 77 int32_t disp_phase_no; /* The making phase of the display image */
dkato 0:ee40da884cfc 78 } dsp_tft_ctrl_t;
dkato 0:ee40da884cfc 79
dkato 0:ee40da884cfc 80
dkato 0:ee40da884cfc 81 /** Display Thread
dkato 0:ee40da884cfc 82 *
dkato 0:ee40da884cfc 83 * @param argument Pointer to the thread function as start argument.
dkato 0:ee40da884cfc 84 */
dkato 0:ee40da884cfc 85 void dsp_thread(void const *argument);
dkato 0:ee40da884cfc 86
dkato 0:ee40da884cfc 87 /** Notifies the display thread of the song information (file number, play time, total play time, play state).
dkato 0:ee40da884cfc 88 *
dkato 0:ee40da884cfc 89 * @param play_stat Playback state
dkato 0:ee40da884cfc 90 * Stopped : SYS_PLAYSTAT_STOP
dkato 0:ee40da884cfc 91 * Playing : SYS_PLAYSTAT_PLAY
dkato 0:ee40da884cfc 92 * Paused : SYS_PLAYSTAT_PAUSE
dkato 0:ee40da884cfc 93 * @param file_no File number
dkato 0:ee40da884cfc 94 * 1 to 999
dkato 0:ee40da884cfc 95 * @param play_time Playback time (in seconds)
dkato 0:ee40da884cfc 96 * 0 to 359999
dkato 0:ee40da884cfc 97 * * 0 hour, 0 minute, 0 second to 99 hours, 59 minutes, 59 seconds
dkato 0:ee40da884cfc 98 * @param total_time Total play time (in seconds)
dkato 0:ee40da884cfc 99 * 0 to 359999
dkato 0:ee40da884cfc 100 * * 0 hour, 0 minute, 0 second to 99 hours, 59 minutes, 59 seconds
dkato 0:ee40da884cfc 101 *
dkato 0:ee40da884cfc 102 * @returns
dkato 0:ee40da884cfc 103 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 104 * This function fails when:
dkato 0:ee40da884cfc 105 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 106 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 107 */
dkato 0:ee40da884cfc 108 bool dsp_notify_play_time(const SYS_PlayStat play_stat, const uint32_t file_no,
dkato 0:ee40da884cfc 109 const uint32_t play_time, const uint32_t total_time);
dkato 0:ee40da884cfc 110
dkato 0:ee40da884cfc 111 /** Notifies the display thread of the song information (file number, sampling frequency, and number of channels).
dkato 0:ee40da884cfc 112 *
dkato 0:ee40da884cfc 113 * @param file_no File number
dkato 0:ee40da884cfc 114 * 1 to 999
dkato 0:ee40da884cfc 115 * @param sample_freq Sampling frequency (Hz)
dkato 0:ee40da884cfc 116 * 22050, 24000, 32000, 44100, 48000, 64000, 88200, 96000
dkato 0:ee40da884cfc 117 * @param channel_num Number of channels
dkato 0:ee40da884cfc 118 * 1, 2
dkato 0:ee40da884cfc 119 *
dkato 0:ee40da884cfc 120 * @returns
dkato 0:ee40da884cfc 121 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 122 * This function fails when:
dkato 0:ee40da884cfc 123 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 124 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 125 */
dkato 0:ee40da884cfc 126 bool dsp_notify_play_info(const uint32_t file_no,
dkato 0:ee40da884cfc 127 const uint32_t sample_freq, const uint32_t channel_num);
dkato 0:ee40da884cfc 128
dkato 0:ee40da884cfc 129 /** Notifies the display thread of the playback mode (repeat mode).
dkato 0:ee40da884cfc 130 *
dkato 0:ee40da884cfc 131 * @param rep_mode Repeat mode
dkato 0:ee40da884cfc 132 * Repeat mode OFF : false
dkato 0:ee40da884cfc 133 * Repeat mode ON : true
dkato 0:ee40da884cfc 134 *
dkato 0:ee40da884cfc 135 * @returns
dkato 0:ee40da884cfc 136 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 137 * This function fails when:
dkato 0:ee40da884cfc 138 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 139 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 140 */
dkato 0:ee40da884cfc 141 bool dsp_notify_play_mode(const bool rep_mode);
dkato 0:ee40da884cfc 142
dkato 0:ee40da884cfc 143 /** Notifies the display thread of the file name.
dkato 0:ee40da884cfc 144 *
dkato 0:ee40da884cfc 145 * @param p_str File name string
dkato 0:ee40da884cfc 146 * * The string must be terminated by '\0'.
dkato 0:ee40da884cfc 147 * The character code must be the local character code. Since the end of
dkato 0:ee40da884cfc 148 * a string is identified by the presence of '\0', a file name of
dkato 0:ee40da884cfc 149 * multi-byte code may not be displayed correctly.
dkato 0:ee40da884cfc 150 * The maximum length of the string that the display thread can notify
dkato 0:ee40da884cfc 151 * is 64 bytes including '\0'.
dkato 0:ee40da884cfc 152 *
dkato 0:ee40da884cfc 153 * @returns
dkato 0:ee40da884cfc 154 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 155 * This function fails when:
dkato 0:ee40da884cfc 156 * The argument p_str is set to NULL.
dkato 0:ee40da884cfc 157 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 158 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 159 */
dkato 0:ee40da884cfc 160 bool dsp_notify_file_name(const char_t * const p_str);
dkato 0:ee40da884cfc 161
dkato 0:ee40da884cfc 162 /** Notifies the display thread of the string to be output on the terminal.
dkato 0:ee40da884cfc 163 *
dkato 0:ee40da884cfc 164 * @param p_str String to be output on the terminal
dkato 0:ee40da884cfc 165 * * The string must be terminated by '\0'.
dkato 0:ee40da884cfc 166 * The character code must be the local character code. Since the end of
dkato 0:ee40da884cfc 167 * a string is identified by the presence of '\0', a file name of
dkato 0:ee40da884cfc 168 * multi-byte code may not be displayed correctly.
dkato 0:ee40da884cfc 169 * The maximum length of the string that the display thread can notify
dkato 0:ee40da884cfc 170 * is 64 bytes including '\0'.
dkato 0:ee40da884cfc 171 *
dkato 0:ee40da884cfc 172 * @returns
dkato 0:ee40da884cfc 173 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 174 * This function fails when:
dkato 0:ee40da884cfc 175 * The argument p_str is set to NULL.
dkato 0:ee40da884cfc 176 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 177 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 178 */
dkato 0:ee40da884cfc 179 bool dsp_notify_print_string(const char_t * const p_str);
dkato 0:ee40da884cfc 180
dkato 0:ee40da884cfc 181 /** Notifies the display thread of the command line input string.
dkato 0:ee40da884cfc 182 * * Used to echo back the string entered from the command line.
dkato 0:ee40da884cfc 183 *
dkato 0:ee40da884cfc 184 * @param p_str Command line input string
dkato 0:ee40da884cfc 185 * * The string must contain no control characters and terminate with '\0'.
dkato 0:ee40da884cfc 186 * The character code must be the local character code. Since the end of
dkato 0:ee40da884cfc 187 * a string is identified by the presence of '\0', a file name of
dkato 0:ee40da884cfc 188 * multi-byte code may not be displayed correctly.
dkato 0:ee40da884cfc 189 * The maximum length of the string that the display thread can notify
dkato 0:ee40da884cfc 190 * is 63 bytes including '\0'.
dkato 0:ee40da884cfc 191 *
dkato 0:ee40da884cfc 192 * @param flag_fin Input completion flag
dkato 0:ee40da884cfc 193 * Middle of input : false
dkato 0:ee40da884cfc 194 * Input complete : true
dkato 0:ee40da884cfc 195 *
dkato 0:ee40da884cfc 196 * @returns
dkato 0:ee40da884cfc 197 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 198 * This function fails when:
dkato 0:ee40da884cfc 199 * The argument p_str is set to NULL.
dkato 0:ee40da884cfc 200 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 201 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 202 */
dkato 0:ee40da884cfc 203 bool dsp_notify_input_string(const char_t * const p_str, const bool flag_fin);
dkato 0:ee40da884cfc 204
dkato 0:ee40da884cfc 205 #endif /* DISPLAY_H */