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

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dkato 0:ee40da884cfc 1 /* libFLAC - Free Lossless Audio Codec library
dkato 0:ee40da884cfc 2 * Copyright (C) 2001-2009 Josh Coalson
dkato 0:ee40da884cfc 3 * Copyright (C) 2011-2014 Xiph.Org Foundation
dkato 0:ee40da884cfc 4 *
dkato 0:ee40da884cfc 5 * Redistribution and use in source and binary forms, with or without
dkato 0:ee40da884cfc 6 * modification, are permitted provided that the following conditions
dkato 0:ee40da884cfc 7 * are met:
dkato 0:ee40da884cfc 8 *
dkato 0:ee40da884cfc 9 * - Redistributions of source code must retain the above copyright
dkato 0:ee40da884cfc 10 * notice, this list of conditions and the following disclaimer.
dkato 0:ee40da884cfc 11 *
dkato 0:ee40da884cfc 12 * - Redistributions in binary form must reproduce the above copyright
dkato 0:ee40da884cfc 13 * notice, this list of conditions and the following disclaimer in the
dkato 0:ee40da884cfc 14 * documentation and/or other materials provided with the distribution.
dkato 0:ee40da884cfc 15 *
dkato 0:ee40da884cfc 16 * - Neither the name of the Xiph.org Foundation nor the names of its
dkato 0:ee40da884cfc 17 * contributors may be used to endorse or promote products derived from
dkato 0:ee40da884cfc 18 * this software without specific prior written permission.
dkato 0:ee40da884cfc 19 *
dkato 0:ee40da884cfc 20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
dkato 0:ee40da884cfc 21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
dkato 0:ee40da884cfc 22 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
dkato 0:ee40da884cfc 23 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR
dkato 0:ee40da884cfc 24 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
dkato 0:ee40da884cfc 25 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
dkato 0:ee40da884cfc 26 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
dkato 0:ee40da884cfc 27 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
dkato 0:ee40da884cfc 28 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
dkato 0:ee40da884cfc 29 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
dkato 0:ee40da884cfc 30 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
dkato 0:ee40da884cfc 31 */
dkato 0:ee40da884cfc 32
dkato 0:ee40da884cfc 33 #ifdef HAVE_CONFIG_H
dkato 0:ee40da884cfc 34 # include <config.h>
dkato 0:ee40da884cfc 35 #endif
dkato 0:ee40da884cfc 36
dkato 0:ee40da884cfc 37 #ifdef HAVE_STDINT_H
dkato 0:ee40da884cfc 38 #include <stdint.h>
dkato 0:ee40da884cfc 39 #endif
dkato 0:ee40da884cfc 40
dkato 0:ee40da884cfc 41 #include "private/memory.h"
dkato 0:ee40da884cfc 42 #include "FLAC/assert.h"
dkato 0:ee40da884cfc 43 #include "share/alloc.h"
dkato 0:ee40da884cfc 44
dkato 0:ee40da884cfc 45 void *FLAC__memory_alloc_aligned(size_t bytes, void **aligned_address)
dkato 0:ee40da884cfc 46 {
dkato 0:ee40da884cfc 47 void *x;
dkato 0:ee40da884cfc 48
dkato 0:ee40da884cfc 49 FLAC__ASSERT(0 != aligned_address);
dkato 0:ee40da884cfc 50
dkato 0:ee40da884cfc 51 #ifdef FLAC__ALIGN_MALLOC_DATA
dkato 0:ee40da884cfc 52 /* align on 32-byte (256-bit) boundary */
dkato 0:ee40da884cfc 53 x = safe_malloc_add_2op_(bytes, /*+*/31L);
dkato 0:ee40da884cfc 54 *aligned_address = (void*)(((uintptr_t)x + 31L) & -32L);
dkato 0:ee40da884cfc 55 #else
dkato 0:ee40da884cfc 56 x = safe_malloc_(bytes);
dkato 0:ee40da884cfc 57 *aligned_address = x;
dkato 0:ee40da884cfc 58 #endif
dkato 0:ee40da884cfc 59 return x;
dkato 0:ee40da884cfc 60 }
dkato 0:ee40da884cfc 61
dkato 0:ee40da884cfc 62 FLAC__bool FLAC__memory_alloc_aligned_int32_array(size_t elements, FLAC__int32 **unaligned_pointer, FLAC__int32 **aligned_pointer)
dkato 0:ee40da884cfc 63 {
dkato 0:ee40da884cfc 64 FLAC__int32 *pu; /* unaligned pointer */
dkato 0:ee40da884cfc 65 union { /* union needed to comply with C99 pointer aliasing rules */
dkato 0:ee40da884cfc 66 FLAC__int32 *pa; /* aligned pointer */
dkato 0:ee40da884cfc 67 void *pv; /* aligned pointer alias */
dkato 0:ee40da884cfc 68 } u;
dkato 0:ee40da884cfc 69
dkato 0:ee40da884cfc 70 FLAC__ASSERT(elements > 0);
dkato 0:ee40da884cfc 71 FLAC__ASSERT(0 != unaligned_pointer);
dkato 0:ee40da884cfc 72 FLAC__ASSERT(0 != aligned_pointer);
dkato 0:ee40da884cfc 73 FLAC__ASSERT(unaligned_pointer != aligned_pointer);
dkato 0:ee40da884cfc 74
dkato 0:ee40da884cfc 75 if(elements > SIZE_MAX / sizeof(*pu)) /* overflow check */
dkato 0:ee40da884cfc 76 return false;
dkato 0:ee40da884cfc 77
dkato 0:ee40da884cfc 78 pu = FLAC__memory_alloc_aligned(sizeof(*pu) * elements, &u.pv);
dkato 0:ee40da884cfc 79 if(0 == pu) {
dkato 0:ee40da884cfc 80 return false;
dkato 0:ee40da884cfc 81 }
dkato 0:ee40da884cfc 82 else {
dkato 0:ee40da884cfc 83 if(*unaligned_pointer != 0)
dkato 0:ee40da884cfc 84 free(*unaligned_pointer);
dkato 0:ee40da884cfc 85 *unaligned_pointer = pu;
dkato 0:ee40da884cfc 86 *aligned_pointer = u.pa;
dkato 0:ee40da884cfc 87 return true;
dkato 0:ee40da884cfc 88 }
dkato 0:ee40da884cfc 89 }
dkato 0:ee40da884cfc 90
dkato 0:ee40da884cfc 91 FLAC__bool FLAC__memory_alloc_aligned_uint32_array(size_t elements, FLAC__uint32 **unaligned_pointer, FLAC__uint32 **aligned_pointer)
dkato 0:ee40da884cfc 92 {
dkato 0:ee40da884cfc 93 FLAC__uint32 *pu; /* unaligned pointer */
dkato 0:ee40da884cfc 94 union { /* union needed to comply with C99 pointer aliasing rules */
dkato 0:ee40da884cfc 95 FLAC__uint32 *pa; /* aligned pointer */
dkato 0:ee40da884cfc 96 void *pv; /* aligned pointer alias */
dkato 0:ee40da884cfc 97 } u;
dkato 0:ee40da884cfc 98
dkato 0:ee40da884cfc 99 FLAC__ASSERT(elements > 0);
dkato 0:ee40da884cfc 100 FLAC__ASSERT(0 != unaligned_pointer);
dkato 0:ee40da884cfc 101 FLAC__ASSERT(0 != aligned_pointer);
dkato 0:ee40da884cfc 102 FLAC__ASSERT(unaligned_pointer != aligned_pointer);
dkato 0:ee40da884cfc 103
dkato 0:ee40da884cfc 104 if(elements > SIZE_MAX / sizeof(*pu)) /* overflow check */
dkato 0:ee40da884cfc 105 return false;
dkato 0:ee40da884cfc 106
dkato 0:ee40da884cfc 107 pu = FLAC__memory_alloc_aligned(sizeof(*pu) * elements, &u.pv);
dkato 0:ee40da884cfc 108 if(0 == pu) {
dkato 0:ee40da884cfc 109 return false;
dkato 0:ee40da884cfc 110 }
dkato 0:ee40da884cfc 111 else {
dkato 0:ee40da884cfc 112 if(*unaligned_pointer != 0)
dkato 0:ee40da884cfc 113 free(*unaligned_pointer);
dkato 0:ee40da884cfc 114 *unaligned_pointer = pu;
dkato 0:ee40da884cfc 115 *aligned_pointer = u.pa;
dkato 0:ee40da884cfc 116 return true;
dkato 0:ee40da884cfc 117 }
dkato 0:ee40da884cfc 118 }
dkato 0:ee40da884cfc 119
dkato 0:ee40da884cfc 120 FLAC__bool FLAC__memory_alloc_aligned_uint64_array(size_t elements, FLAC__uint64 **unaligned_pointer, FLAC__uint64 **aligned_pointer)
dkato 0:ee40da884cfc 121 {
dkato 0:ee40da884cfc 122 FLAC__uint64 *pu; /* unaligned pointer */
dkato 0:ee40da884cfc 123 union { /* union needed to comply with C99 pointer aliasing rules */
dkato 0:ee40da884cfc 124 FLAC__uint64 *pa; /* aligned pointer */
dkato 0:ee40da884cfc 125 void *pv; /* aligned pointer alias */
dkato 0:ee40da884cfc 126 } u;
dkato 0:ee40da884cfc 127
dkato 0:ee40da884cfc 128 FLAC__ASSERT(elements > 0);
dkato 0:ee40da884cfc 129 FLAC__ASSERT(0 != unaligned_pointer);
dkato 0:ee40da884cfc 130 FLAC__ASSERT(0 != aligned_pointer);
dkato 0:ee40da884cfc 131 FLAC__ASSERT(unaligned_pointer != aligned_pointer);
dkato 0:ee40da884cfc 132
dkato 0:ee40da884cfc 133 if(elements > SIZE_MAX / sizeof(*pu)) /* overflow check */
dkato 0:ee40da884cfc 134 return false;
dkato 0:ee40da884cfc 135
dkato 0:ee40da884cfc 136 pu = FLAC__memory_alloc_aligned(sizeof(*pu) * elements, &u.pv);
dkato 0:ee40da884cfc 137 if(0 == pu) {
dkato 0:ee40da884cfc 138 return false;
dkato 0:ee40da884cfc 139 }
dkato 0:ee40da884cfc 140 else {
dkato 0:ee40da884cfc 141 if(*unaligned_pointer != 0)
dkato 0:ee40da884cfc 142 free(*unaligned_pointer);
dkato 0:ee40da884cfc 143 *unaligned_pointer = pu;
dkato 0:ee40da884cfc 144 *aligned_pointer = u.pa;
dkato 0:ee40da884cfc 145 return true;
dkato 0:ee40da884cfc 146 }
dkato 0:ee40da884cfc 147 }
dkato 0:ee40da884cfc 148
dkato 0:ee40da884cfc 149 FLAC__bool FLAC__memory_alloc_aligned_unsigned_array(size_t elements, unsigned **unaligned_pointer, unsigned **aligned_pointer)
dkato 0:ee40da884cfc 150 {
dkato 0:ee40da884cfc 151 unsigned *pu; /* unaligned pointer */
dkato 0:ee40da884cfc 152 union { /* union needed to comply with C99 pointer aliasing rules */
dkato 0:ee40da884cfc 153 unsigned *pa; /* aligned pointer */
dkato 0:ee40da884cfc 154 void *pv; /* aligned pointer alias */
dkato 0:ee40da884cfc 155 } u;
dkato 0:ee40da884cfc 156
dkato 0:ee40da884cfc 157 FLAC__ASSERT(elements > 0);
dkato 0:ee40da884cfc 158 FLAC__ASSERT(0 != unaligned_pointer);
dkato 0:ee40da884cfc 159 FLAC__ASSERT(0 != aligned_pointer);
dkato 0:ee40da884cfc 160 FLAC__ASSERT(unaligned_pointer != aligned_pointer);
dkato 0:ee40da884cfc 161
dkato 0:ee40da884cfc 162 if(elements > SIZE_MAX / sizeof(*pu)) /* overflow check */
dkato 0:ee40da884cfc 163 return false;
dkato 0:ee40da884cfc 164
dkato 0:ee40da884cfc 165 pu = FLAC__memory_alloc_aligned(sizeof(*pu) * elements, &u.pv);
dkato 0:ee40da884cfc 166 if(0 == pu) {
dkato 0:ee40da884cfc 167 return false;
dkato 0:ee40da884cfc 168 }
dkato 0:ee40da884cfc 169 else {
dkato 0:ee40da884cfc 170 if(*unaligned_pointer != 0)
dkato 0:ee40da884cfc 171 free(*unaligned_pointer);
dkato 0:ee40da884cfc 172 *unaligned_pointer = pu;
dkato 0:ee40da884cfc 173 *aligned_pointer = u.pa;
dkato 0:ee40da884cfc 174 return true;
dkato 0:ee40da884cfc 175 }
dkato 0:ee40da884cfc 176 }
dkato 0:ee40da884cfc 177
dkato 0:ee40da884cfc 178 #ifndef FLAC__INTEGER_ONLY_LIBRARY
dkato 0:ee40da884cfc 179
dkato 0:ee40da884cfc 180 FLAC__bool FLAC__memory_alloc_aligned_real_array(size_t elements, FLAC__real **unaligned_pointer, FLAC__real **aligned_pointer)
dkato 0:ee40da884cfc 181 {
dkato 0:ee40da884cfc 182 FLAC__real *pu; /* unaligned pointer */
dkato 0:ee40da884cfc 183 union { /* union needed to comply with C99 pointer aliasing rules */
dkato 0:ee40da884cfc 184 FLAC__real *pa; /* aligned pointer */
dkato 0:ee40da884cfc 185 void *pv; /* aligned pointer alias */
dkato 0:ee40da884cfc 186 } u;
dkato 0:ee40da884cfc 187
dkato 0:ee40da884cfc 188 FLAC__ASSERT(elements > 0);
dkato 0:ee40da884cfc 189 FLAC__ASSERT(0 != unaligned_pointer);
dkato 0:ee40da884cfc 190 FLAC__ASSERT(0 != aligned_pointer);
dkato 0:ee40da884cfc 191 FLAC__ASSERT(unaligned_pointer != aligned_pointer);
dkato 0:ee40da884cfc 192
dkato 0:ee40da884cfc 193 if(elements > SIZE_MAX / sizeof(*pu)) /* overflow check */
dkato 0:ee40da884cfc 194 return false;
dkato 0:ee40da884cfc 195
dkato 0:ee40da884cfc 196 pu = FLAC__memory_alloc_aligned(sizeof(*pu) * elements, &u.pv);
dkato 0:ee40da884cfc 197 if(0 == pu) {
dkato 0:ee40da884cfc 198 return false;
dkato 0:ee40da884cfc 199 }
dkato 0:ee40da884cfc 200 else {
dkato 0:ee40da884cfc 201 if(*unaligned_pointer != 0)
dkato 0:ee40da884cfc 202 free(*unaligned_pointer);
dkato 0:ee40da884cfc 203 *unaligned_pointer = pu;
dkato 0:ee40da884cfc 204 *aligned_pointer = u.pa;
dkato 0:ee40da884cfc 205 return true;
dkato 0:ee40da884cfc 206 }
dkato 0:ee40da884cfc 207 }
dkato 0:ee40da884cfc 208
dkato 0:ee40da884cfc 209 #endif
dkato 0:ee40da884cfc 210
dkato 0:ee40da884cfc 211 void *safe_malloc_mul_2op_p(size_t size1, size_t size2)
dkato 0:ee40da884cfc 212 {
dkato 0:ee40da884cfc 213 if(!size1 || !size2)
dkato 0:ee40da884cfc 214 return malloc(1); /* malloc(0) is undefined; FLAC src convention is to always allocate */
dkato 0:ee40da884cfc 215 if(size1 > SIZE_MAX / size2)
dkato 0:ee40da884cfc 216 return 0;
dkato 0:ee40da884cfc 217 return malloc(size1*size2);
dkato 0:ee40da884cfc 218 }