https://github.com/robotdad/freertos_generic
Conversion of freertos_generic NXP sample using LPC55S69 as base
https://github.com/robotdad/freertos_generic
Last synced: 4 months ago
JSON representation
Conversion of freertos_generic NXP sample using LPC55S69 as base
- Host: GitHub
- URL: https://github.com/robotdad/freertos_generic
- Owner: robotdad
- Created: 2022-09-11T19:02:40.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-09-21T14:22:17.000Z (over 3 years ago)
- Last Synced: 2025-06-04T13:29:46.886Z (about 1 year ago)
- Language: C
- Size: 1.8 MB
- Stars: 1
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# freertos_generic NXP LPC55S69 sample
This project was started from the [LPC55S69_CMake_Template](https://github.com/robotdad/LPC55S69_CMake_Template). The sources from the NXP sample for freertos_generic were then adapted to this format. Minimal dependencies from the SDK are included.
By using the CMakeTemplate the project has a base for working with CMakePresets, vcpkg for toolchain acquisition, and enables VS and VS Code usage. Changes from the template were to remove the unused example source, then update launch and ci files that use the output name. The CMakeLists.txt is adapted from the template and sample starting points. The Arm gcc toolchain from the template is used rather than from the SDK, they do not appear functionally different.
A devcontainer has also been configured, but it has only been validated to run builds so far.
## vcpkg
Install vcpkg for your platform.
Run vcpkg activate in the root directory to acquire depenencies and have them configured for use in your shell.
## CMake
To build the project from a vcpkg activated shell run CMake configure for the desired preset, then build.
```
cmake --preset m33-debug
cmake --build --preset m33-debug
```
## Visual Studio
When using as a base for another project see .vs/launch.vs.json and update the debug target to your project name.
Embedded support was added in Visual Studio 2022. To use just open the folder in Visual Studio.
From VS2022 17.4 vcpkg activation will occur automatically, so long as it has been installed.
## Visual Studio Code
When using as a base for another project see .vscode/launch.json and flash.jlink and update the debug target to your project name.
Install the Embedded Tools extension. Run vcpkg activation and launch code from the root of your project, the dependencies will then be available in the VS Code context.
## CLion
See [CLion Embedded Development](https://www.jetbrains.com/help/clion/embedded-overview.html) for how to configure your toolchains and debugger. You should be able to use vcpkg activated toolchains with CLion through the standard configuration.
## Eclipse
See [creating CMake projects for use with Eclipse](https://mcuoneclipse.com/2022/09/04/tutorial-creating-bare-bare-embedded-projects-with-cmake-with-eclipse-included/).
## Containers
Run the below commands from the root of your project. The dockerfile is configured with a base development layer and build layer. The base layer sets up prerequisites using vcpkg and the project manifest. The build layer pulls in all sources and runs the build using CMake. Usage suggestions follow.
### Images
Name the interactive dev image for the target.
The idea here is that the artifacts are common across many, so you can spin up new containers from this image for different apps.
```
docker build --target dev -t arm-dev-image -f .\.devcontainer\Dockerfile .
```
Name the build image for the app being built.
```
docker build --target build -t app-build-image -f .\.devcontainer\Dockerfile .
```
### Containers
Name the container for easy use in subsequent actions, like extracting the build artifacts.
```
docker run --name app-build-container app-build-image
```
Get you binary out of your build container
```
docker cp app-build-container:/src/build/m33-debug/freertos_generic.elf .
```
Don't name the container to easily spin it up multiple times, easily discard them all later with ```docker container prune``` (deletes all containers not running).
```
docker run -it arm-dev-image
```
If you want to interactively see what is happening in your build image
```
docker container run -it app-build-image
```