Renesas / Mbed OS GR-PEACH_Audio_Playback_Sample

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

Note

For a sample program of with LCD Board,
please refer to GR-PEACH_Audio_Playback_7InchLCD_Sample.

Introduction

The "GR-PEACH_Audio_Playback_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/dkato/audioplayback_figure1_1x.png

1.2 Pin Definitions

Table 1.1 shows the pins that this sample code are to use.

/media/uploads/dkato/audioplayback_table1_1.png

2. Sample Code Operating Environment

This sample code runs in GR-PEACH + the Audio/Camera shield for the GR-PEACH environment. This section explains the functions of the ports that are used by this sample code.

2.1 Operating Environment

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

/media/uploads/dkato/audioplayback_figure2_1.png /media/uploads/1050186/figure2_2.png /media/uploads/dkato/audioplayback_figure2_3.png

2.2 List of User Operations

A list of user operations on the command line, TFT touch keys, and switch key that the user can perform for this sample code is shown in. Table 2.1.

/media/uploads/dkato/audioplayback_table2_1x.png

3. Function Outline

The functions of this sample code are summarized in Table 3.1 to Table 3.3.

/media/uploads/dkato/audioplayback_table3_1.png /media/uploads/dkato/audioplayback_table3_2.png /media/uploads/dkato/audioplayback_table3_3.png /media/uploads/dkato/audioplayback_figure3_1.png

3.1 Playback Control

The playback control that the sample code supports include play, pause, stop, skip to next, and skip to previous.

3.2 Trick Play Control

Manipulating "Repeat" alternates between "Repeat mode On" and "Repeat mode Off". The default mode is "Repeat mode On". When the repeat mode is on, the playback of the first song starts after the playback of the last song is finished. When the repeat mode is off, the sample code enters the stopped state after the playback of the last song is finished.

3.3 Acquisition of the Song Information

The information of the song being played is obtained by operating the "Play info" during the playback of the song. Table 3.4 lists the items of information that can be obtained by the "Play info" operation.

/media/uploads/dkato/audioplayback_table3_4.png

3.4 How the Folder Structure is Analyzed

The sample coded analyzes the folder structure in the breadth-first search order. The order in which files are numbered is illustrated in Table 3.5. The sample code does not sort the files by file or folder name.

/media/uploads/dkato/audioplayback_table3_5.png

4.Others

The default setting of serial communication (baud rate etc.) in mbed is shown the following link.
Please refer to the link and change the settings of your PC terminal software.
The default value of baud rate in mbed is 9600, and this application uses baud rate 9600.
https://developer.mbed.org/teams/Renesas/wiki/GR-PEACH-Getting-Started#install-the-usb-serial-communication

decode/dec_flac.h

Committer:
Osamu Nakamura
Date:
2017-03-31
Revision:
6:df19c3e787ca
Parent:
0:ee40da884cfc

File content as of revision 6:df19c3e787ca:

/*******************************************************************************
* 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 DEC_FLAC_H
#define DEC_FLAC_H

#include "r_typedefs.h"
#include "stream_decoder.h"

/*--- User defined types ---*/
typedef struct {
    FLAC__StreamDecoder     *p_decoder;         /* Handle of flac decoder */
    FILE                    *p_file_handle;     /* Handle of flac file */
    uint64_t                decoded_sample;     /* Number of a decoded sample */
    uint64_t                total_sample;       /* Total number of sample */
    uint32_t                sample_rate;        /* Sample rate in Hz */
    uint32_t                channel_num;        /* Number of channels */
    uint32_t                bits_per_sample;    /* bit per sample */
    int32_t                 *p_pcm_buf;         /* Pointer of PCM buffer */
    uint32_t                pcm_buf_num;        /* Size of PCM buffer */
    uint32_t                pcm_buf_used_cnt;   /* Counter of used elements in PCM buffer */
} flac_ctrl_t;

/** Sets the PCM buffer to store decoded data
 *
 *  @param p_flac_ctrl Pointer to the control data of FLAC module.
 *  @param p_buf_addr Pointer to PCM buffer to store decoded data.
 *  @param buf_num Elements number of PCM buffer array.
 *
 *  @returns 
 *    Results of process. true is success. false is failure.
 */
bool flac_set_pcm_buf(flac_ctrl_t * const p_flac_ctrl, 
        int32_t * const p_buf_addr, const uint32_t buf_num);

/** Gets elements number of the decoded data
 *
 *  @param p_flac_ctrl Pointer to the control data of FLAC module.
 *
 *  @returns 
 *    Elements number of the decoded data.
 */
uint32_t flac_get_pcm_cnt(const flac_ctrl_t * const p_flac_ctrl);

/** Gets the playback time
 *
 *  @param p_flac_ctrl Pointer to the control data of FLAC module.
 *
 *  @returns 
 *    Playback time (second).
 */
uint32_t flac_get_play_time(const flac_ctrl_t * const p_flac_ctrl);

/** Gets the total playback time
 *
 *  @param p_flac_ctrl Pointer to the control data of FLAC module.
 *
 *  @returns 
 *    Total playback time (second).
 */
uint32_t flac_get_total_time(const flac_ctrl_t * const p_flac_ctrl);

/** Open the FLAC decoder
 *
 *  @param p_handle Pointer to the handle of FLAC file.
 *  @param p_flac_ctrl Pointer to the control data of FLAC module.
 *
 *  @returns 
 *    Results of process. true is success. false is failure.
 */
bool flac_open(FILE * const p_handle, flac_ctrl_t * const p_flac_ctrl);

/** Decode some audio frames.
 *
 *  @param p_flac_ctrl Pointer to the control data of FLAC module.
 *
 *  @returns 
 *    Results of process. true is success. false is failure.
 */
bool flac_decode(const flac_ctrl_t * const p_flac_ctrl);

/** Close the FLAC decoder
 *
 *  @param p_flac_ctrl Pointer to the control data of FLAC module.
 */
void flac_close(flac_ctrl_t * const p_flac_ctrl);

#endif /* DEC_FLAC_H */