# Play mp3 file on sd card. If no filename is given, stop playing. Add a second argument of one
# to wait mp3 ending before exit. 
sd([<filename>][,1])
# Although LD3320 has a mechanism to determin the MP3 duration,
# I can't get it to work properly. It will wait about 2 seconds more before signalling the end
# in most cases. So instead, the function will read the MP3 header to determine the duration.
#
# MP3 file directory setting
sd(<0,1>,<directory>)
# When the first argument is 0, it sets the current MP3 directory to look for when start playing
# an MP3 file with relative path.
# When the first argument is 1, it sets the default MP3 directory which will be searched if the
# file is not found in the current MP3 directory.
# These function is here to make it easy to switch the whole set of voice prompt without requiring
# to change ASR menu, e.g. swith from male prompt to female.
#
# File manipulation functions
#
# Change the current working directory
cd(<directory name>)
#
# List the current directory content
dir
#
#  Delete the file
rm(<filename>)
#
#  Check if the file exists
exists(<filename>)
#
# Append text to a file. Create the file if not exists
append(<filename>,<text>)
#
# Append binary content to a file. Create the file if not exists.
append64(<filname>,<base 64 encoded string>)
#
# Make directory
md(<diretory name>)


# ASR commands
#
# ASR initialization
asr
#
# ASR global action settings
asr(0,<index>,<filename>[,<directory>])
# The supported index values are 
#   0: current menu. When an ASR round is finished, this script will be ran to setup the menu fo
#      the next round of ASR recognition.
#   1: default action will be executed if an ASR result is detected but no 
#      associated actions, 
#   2: error action will be executed if any chip configuration error has happed.
#   3: confirmation action will be ran if an ASR result is detected which requires a confirmation.
#      Unlike the current menu setting above, the confirmation menu item does not support action.
#      Specifiy an '!' in the action setting to confirm.
#      The default confirmation start a ASR loop waiting for the following keywords,
#      - mei cuo (means no error)
#      - hao wa (alright)
#      - bu shi la (no no no)
#      - bu shi (no)
#      - a (ah...)
#
# Start ASR recognition
asr(1)
#
# Add an ASR menu item
asr(2,<command in Chinese HanYuPinYin> [, <action script>])
# If no action script is given, if this menu item is recognized, the default action will be executed
# if there is one. 
#
# Add an ASR menu item that requires confirmation
asr(2,<command in Chinese HanYuPinYin>, <action script> [, <voice prompt>])
# <voice prompt> is an MP3 filename. If omitted, then the voice prompt shall be the same name as 
# <action script> appended with extension ".mp3".


# Infra Red signal transmitting
#
# General form
ir(<cmd>,...)
# If <cmd> is omitted, it will transmits the last received IR code.
#
# IR transmitting
ir(1,[code_type] [,<code_length>, <code_value>])
# If [code_type] is anything other than -1 (i.e. raw data), you need to specify the code length and
# value. Refer to arduino IRRemote library for code type. or just copy the output of ir(0). 
# For raw data sending, you can prepare the data using  the following raw buffer setup commands.
#
# IR raw buffer setup
ir(2,[value]...)
ir(3,[value]...)
# ir(2,...) resets the internal raw buffer index to 0, and squentially fill the buffer with
# the input argument. ir(3,...) continues the filling. This function exists because of the 
# limited line buffer size of bitlash, which is in turn limited by the arduino device memory.