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:
Osamu Nakamura
Date:
Tue Apr 11 12:42:10 2017 +0900
Revision:
6:a957aaa284f0
Parent:
4:2672de88a46b
Update R-BSP from rev. cbb9d60c8748 to fb9eda52224e so that this program can be compiled with IAR toolchain.

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 SYSTEM_H
dkato 0:ee40da884cfc 25 #define SYSTEM_H
dkato 0:ee40da884cfc 26
dkato 0:ee40da884cfc 27 #include "r_typedefs.h"
dkato 0:ee40da884cfc 28 #include "USBHostMSD.h"
dkato 0:ee40da884cfc 29
dkato 0:ee40da884cfc 30 /*--- Macro definition of folder scan in USB memory ---*/
dkato 0:ee40da884cfc 31 #define SYS_MAX_FOLDER_NUM (99u) /* Supported number of folders */
dkato 0:ee40da884cfc 32 #define SYS_MAX_TRACK_NUM (999u) /* Supported number of tracks */
dkato 0:ee40da884cfc 33 #define SYS_MAX_FOLDER_DEPTH (8u) /* Supported folder levels */
dkato 0:ee40da884cfc 34 #define SYS_MAX_NAME_LENGTH (NAME_MAX) /* Maximum length of track name and folder name */
dkato 0:ee40da884cfc 35 #define SYS_MAX_PATH_LENGTH (511) /* Maximum length of the full path */
dkato 0:ee40da884cfc 36
dkato 0:ee40da884cfc 37 /* It is the name to mount the file system of the USBHostMSD class. */
dkato 0:ee40da884cfc 38 #define SYS_USB_MOUNT_NAME "usb"
dkato 0:ee40da884cfc 39
dkato 0:ee40da884cfc 40 /*--- User defined types of main thread ---*/
dkato 0:ee40da884cfc 41 /* Key code */
dkato 0:ee40da884cfc 42 typedef enum {
dkato 0:ee40da884cfc 43 SYS_KEYCODE_NON = 0,
dkato 0:ee40da884cfc 44 SYS_KEYCODE_STOP, /* Stop */
dkato 0:ee40da884cfc 45 SYS_KEYCODE_PLAYPAUSE, /* Play / Pause */
dkato 0:ee40da884cfc 46 SYS_KEYCODE_NEXT, /* Next track */
dkato 0:ee40da884cfc 47 SYS_KEYCODE_PREV, /* Previous track */
dkato 0:ee40da884cfc 48 SYS_KEYCODE_PLAYINFO, /* Play info */
dkato 0:ee40da884cfc 49 SYS_KEYCODE_REPEAT, /* Repeat */
dkato 2:d9fca8cd7f03 50 SYS_KEYCODE_HELP, /* Help */
1050186 4:2672de88a46b 51 SYS_KEYCODE_MODE, /* Mode */
dkato 0:ee40da884cfc 52 SYS_KEYCODE_NUM
dkato 0:ee40da884cfc 53 } SYS_KeyCode;
dkato 0:ee40da884cfc 54
dkato 0:ee40da884cfc 55 /* Playback status */
dkato 0:ee40da884cfc 56 typedef enum {
dkato 0:ee40da884cfc 57 SYS_PLAYSTAT_STOP = 0, /* Stop */
dkato 0:ee40da884cfc 58 SYS_PLAYSTAT_PLAY, /* Play */
dkato 0:ee40da884cfc 59 SYS_PLAYSTAT_PAUSE, /* Pause */
dkato 0:ee40da884cfc 60 SYS_PLAYSTAT_NUM
dkato 0:ee40da884cfc 61 } SYS_PlayStat;
dkato 0:ee40da884cfc 62
dkato 0:ee40da884cfc 63 /** Main Thread
dkato 0:ee40da884cfc 64 *
dkato 0:ee40da884cfc 65 * @param argument Pointer to the thread function as start argument.
dkato 0:ee40da884cfc 66 */
dkato 0:ee40da884cfc 67 void system_main(void);
dkato 0:ee40da884cfc 68
dkato 0:ee40da884cfc 69 /** Notifies the main thread of the key input information.
dkato 0:ee40da884cfc 70 *
dkato 0:ee40da884cfc 71 * @param key_code key code
dkato 0:ee40da884cfc 72 * Stop : SYS_KEYCODE_STOP
dkato 0:ee40da884cfc 73 * Play/pause : SYS_KEYCODE_PLAYPAUSE
dkato 0:ee40da884cfc 74 * Play next song : SYS_KEYCODE_NEXT
dkato 0:ee40da884cfc 75 * Play previous song : SYS_KEYCODE_PREV
dkato 0:ee40da884cfc 76 * Show song information : SYS_KEYCODE_PLAYINFO
dkato 0:ee40da884cfc 77 * Switch repeat mode : SYS_KEYCODE_REPEAT
dkato 2:d9fca8cd7f03 78 * Show help message: SYS_KEYCODE_HELP
1050186 4:2672de88a46b 79 * Switch display mode: SYS_KEYCODE_MODE
dkato 0:ee40da884cfc 80 *
dkato 0:ee40da884cfc 81 * @returns
dkato 0:ee40da884cfc 82 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 83 * This function fails when:
dkato 0:ee40da884cfc 84 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 85 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 86 */
dkato 0:ee40da884cfc 87 bool sys_notify_key_input(const SYS_KeyCode key_code);
dkato 0:ee40da884cfc 88
dkato 0:ee40da884cfc 89 /** Notifies the main thread of the play time, total play time, and play state.
dkato 0:ee40da884cfc 90 *
dkato 0:ee40da884cfc 91 * @param play_stat Playback state
dkato 0:ee40da884cfc 92 * Stopped : SYS_PLAYSTAT_STOP
dkato 0:ee40da884cfc 93 * Playing : SYS_PLAYSTAT_PLAY
dkato 0:ee40da884cfc 94 * Paused : SYS_PLAYSTAT_PAUSE
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 sys_notify_play_time(const SYS_PlayStat play_stat,
dkato 0:ee40da884cfc 109 const uint32_t play_time, const uint32_t total_time);
dkato 0:ee40da884cfc 110
dkato 0:ee40da884cfc 111 #endif /* SYSTEM_H */