Edge Impulse Docs

Edge Impulse Documentation

Welcome to the Edge Impulse documentation. You'll find comprehensive guides and documentation to help you start working with Edge Impulse as quickly as possible, as well as support if you get stuck. Let's jump right in!

TI CC1352P LaunchPad

The Texas Instruments CC1352P LaunchPad is a development board equipped with the multiprotocol wireless CC1352P microcontroller. The LaunchPad, when paired with the BOOSTXL-SENSORS BoosterPack, is fully supported by Edge Impulse, and is able to sample accelerometer data, build models, and deploy directly to the device without any programming required. The CC1352P Launchpad and BOOSTXL-SENSORS boards are available for purchase directly from Texas Instruments.

If you don't have the BOOSTXL-SENSORS BoosterPack or are using different sensing hardware, you can use the Data forwarder to capture data from any other sensor type, and then follow the Running your impulse locally tutorial to run your impulse. Or, you can clone and modify the open source firmware-ti-launchxl project on GitHub.

Installing dependencies

To set this device up in Edge Impulse, you will need to install the following software:

  1. Edge Impulse CLI.
  2. Texas Instruments UniFlash
    • Install the desktop version for your operating system here
    • Add the installation directory to your PATH
    • See Troubleshooting for more details
  3. On Linux:
    • GNU Screen: install for example via sudo apt install screen.

šŸš§

Problems installing the Edge Impulse CLI?

See the Installation and troubleshooting guide.

Connecting to Edge Impulse

With all the software in place it's time to connect the development board to Edge Impulse.

1. Attach the BOOSTXL-SENSORS board to the LaunchPad.

Orient the sensor board such that the 3V3 and GND markings line up with the LaunchPad.

TI LaunchPad connected with Sensor BoosterPackTI LaunchPad connected with Sensor BoosterPack

TI LaunchPad connected with Sensor BoosterPack

šŸ“˜

The LaunchPad jumpers should be in their original configuration out of the box

If you have already modified the jumper connections, see the LaunchPad's User Guide for the original configuration.

2. Connect the development board to your computer

Use a micro-USB cable to connect the development board to your computer.

3. Update the firmware

The development board does not come with the right firmware yet. To update the firmware:

  1. Download the latest Edge Impulse firmware, and unzip the file.
  2. Open the flash script for your operating system (flash_windows.bat, flash_mac.command or flash_linux.sh) to flash the firmware.
  3. Wait until flashing is complete, and press the RESET button once to launch the new firmware.

šŸš§

Problems flashing firmware onto the LaunchPad?

See the Troubleshooting section for more information.

3. Setting keys

From a command prompt or terminal, run:

edge-impulse-daemon

This will start a wizard which will ask you to log in, and choose an Edge Impulse project. If you want to switch projects run the command with --clean.

šŸš§

Which device do you want to connect to?

The TI LaunchPad enumerates two serial ports. The first is the Application/User UART, which the edge-impulse firmware communicates through. The other is an Auxiliary Data Port, which is unused.

When running the edge-impulse-daemon you will be prompted on which serial port to connect to. On Mac & Linux, this will appear as:

? Which device do you want to connect to? (Use arrow keys)
āÆ /dev/tty.usbmodemL42003QP1 (Texas Instruments)
  /dev/tty.usbmodemL42003QP4 (Texas Instruments)

Generally, select the lower numbered serial port. This usually corresponds with the Application/User UART. On Windows, the serial port may also be verified in the Device Manager

If a selected serial port fails to connect. Test the other port before checking troubleshooting for other common issues.

Alternatively, recent versions of Google Chrome and Microsoft Edge can collect data directly from your development board, without the need for the Edge Impulse CLI. See this blog post for more information.

4. Verifying that the device is connected

That's all! Your device is now connected to Edge Impulse. To verify this, go to your Edge Impulse project, and click Devices. The device will be listed here.

Device connected to Edge ImpulseDevice connected to Edge Impulse

Device connected to Edge Impulse

Next steps: building a machine learning model

With everything set up you can now build your first machine learning model with the Building a continuous motion recognition system tutorial.

You can also test out a pre-loaded model, included with the Edge Impulse firmware, right away! Just close the edge-impulse-daemon and run edge-impulse-run-impulse.

Looking to connect different sensors? The Data forwarder lets you easily send data from any sensor into Edge Impulse, and you can run your impulse locally with custom firmware or sensor data.

Troubleshooting

Failed to flash

If the UniFlash CLI is not added to your PATH, the install scripts will fail. To fix this, add the installation directory of UniFlash (example /Applications/ti/uniflash_6.4.0 on macOS) to your PATH on:

If during flashing you encounter further issues, ensure:

  • The device is properly connected and/or the cable is not damaged.
  • You have the proper permissions to access the USB device and run scripts. On macOS you can manually approve blocked scripts via System Preferences->Security Settings->Unlock Icon
  • If on Linux you may want to try copying tools/71-ti-permissions.rules to /etc/udev/rules.d/. Then re-attach the USB cable and try again.

Alternatively, the gcc/build/edge-impulse-standalone.out binary file may be flashed to the LaunchPad using the UniFlash GUI or web-app. See the Texas Instruments Quick Start Guide for more info.

Updated about a month ago


TI CC1352P LaunchPad


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.