Renesas / Mbed OS GR-PEACH_Audio_Playback_7InchLCD_Sample

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)

Diff: display/display.h

Revision:
4:2672de88a46b
Parent:
2:d9fca8cd7f03
--- a/display/display.h	Mon Dec 07 05:08:45 2015 +0000
+++ b/display/display.h	Mon Jan 25 02:41:36 2016 +0000
@@ -38,6 +38,11 @@
 /* The baud rate of the serial port for PC communication. */
 #define DSP_PC_COM_BAUDRATE         (9600)
 
+/* Display mode */
+#define DSP_DISPMODE_1              (1u)
+#define DSP_DISPMODE_2              (2u)
+#define DSP_DISPMODE_3              (3u)
+
 /*--- User defined types ---*/
 typedef enum {
     DSP_MAILID_DUMMY = 0,
@@ -49,6 +54,11 @@
     DSP_MAILID_PLAY_MODE,   /* Notifies display thread of repeat mode. */
     DSP_MAILID_FILE_NAME,   /* Notifies display thread of file name. */
     DSP_MAILID_HELP,        /* Requests display thread to display help message. */
+    DSP_MAILID_DISP_MODE,   /* Notifies display thread of display mode. */
+    DSP_MAILID_TFT_KEY,     /* Notifies display thread of tft keycode. */
+    DSP_MAILID_AUDIO_FIN,   /* Notifies display thread of completion */
+                            /* of audio data acquisition. */
+    DSP_MAILID_PLAY_STAT,   /* Notifies display thread of play state. */
     DSP_MAILID_NUM
 } DSP_MAIL_ID;
 
@@ -64,6 +74,7 @@
     bool            repeat_mode;    /* Repeat mode */
     char_t          file_name[DSP_DISP_STR_MAX_LEN];/* Character string of file name */
     char_t          dspl_str[DSP_DISP_STR_MAX_LEN]; /* Display character string */
+    bool            edge_track_change; /* Indicates the change of track number. */
 } dsp_com_ctrl_t;
 
 /* These data are used only in the terminal-output module. */
@@ -73,18 +84,22 @@
     char_t      inpt_str[DSP_CMD_INPT_STR_MAX_LEN];/* Input character string by the command-line. */
 } dsp_trm_ctrl_t;
 
-/* These data are used only in the TFT module. */
-typedef struct {
-    int32_t         disp_phase_no;  /* The making phase of the display image */
-} dsp_tft_ctrl_t;
-
-
 /** Display Thread
  *
  *  @param argument Pointer to the thread function as start argument.
  */
 void dsp_thread(void const *argument);
 
+/** Notifies the display thread of the cyclic event.
+ *
+ *  @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 dsp_notify_cycle_time(void);
+
 /** Notifies the display thread of the song information (file number, play time, total play time, play state).
  *
  *  @param play_stat Playback state
@@ -213,4 +228,61 @@
  */
 bool dsp_req_help(void);
 
+/** Notifies the display thread of the display mode.
+ *
+ *  @param disp_mode display 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 dsp_notify_disp_mode(const uint32_t disp_mode);
+
+/** Notifies the display thread of the information of the pushed key on TFT display.
+ *
+ *  @param key_code pushed key code
+ *                    Play/pause : SYS_KEYCODE_PLAYPAUSE
+ *                    Play next song : SYS_KEYCODE_NEXT
+ *                    Play previous song : SYS_KEYCODE_PREV
+ *                    Switch repeat mode : SYS_KEYCODE_REPEAT
+ *                    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 dsp_notify_tft_key(const SYS_KeyCode key_code);
+
+/** Notifies the display thread of the playback status.
+ *
+ *  @param play_stat pushed key code
+ *                    Stopped : SYS_PLAYSTAT_STOP
+ *                    Playing : SYS_PLAYSTAT_PLAY
+ *                    Paused : SYS_PLAYSTAT_PAUSE
+ *
+ *  @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 dsp_notify_play_status(const SYS_PlayStat play_stat);
+
+/** This function converts the touch position of current screen into the key code.
+ *
+ *  @param disp_mode Display mode
+ *  @param pos_x Touch X position
+ *  @param pos_y Touch Y position
+ *
+ *  @returns 
+ *    If touch position is on the picture of key, this function returns key code.
+ *    Otherwise this function returns "SYS_KEYCODE_NON".
+ */
+SYS_KeyCode dsp_convert_key(const uint32_t disp_mode, 
+                                    const uint32_t pos_x, const uint32_t pos_y);
+
 #endif /* DISPLAY_H */