Welcome to FRDM-IMX93 for NXP CUP!

About this project

Through a series of guides and various pieces of documentation, this project aims to help the students participating in the NXP CUP contest get started with the development on the FRDM-IMX93 board.

The software provided in this project is meant to be run as an application in the context of the Zephyr RTOS, which is why you’ll notice the usage of tools such as west, ninja, and cmake.

Getting started guides

Check out the following guides to help you prepare your development environment:

• ✅ Getting acquainted with the FRDM-IMX93 board

• ✅ Preparing the development environment (Linux)

• ✅ Preparing the development environment (Windows)

• ✅ Booting the FRDM-IMX93 board

• ✅ Writing your own application

Tutorials

Check out the following tutorials to help you with the software development:

• 📘 Command cheatsheet

• 📘 Configuring your application

• 📘 Devicetree basics

• 📘 Zephyr FRDM-IMX93 devicetree files

• 📘 The Zephyr device driver model

• 📘 Zephyr devicetree bindings

• 📘 i.MX93 pin control

Connecting the kit compontents

Ready to connect the kit components? Check out the following guides:

• 🔧 Connecting the Pixy2 camera

• 🔧 Connecting the MG996R servo motor

• 🔧 Connecting the L298N H-BRIDGE motor

• 🔧 Connecting the battery

Supported samples

Want to test out a certain functionality/hardware module? Check out this list of supported samples:

Sample name	Hardware
hello_world	N/A
servo	MG996R servo motor
hbridge	L298N H-BRIDGE
pixy2	Pixy2 camera

Is your hardware module not listed here? That’s fine! You can use one of the supported modules as a starting point and add support for your own.

Sample API documentation

Check out the main documentation page for the various APIs used throughout the samples.

Issues and contributions

Since this is an open-source project, all kinds of contributions are encouraged and highly appreciated. Your contribution will help improve the infrastructure and guides for future editions of the contest.

If you encounter a bug or an issue, please make sure you file a report under the Issues tab of our GitHub repository. Additionally, we encourage students to try and fix the issues/bugs themselves by submitting a pull request.

Contributing to the Zephyr project is also highly encouraged. To do so, please make sure you follow the Contributing to Zephyr guide. We recommend checking out the aforementioned guide before contributing to this project as well.