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 /* alloc - Convenience routines for safely allocating memory
dkato 0:ee40da884cfc 2 * Copyright (C) 2007-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 #ifndef FLAC__SHARE__ALLOC_H
dkato 0:ee40da884cfc 34 #define FLAC__SHARE__ALLOC_H
dkato 0:ee40da884cfc 35
dkato 0:ee40da884cfc 36 #ifdef HAVE_CONFIG_H
dkato 0:ee40da884cfc 37 # include <config.h>
dkato 0:ee40da884cfc 38 #endif
dkato 0:ee40da884cfc 39
dkato 0:ee40da884cfc 40 /* WATCHOUT: for c++ you may have to #define __STDC_LIMIT_MACROS 1 real early
dkato 0:ee40da884cfc 41 * before #including this file, otherwise SIZE_MAX might not be defined
dkato 0:ee40da884cfc 42 */
dkato 0:ee40da884cfc 43
dkato 0:ee40da884cfc 44 #include <limits.h> /* for SIZE_MAX */
dkato 0:ee40da884cfc 45 #if HAVE_STDINT_H
dkato 0:ee40da884cfc 46 #include <stdint.h> /* for SIZE_MAX in case limits.h didn't get it */
dkato 0:ee40da884cfc 47 #endif
dkato 0:ee40da884cfc 48 #include <stdlib.h> /* for size_t, malloc(), etc */
dkato 0:ee40da884cfc 49 #include "share/compat.h"
dkato 0:ee40da884cfc 50
dkato 0:ee40da884cfc 51 #ifndef SIZE_MAX
dkato 0:ee40da884cfc 52 # ifndef SIZE_T_MAX
dkato 0:ee40da884cfc 53 # ifdef _MSC_VER
dkato 0:ee40da884cfc 54 # ifdef _WIN64
dkato 0:ee40da884cfc 55 # define SIZE_T_MAX 0xffffffffffffffffui64
dkato 0:ee40da884cfc 56 # else
dkato 0:ee40da884cfc 57 # define SIZE_T_MAX 0xffffffff
dkato 0:ee40da884cfc 58 # endif
dkato 0:ee40da884cfc 59 # else
dkato 0:ee40da884cfc 60 # error
dkato 0:ee40da884cfc 61 # endif
dkato 0:ee40da884cfc 62 # endif
dkato 0:ee40da884cfc 63 # define SIZE_MAX SIZE_T_MAX
dkato 0:ee40da884cfc 64 #endif
dkato 0:ee40da884cfc 65
dkato 0:ee40da884cfc 66 /* avoid malloc()ing 0 bytes, see:
dkato 0:ee40da884cfc 67 * https://www.securecoding.cert.org/confluence/display/seccode/MEM04-A.+Do+not+make+assumptions+about+the+result+of+allocating+0+bytes?focusedCommentId=5407003
dkato 0:ee40da884cfc 68 */
dkato 0:ee40da884cfc 69 static inline void *safe_malloc_(size_t size)
dkato 0:ee40da884cfc 70 {
dkato 0:ee40da884cfc 71 /* malloc(0) is undefined; FLAC src convention is to always allocate */
dkato 0:ee40da884cfc 72 if(!size)
dkato 0:ee40da884cfc 73 size++;
dkato 0:ee40da884cfc 74 return malloc(size);
dkato 0:ee40da884cfc 75 }
dkato 0:ee40da884cfc 76
dkato 0:ee40da884cfc 77 static inline void *safe_calloc_(size_t nmemb, size_t size)
dkato 0:ee40da884cfc 78 {
dkato 0:ee40da884cfc 79 if(!nmemb || !size)
dkato 0:ee40da884cfc 80 return malloc(1); /* malloc(0) is undefined; FLAC src convention is to always allocate */
dkato 0:ee40da884cfc 81 return calloc(nmemb, size);
dkato 0:ee40da884cfc 82 }
dkato 0:ee40da884cfc 83
dkato 0:ee40da884cfc 84 /*@@@@ there's probably a better way to prevent overflows when allocating untrusted sums but this works for now */
dkato 0:ee40da884cfc 85
dkato 0:ee40da884cfc 86 static inline void *safe_malloc_add_2op_(size_t size1, size_t size2)
dkato 0:ee40da884cfc 87 {
dkato 0:ee40da884cfc 88 size2 += size1;
dkato 0:ee40da884cfc 89 if(size2 < size1)
dkato 0:ee40da884cfc 90 return 0;
dkato 0:ee40da884cfc 91 return safe_malloc_(size2);
dkato 0:ee40da884cfc 92 }
dkato 0:ee40da884cfc 93
dkato 0:ee40da884cfc 94 static inline void *safe_malloc_add_3op_(size_t size1, size_t size2, size_t size3)
dkato 0:ee40da884cfc 95 {
dkato 0:ee40da884cfc 96 size2 += size1;
dkato 0:ee40da884cfc 97 if(size2 < size1)
dkato 0:ee40da884cfc 98 return 0;
dkato 0:ee40da884cfc 99 size3 += size2;
dkato 0:ee40da884cfc 100 if(size3 < size2)
dkato 0:ee40da884cfc 101 return 0;
dkato 0:ee40da884cfc 102 return safe_malloc_(size3);
dkato 0:ee40da884cfc 103 }
dkato 0:ee40da884cfc 104
dkato 0:ee40da884cfc 105 static inline void *safe_malloc_add_4op_(size_t size1, size_t size2, size_t size3, size_t size4)
dkato 0:ee40da884cfc 106 {
dkato 0:ee40da884cfc 107 size2 += size1;
dkato 0:ee40da884cfc 108 if(size2 < size1)
dkato 0:ee40da884cfc 109 return 0;
dkato 0:ee40da884cfc 110 size3 += size2;
dkato 0:ee40da884cfc 111 if(size3 < size2)
dkato 0:ee40da884cfc 112 return 0;
dkato 0:ee40da884cfc 113 size4 += size3;
dkato 0:ee40da884cfc 114 if(size4 < size3)
dkato 0:ee40da884cfc 115 return 0;
dkato 0:ee40da884cfc 116 return safe_malloc_(size4);
dkato 0:ee40da884cfc 117 }
dkato 0:ee40da884cfc 118
dkato 0:ee40da884cfc 119 void *safe_malloc_mul_2op_(size_t size1, size_t size2) ;
dkato 0:ee40da884cfc 120
dkato 0:ee40da884cfc 121 static inline void *safe_malloc_mul_3op_(size_t size1, size_t size2, size_t size3)
dkato 0:ee40da884cfc 122 {
dkato 0:ee40da884cfc 123 if(!size1 || !size2 || !size3)
dkato 0:ee40da884cfc 124 return malloc(1); /* malloc(0) is undefined; FLAC src convention is to always allocate */
dkato 0:ee40da884cfc 125 if(size1 > SIZE_MAX / size2)
dkato 0:ee40da884cfc 126 return 0;
dkato 0:ee40da884cfc 127 size1 *= size2;
dkato 0:ee40da884cfc 128 if(size1 > SIZE_MAX / size3)
dkato 0:ee40da884cfc 129 return 0;
dkato 0:ee40da884cfc 130 return malloc(size1*size3);
dkato 0:ee40da884cfc 131 }
dkato 0:ee40da884cfc 132
dkato 0:ee40da884cfc 133 /* size1*size2 + size3 */
dkato 0:ee40da884cfc 134 static inline void *safe_malloc_mul2add_(size_t size1, size_t size2, size_t size3)
dkato 0:ee40da884cfc 135 {
dkato 0:ee40da884cfc 136 if(!size1 || !size2)
dkato 0:ee40da884cfc 137 return safe_malloc_(size3);
dkato 0:ee40da884cfc 138 if(size1 > SIZE_MAX / size2)
dkato 0:ee40da884cfc 139 return 0;
dkato 0:ee40da884cfc 140 return safe_malloc_add_2op_(size1*size2, size3);
dkato 0:ee40da884cfc 141 }
dkato 0:ee40da884cfc 142
dkato 0:ee40da884cfc 143 /* size1 * (size2 + size3) */
dkato 0:ee40da884cfc 144 static inline void *safe_malloc_muladd2_(size_t size1, size_t size2, size_t size3)
dkato 0:ee40da884cfc 145 {
dkato 0:ee40da884cfc 146 if(!size1 || (!size2 && !size3))
dkato 0:ee40da884cfc 147 return malloc(1); /* malloc(0) is undefined; FLAC src convention is to always allocate */
dkato 0:ee40da884cfc 148 size2 += size3;
dkato 0:ee40da884cfc 149 if(size2 < size3)
dkato 0:ee40da884cfc 150 return 0;
dkato 0:ee40da884cfc 151 if(size1 > SIZE_MAX / size2)
dkato 0:ee40da884cfc 152 return 0;
dkato 0:ee40da884cfc 153 return malloc(size1*size2);
dkato 0:ee40da884cfc 154 }
dkato 0:ee40da884cfc 155
dkato 0:ee40da884cfc 156 static inline void *safe_realloc_add_2op_(void *ptr, size_t size1, size_t size2)
dkato 0:ee40da884cfc 157 {
dkato 0:ee40da884cfc 158 size2 += size1;
dkato 0:ee40da884cfc 159 if(size2 < size1)
dkato 0:ee40da884cfc 160 return 0;
dkato 0:ee40da884cfc 161 return realloc(ptr, size2);
dkato 0:ee40da884cfc 162 }
dkato 0:ee40da884cfc 163
dkato 0:ee40da884cfc 164 static inline void *safe_realloc_add_3op_(void *ptr, size_t size1, size_t size2, size_t size3)
dkato 0:ee40da884cfc 165 {
dkato 0:ee40da884cfc 166 size2 += size1;
dkato 0:ee40da884cfc 167 if(size2 < size1)
dkato 0:ee40da884cfc 168 return 0;
dkato 0:ee40da884cfc 169 size3 += size2;
dkato 0:ee40da884cfc 170 if(size3 < size2)
dkato 0:ee40da884cfc 171 return 0;
dkato 0:ee40da884cfc 172 return realloc(ptr, size3);
dkato 0:ee40da884cfc 173 }
dkato 0:ee40da884cfc 174
dkato 0:ee40da884cfc 175 static inline void *safe_realloc_add_4op_(void *ptr, size_t size1, size_t size2, size_t size3, size_t size4)
dkato 0:ee40da884cfc 176 {
dkato 0:ee40da884cfc 177 size2 += size1;
dkato 0:ee40da884cfc 178 if(size2 < size1)
dkato 0:ee40da884cfc 179 return 0;
dkato 0:ee40da884cfc 180 size3 += size2;
dkato 0:ee40da884cfc 181 if(size3 < size2)
dkato 0:ee40da884cfc 182 return 0;
dkato 0:ee40da884cfc 183 size4 += size3;
dkato 0:ee40da884cfc 184 if(size4 < size3)
dkato 0:ee40da884cfc 185 return 0;
dkato 0:ee40da884cfc 186 return realloc(ptr, size4);
dkato 0:ee40da884cfc 187 }
dkato 0:ee40da884cfc 188
dkato 0:ee40da884cfc 189 static inline void *safe_realloc_mul_2op_(void *ptr, size_t size1, size_t size2)
dkato 0:ee40da884cfc 190 {
dkato 0:ee40da884cfc 191 if(!size1 || !size2)
dkato 0:ee40da884cfc 192 return realloc(ptr, 0); /* preserve POSIX realloc(ptr, 0) semantics */
dkato 0:ee40da884cfc 193 if(size1 > SIZE_MAX / size2)
dkato 0:ee40da884cfc 194 return 0;
dkato 0:ee40da884cfc 195 return realloc(ptr, size1*size2);
dkato 0:ee40da884cfc 196 }
dkato 0:ee40da884cfc 197
dkato 0:ee40da884cfc 198 /* size1 * (size2 + size3) */
dkato 0:ee40da884cfc 199 static inline void *safe_realloc_muladd2_(void *ptr, size_t size1, size_t size2, size_t size3)
dkato 0:ee40da884cfc 200 {
dkato 0:ee40da884cfc 201 if(!size1 || (!size2 && !size3))
dkato 0:ee40da884cfc 202 return realloc(ptr, 0); /* preserve POSIX realloc(ptr, 0) semantics */
dkato 0:ee40da884cfc 203 size2 += size3;
dkato 0:ee40da884cfc 204 if(size2 < size3)
dkato 0:ee40da884cfc 205 return 0;
dkato 0:ee40da884cfc 206 return safe_realloc_mul_2op_(ptr, size1, size2);
dkato 0:ee40da884cfc 207 }
dkato 0:ee40da884cfc 208
dkato 0:ee40da884cfc 209 #endif