From 96ba7df9d3838ab487498dc8913c3a262cf00c22 Mon Sep 17 00:00:00 2001 From: Rene Hopf Date: Sun, 24 May 2020 01:38:05 +0200 Subject: [PATCH 01/13] fixed RGB palette name in config template --- lv_conf_template.h | 2 +- src/lv_conf_internal.h | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/lv_conf_template.h b/lv_conf_template.h index 04efb35a4..7b985d5dc 100644 --- a/lv_conf_template.h +++ b/lv_conf_template.h @@ -25,7 +25,7 @@ /* Color depth: * - 1: 1 byte per pixel - * - 8: RGB233 + * - 8: RGB332 * - 16: RGB565 * - 32: ARGB8888 */ diff --git a/src/lv_conf_internal.h b/src/lv_conf_internal.h index 2aa30c6f4..a009dedf8 100644 --- a/src/lv_conf_internal.h +++ b/src/lv_conf_internal.h @@ -40,7 +40,7 @@ /* Color depth: * - 1: 1 byte per pixel - * - 8: RGB233 + * - 8: RGB332 * - 16: RGB565 * - 32: ARGB8888 */ From ab6d69445edfc299aeba4a497803694b3f3b2265 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 05:40:04 +0200 Subject: [PATCH 02/13] Create config.yml --- .github/ISSUE_TEMPLATE/config.yml | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/config.yml diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 000000000..9d8047b48 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: false +contact_links: + - name: CONTIBUTING.md + url: https://github.com/lvgl/lvgl/blob/master/docs/CONTRIBUTING.md#faq-about-contributing + about: The basic rules of contributing + - name: CODING_STYLE.md + url: https://github.com/lvgl/lvgl/blob/master/docs/CODING_STYLE.md + about: Quick summary of LVGL's code style From 38944883b1ecee0cb3df4fe4c113d5f62ca49aad Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 05:44:01 +0200 Subject: [PATCH 03/13] Update config.yml --- .github/ISSUE_TEMPLATE/config.yml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 9d8047b48..ad639848f 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1,5 +1,11 @@ blank_issues_enabled: false contact_links: + - name: Cocumentation + url: https://docs.lvgl.io + about: Be sure to read to documentation first + - name: Forum + url: https://forum.lvgl.io + about: For how-to questions use the forum - name: CONTIBUTING.md url: https://github.com/lvgl/lvgl/blob/master/docs/CONTRIBUTING.md#faq-about-contributing about: The basic rules of contributing From 5ea142eaf0072d89294440c9060bccd1ba47e160 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 05:44:24 +0200 Subject: [PATCH 04/13] Update config.yml --- .github/ISSUE_TEMPLATE/config.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index ad639848f..0ef14eb45 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1,6 +1,6 @@ blank_issues_enabled: false contact_links: - - name: Cocumentation + - name: Documentation url: https://docs.lvgl.io about: Be sure to read to documentation first - name: Forum From 3837988f2d0c2fed9f7c741b08c2fd4b3133f392 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 05:54:38 +0200 Subject: [PATCH 05/13] README: change littlevgl to lvgl --- README.md | 27 +++++++++++++-------------- 1 file changed, 13 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 9c881ea5c..8c8a38b97 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ -

LVGL - Little and Versatile Graphics Library

+

LVGL - and Versatile Graphics Library

- - + +

