mirrors/mch2022-template-app
1
0
Fork 1
mirror of https://github.com/badgeteam/mch2022-template-app.git synced 2024-11-22 00:31:00 +00:00
Code Issues Projects Releases Wiki Activity
A simple helloworld app to build other apps on.
219 commits 4 branches 0 tags 5 MiB
C 72.9%
Makefile 10.5%
CMake 9.4%
Shell 7.2%
Find a file
Sylvain Lefebvre 3938b4bd0c getting started url fix
2022-07-16 19:10:48 +02:00
components Update submodules, change licene of source code in main folder to public domain / cc0 and update readme with the changes made by a2800276 2022-07-11 22:33:51 +02:00
esp-idf@1329b19fe4 Update idf, config, bsp 2022-06-29 22:02:21 +02:00
main edited comments in main.c 2022-07-12 07:54:17 +02:00
tools@a932756f91 Update tools submodule 2022-07-11 22:41:34 +02:00
.gitignore Add .vscode to .gitignore 2022-05-09 12:23:55 +02:00
.gitmodules Import tools module. 2022-06-29 22:20:39 +02:00
CMakeLists.txt Use PROJECT_VER variable for version, display version on main menu 2022-06-03 07:17:22 +02:00
Makefile make s default task prepares. README desc make tagets 2022-07-12 20:02:05 +02:00
partitions.csv Fix partition table. 2022-06-28 10:34:49 +02:00
README.md getting started url fix 2022-07-16 19:10:48 +02:00
sdkconfig Clean up sdkconfig 2022-06-29 22:14:13 +02:00
update_components.sh updated components, modified Makefile to not always run idf-install; just run prepare once. 2022-07-12 07:53:30 +02:00

README.md

MCH2022 template app

This repository contains a template app for the MCH2022 badge. It is intended to be used as the basis for developing your own native ESP32 apps. See Getting Started

License

The source code contained in the main folder of this example is public domain / CC0 licensed, use it as you please.

Source code included as submodules is licensed separately, please check the following table for details.

Submodule License Author
esp-idf Apache License 2.0 Espressif Systems (Shanghai) CO LTD
components/appfs THE BEER-WARE LICENSE Revision 42 Jeroen Domburg jeroen@spritesmods.com
components/bus-i2c MIT Nicolai Electronics
components/i2c-bno055 MIT Nicolai Electronics
components/mch2022-rp2040 MIT Renze Nicolai
components/pax-graphics MIT Julian Scheffers
components/pax-keyboard MIT Julian Scheffers
components/sdcard MIT Nicolai Electronics
components/spi-ice40 MIT Nicolai Electronics
components/spi-ili9341 MIT Nicolai Electronics
components/ws2812 Unlicense / Public domain None

Source the update_components.sh to update all the submodules to their corresponding tips.

How to make

git clone --recursive https://github.com/badgeteam/mch2022-template-app
cd mch2022-template-app
make

The default target of the Makefile (the one executed if you just run make) installs the proper ESP-IDF version and all other dependencies, then builds the project and tries to install it on an attached Badge. Because this process checks all the dependencies for updates, this can become tedious during development, so you'll probably want to execute specific targets:

  • prepare : this is (one of) the targets executed in the default task and the one that, technically, only needs to run once to install dependencies
  • clean : clean the build environment. This does NOT clean up installed dependencies.
  • build : well ... build. Compiles you sources and assembles a binary to install.
  • install : This install the binary that was build, you can only call install, it depends on build. Note installation is not and SHOULD NOT be performed with the typical idf.py flash call, see the note below for details.
  • monitor : start the serial monitor to examine log output
  • menuconfig : The IDF build system has a fairly elaborate configuration system that can be accessed via menuconfig. You'll know if you need it. Or try it out to explore.

Note: Why not to use idf.py flash to install my native app.

If you have previously used the IDF, you may have noticed that we don’t use idf.py flash to install the app on the Badge. (And if you haven’t, you can safely skip this section. :)

The idf.py flash command assumes that the binary to flash is the main (and only) application for the device. This is not the case for the Badge, though. The main application is the launcher app, i.e. the app with the menu that starts by default. The make install target of the Makefile copies our newly created app into the [appfs](https://github.com/badgeteam/esp32-component-appfThe Makefile cs) instead of overwriting the launcher. Once copied to the appfs, the launcher can find your app and it should appear in the apps menu.

Obviously you can use idf.py flash but you’ll delete the launcher app and would need to reinstall it later.