https://github.com/edgeimpulse/firmware-silabs-xg24
https://github.com/edgeimpulse/firmware-silabs-xg24
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/edgeimpulse/firmware-silabs-xg24
- Owner: edgeimpulse
- License: apache-2.0
- Created: 2022-03-23T12:56:28.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-18T08:13:33.000Z (over 1 year ago)
- Last Synced: 2024-09-18T10:51:43.302Z (over 1 year ago)
- Language: C
- Size: 10.8 MB
- Stars: 5
- Watchers: 15
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Firmware Silicon Labs xG24 Dev Kit
Edge Impulse enables developers to create the next generation of intelligent device solutions with embedded machine learning. This repository contains the Edge Impulse firmware for Silicon Labs EFR32xG24 Dev Kit. This device supports all of Edge Impulse's device features, including ingestion, remote management and inferencing.
> **Note:** Do you just want to use this development board to collect data with Edge Impulse? No need to build this firmware. View the [getting started guide](https://docs.edgeimpulse.com/docs/development-platforms/officially-supported-mcu-targets/silabs-xg24-devkit) for a pre-built firmware image and flashing instructions.
This firmware has a [BLE capabilities](https://docs.edgeimpulse.com/docs/development-platforms/officially-supported-mcu-targets/silabs-thunderboard-sense-2#bluetooth-demo) built-in that allow you to start/stop inference and see its results on the mobile phone.
## Source code organization
* If you want to deploy your model (exported as a `Simplicity Studio Component` from Studio), extract the exported `zip` file content into:
`extension`
### Reporting issues
This repository is a snapshot of the Edge Impulse internal code base, therefore PRs won't be merged. If you find any bugs or want to contribute use our [Developer Forum](https://forum.edgeimpulse.com/) to submit them.
## Requirements
### Hardware
* [EFR32xG24 Dev Kit](https://www.silabs.com/wireless/zigbee/efr32mg24-series-2-socs)
* (optional) [Arducam Mini 2MP PLUS](https://www.arducam.com/product/arducam-2mp-spi-camera-b0067-arduino/)
### Software
For a local build using command line tools:
* [SLC CLI Tools](https://www.silabs.com/documents/public/user-guides/ug520-software-project-generation-configuration-with-slc-cli.pdf)
* [GNU Arm Embedded Toolchain 10-2020-q4-major](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads)
* [Gecko SDK v4.0.2](https://github.com/SiliconLabs/gecko_sdk/tree/v4.0.2)
For build using Docker container:
* [Docker Desktop](https://www.docker.com/products/docker-desktop)
For build using Simplicity Studio v5:
* [Simplicity Studio 5](https://www.silabs.com/developers/simplicity-studio) with Gecko SDK 4.0.2
## How to build
### Local build using command line tools
1. Clone the [Gecko SDK v.4.0.2](https://github.com/SiliconLabs/gecko_sdk/tree/v4.0.2)
```
git clone -b v4.0.2 https://github.com/SiliconLabs/gecko_sdk.git
```
1. Install [SLC CLI Tools (see p. 2.1)](https://www.silabs.com/documents/public/user-guides/ug520-software-project-generation-configuration-with-slc-cli.pdf)
1. Configure `SLC CLI` to point the location of the `Gecko SDK` and sign the SDK
```
slc configuration --sdk /home/user/gecko_sdk/
slc signature trust --sdk /home/user/gecko_sdk/
```
1. Also configure the default location of your toolchain, eg.
```
slc configuration --gcc-toolchain /opt/toolchains/gcc-arm-none-eabi-10-2020-q4-major
```
1. Clone this repository and build
```
git clone git@github.com:edgeimpulse/firmware-silabs-xg24.git
cd firmware-silabs-xg24/
./build.sh --build
```
### Using Docker
1. Clone this repository
```
git clone git@github.com:edgeimpulse/firmware-silabs-xg24.git
cd firmware-silabs-xg24/
```
1. Build the container
```
$ docker build -t edge-impulse-silabs .
```
1. Build the application
```
docker run --rm -v $PWD:/app edge-impulse-silabs /bin/bash build.sh --build
```
### Using Simplicity Studio v5
1. Install [Simplicity Studio v5](https://www.silabs.com/developers/simplicity-studio) and [Gecko SDK v4.0.2](https://github.com/SiliconLabs/gecko_sdk)
1. Clone this repository
1. In the Simplicity Studio, choose `File -> Import`
1. Browse to the directory with cloned repository select `firmware-xg24` project and clik `Next`
1. Check if all imported configurations are correct, especially `Board`, `SDK` and `Toolchain`:
1. Choose a project name in your workspace and finish
1. We have to make a few tweaks before building the project. In the `Project Explorer` panel, right click on the `extension` directory and choose `Delete`
1. Confirm that only workspace link will be removed, the target will remain unchanged
1. Now, double click on the `firmware-xg24.slcp` file to open project configuration
1. In the new window choose `Change Targed/SDK/Generators`
1. Make sure only `Simplicity IDE Project` generator is selected, **REMOVE** any other generators.
1. Build the project
## Flashing
1. Install [Simplicity Commander](https://community.silabs.com/s/article/simplicity-commander?language=en_US)
1. Connect the board and flash:
```
$ ./build.sh --flash
```