aboutsummaryrefslogtreecommitdiffstats
path: root/lib/README
diff options
context:
space:
mode:
authorFilip Wandzio <contact@philw.dev>2025-09-04 01:11:11 +0200
committerFilip Wandzio <contact@philw.dev>2025-09-04 01:11:11 +0200
commite00f3a9ede1b8e46b480bd68daf48da0bb08acae (patch)
treef666b9aa4d0a03246ab9880e11802d91a23ab1e7 /lib/README
downloade1-e00f3a9ede1b8e46b480bd68daf48da0bb08acae.tar.gz
e1-e00f3a9ede1b8e46b480bd68daf48da0bb08acae.zip
Initial
Diffstat (limited to 'lib/README')
-rw-r--r--lib/README46
1 files changed, 46 insertions, 0 deletions
diff --git a/lib/README b/lib/README
new file mode 100644
index 0000000..9379397
--- /dev/null
+++ b/lib/README
@@ -0,0 +1,46 @@
1
2This directory is intended for project specific (private) libraries.
3PlatformIO will compile them to static libraries and link into the executable file.
4
5The source code of each library should be placed in a separate directory
6("lib/your_library_name/[Code]").
7
8For example, see the structure of the following example libraries `Foo` and `Bar`:
9
10|--lib
11| |
12| |--Bar
13| | |--docs
14| | |--examples
15| | |--src
16| | |- Bar.c
17| | |- Bar.h
18| | |- library.json (optional. for custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html
19| |
20| |--Foo
21| | |- Foo.c
22| | |- Foo.h
23| |
24| |- README --> THIS FILE
25|
26|- platformio.ini
27|--src
28 |- main.c
29
30Example contents of `src/main.c` using Foo and Bar:
31```
32#include <Foo.h>
33#include <Bar.h>
34
35int main (void)
36{
37 ...
38}
39
40```
41
42The PlatformIO Library Dependency Finder will find automatically dependent
43libraries by scanning project source files.
44
45More information about PlatformIO Library Dependency Finder
46- https://docs.platformio.org/page/librarymanager/ldf.html