系统变量
=================

**系统变量分为：工程配置和本机变量。**
   - **工程配置：主要是用配置工程，如屏幕旋转、默认音量大小等。**
   - **本机变量：主要是用于在事件脚本中控制音频、获取RTC参数（配合控件实现钟表功能）等**

.. _工程配置属性详解:

工程配置
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

+----------------------------+---------+-----------------------------------------------------------------------------------------------------------+
|名称                        |    读写 | 含义                                                                                                      |
+============================+=========+===========================================================================================================+
|屏幕旋转(sys.dir)           |    只读 | 屏幕旋转：0-旋转0度 1-旋转90度 2-旋转180度 3-旋转270。                                                    |
+----------------------------+---------+-----------------------------------------------------------------------------------------------------------+
|背光亮度(sys.bl)            |    读写 | 调节范围：0-100。该值上电后默认为100，屏幕掉电后不会保存                                                  | 
+----------------------------+---------+-----------------------------------------------------------------------------------------------------------+
|触摸使能(sys.ten)           |    读写 | 使能触摸功能：0-关闭 1-开启。                                                                             |    
+----------------------------+---------+-----------------------------------------------------------------------------------------------------------+
|音量大小(sys.vol)           |    读写 | 调节范围：0-100。                                                                                         | 
+----------------------------+---------+-----------------------------------------------------------------------------------------------------------+
|触摸提示音(sys.ben)         |    读写 | 开启和关闭触摸后蜂鸣提示音：0-关闭 1-开启                                                                 |     
+----------------------------+---------+-----------------------------------------------------------------------------------------------------------+
|启动页面(sys.pid)           |    读写 | 启动页面的id,范围0-249。运行过程，脚本修改此值可切换页面                                                  |    
+----------------------------+---------+-----------------------------------------------------------------------------------------------------------+
|字符编码(sys.code)          |    只读 | 配置工程所有输入文本的编码，如：脚本字符、文本控件的文本值。                                              |
|                            |         |                                                                                                           |
|                            |         | **注意：串口发送的字符串编码需要此配置一致**                                                              |    
+----------------------------+---------+-----------------------------------------------------------------------------------------------------------+
|串口波特率(sys.baud)        |    读写 | 配置串口的波特率                                                                                          |    
+----------------------------+---------+-----------------------------------------------------------------------------------------------------------+
|设备地址(sys.addr)          |    读写 | 配置该设备的地址                                                                                          |    
+----------------------------+---------+-----------------------------------------------------------------------------------------------------------+
|背景变暗(sys.mask)          |    读写 | 滑屏时，当前页面是否变暗: 0-否1-是                                                                        |    
+----------------------------+---------+-----------------------------------------------------------------------------------------------------------+

.. warning:: 
    脚本对工程配置修改，并不会保存到Flash，不能掉电保存！

.. warning:: 
    sys.pid=1; 等同于 page(1);  对该变量赋值，直接会切换页面，后面的代码将不会执行。


本机变量
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+
|名称                       |读写     |含义                                                                                                          |
+===========================+=========+==============================================================================================================+
|触摸X坐标(sys.tchx)        |只读     |获取实时X轴触摸坐标值，int16_t类型                                                                            |
+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+
|触摸Y坐标(sys.tchy)        |只读     |获取实时y轴触摸坐标值，int16_t类型                                                                            |
+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+
|系统随机数(sys.rand)       |只读     |获取系统随机数。该值的范围可通过指令randset(min,max)来设置                                                    |
+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+
|音频控制(sys.audio)        |读写     |控制音频播放状态：0-停止1-播放2-暂停。脚本中调用指令play()                                                    |
|                           |         |                                                                                                              |
|                           |         |播放后，我们可以通过读写sys.audio来控制暂停播放                                                               |
+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+
|获取RTC-年(sys.year)       |只读     |获取RTC-年参数，该值范围：2000-2099                                                                           |
+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+
|获取RTC-月(sys.month)      |只读     |获取RTC-月参数，该值范围：1-12                                                                                |
+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+
|获取RTC-日(sys.day)        |只读     |获取RTC-日参数，该值范围：1-31                                                                                |
+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+
|获取RTC-时(sys.hour)       |只读     |获取RTC-小时参数，该值范围：0-23                                                                              |
+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+
|获取RTC-分(sys.min)        |只读     |获取RTC-分钟参数，该值范围：0-59                                                                              |
+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+
|获取RTC-秒(sys.sec)        |只读     |获取RTC-秒参数，该值范围：0-59                                                                                |
+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+
|获取RTC-星期(sys.week)     |只读     |获取RTC-星期参数，该值范围：0-6。0表示星期日                                                                  |  
+---------------------------+---------+--------------------------------------------------------------------------------------------------------------+