/**
  ******************************************************************************
  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *
  * Copyright (C) 2022 Shanghai Eastsoft Microelectronics Co., Ltd. ALL rights reserved.
  *******************************************************************************
  */

<--------------------------------------------------------------------------------
Version history:
--------------------------------------------------------------------------------->
2023-04-17       V1.0.0      AE TEAM

<--------------------------------------------------------------------------------
Demo introduction:
--------------------------------------------------------------------------------->
本示例功能：msc设备演示。且可用shell命令操作设备。
命令如下：
    uint32_t list_cmd(void)
    列出所有命令。
    例子1 = list_cmd()
                                   
    uint32_t make_dir(char* input_fullpath) 
    生成文件夹。新生成的文件夹路径 = 输入路径。
    例子1 = make_dir("0:/TEST_DIR")
    例子2 = make_dir("0:/TEST_DIR/TEST_DIR2")  
    例子3 = make_dir("0:/TEST_DIR/TEST_DIR2/TEST_DIR3")
    
    uint32_t read_dir(char* input_fullpath)
    查看文件夹中的内容。
    例子1 = read_dir(0)         
    例子2 = read_dir("0:/TEST_DIR")  
    例子3 = read_dir("0:/TEST_DIR/TEST_DIR2")  
    例子4 = read_dir("0:/TEST_DIR/TEST_DIR2/TEST_DIR3")
    
    uint32_t rm_dir(char* input_fullpath)
    删除输入路径文件夹及文件夹下的文件。   。
    例子1 = rm_dir("0:/TEST_DIR")
    
    uint32_t write_file(char *input_fullpath, char *write_buf)
    写文件。如果文件不存在，则创建文件。   。
    例子1 = write_file("0:/test.txt","abc123")

    uint32_t read_file(char* input_fullpath) 
    读文件。                                   。
    例子1 = read_file("0:/test.txt")        

    uint32_t rm_file(char* input_fullpath)
    删除文件。
    例子1 = rm_file("0:/test.txt")
    
    uint32_t move_rename(char* old_fullpath,char* new_fullpath)
    重命名/移动 文件/文件夹
    例子1 = move_rename("0:/test.txt","0:/test1.txt")
    
    uint32_t es_pdf_test(char* input_fullpath)
    生成pdf文件。pdf的文件内容见es_pdf_test.c。 
    例子1 =  es_pdf_test("0:/test.pdf")


<--------------------------------------------------------------------------------
测试环境:
--------------------------------------------------------------------------------->
测试用板；
ES-PDS-ES32VF2264LT-T2
需要对开发板进行如下操作：
1.闭合JP1、JP2、JP3、JP4。
2.断开SB1、SB2、SB3。

辅助工具：
ES-BUR-ESLINK2OB

辅助软件：
XCOM上位机软件

<--------------------------------------------------------------------------------
测试步骤：
--------------------------------------------------------------------------------->
1) 编译工程，编译通过后将程序下载到目标芯片；在开发板的背面插入spiflash模块：ES-PDS-E2-FLASH。
2) 打开XCOM上位机软件，配置参数（波特率-115200，1位停止位，8位数据位，无奇偶校验），打开串口；
3) 复位芯片，或在线调试，运行程序；
4) 等待USB设备枚举完成。
5) 枚举成功后，可作为储存设备使用。
6）可通过shell 命令与设备交互。

<--------------------------------------------------------------------------------
注意：
--------------------------------------------------------------------------------->
当PC在写spiflash时，不要通过shell命令写spiflash。

<--------------------------------------------------------------------------------
System clock:
--------------------------------------------------------------------------------->


<--------------------------------------------------------------------------------
Pin connection: 
--------------------------------------------------------------------------------->
