The "GR-PEACH_Audio_Playback_7InchLCD_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:   GR-PEACH_video R_BSP TLV320_RBSP USBHost_custom

Fork of GR-PEACH_Audio_Playback_Sample by Renesas

Note

For a sample program of without LCD Board, please refer to GR-PEACH_Audio_Playback_Sample.

Introduction

The "GR-PEACH_Audio_Playback_7InchLCD_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/1050186/lcd_figure1_1.png

1.2 Pin Definitions

Table 1.1 shows the pins used in this sample code.

/media/uploads/1050186/lcd_table1_1.png

2. Sample Code Operating Environment

In order to operate this sample code, GR-PEACH, Audio Camera Shield and 7.1 inch LCD Shield must be needed. For details on Audio Camera Shield and 7.1 inch LCD Shield, please refer to the following links, respectively:

In this section, it is described that how board is configured and to control audio playback via command line and touch screen.

2.1 Operating Environment

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

/media/uploads/1050186/lcd_figure2_1.png

Figure 2.2 and 2.3 show how to configure GR-PEACH, Audio Camera Shield and 7.1 inch LCD shield when using USB0 and USB1, respectively.

/media/uploads/1050186/lcd_figure2_2.png /media/uploads/1050186/lcd_figure2_3.png

Table 2.1 lists the overview of Graphical User Interface (GUI) of this sample code.

/media/uploads/1050186/lcd_table2_1.png

2.2 List of User Operations

Table 2.2 shows the relationship among Audio Playback, Command Line and Onboard Switch.

/media/uploads/1050186/lcd_table2_2.png

3. Function Outline

Table 3.1, 3.2 and 3.3 shows the overview of functions implemented in this sample code.

/media/uploads/1050186/lcd_table3_1.png /media/uploads/1050186/lcd_table3_2.png /media/uploads/1050186/lcd_table3_3.png /media/uploads/1050186/lcd_figure3_1.png

3.1 Playback Control

This sample program supports the operation "play", "pause", "stop", "play next song" and "play previous song".

3.2 Trick Play Control

In order to enable/disable Repeat Mode, user need to type "repeat" on command line or click the corresponding icon shown in Table 2.2. By derault, Repeat Mode is enabled. When Repeat Mode is enabled, the first song is played back after the playback of the last song is finished. Otherwise, the playback is shopped when finishing to play back the last song.

3.3 How to see Song Information

The information of the song being played back can be seen by typing playinfo on command line. Table 3.4 lists the items user can see on the terminal.

/media/uploads/dkato/audioplayback_table3_4.png

3.4 How to analyze the folder structure in USB stick

In this sample code, the folder structure in USB stick is analyzed in the breadth-first order. Table 3.5 shows how the files in USB stick are numbered.

/media/uploads/dkato/audioplayback_table3_5.png

4.Others

4.1 Serial Communication Setting

With respect to the default serial communication related setting on mbed, please refer to the follwing link:
https://developer.mbed.org/teams/Renesas/wiki/GR-PEACH-Getting-Started#install-the-usb-serial-communication
Please set up the terminal software you would like to use on your PC in consideration of the above. For example, 9600 should be specified for the baud rate on the terminal in order to control this sample via command line.

4.2 Necessary modification when using GCC ARM Embedded

If you would like to use GCC ARM Embedded, you must revise the following linker script incorporated in mbed OS 5 package as follows:

  • Linker Script to be modified
    $(PROJECT_ROOT)/mbed-os/targets/TARGET_RENESAS/TARGET_RZ_A1H/device/TOOLCHAIN_GCC_ARM/RZA1H.ld

    Please note that $(PROJECT_ROOT) in the above denotes the root directory of this sample code

  • Before Modification

RZA1H.ld

/* Linker script for mbed RZ_A1H */

/* Linker script to configure memory regions. */
MEMORY
{
  ROM   (rx)  : ORIGIN = 0x00000000, LENGTH = 0x02000000
  BOOT_LOADER (rx) : ORIGIN = 0x18000000, LENGTH = 0x00004000 
  SFLASH (rx) : ORIGIN = 0x18004000, LENGTH = 0x07FFC000 
  L_TTB (rw)  : ORIGIN = 0x20000000, LENGTH = 0x00004000 
  RAM (rwx) : ORIGIN = 0x20020000, LENGTH = 0x00700000
  RAM_NC (rwx) : ORIGIN = 0x20900000, LENGTH = 0x00100000
}
(snip)
  • After Modification

RZA1H.ld

/* Linker script for mbed RZ_A1H */

/* Linker script to configure memory regions. */
MEMORY
{
  ROM   (rx)  : ORIGIN = 0x00000000, LENGTH = 0x02000000
  BOOT_LOADER (rx) : ORIGIN = 0x18000000, LENGTH = 0x00004000 
  SFLASH (rx) : ORIGIN = 0x18004000, LENGTH = 0x07FFC000 
  L_TTB (rw)  : ORIGIN = 0x20000000, LENGTH = 0x00004000 
  RAM (rwx) : ORIGIN = 0x20020000, LENGTH = 0x00180000
  RAM_NC (rwx) : ORIGIN = 0x20200000, LENGTH = 0x00680000
}
(snip)
Committer:
dkato
Date:
Thu Nov 05 02:46:24 2015 +0000
Revision:
2:d9fca8cd7f03
Parent:
0:ee40da884cfc
Child:
4:2672de88a46b
The output frequency was changed to 96kHz. The help command was added.

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 */