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 DISPLAY_H
dkato 0:ee40da884cfc 25 #define DISPLAY_H
dkato 0:ee40da884cfc 26
dkato 0:ee40da884cfc 27 #include "r_typedefs.h"
dkato 0:ee40da884cfc 28 #include "system.h"
dkato 0:ee40da884cfc 29
dkato 0:ee40da884cfc 30 /*--- Macro definition ---*/
dkato 0:ee40da884cfc 31 #define DSP_STACK_SIZE (2048u) /* Stack size of display thread */
dkato 0:ee40da884cfc 32
dkato 0:ee40da884cfc 33 /* The maximum length of display character string. */
dkato 0:ee40da884cfc 34 #define DSP_DISP_STR_MAX_LEN (64)
dkato 0:ee40da884cfc 35 /* The maximum length of input character string by the command-line. */
dkato 0:ee40da884cfc 36 #define DSP_CMD_INPT_STR_MAX_LEN (63)
dkato 0:ee40da884cfc 37
dkato 0:ee40da884cfc 38 /* The baud rate of the serial port for PC communication. */
dkato 0:ee40da884cfc 39 #define DSP_PC_COM_BAUDRATE (9600)
dkato 0:ee40da884cfc 40
1050186 4:2672de88a46b 41 /* Display mode */
1050186 4:2672de88a46b 42 #define DSP_DISPMODE_1 (1u)
1050186 4:2672de88a46b 43 #define DSP_DISPMODE_2 (2u)
1050186 4:2672de88a46b 44 #define DSP_DISPMODE_3 (3u)
1050186 4:2672de88a46b 45
dkato 0:ee40da884cfc 46 /*--- User defined types ---*/
dkato 0:ee40da884cfc 47 typedef enum {
dkato 0:ee40da884cfc 48 DSP_MAILID_DUMMY = 0,
dkato 0:ee40da884cfc 49 DSP_MAILID_CYCLE_IND, /* Cyclic notice */
dkato 0:ee40da884cfc 50 DSP_MAILID_CMD_STR, /* Notifies display thread of input string. */
dkato 0:ee40da884cfc 51 DSP_MAILID_PRINT_STR, /* Notifies display thread of output string. */
dkato 0:ee40da884cfc 52 DSP_MAILID_PLAY_TIME, /* Notifies display thread of playback time. */
dkato 0:ee40da884cfc 53 DSP_MAILID_PLAY_INFO, /* Notifies display thread of playback information. */
dkato 0:ee40da884cfc 54 DSP_MAILID_PLAY_MODE, /* Notifies display thread of repeat mode. */
dkato 0:ee40da884cfc 55 DSP_MAILID_FILE_NAME, /* Notifies display thread of file name. */
dkato 2:d9fca8cd7f03 56 DSP_MAILID_HELP, /* Requests display thread to display help message. */
1050186 4:2672de88a46b 57 DSP_MAILID_DISP_MODE, /* Notifies display thread of display mode. */
1050186 4:2672de88a46b 58 DSP_MAILID_TFT_KEY, /* Notifies display thread of tft keycode. */
1050186 4:2672de88a46b 59 DSP_MAILID_AUDIO_FIN, /* Notifies display thread of completion */
1050186 4:2672de88a46b 60 /* of audio data acquisition. */
1050186 4:2672de88a46b 61 DSP_MAILID_PLAY_STAT, /* Notifies display thread of play state. */
dkato 0:ee40da884cfc 62 DSP_MAILID_NUM
dkato 0:ee40da884cfc 63 } DSP_MAIL_ID;
dkato 0:ee40da884cfc 64
dkato 0:ee40da884cfc 65 /* These data are used in all display modules. */
dkato 0:ee40da884cfc 66 typedef struct {
dkato 0:ee40da884cfc 67 uint32_t disp_mode; /* Display mode */
dkato 0:ee40da884cfc 68 SYS_PlayStat play_stat; /* Playback status */
dkato 0:ee40da884cfc 69 uint32_t track_id; /* Track number */
dkato 0:ee40da884cfc 70 uint32_t play_time; /* Playback time (sec) */
dkato 0:ee40da884cfc 71 uint32_t total_time; /* Total playback time (sec) */
dkato 0:ee40da884cfc 72 uint32_t samp_freq; /* Sampling frequency (Hz) */
dkato 0:ee40da884cfc 73 uint32_t channel; /* Channel number */
dkato 0:ee40da884cfc 74 bool repeat_mode; /* Repeat mode */
dkato 0:ee40da884cfc 75 char_t file_name[DSP_DISP_STR_MAX_LEN];/* Character string of file name */
dkato 0:ee40da884cfc 76 char_t dspl_str[DSP_DISP_STR_MAX_LEN]; /* Display character string */
1050186 4:2672de88a46b 77 bool edge_track_change; /* Indicates the change of track number. */
dkato 0:ee40da884cfc 78 } dsp_com_ctrl_t;
dkato 0:ee40da884cfc 79
dkato 0:ee40da884cfc 80 /* These data are used only in the terminal-output module. */
dkato 0:ee40da884cfc 81 typedef struct {
dkato 0:ee40da884cfc 82 bool edge_fin_inpt; /* Completion status of the input by the command-line.*/
dkato 0:ee40da884cfc 83 /* [true = input completion, false = input now] */
dkato 0:ee40da884cfc 84 char_t inpt_str[DSP_CMD_INPT_STR_MAX_LEN];/* Input character string by the command-line. */
dkato 0:ee40da884cfc 85 } dsp_trm_ctrl_t;
dkato 0:ee40da884cfc 86
dkato 0:ee40da884cfc 87 /** Display Thread
dkato 0:ee40da884cfc 88 *
dkato 0:ee40da884cfc 89 * @param argument Pointer to the thread function as start argument.
dkato 0:ee40da884cfc 90 */
dkato 0:ee40da884cfc 91 void dsp_thread(void const *argument);
dkato 0:ee40da884cfc 92
1050186 4:2672de88a46b 93 /** Notifies the display thread of the cyclic event.
1050186 4:2672de88a46b 94 *
1050186 4:2672de88a46b 95 * @returns
1050186 4:2672de88a46b 96 * Returns true if the API is successful. Returns false if the API fails.
1050186 4:2672de88a46b 97 * This function fails when:
1050186 4:2672de88a46b 98 * Failed to secure memory for mailbox communication.
1050186 4:2672de88a46b 99 * Failed to perform transmit processing for mailbox communication.
1050186 4:2672de88a46b 100 */
1050186 4:2672de88a46b 101 bool dsp_notify_cycle_time(void);
1050186 4:2672de88a46b 102
dkato 0:ee40da884cfc 103 /** Notifies the display thread of the song information (file number, play time, total play time, play state).
dkato 0:ee40da884cfc 104 *
dkato 0:ee40da884cfc 105 * @param play_stat Playback state
dkato 0:ee40da884cfc 106 * Stopped : SYS_PLAYSTAT_STOP
dkato 0:ee40da884cfc 107 * Playing : SYS_PLAYSTAT_PLAY
dkato 0:ee40da884cfc 108 * Paused : SYS_PLAYSTAT_PAUSE
dkato 0:ee40da884cfc 109 * @param file_no File number
dkato 0:ee40da884cfc 110 * 1 to 999
dkato 0:ee40da884cfc 111 * @param play_time Playback time (in seconds)
dkato 0:ee40da884cfc 112 * 0 to 359999
dkato 0:ee40da884cfc 113 * * 0 hour, 0 minute, 0 second to 99 hours, 59 minutes, 59 seconds
dkato 0:ee40da884cfc 114 * @param total_time Total play time (in seconds)
dkato 0:ee40da884cfc 115 * 0 to 359999
dkato 0:ee40da884cfc 116 * * 0 hour, 0 minute, 0 second to 99 hours, 59 minutes, 59 seconds
dkato 0:ee40da884cfc 117 *
dkato 0:ee40da884cfc 118 * @returns
dkato 0:ee40da884cfc 119 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 120 * This function fails when:
dkato 0:ee40da884cfc 121 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 122 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 123 */
dkato 0:ee40da884cfc 124 bool dsp_notify_play_time(const SYS_PlayStat play_stat, const uint32_t file_no,
dkato 0:ee40da884cfc 125 const uint32_t play_time, const uint32_t total_time);
dkato 0:ee40da884cfc 126
dkato 0:ee40da884cfc 127 /** Notifies the display thread of the song information (file number, sampling frequency, and number of channels).
dkato 0:ee40da884cfc 128 *
dkato 0:ee40da884cfc 129 * @param file_no File number
dkato 0:ee40da884cfc 130 * 1 to 999
dkato 0:ee40da884cfc 131 * @param sample_freq Sampling frequency (Hz)
dkato 0:ee40da884cfc 132 * 22050, 24000, 32000, 44100, 48000, 64000, 88200, 96000
dkato 0:ee40da884cfc 133 * @param channel_num Number of channels
dkato 0:ee40da884cfc 134 * 1, 2
dkato 0:ee40da884cfc 135 *
dkato 0:ee40da884cfc 136 * @returns
dkato 0:ee40da884cfc 137 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 138 * This function fails when:
dkato 0:ee40da884cfc 139 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 140 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 141 */
dkato 0:ee40da884cfc 142 bool dsp_notify_play_info(const uint32_t file_no,
dkato 0:ee40da884cfc 143 const uint32_t sample_freq, const uint32_t channel_num);
dkato 0:ee40da884cfc 144
dkato 0:ee40da884cfc 145 /** Notifies the display thread of the playback mode (repeat mode).
dkato 0:ee40da884cfc 146 *
dkato 0:ee40da884cfc 147 * @param rep_mode Repeat mode
dkato 0:ee40da884cfc 148 * Repeat mode OFF : false
dkato 0:ee40da884cfc 149 * Repeat mode ON : true
dkato 0:ee40da884cfc 150 *
dkato 0:ee40da884cfc 151 * @returns
dkato 0:ee40da884cfc 152 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 153 * This function fails when:
dkato 0:ee40da884cfc 154 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 155 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 156 */
dkato 0:ee40da884cfc 157 bool dsp_notify_play_mode(const bool rep_mode);
dkato 0:ee40da884cfc 158
dkato 0:ee40da884cfc 159 /** Notifies the display thread of the file name.
dkato 0:ee40da884cfc 160 *
dkato 0:ee40da884cfc 161 * @param p_str File name string
dkato 0:ee40da884cfc 162 * * The string must be terminated by '\0'.
dkato 0:ee40da884cfc 163 * The character code must be the local character code. Since the end of
dkato 0:ee40da884cfc 164 * a string is identified by the presence of '\0', a file name of
dkato 0:ee40da884cfc 165 * multi-byte code may not be displayed correctly.
dkato 0:ee40da884cfc 166 * The maximum length of the string that the display thread can notify
dkato 0:ee40da884cfc 167 * is 64 bytes including '\0'.
dkato 0:ee40da884cfc 168 *
dkato 0:ee40da884cfc 169 * @returns
dkato 0:ee40da884cfc 170 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 171 * This function fails when:
dkato 0:ee40da884cfc 172 * The argument p_str is set to NULL.
dkato 0:ee40da884cfc 173 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 174 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 175 */
dkato 0:ee40da884cfc 176 bool dsp_notify_file_name(const char_t * const p_str);
dkato 0:ee40da884cfc 177
dkato 0:ee40da884cfc 178 /** Notifies the display thread of the string to be output on the terminal.
dkato 0:ee40da884cfc 179 *
dkato 0:ee40da884cfc 180 * @param p_str String to be output on the terminal
dkato 0:ee40da884cfc 181 * * The string must be terminated by '\0'.
dkato 0:ee40da884cfc 182 * The character code must be the local character code. Since the end of
dkato 0:ee40da884cfc 183 * a string is identified by the presence of '\0', a file name of
dkato 0:ee40da884cfc 184 * multi-byte code may not be displayed correctly.
dkato 0:ee40da884cfc 185 * The maximum length of the string that the display thread can notify
dkato 0:ee40da884cfc 186 * is 64 bytes including '\0'.
dkato 0:ee40da884cfc 187 *
dkato 0:ee40da884cfc 188 * @returns
dkato 0:ee40da884cfc 189 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 190 * This function fails when:
dkato 0:ee40da884cfc 191 * The argument p_str is set to NULL.
dkato 0:ee40da884cfc 192 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 193 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 194 */
dkato 0:ee40da884cfc 195 bool dsp_notify_print_string(const char_t * const p_str);
dkato 0:ee40da884cfc 196
dkato 0:ee40da884cfc 197 /** Notifies the display thread of the command line input string.
dkato 0:ee40da884cfc 198 * * Used to echo back the string entered from the command line.
dkato 0:ee40da884cfc 199 *
dkato 0:ee40da884cfc 200 * @param p_str Command line input string
dkato 0:ee40da884cfc 201 * * The string must contain no control characters and terminate with '\0'.
dkato 0:ee40da884cfc 202 * The character code must be the local character code. Since the end of
dkato 0:ee40da884cfc 203 * a string is identified by the presence of '\0', a file name of
dkato 0:ee40da884cfc 204 * multi-byte code may not be displayed correctly.
dkato 0:ee40da884cfc 205 * The maximum length of the string that the display thread can notify
dkato 0:ee40da884cfc 206 * is 63 bytes including '\0'.
dkato 0:ee40da884cfc 207 *
dkato 0:ee40da884cfc 208 * @param flag_fin Input completion flag
dkato 0:ee40da884cfc 209 * Middle of input : false
dkato 0:ee40da884cfc 210 * Input complete : true
dkato 0:ee40da884cfc 211 *
dkato 0:ee40da884cfc 212 * @returns
dkato 0:ee40da884cfc 213 * Returns true if the API is successful. Returns false if the API fails.
dkato 0:ee40da884cfc 214 * This function fails when:
dkato 0:ee40da884cfc 215 * The argument p_str is set to NULL.
dkato 0:ee40da884cfc 216 * Failed to secure memory for mailbox communication.
dkato 0:ee40da884cfc 217 * Failed to perform transmit processing for mailbox communication.
dkato 0:ee40da884cfc 218 */
dkato 0:ee40da884cfc 219 bool dsp_notify_input_string(const char_t * const p_str, const bool flag_fin);
dkato 0:ee40da884cfc 220
dkato 2:d9fca8cd7f03 221 /** Requests the display thread to display help message.
dkato 2:d9fca8cd7f03 222 *
dkato 2:d9fca8cd7f03 223 * @returns
dkato 2:d9fca8cd7f03 224 * Returns true if the API is successful. Returns false if the API fails.
dkato 2:d9fca8cd7f03 225 * This function fails when:
dkato 2:d9fca8cd7f03 226 * Failed to secure memory for mailbox communication.
dkato 2:d9fca8cd7f03 227 * Failed to perform transmit processing for mailbox communication.
dkato 2:d9fca8cd7f03 228 */
dkato 2:d9fca8cd7f03 229 bool dsp_req_help(void);
dkato 2:d9fca8cd7f03 230
1050186 4:2672de88a46b 231 /** Notifies the display thread of the display mode.
1050186 4:2672de88a46b 232 *
1050186 4:2672de88a46b 233 * @param disp_mode display mode
1050186 4:2672de88a46b 234 *
1050186 4:2672de88a46b 235 * @returns
1050186 4:2672de88a46b 236 * Returns true if the API is successful. Returns false if the API fails.
1050186 4:2672de88a46b 237 * This function fails when:
1050186 4:2672de88a46b 238 * Failed to secure memory for mailbox communication.
1050186 4:2672de88a46b 239 * Failed to perform transmit processing for mailbox communication.
1050186 4:2672de88a46b 240 */
1050186 4:2672de88a46b 241 bool dsp_notify_disp_mode(const uint32_t disp_mode);
1050186 4:2672de88a46b 242
1050186 4:2672de88a46b 243 /** Notifies the display thread of the information of the pushed key on TFT display.
1050186 4:2672de88a46b 244 *
1050186 4:2672de88a46b 245 * @param key_code pushed key code
1050186 4:2672de88a46b 246 * Play/pause : SYS_KEYCODE_PLAYPAUSE
1050186 4:2672de88a46b 247 * Play next song : SYS_KEYCODE_NEXT
1050186 4:2672de88a46b 248 * Play previous song : SYS_KEYCODE_PREV
1050186 4:2672de88a46b 249 * Switch repeat mode : SYS_KEYCODE_REPEAT
1050186 4:2672de88a46b 250 * Switch display mode : SYS_KEYCODE_MODE
1050186 4:2672de88a46b 251 *
1050186 4:2672de88a46b 252 * @returns
1050186 4:2672de88a46b 253 * Returns true if the API is successful. Returns false if the API fails.
1050186 4:2672de88a46b 254 * This function fails when:
1050186 4:2672de88a46b 255 * Failed to secure memory for mailbox communication.
1050186 4:2672de88a46b 256 * Failed to perform transmit processing for mailbox communication.
1050186 4:2672de88a46b 257 */
1050186 4:2672de88a46b 258 bool dsp_notify_tft_key(const SYS_KeyCode key_code);
1050186 4:2672de88a46b 259
1050186 4:2672de88a46b 260 /** Notifies the display thread of the playback status.
1050186 4:2672de88a46b 261 *
1050186 4:2672de88a46b 262 * @param play_stat pushed key code
1050186 4:2672de88a46b 263 * Stopped : SYS_PLAYSTAT_STOP
1050186 4:2672de88a46b 264 * Playing : SYS_PLAYSTAT_PLAY
1050186 4:2672de88a46b 265 * Paused : SYS_PLAYSTAT_PAUSE
1050186 4:2672de88a46b 266 *
1050186 4:2672de88a46b 267 * @returns
1050186 4:2672de88a46b 268 * Returns true if the API is successful. Returns false if the API fails.
1050186 4:2672de88a46b 269 * This function fails when:
1050186 4:2672de88a46b 270 * Failed to secure memory for mailbox communication.
1050186 4:2672de88a46b 271 * Failed to perform transmit processing for mailbox communication.
1050186 4:2672de88a46b 272 */
1050186 4:2672de88a46b 273 bool dsp_notify_play_status(const SYS_PlayStat play_stat);
1050186 4:2672de88a46b 274
1050186 4:2672de88a46b 275 /** This function converts the touch position of current screen into the key code.
1050186 4:2672de88a46b 276 *
1050186 4:2672de88a46b 277 * @param disp_mode Display mode
1050186 4:2672de88a46b 278 * @param pos_x Touch X position
1050186 4:2672de88a46b 279 * @param pos_y Touch Y position
1050186 4:2672de88a46b 280 *
1050186 4:2672de88a46b 281 * @returns
1050186 4:2672de88a46b 282 * If touch position is on the picture of key, this function returns key code.
1050186 4:2672de88a46b 283 * Otherwise this function returns "SYS_KEYCODE_NON".
1050186 4:2672de88a46b 284 */
1050186 4:2672de88a46b 285 SYS_KeyCode dsp_convert_key(const uint32_t disp_mode,
1050186 4:2672de88a46b 286 const uint32_t pos_x, const uint32_t pos_y);
1050186 4:2672de88a46b 287
dkato 0:ee40da884cfc 288 #endif /* DISPLAY_H */