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