From 5bca4b1d6d5b176fcb25ba8dfbe98a4e8ab2d13c Mon Sep 17 00:00:00 2001 From: Krzysztof Strehlau Date: Thu, 13 Jun 2024 07:45:26 +0200 Subject: [PATCH 1/3] Update readme.md --- examples/readme.md | 68 +++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 67 insertions(+), 1 deletion(-) diff --git a/examples/readme.md b/examples/readme.md index 07f1765..7c17106 100644 --- a/examples/readme.md +++ b/examples/readme.md @@ -1,5 +1,71 @@ # Examples -This is a directory that contains aplplication examples. +In this directory, you will find examples that guide you through building various firmware applications. + +**Before you start, read this page to ensure you are familiar with PlatformIO and have the correct IDE setup.** + +## IDE Preparation + +**When using PlatformIO, no additional setup is required, and you don't need to install the Arduino IDE separately. This library can be used with the Arduino IDE, though it may be suboptimal.** + +- [Download and install official Microsoft Visual Studio Code](https://code.visualstudio.com/). PlatformIO IDE is built on top of it. +- Open the extension manager. +- Search for the official `platformio ide` extension. +- Install PlatformIO IDE extension. + +![image](https://github.com/cziter15/ksIotFrameworkLib/assets/5003708/18dfb3a2-866c-4308-a197-5a90bbb13b90) + +## Opening existing projects +- If properly configured, the project should contain a `platformio.ini` file in its main directory. +- To open a project, use the `Open Folder` option from the File menu. +- Dependencies will be automatically installed, which may take some time. + +## Creating your first application +1. Open PlatformIO UI. +2. Click on `New project`, and select your ESP version. Then click `Finish`. + +![image](https://github.com/cziter15/ksIotFrameworkLib/assets/5003708/494565fa-4753-446c-a18e-c903626637a3) + +3. Open the `platformio.ini` file: + +![image](https://github.com/cziter15/ksIotFrameworkLib/assets/5003708/1d882165-c64f-40a6-addb-36141837c5dc) + +4. Add the following code and save the file: +```ini +# Define library dependencies. +lib_deps = + ksIotFrameworkLib=https://github.com/cziter15/ksIotFrameworkLib +``` +5. Platformio will download required dependencies. Please be patient as it may take some time. +6. Now open `main.cpp` file and replace the code with the following listing and save the file. +```cpp +#include + +class MyApplication : public ksf::ksApplication +{ + public: + bool init() override + { + return true; + } + bool loop() override + { + return true; + } +}; + +KSF_IMPLEMENT_APP_ROTATOR +( + MyApplication +) +``` + +7. Now you are able to build the application stub. + +![image](https://github.com/cziter15/ksIotFrameworkLib/assets/5003708/afac0511-cf68-4007-ba89-b2902cabca6c) + +8. Now all that's left to do is implement the components and logic of your device. + +# Examples # [basic-config](basic-config) This application demonstrates how create most typical application stack. One ksApplication is responsible for device logic and the another is the application that is used to configure the device. From 3f79157d51c67c0592d82f9983be695a76665ea8 Mon Sep 17 00:00:00 2001 From: Krzysztof Strehlau Date: Thu, 13 Jun 2024 07:45:35 +0200 Subject: [PATCH 2/3] Delete tutorials/readme.md --- tutorials/readme.md | 66 --------------------------------------------- 1 file changed, 66 deletions(-) delete mode 100644 tutorials/readme.md diff --git a/tutorials/readme.md b/tutorials/readme.md deleted file mode 100644 index d975a87..0000000 --- a/tutorials/readme.md +++ /dev/null @@ -1,66 +0,0 @@ -# Tutorials -In this directory, you will find step-by-step tutorials that guide you through building various firmware applications. - -**Before you start, read this page to ensure you are familiar with PlatformIO and have the correct IDE setup.** - -## IDE Preparation - -**When using PlatformIO, no additional setup is required, and you don't need to install the Arduino IDE separately. This library can be used with the Arduino IDE, though it may be suboptimal.** - -- [Download and install official Microsoft Visual Studio Code](https://code.visualstudio.com/). PlatformIO IDE is built on top of it. -- Open the extension manager. -- Search for the official `platformio ide` extension. -- Install PlatformIO IDE extension. - -![image](https://github.com/cziter15/ksIotFrameworkLib/assets/5003708/18dfb3a2-866c-4308-a197-5a90bbb13b90) - -## Opening existing projects -- If properly configured, the project should contain a `platformio.ini` file in its main directory. -- To open a project, use the `Open Folder` option from the File menu. -- Dependencies will be automatically installed, which may take some time. - -## Creating your first application -1. Open PlatformIO UI. -2. Click on `New project`, and select your ESP version. Then click `Finish`. - -![image](https://github.com/cziter15/ksIotFrameworkLib/assets/5003708/494565fa-4753-446c-a18e-c903626637a3) - -3. Open the `platformio.ini` file: - -![image](https://github.com/cziter15/ksIotFrameworkLib/assets/5003708/1d882165-c64f-40a6-addb-36141837c5dc) - -4. Add the following code and save the file: -```ini -# Define library dependencies. -lib_deps = - ksIotFrameworkLib=https://github.com/cziter15/ksIotFrameworkLib -``` -5. Platformio will download required dependencies. Please be patient as it may take some time. -6. Now open `main.cpp` file and replace the code with the following listing and save the file. -```cpp -#include - -class MyApplication : public ksf::ksApplication -{ - public: - bool init() override - { - return true; - } - bool loop() override - { - return true; - } -}; - -KSF_IMPLEMENT_APP_ROTATOR -( - MyApplication -) -``` - -7. Now you are able to build the application stub. - -![image](https://github.com/cziter15/ksIotFrameworkLib/assets/5003708/afac0511-cf68-4007-ba89-b2902cabca6c) - -8. Now all that's left to do is implement the components and logic of your device. From 06c273fa809aafb2e1f7fee714cba7673b858703 Mon Sep 17 00:00:00 2001 From: Krzysztof Strehlau Date: Thu, 13 Jun 2024 07:47:59 +0200 Subject: [PATCH 3/3] Update Doxyfile --- Doxyfile | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Doxyfile b/Doxyfile index 276dc4d..11e9aa0 100644 --- a/Doxyfile +++ b/Doxyfile @@ -900,7 +900,8 @@ EXCLUDE_SYMLINKS = NO # Note that the wildcards are matched against the file with absolute path, so to # exclude all test directories for example use the pattern */test/* -EXCLUDE_PATTERNS = +EXCLUDE_PATTERNS = */.github/* +EXCLUDE_PATTERNS += */examples/* # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names # (namespaces, classes, functions, etc.) that should be excluded from the