.. _quickref:

快速上手
===============================

MicroPython 继承了python优美简介的语法，同时提供了便捷的嵌入式硬件操作库。HaaS100作为阿里云Iot推出的一款
Iot 开发板，它适配了MicroPython的运行引擎,提供了各种丰富的硬件操作接口，同时提供阿里云物联网平台和云端AI相关的能力。通过这块芯片，我们可以轻松通过python程序实现硬件控制，云端AI以及云端互通的能力。

环境搭建
---------------------
环境搭建可以有两种方法:基于源码编译烧录和基于官方固件直接烧录

建议开发者基于官方固件快速搭建python开发环境，具体步骤如下:


- Mac环境搭建


  第一步:下载官方固件包,并解压到当前目录

    `<<Mac固件下载链接>> <https://hli.aliyuncs.com/haasai/image/20210301/mac_burn.zip>`_

    固件包中包含需要烧录的两个bin文件和两个烧录工具文件,具体见下图:

    .. image:: https://img.alicdn.com/imgextra/i4/O1CN01a9VrdP1s4bNzl1239_!!6000000005713-2-tps-1652-242.png
        :alt: 固件包文件列表
        :width: 80%
        :height: 500px
        :align: center


  第二步: 机器连接电源，并通过usb连接到电脑

    通常情况下,连接成功以后,设备上会多出来一个/dev/cu.SLAB_USBtoUART设备

  第三步: 设置串口,执行烧录命令

    推荐使用picocom 工具，设置波特率:1500000,设备节点:/dev/cu.SLAB_USBtoUART

    ::

        picocom -b 1500000 /dev/cu.SLAB_USBtoUART

    设置成功以后，按下回车键能正常进去设备串口命令行模式下

    退出picocom(Ctrl+A 加上 Ctrl +Q ),进入mpy_burn目录,执行以下命令烧录:
    
    ::

        python flash_program.py --bin=./micropython_repl_demo@haas100.bin --bin=./littlefs.bin#0xB32000

    Mac电脑烧录请确保电脑安装pserial,安装命令如下:

    ::

        brew install python
        pip install pserial


- Windows环境搭建

  第一步:下载官方固件包,并解压到当前目录

    `<<Windows固件下载链接>> <https://hli.aliyuncs.com/haasai/image/20210301/win_burn.zip>`_

    刷机包解压后,具体见下图:

    .. image:: https://img.alicdn.com/imgextra/i3/O1CN01UhLE0I1OBzIbMGGhA_!!6000000001668-2-tps-1798-800.png
        :alt: 固件包文件列表
        :width: 80%
        :height: 500px
        :align: center


  第二步: 机器连接电源，并通过usb连接到电脑

  第三步:进入write_flash_gui目录，双击运行haas1000_write_flash_main，出现如下烧录软件的主界面

    .. image:: https://img.alicdn.com/imgextra/i2/O1CN01swsFmP1SDb9eSaJsl_!!6000000002213-2-tps-1668-678.png
        :alt: 固件包文件列表
        :width: 80%
        :height: 500px
        :align: center
  第四步:Port Config,选择对应的串口设备后，点击开始按钮烧录即可

源码固件编译方法，可以参考: `<<HaaS100快速开始>> <https://help.aliyun.com/document_detail/184184.html?spm=a2c4g.11186623.6.641.aac221ffSEcctz>`_
,将编译工程名从helloworld_demo 改成 mpy_cli_demo

快速验证
----------------------

开机默认会启动之前烧录进去的程序，打开串口工具,选择对应的串口设备，设置波特率为1500000 并连接。
micropython默认支持两种运行模式: 交互式 和 执行文件，在串口下输入不同的命令进入不同的模式

    - 命令行输入micropython进入交互模式，在交互模式输入python语句,就能看到执行结果。

    ::

      micropython

    .. image:: https://img.alicdn.com/imgextra/i2/O1CN01MKxiX91cbY1YGdbVj_!!6000000003619-1-tps-600-375.gif
        :alt: MicroPython轻应用交互式运行结果
        :width: 80%
        :height: 500px
        :align: center

    - 命令行输入micropython  /data/led_test.py,执行data目录的led_test.py文件
    
    ::
     
      micropython /data/led_test.py
      

    .. image:: https://img.alicdn.com/imgextra/i1/O1CN01jXpEdm1Pa5lDCkWry_!!6000000001856-1-tps-600-340.gif
        :alt: MicroPython跑马灯运行结果
        :width: 80%
        :height: 500px
        :align: center

    以下是跑马灯的代码示例，更多示例请参考主页的参考案例界面

    ::

      # coding=utf-8
      # This is a sample Python script.
      import utime
      from haascv import driver

      GPIO = driver.gpio()
        leds=(34,35,36,40,41)
        for i in range(10):
            for led in leds:
                GPIO.open(led, 5, 0)
                GPIO.write(0)
                utime.sleep_ms(200)
                GPIO.write(1)
                utime.sleep_ms(200)
                GPIO.close()


    除了/data目录之外,还支持执行/sdcard 目录python程序.
    文件在pc上面编辑,保存到sdcard目录,然后将sdcard插入机器,重启机器,执行如下命令

    ::

      micropython /sdcard/led_test.py