Merge pull request #386 from forGGe/g378_migrate_cs43l22

cs43l22 example migrated to new tcore scripts

Author: forGGe

doc/sphinx/source/examples/stm32f4-discovery-cs43l22.rst

@@ -25,53 +25,65 @@ Wiring
    | GND               | module's GND    |
    +-------------------+-----------------+
 
+Preparing
+~~~~~~~~~
+
+#. Install and initialize theCore (if not done previously)::
+
+      pip3 install tcore
+      # Or if python3-pip is default: pip install tcore
+      tcore bootstrap
+
+
+#. Download the example::
+
+      tcore init --remote https://github.com/theCore-embedded/example_cs43l22_audio
+      cd example_cs43l22_audio
+
 Building
 ~~~~~~~~
 
-#. Complete :ref:`theCore_examples_initial_setup` section.
-#. Execute build commands.
-   The CMake Toolchain file is required to build this application.
-   theCore already has one suitable for this target.
+Run ``compile`` command using theCore CLI::
 
-   ::
-
-     cd examples/cs43l22_audio
-     mkdir build
-     cd build
-     cmake -DCMAKE_TOOLCHAIN_FILE=../../../toolchains/arm-cm4-gnu.cmake ..
-     make
+  tcore compile --target stm32f4_disc
 
 Running
 ~~~~~~~
 
-Firmware will be flashed via ``openocd`` and ``gdb``.
+Firmware will be flashed via ``openocd`` debugger and ``flash`` command.
 
 #. Connect stm32f4 Discovery board to USB cable and connect USB <-> UART converter to the PC.
 
 #. Launch ``minicom`` with device associated with USB <-> UART converter.
    (``/dev/ttyUSB0`` here used as an example)::
 
-     # From new terminal
-     minicom -D /dev/ttyUSB0
+      # From new terminal
+      tcore runenv "minicom -D /dev/ttyUSB0"
+
+   Or the same, but with superuser permissions::
+
+      # From new terminal
+      tcore runenv --sudo "minicom -D /dev/ttyUSB0"
 
 #. Determine stm32f4discovery board revision.
 
    If you don't remember your board revision, check FAQ section
    :ref:`theCore_STM32F4_Discovery_rev`.
 
-#. Launch ``openocd`` and flash image using script from openocd installation.
+#. Launch ``flash`` command in separate terminal, as shown below.
 
    For old STM32F407G-DISC boards, with STLINK/V2:
 
    ::
 
-     sudo $(which openocd) -f board/stm32f4discovery.cfg -c 'init; reset halt; flash write_image erase audio.bin 0x08000000; reset run; exit'
+     tcore flash --sudo
+
 
    For new STM32F407G-DISC1 boards, with STLINK/V2.1:
 
    ::
 
-     sudo $(which openocd) -f board/stm32f429disc1.cfg -c 'init; reset halt; flash write_image erase audio.bin 0x08000000; reset run; exit'
+     tcore flash --sudo --debuger-config stlink-v2.1
 
    See :ref:`theCore_SudoOpenOCD_Nix` section to get insight why ``which openocd``
    is important.
@@ -83,6 +95,8 @@ Firmware will be flashed via ``openocd`` and ``gdb``.
 
 #. Attach headphones to the audio jack on Discovery board.
 
+#. Wear your headphones and enjoy.
+
 Expected output
 ~~~~~~~~~~~~~~~
 

examples/CMakeLists.txt

@@ -44,19 +44,6 @@ ExternalProject_Add(stm32f4_exti
         INSTALL_COMMAND echo "Install isn't required, skipping...")
 
 
-################################################################################
-# Audio stm32 and cs43l22 demo.
-################################################################################
-
-ExternalProject_Add(stm32f4_cs43l22_audio
-        SOURCE_DIR ${CMAKE_CURRENT_LIST_DIR}/cs43l22_audio
-        CMAKE_ARGS
-            -DTHECORE_BUILD_THIRDPARTY_DIR=${THECORE_BUILD_THIRDPARTY_DIR}
-            -DCMAKE_BUILD_TYPE=${CMAKE_BUILD_TYPE}
-            -DCMAKE_TOOLCHAIN_FILE=${ARM_CM4_GNU_TOOLCHAIN}
-        BUILD_ALWAYS 1 # Allows to rebuild external project if its files changes
-        INSTALL_COMMAND echo "Install isn't required, skipping...")
-
 ################################################################################
 # STM32 and HTU21D demo.
 ################################################################################