Renesas
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.
1.2 Pin Definitions
Table 1.1 shows the pins used in this sample code.
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:
- Audio Camera Shield
https://developer.mbed.org/teams/Renesas/wiki/Audio_Camera-shield - 7.1 inch LCD Shield
https://developer.mbed.org/teams/Renesas/wiki/LCD-shield
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.
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.
Table 2.1 lists the overview of Graphical User Interface (GUI) of this sample code.
2.2 List of User Operations
Table 2.2 shows the relationship among Audio Playback, Command Line and Onboard Switch.
3. Function Outline
Table 3.1, 3.2 and 3.3 shows the overview of functions implemented in this sample code.
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.
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.
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)
main/system.h
- Committer:
- Osamu Nakamura
- Date:
- 2017-04-11
- Revision:
- 6:a957aaa284f0
- Parent:
- 4:2672de88a46b
File content as of revision 6:a957aaa284f0:
/*******************************************************************************
* DISCLAIMER
* This software is supplied by Renesas Electronics Corporation and is only
* intended for use with Renesas products. No other uses are authorized. This
* software is owned by Renesas Electronics Corporation and is protected under
* all applicable laws, including copyright laws.
* THIS SOFTWARE IS PROVIDED "AS IS" AND RENESAS MAKES NO WARRANTIES REGARDING
* THIS SOFTWARE, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
* LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
* AND NON-INFRINGEMENT. ALL SUCH WARRANTIES ARE EXPRESSLY DISCLAIMED.
* TO THE MAXIMUM EXTENT PERMITTED NOT PROHIBITED BY LAW, NEITHER RENESAS
* ELECTRONICS CORPORATION NOR ANY OF ITS AFFILIATED COMPANIES SHALL BE LIABLE
* FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR
* ANY REASON RELATED TO THIS SOFTWARE, EVEN IF RENESAS OR ITS AFFILIATES HAVE
* BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
* Renesas reserves the right, without notice, to make changes to this software
* and to discontinue the availability of this software. By using this software,
* you agree to the additional terms and conditions found by accessing the
* following link:
* http://www.renesas.com/disclaimer*
* Copyright (C) 2015 Renesas Electronics Corporation. All rights reserved.
*******************************************************************************/
#ifndef SYSTEM_H
#define SYSTEM_H
#include "r_typedefs.h"
#include "USBHostMSD.h"
/*--- Macro definition of folder scan in USB memory ---*/
#define SYS_MAX_FOLDER_NUM (99u) /* Supported number of folders */
#define SYS_MAX_TRACK_NUM (999u) /* Supported number of tracks */
#define SYS_MAX_FOLDER_DEPTH (8u) /* Supported folder levels */
#define SYS_MAX_NAME_LENGTH (NAME_MAX) /* Maximum length of track name and folder name */
#define SYS_MAX_PATH_LENGTH (511) /* Maximum length of the full path */
/* It is the name to mount the file system of the USBHostMSD class. */
#define SYS_USB_MOUNT_NAME "usb"
/*--- User defined types of main thread ---*/
/* Key code */
typedef enum {
SYS_KEYCODE_NON = 0,
SYS_KEYCODE_STOP, /* Stop */
SYS_KEYCODE_PLAYPAUSE, /* Play / Pause */
SYS_KEYCODE_NEXT, /* Next track */
SYS_KEYCODE_PREV, /* Previous track */
SYS_KEYCODE_PLAYINFO, /* Play info */
SYS_KEYCODE_REPEAT, /* Repeat */
SYS_KEYCODE_HELP, /* Help */
SYS_KEYCODE_MODE, /* Mode */
SYS_KEYCODE_NUM
} SYS_KeyCode;
/* Playback status */
typedef enum {
SYS_PLAYSTAT_STOP = 0, /* Stop */
SYS_PLAYSTAT_PLAY, /* Play */
SYS_PLAYSTAT_PAUSE, /* Pause */
SYS_PLAYSTAT_NUM
} SYS_PlayStat;
/** Main Thread
*
* @param argument Pointer to the thread function as start argument.
*/
void system_main(void);
/** Notifies the main thread of the key input information.
*
* @param key_code key code
* Stop : SYS_KEYCODE_STOP
* Play/pause : SYS_KEYCODE_PLAYPAUSE
* Play next song : SYS_KEYCODE_NEXT
* Play previous song : SYS_KEYCODE_PREV
* Show song information : SYS_KEYCODE_PLAYINFO
* Switch repeat mode : SYS_KEYCODE_REPEAT
* Show help message: SYS_KEYCODE_HELP
* Switch display mode: SYS_KEYCODE_MODE
*
* @returns
* Returns true if the API is successful. Returns false if the API fails.
* This function fails when:
* Failed to secure memory for mailbox communication.
* Failed to perform transmit processing for mailbox communication.
*/
bool sys_notify_key_input(const SYS_KeyCode key_code);
/** Notifies the main thread of the play time, total play time, and play state.
*
* @param play_stat Playback state
* Stopped : SYS_PLAYSTAT_STOP
* Playing : SYS_PLAYSTAT_PLAY
* Paused : SYS_PLAYSTAT_PAUSE
* @param play_time Playback time (in seconds)
* 0 to 359999
* * 0 hour, 0 minute, 0 second to 99 hours, 59 minutes, 59 seconds
* @param total_time Total play time (in seconds)
* 0 to 359999
* * 0 hour, 0 minute, 0 second to 99 hours, 59 minutes, 59 seconds
*
* @returns
* Returns true if the API is successful. Returns false if the API fails.
* This function fails when:
* Failed to secure memory for mailbox communication.
* Failed to perform transmit processing for mailbox communication.
*/
bool sys_notify_play_time(const SYS_PlayStat play_stat,
const uint32_t play_time, const uint32_t total_time);
#endif /* SYSTEM_H */