# M1s_BL808_example

**Repository Path**: Sipeed/M1s_BL808_example

## Basic Information

- **Project Name**: M1s_BL808_example
- **Description**: M1s_BL808_example github 同步仓库，原仓库：https://github.com/Sipeed/M1s_BL808_example
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 4
- **Created**: 2022-11-23
- **Last Updated**: 2025-01-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# M1s_BL808_example

[详细说明文档](https://wiki.sipeed.com/hardware/zh/maix/m1s/other/start.html)
[Detailed document](https://wiki.sipeed.com/hardware/en/maix/m1s/other/start.html)

## Setup

1. Download sdk

    ```shell
    mkdir ~/bl808 && cd ~/bl808
    git clone https://github.com/sipeed/M1s_BL808_SDK.git
    ```
    
2. Download example

    ```shell
    cd ~/bl808
    git clone https://github.com/sipeed/M1s_BL808_example.git
    cd M1s_BL808_example && ln -s ../M1s_BL808_SDK ./
    ```

3. Download toolchain (version 2.2.4) [here](https://dl.sipeed.com/shareURL/others/toolchain) or [here](https://occ.t-head.cn/community/download?id=3996672928124047360). Extract it to `M1s_BL808_SDK/toolchain/` and rename to  `Linux_x86_64` 

    ```shell
    cd ~/bl808 && mkdir M1s_BL808_SDK/toolchain
    
    mv {your_download_path}/Xuantie-900-gcc-elf-newlib-x86_64-V2.2.4-20220715.tar.gz ~/bl808
    tar -zxvf Xuantie-900-gcc-elf-newlib-x86_64-V2.2.4-20220715.tar.gz -C M1s_BL808_SDK/toolchain/
    
    cd M1s_BL808_SDK/toolchain && mv Xuantie-900-gcc-elf-newlib-x86_64-V2.2.4/ Linux_x86_64 && cd -
    ```

4. Build the hello_world example

    ```shell
    cd ~/bl808/M1s_BL808_example/c906_app/

    # Configure environment variables (Executed only once per working environment)
    export BL_SDK_PATH=$(pwd)/../M1s_BL808_SDK

    # Compile the hello_world project
    ./build.sh hello_world
    ```

5. The compilation is complete, and the target file is saved in the `build_out` path

##  Flash Guide

1. Download flash tool and startup

    Go to [bflb_dev_website](https://dev.bouffalolab.com/download) and download `Bouffalo Lab Dev Cube` released on `2022-09-01` and with version `v1.8.0`

    ```shell
    # unzip
    unzip BouffaloLabDevCube-v1.8.0.zip
    
    # startup
    ./BLDevCube-v1.8.0/BLDevCube-ubuntu &> /dev/null &
    ```

2. Download bl808 firmware

    - Use the type-c usb cable to connect from the PC side to the UART port of the board

    - Keep the `BOOT` button pressed and click `RST` button, then release the `BOOT` button

    - Startup `BLDevCube Tools` and choose `BL808` chip

    - Configure the tool according to the label below, finally click `Create & Download` will start to download firmware

        ![image-20221018233328391](assets/image-20221018233328391.png)
        
        **Tips:**
        
        > If you have downloaded the e907 firmware and have an extra USB port on your PC, you can update the c906 firmware via USB. You just need connect the USB to the OTG port, press and hold the left and right buttons before the board is reset, then drag your firmware to the ejected disk and just wait for the new firmware to boot.

3. Download bl702 firmware

    - Press the `BOOT` button, and connect the type-c cable to the UART port, then release the `BOOT` button

    - Startup `BLDevCube Tools` and choose `BL702/704/706` chip

    - Configure the tool according to the label below, finally click `Create & Download` will start to download firmware

        ![image-20221018233819623](assets/image-20221018233819623.png)

4. Download e907 firmware

    - Use the type-c usb cable to connect from the PC side to the UART port of the board

    - Keep the `BOOT` button pressed and click `RST` button, then release the `BOOT` button

    - Startup `BLDevCube Tools` and choose `BL808` chip

    - Configure the tool according to the label below, finally click `Create & Download` will start to download firmware

        ![image-20221109200656](assets/image-20221109200656.jpg)

5. About partition table files

    The partition table of bl808 is written in toml file format. You can specify the flash size used by the firmware by modifying the partition table.

    The default partition table is provided in the M1s_BL808_example/partition directory, and you can also create your own partition table.