@@ -26,7 +26,7 @@ LVGL provides everything you need to create embedded GUI with easy-to-use graphi - [Features](#features) - [Supported devices](#supported-devices) - [Quick start in a simulator](#quick-start-in-a-simulator) -- [Add LittlevGL to your project](#add-littlevgl-to-your-project) +- [Add LVGL to your project](#add-lvgl-to-your-project) - [Learn the basics](#learn-the-basics) - [Examples](#examples) - [Contributing](#contributing) @@ -50,7 +50,7 @@ LVGL provides everything you need to create embedded GUI with easy-to-use graphi * **Documentation** and API references ## Supported devices -Basically, every modern controller - which is able to drive a display - is suitable to run LittlevGL. The minimal requirements: +Basically, every modern controller - which is able to drive a display - is suitable to run LVGL. The minimal requirements: - 16, 32 or 64 bit microcontroller or processor - > 16 MHz clock speed is recommended - Flash/ROM: > 64 kB for the very essential components (> 180 kB is recommended) @@ -65,7 +65,7 @@ Basically, every modern controller - which is able to drive a display - is suita *Note that the memory usage might vary depending on the architecture, compiler and build options.* Just to mention some **platforms**: -- STM32F1, STM32F3, [STM32F4](https://blog.lvgl.io/2017-07-15/stm32f429_disco_port), [STM32F7](https://github.com/littlevgl/stm32f746_disco_no_os_sw4stm32) +- STM32F1, STM32F3, [STM32F4](https://blog.lvgl.io/2017-07-15/stm32f429_disco_port), [STM32F7](https://github.com/lvgl/stm32f746_disco_no_os_sw4stm32) - Microchip dsPIC33, PIC24, PIC32MX, PIC32MZ - NXP Kinetis, LPC, iMX - [Linux frame buffer](https://blog.lvgl.io/2018-01-03/linux_fb) (/dev/fb) @@ -75,7 +75,7 @@ Just to mention some **platforms**: - Quectell M66 ## Quick start in a simulator -The easiest way to get started with LittlevGL is to run it in a simulator on your PC without any embedded hardware. +The easiest way to get started with LVGL is to run it in a simulator on your PC without any embedded hardware. Choose a project with your favourite IDE: @@ -85,7 +85,7 @@ Choose a project with your favourite IDE: | Cross-platform
with SDL
(Recommended on
Linux and Mac) | Native Windows | Windows
with SDL | Cross-platform
with SDL | Cross-platform
with SDL | -## Add LittlevGL to your project +## Add LVGL to your project The steps below show how to setup LVGL on an embedded system with a display and a touchpad. You can use the [Simulators](https://docs.lvgl.io/v7/en/html/get-started/pc-simulator) to get ready to use projects which can be run on your PC. @@ -153,12 +153,11 @@ It will redraw the screen if required, handle input devices etc. ## Learn the basics -In this section you can ready the very basics. For a more detailed guide check the [Quick overview] -(https://docs.littlevgl.com/v7/en/html/get-started/quick-overview.html#learn-the-basics) in the documentation. +In this section you can ready the very basics. For a more detailed guide check the [Quick overview](https://docs.lvgl.io/v7/en/html/get-started/quick-overview.html#learn-the-basics) in the documentation. ### Widgets (Objects) -The graphical elements like Buttons, Labels, Sliders, Charts etc are called objects in LittelvGL. Go to [Object types](https://docs.littlevgl.com/v7/en/html/widgets/index) to see the full list of available types. +The graphical elements like Buttons, Labels, Sliders, Charts etc are called objects in LittelvGL. Go to [Object types](https://docs.lvgl.io/v7/en/html/widgets/index) to see the full list of available types. Every object has a parent object. The child object moves with the parent and if you delete the parent the children will be deleted too. Children can be visible only on their parent. @@ -224,7 +223,7 @@ void btn_event_cb(lv_obj_t * btn, lv_event_t event) } ``` -Learn more about the events in the [Event overview](https://docs.littlevgl.com/en/html/overview/event) section. +Learn more about the events in the [Event overview](https://docs.lvgl.io/v7/en/html/overview/event) section. ## Examples @@ -272,10 +271,10 @@ If you are interested in contributing to LVGL you can - **Help others** in the [Forum](https://forum.lvgl.io). - **Inspire people** by speaking about your project in [My project](https://forum.lvgl.io/c/my-projects) category in the Forum. - **Improve and/or translate the documentation.** Go to the [Documentation](https://github.com/lvgl/docs) repository to learn more -- **Write a blog post** about your experiences. See how to do it in the [Blog](https://github.com/littlevgl/blog) repository +- **Write a blog post** about your experiences. See how to do it in the [Blog](https://github.com/lvgl/blog) repository - **Report and/or fix bugs** in [GitHub's issue tracker](https://github.com/lvgl/lvgl/issues) - **Help in the developement**. Check the [Open issues](https://github.com/lvgl/lvgl/issues) especially the ones with [Help wanted](https://github.com/lvgl/lvgl/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) label and tell your ideas about a topic or implement a feature. Before sending Pull requests, please read the following guides: -- [Contributing guide](https://github.com/littlevgl/lvgl/blob/master/docs/CONTRIBUTING.md) +- [Contributing guide](https://github.com/lvgl/lvgl/blob/master/docs/CONTRIBUTING.md) - [Coding style guide](https://github.com/lvgl/lvgl/blob/master/docs/CODING_STYLE.md) From 07efe31ff4e6ed3f4b50bcdfc683e1314c56403b Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 06:23:12 +0200 Subject: [PATCH 06/13] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 71 +++++++++++++++++++++++--------------------- 1 file changed, 37 insertions(+), 34 deletions(-) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index d441d6d16..4a7af7907 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -1,40 +1,49 @@ # Contributing to LVGL **Do you have some free time to spend with programming? -Are you working on an Embedded GUI project with LittlevGL? -See how can you help to improve the graphics library!** +Are you working on an embedded GUI project with LVGL? +See how can you help to improve the graphics library and help others!** -There are many ways to join the community. If you have some time to work with us I'm sure you will find something that fits you! You can: + +- [Overview](#overview) +- [How to send a pull request?](#how-to-send-a-pull-request) +- [Help others in the Forum](help-others-in-the-forum) +- [Improve or translate the documentation](#improve-or-translate-the-documentation) +- [Write a blog post](#write-a-blog-post) +- [Report or fixing bugs](#report-or-fixing-bugs) +- [Suggest or implementing new features](#suggest-or-implementing-new-features) +- [Summary](#summary) + + +## Overview + +There are many ways to join the community. If you have some time to work with us you will surely find something that fits you! You can: - **Help others** in the [Forum](https://forum.lvgl.io). - **Inspire people** by speaking about your project in [My project](https://forum.lvgl.io/c/my-projects) category in the Forum. - **Improve and/or translate the documentation.** Go to the [Documentation](https://github.com/lvgl/docs) repository to learn more -- **Write a blog post** about your experiences. See how to do it in the [Blog](https://github.com/littlevgl/blog) repository +- **Write a blog post** about your experiences. See how to do it in the [Blog](https://github.com/lvgl/blog) repository - **Report and/or fix bugs** in [GitHub's issue tracker](https://github.com/lvgl/lvgl/issues) -- **Help in the developement**. Check the [Open issues](https://github.com/lvgl/lvgl/issues) especially the ones with [Help wanted](https://github.com/lvgl/lvgl/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) label and tell your ideas about a topic or implement a feature. -But first, start with the most Frequently Asked Questions. - -# FAQ about contributing - -## Where can I write my question and remarks? - -We use the [Forum](https://forum.lvgl.io/) to ask and answer questions and [GitHub's issue tracker](https://github.com/lvgl/lvgl/issues) for development-related discussion. +- **Help the development**. Check the [Open issues](https://github.com/lvgl/lvgl/issues) especially the ones with [Help wanted](https://github.com/lvgl/lvgl/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) label and tell your ideas about a topic or implement a feature. We have some simple rules: - Be kind and friendly. - Speak about one thing in one issue/topic. - Give feedback and close the issue or mark the topic as solved if your question is answered. - Tell what you experience or expect. _"The button is not working"_ is not enough info to get help. -- If possible send an absolute minimal code example in order to reproduce the issue - Use [Markdown](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) to format your post. +- We use the [Forum](https://forum.lvgl.io/) to ask and answer questions and [GitHub's issue tracker](https://github.com/lvgl/lvgl/issues) for development-related discussion. +- If possible send an absolute minimal code example in order to reproduce the issue -## How can I send fixes and improvements? -Merging new code happens via Pull Requests. If you are still not familiar with the Pull Requests (PR for short) here is a quick guide: +## How to send a pull request? + +Merging new code into LVGL, documentation, blog, and examples happens via *Pull requests*. If you are still not familiar with Pull Requests (PR for short) here is a short guide. It's about the `lvgl` repository but world the same for other repositories too. 1. **Fork** the [lvgl repository](https://github.com/lvgl/lvgl). To do this click the "Fork" button in the top right corner. It will "copy" the `lvgl` repository to your GitHub account (`https://github.com/your_name?tab=repositories`) 2. **Clone** the forked repository and add your changes 3. **Create a PR** on GitHub from the page of your `lvgl` repository (`https://github.com/your_name/lvgl`) by hitting the "New pull request" button 4. **Set the base branch**. It means where you want to merge your update. Fixes go to `master`, new features to feature branch. 5. **Describe** what is in the update. An example code is welcome if applicable. +6. **Update** your `lvgl` branch with new commits. They will appear in the PR too. Some advice: - For non-trivial fixes and features it's better open an issue first to discuss the details. @@ -43,25 +52,13 @@ Some advice: So it's better to say don't have time to continue than saying nothing. - Please read and follow this [guide about the coding style](https://github.com/lvgl/lvgl/blob/master/docs/CODING_STYLE.md) -If you implemented a new feature it's important to record it in the documentation and if applicable create an example for it: -- Go to the [docs](https://github.com/littlevgl/docs/tree/master/v7/en) repository and update the relevant part of the English documentation. -- Go to the [examples](https://github.com/littlevgl/lv_examples) repository and add a new file about the new feature i nthe related directory. - - -## Where is the documentation? - -You can read the documentation here: -You can edit the documentation here: - -# So how and where can you contribute? - ## Help others in the Forum It's a great way to contribute to the library if you already use it. Just go to [https://forum.lvgl.io/](https://forum.lvgl.io/) a register (Google and GitHub login also works). Log in, read the titles and if you are already familiar with a topic, don't be shy, and write your suggestion. -## Improving and/or translating the documentation +## Improve or translate the documentation If you would like to contribute to LVGL the documentation is the best place to start. @@ -88,9 +85,7 @@ Note that a translation will be added to the documentation only if the following - [Porting section](https://docs.lvgl.io/en/v7/html/porting/index.html) - [Quick overview](https://docs.lvgl.io/v7/en/html/get-started/quick-overview.html) - - -## Writing a blog post about your experiences +## Write a blog post Have you ported LVGL to a new platform? Have you created a fancy GUI? Do you know a great trick? You can share your knowledge on LVGL's blog! It's super easy to add your own post: @@ -101,14 +96,22 @@ You can share your knowledge on LVGL's blog! It's super easy to add your own pos The blog uses [Jekyll](https://jekyllrb.com/) to convert the `.md` files to a webpage. You can easily [run Jekyll offline](https://jekyllrb.com/docs/) to check your post before creating the Pull request -## Reporting and/or fixing bugs -For simple bugfixes (typos, missing error handling, fixing a warning) is fine to send a Pull request directly. However, for more complex bugs it's better to open an issue first. In the issue, you should describe how to reproduce the bug and even add the minimal code snippet. +## Report or fixing bugs +For simple bugfixes (typos, missing error handling, fixing a warning) it's fine to send a Pull request directly. However, for more complex bugs it's better to open an issue first. In the issue, you should describe how to reproduce the bug and add the minimal code snippet. -## Suggesting and/or implementing new features +## Suggest or implementing new features If you have a good idea don't hesitate to share with us. It's even better if you have time to deal with its implementation. Don't be afraid if you still don't know LVGL well enough. We will help you to get started. +To share your ideas use [Feature request](https://forum.lvgl.io/c/feature-request/9) category of the forum. + +If you are ready to get involved into the development of this faetures feel free to pen a [new issue](https://github.com/lvgl/lvgl/issues) for it on GitHub. + During the implementation don't forget the [Code style guide](https://github.com/lvgl/lvgl/blob/master/docs/CODING_STYLE.md). +If you implemented a new feature it's important to record it in the documentation and if applicable create an example for it: +- Go to the [docs](https://github.com/lvgl/docs/tree/master/v7/en) repository and update the relevant part of the English documentation. +- Go to the [examples](https://github.com/lvgl/lv_examples) repository and add a new file about the new feature in the related directory. + # Summary I hope you have taken a liking to contribute to LVGL. A helpful and friendly community is waiting for you! :) From e3f63e09cf67999bb2ddd29da6fce3c17bb983bb Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 06:24:33 +0200 Subject: [PATCH 07/13] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 4a7af7907..4365c8cac 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -37,7 +37,7 @@ We have some simple rules: ## How to send a pull request? -Merging new code into LVGL, documentation, blog, and examples happens via *Pull requests*. If you are still not familiar with Pull Requests (PR for short) here is a short guide. It's about the `lvgl` repository but world the same for other repositories too. +Merging new code into LVGL, documentation, blog, and examples happens via *Pull requests*. If you are still not familiar with Pull Requests (PR for short) here is a short guide. It's about the `lvgl` repository but it works the same way for other repositories too. 1. **Fork** the [lvgl repository](https://github.com/lvgl/lvgl). To do this click the "Fork" button in the top right corner. It will "copy" the `lvgl` repository to your GitHub account (`https://github.com/your_name?tab=repositories`) 2. **Clone** the forked repository and add your changes 3. **Create a PR** on GitHub from the page of your `lvgl` repository (`https://github.com/your_name/lvgl`) by hitting the "New pull request" button From 11c80b626c69a9d989dbe49eca1a854a4de772ad Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 06:26:04 +0200 Subject: [PATCH 08/13] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 4365c8cac..184fe184b 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -10,8 +10,8 @@ See how can you help to improve the graphics library and help others!** - [Help others in the Forum](help-others-in-the-forum) - [Improve or translate the documentation](#improve-or-translate-the-documentation) - [Write a blog post](#write-a-blog-post) -- [Report or fixing bugs](#report-or-fixing-bugs) -- [Suggest or implementing new features](#suggest-or-implementing-new-features) +- [Report or fix bugs](#report-or-fix-bugs) +- [Suggest or implement new features](#suggest-or-implement-new-features) - [Summary](#summary) @@ -87,7 +87,7 @@ Note that a translation will be added to the documentation only if the following ## Write a blog post -Have you ported LVGL to a new platform? Have you created a fancy GUI? Do you know a great trick? +Have you ported LVGL to a new platform or created a fancy GUI? Do you know a great trick? You can share your knowledge on LVGL's blog! It's super easy to add your own post: - Fork and clone the [blog repository](https://github.com/lvgl/blog) - Add your post in Markdown to the `_posts` folder. @@ -96,10 +96,10 @@ You can share your knowledge on LVGL's blog! It's super easy to add your own pos The blog uses [Jekyll](https://jekyllrb.com/) to convert the `.md` files to a webpage. You can easily [run Jekyll offline](https://jekyllrb.com/docs/) to check your post before creating the Pull request -## Report or fixing bugs +## Report or fix bugs For simple bugfixes (typos, missing error handling, fixing a warning) it's fine to send a Pull request directly. However, for more complex bugs it's better to open an issue first. In the issue, you should describe how to reproduce the bug and add the minimal code snippet. -## Suggest or implementing new features +## Suggest or implement new features If you have a good idea don't hesitate to share with us. It's even better if you have time to deal with its implementation. Don't be afraid if you still don't know LVGL well enough. We will help you to get started. To share your ideas use [Feature request](https://forum.lvgl.io/c/feature-request/9) category of the forum. From 2078e4a01a4a59c985d882d740e59d44ac713d8f Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 06:26:30 +0200 Subject: [PATCH 09/13] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 184fe184b..2fdfca350 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -112,6 +112,6 @@ If you implemented a new feature it's important to record it in the documentatio - Go to the [docs](https://github.com/lvgl/docs/tree/master/v7/en) repository and update the relevant part of the English documentation. - Go to the [examples](https://github.com/lvgl/lv_examples) repository and add a new file about the new feature in the related directory. -# Summary +## Summary I hope you have taken a liking to contribute to LVGL. A helpful and friendly community is waiting for you! :) From dfb7c6731c48ed481da99c1e92248b9a80c7ea30 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 06:35:00 +0200 Subject: [PATCH 10/13] Update CODING_STYLE.md --- docs/CODING_STYLE.md | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/docs/CODING_STYLE.md b/docs/CODING_STYLE.md index 31071e94f..1f7b590e9 100644 --- a/docs/CODING_STYLE.md +++ b/docs/CODING_STYLE.md @@ -1,6 +1,7 @@ +# Coding style ## File format -Use [lv_misc/lv_templ.c](https://github.com/littlevgl/lvgl/blob/master/src/lv_misc/lv_templ.c) and [lv_misc/lv_templ.h](https://github.com/littlevgl/lvgl/blob/master/src/lv_misc/lv_templ.h) +Use [lv_misc/lv_templ.c](https://github.com/lvgl/lvgl/blob/master/src/lv_misc/lv_templ.c) and [lv_misc/lv_templ.h](https://github.com/lvgl/lvgl/blob/master/src/lv_misc/lv_templ.h) ## Naming conventions * Words are separated by '_' @@ -15,17 +16,18 @@ Use [lv_misc/lv_templ.c](https://github.com/littlevgl/lvgl/blob/master/src/lv_mi * prefer `typedef struct` and `typedef enum` instead of `struct name` and `enum name` * always end `typedef struct` and `typedef enum` type names with `_t` * Abbreviations: - * Use abbreviations on public names only if they become longer than 32 characters - * Use only very straightforward (e.g. pos: position) or well-established (e.g. pr: press) abbreviations + * Only words longer or equal than 6 characters can be abbreviated. + * Abbreviate only if it makes the word at least half as long + * Use only very straightforward and well-known abbreviations (e.g. pos: position, def: default, btn: button) ## Coding guide * Functions: * Try to write function shorter than is 50 lines - * Always shorter than 100 lines (except very straightforwards) + * Always shorter than 200 lines (except very straightforwards) * Variables: * One line, one declaration (BAD: char x, y;) * Use `` (*uint8_t*, *int32_t* etc) - * Declare variables when needed (not all at function start) + * Declare variables where needed (not all at function start) * Use the smallest required scope * Variables in a file (outside functions) are always *static* * Do not use global variables (use functions to set/get static variables) @@ -84,11 +86,4 @@ void lv_label_set_text(lv_obj_t * label, const char * text) Use 4 spaces indentation instead of tab. -You can use **astyle** to format the code. The required config flies are: `docs/astyle_c` and `docs/astyle_h`. -To format the source files: - `$ find . -type f -name "*.c" | xargs astyle --options=docs/astyle_c` - -To format the header files: - `$ find . -type f -name "*.h" | xargs astyle --options=docs/astyle_h` - -Append `-n` to the end to skip creation of backup file OR use `$ find . -type f -name "*.bak" -delete` (for source file's backups) and `find . -type f -name "*.orig" -delete` (for header file's backups) +You can use **astyle** to format the code. Run `code-formatter.sh` from the `scrips` folder. From b4b37b98aa894211c94b68ac544e3ef30501f854 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 06:41:06 +0200 Subject: [PATCH 11/13] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 8c8a38b97..caaf7b07c 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -

LVGL - and Versatile Graphics Library

+

LVGL - Little and Versatile Graphics Library

From 2e64db0261b593c76f846a9fe5b01048f48ad0cf Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 08:29:57 +0200 Subject: [PATCH 12/13] Update README.md --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index caaf7b07c..299a5ed06 100644 --- a/README.md +++ b/README.md @@ -37,7 +37,7 @@ LVGL provides everything you need to create embedded GUI with easy-to-use graphi * **Advanced graphics** with animations, anti-aliasing, opacity, smooth scrolling * **Simultaneously use various input devices** touchscreen, mouse, keyboard, encoder, buttons, etc. * **Simultaneously use multiple displays** i.e. monochrome and color display -* **Multi-language support** with UTF-8 encoding +* **Multi-language support** with UTF-8 encoding, Bidirectional support, and Arabic text handling * **Fully customizable** graphical elements * **Hardware independent** to use with any microcontroller or display * **Scalable** to operate with little memory (64 kB Flash, 10 kB RAM) @@ -50,14 +50,14 @@ LVGL provides everything you need to create embedded GUI with easy-to-use graphi * **Documentation** and API references ## Supported devices -Basically, every modern controller - which is able to drive a display - is suitable to run LVGL. The minimal requirements: +Basically, every modern controller (which is able to drive a display( is suitable to run LVGL. The minimal requirements are: - 16, 32 or 64 bit microcontroller or processor - > 16 MHz clock speed is recommended - Flash/ROM: > 64 kB for the very essential components (> 180 kB is recommended) - RAM: - - Static RAM usage: ~8..16 kB depending on the used features and objects types - - Stack: > 2kB (> 4 kB is recommended) - - Dynamic data (heap): > 4 KB (> 16 kB is recommended if using several objects). + - Static RAM usage: ~2 kB depending on the used features and objects types + - Stack: > 2kB (> 8 kB is recommended) + - Dynamic data (heap): > 2 KB (> 16 kB is recommended if using several objects). Set by `LV_MEM_SIZE` in *lv_conf.h*. - Display buffer: > *"Horizontal resolution"* pixels (> 10 × *"Horizontal resolution"* is recommended) - C99 or newer compiler From 21a172ca0d0cc13d02f879ef4b037c4f4225f832 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 25 May 2020 09:29:17 +0200 Subject: [PATCH 13/13] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 299a5ed06..5a37ac36f 100644 --- a/README.md +++ b/README.md @@ -60,7 +60,7 @@ Basically, every modern controller (which is able to drive a display( is suitab - Dynamic data (heap): > 2 KB (> 16 kB is recommended if using several objects). Set by `LV_MEM_SIZE` in *lv_conf.h*. - Display buffer: > *"Horizontal resolution"* pixels (> 10 × *"Horizontal resolution"* is recommended) -- C99 or newer compiler +- C99 or newer compiler *Note that the memory usage might vary depending on the architecture, compiler and build options.*