LED 
===========
1. **简介**
--------------
    AIOT-3568A设有LED模块，可以通过API控制LED的状态，目前仅支持主板状态灯控制，如下为主板状态灯：

    |LED1|

2. **HDC相关指令**
--------------

    控制主板蓝灯，0为关闭，1为打开
        
        .. code-block:: c++
            
            echo 0 > sys/class/gpio_sw/blue_led/data

    控制主板红灯，0为关闭，1为打开
        
        .. code-block:: c++
            
            echo 0 > sys/class/gpio_sw/red_led/data


3. **标准API使用方法**
--------------

.. note::
    
        本模块提供shimeta所有自研API的调用，该接口持续更新。

+ **shimeta标准接口++**

     **@ohos.shimeta**

+ **API使用说明**

        使用WIFI相关API开发时候，需要先了解熟悉第一个open Harmony工程的创建，相关文档　:doc:`Hello World应用以及部署<../../Quick-Start/OpenHarmony/04-应用以及部署>`

        在使用一个API时，需要注意以下几点：
        + API权限说明
        + API的参数与返回值
        + API调用错误的时候，参考API错误码和通用错误码
        + API示例的正确使用     
           
    LED相关API具体文档可跳转　:doc:`LED相关API<../../Quick-Start/OpenHarmony/02-ShiMetaAPI接口/>`

4. **社区Demo**
--------------
+ **简介**
    
        社区示例加快正在制作中，敬请等待！将会呈现更优质的内容给各位小伙伴！！

+ **导入模块**

    在使用GPIO API的时候，最重要的一步是导入shimeta的接口。通常模块导入是在文件头导入
    导入模块如下：

    **import shimeta from '@ohos.shimeta'**

+ **shimeta.sys_setControl(其它IO相关设置 (主板状态灯，模块电源))**

        + sys_setControl(type: number, enable: boolean): Promise<void>;

    参数说明：
       .. code-block:: c++
       
            type：number 
        
                3:wifi power
                4:wifi reset
                5:led control
                6:speak power
                7:lvds power
                8:lvds reset
                9:4G power
                10:4G reset
                11:LAN power
                12:LAN reset
                13:SD power
                14:SD reset
                15:TP power
                16:TP reset
                17:GBE reset
                18:EDP BackLight power
                19:Fan power
            
            enable ： boolean

                true:打开 false:关闭
               
.. note::
    普通应用只支持控制 LED灯(5)和风扇(19)
   
   API使用示例：
        .. code-block:: TypeScript
            :linenos:
     
            import shimeta from '@ohos.shimeta'
            import { BusinessError } from '@ohos.base';

            shimeta.sys_setControl(5, this.ledEnable).then(() => {
            promptAction.showToast({
                message: `sys_setControl type:5 ,Enable :${this.ledEnable}`
            })
            this.ledEnable = !this.ledEnable
            }).catch((err: BusinessError) => {
            console.error("error message: " + err.message + ", error code: " + err.code);
            });

+ **shimeta.sys_getControl(获取其它IO相关状态 (主板状态灯，模块电源))**

        + sys_getControl(type: number): Promise<number>;

    参数说明：
       .. code-block:: c++
       
            type：number 
        
                3:wifi power
                4:wifi reset
                5:led control
                6:speak power
                7:lvds power
                8:lvds reset
                9:4G power
                10:4G reset
                11:LAN power
                12:LAN reset
                13:SD power
                14:SD reset
                15:TP power
                16:TP reset
                17:GBE reset
                18:EDP BackLight power
                19:Fan power

.. note::
    普通应用只支持控制 LED灯(5)和风扇(19)


   API使用示例：
        .. code-block:: TypeScript
            :linenos:
     
            import shimeta from '@ohos.shimeta'
            import { BusinessError } from '@ohos.base';

            shimeta.sys_setControl(5, this.ledEnable).then(() => {
            promptAction.showToast({
                message: `sys_setControl type:5 ,Enable :${this.ledEnable}`
            })
            this.ledEnable = !this.ledEnable
            }).catch((err: BusinessError) => {
            console.error("error message: " + err.message + ", error code: " + err.code);
            });


5. **代码编译**
--------------
.. tip::
   代码编译详细流程可见，:doc:`Hello World应用以及部署<../../Quick-Start/OpenHarmony/04-应用以及部署>`  中的第二部分（构建第一个页面部分内容）

6. **代码运行效果**
--------------

.. note::
    社区示例加快正在制作中，敬请等待！将会呈现更优质的内容给各位小伙伴！！

.. |LED1| image:: media1/LED1.png
   :width: 5.75in
   :height: 3.92708in