aboutsummaryrefslogtreecommitdiffstats
path: root/Test/README.md
diff options
context:
space:
mode:
authorRossTheRoss <msattr@gmail.com>2019-02-22 15:19:14 +0000
committerRossTheRoss <msattr@gmail.com>2019-02-22 15:19:14 +0000
commit9ad6bbd3ac975f926755566d3224ade95361a875 (patch)
tree39357990baf2b1f11a27fb86aa416838bb56e2f3 /Test/README.md
parentE (diff)
parentRearrange (diff)
downloadhomework-9ad6bbd3ac975f926755566d3224ade95361a875.tar
homework-9ad6bbd3ac975f926755566d3224ade95361a875.tar.gz
homework-9ad6bbd3ac975f926755566d3224ade95361a875.tar.bz2
homework-9ad6bbd3ac975f926755566d3224ade95361a875.tar.lz
homework-9ad6bbd3ac975f926755566d3224ade95361a875.tar.xz
homework-9ad6bbd3ac975f926755566d3224ade95361a875.tar.zst
homework-9ad6bbd3ac975f926755566d3224ade95361a875.zip
Merge branch 'master' of github.com:RosstheRoss/TestingFun
Forgetting to commit is hard
Diffstat (limited to '')
-rw-r--r--Test/README.md35
1 files changed, 35 insertions, 0 deletions
diff --git a/Test/README.md b/Test/README.md
new file mode 100644
index 0000000..025960f
--- /dev/null
+++ b/Test/README.md
@@ -0,0 +1,35 @@
+# Test
+
+A Particle project named Test
+
+## Welcome to your project!
+
+Every new Particle project is composed of 3 important elements that you'll see have been created in your project directory for Test.
+
+#### ```/src``` folder:
+This is the source folder that contains the firmware files for your project. It should *not* be renamed.
+Anything that is in this folder when you compile your project will be sent to our compile service and compiled into a firmware binary for the Particle device that you have targeted.
+
+If your application contains multiple files, they should all be included in the `src` folder. If your firmware depends on Particle libraries, those dependencies are specified in the `project.properties` file referenced below.
+
+#### ```.ino``` file:
+This file is the firmware that will run as the primary application on your Particle device. It contains a `setup()` and `loop()` function, and can be written in Wiring or C/C++. For more information about using the Particle firmware API to create firmware for your Particle device, refer to the [Firmware Reference](https://docs.particle.io/reference/firmware/) section of the Particle documentation.
+
+#### ```project.properties``` file:
+This is the file that specifies the name and version number of the libraries that your project depends on. Dependencies are added automatically to your `project.properties` file when you add a library to a project using the `particle library add` command in the CLI or add a library in the Desktop IDE.
+
+## Adding additional files to your project
+
+#### Projects with multiple sources
+If you would like add additional files to your application, they should be added to the `/src` folder. All files in the `/src` folder will be sent to the Particle Cloud to produce a compiled binary.
+
+#### Projects with external libraries
+If your project includes a library that has not been registered in the Particle libraries system, you should create a new folder named `/lib/<libraryname>/src` under `/<project dir>` and add the `.h`, `.cpp` & `library.properties` files for your library there. Read the [Firmware Libraries guide](https://docs.particle.io/guide/tools-and-features/libraries/) for more details on how to develop libraries. Note that all contents of the `/lib` folder and subfolders will also be sent to the Cloud for compilation.
+
+## Compiling your project
+
+When you're ready to compile your project, make sure you have the correct Particle device target selected and run `particle compile <platform>` in the CLI or click the Compile button in the Desktop IDE. The following files in your project folder will be sent to the compile service:
+
+- Everything in the `/src` folder, including your `.ino` application file
+- The `project.properties` file for your project
+- Any libraries stored under `lib/<libraryname>/src`