Massive updates to init the project for open source

Author: rayozzie

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "src/note-c"]
+	path = src/note-c
+	url = ../note-c.git

CODE_OF_CONDUCT.md

@@ -0,0 +1,7 @@
+# Code of conduct
+
+By participating in this project, you agree to abide by the
+[Blues Inc code of conduct][1].
+
+[1]: https://blues.github.io/opensource/code-of-conduct
+

CONTRIBUTING.md

@@ -0,0 +1,64 @@
+# Contributing to blues/note-arduino
+
+We love pull requests from everyone. By participating in this project, you
+agree to abide by the Blues Inc [code of conduct].
+
+[code of conduct]: https://blues.github.io/opensource/code-of-conduct
+
+Here are some ways *you* can contribute:
+
+* by using alpha, beta, and prerelease versions
+* by reporting bugs
+* by suggesting new features
+* by writing or editing documentation
+* by writing specifications
+* by writing code ( **no patch is too small** : fix typos, add comments,
+clean up inconsistent whitespace )
+* by refactoring code
+* by closing [issues][]
+* by reviewing patches
+
+[issues]: https://blues.github.com/note-arduino/issues
+
+## Submitting an Issue
+
+* We use the [GitHub issue tracker][issues] to track bugs and features.
+* Before submitting a bug report or feature request, check to make sure it
+  hasn't
+  already been submitted.
+* When submitting a bug report, please include a [Gist][] that includes a stack
+  trace and any details that may be necessary to reproduce the bug, including
+  your release version, stack, and operating system. Ideally, a bug report
+  should include a pull request with failing specs.
+
+[gist]: https://gist.github.com/
+
+## Cleaning up issues
+
+* Issues that have no response from the submitter will be closed after 30 days.
+* Issues will be closed once they're assumed to be fixed or answered. If the
+  maintainer is wrong, it can be opened again.
+* If your issue is closed by mistake, please understand and explain the issue.
+  We will happily reopen the issue.
+
+## Submitting a Pull Request
+1. [Fork][fork] the [official repository][repo].
+2. [Create a topic branch.][branch]
+3. Implement your feature or bug fix.
+4. Add, commit, and push your changes.
+5. [Submit a pull request.][pr]
+
+## Notes
+* Please add tests if you changed code. Contributions without tests won't be
+* accepted. If you don't know how to add tests, please put in a PR and leave a
+* comment asking for help. We love helping!
+
+[repo]: https://github.com/blues/note-arduino/tree/master
+[fork]: https://help.github.com/articles/fork-a-repo/
+[branch]:
+https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/
+[pr]: https://help.github.com/articles/creating-a-pull-request-from-a-fork/
+
+Inspired by
+https://github.com/thoughtbot/factory_bot/blob/master/CONTRIBUTING.md
+

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2019 Blues Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1 @@
+This is a library for the Blues Wireless Notecard. 

README.txt

@@ -0,0 +1,85 @@
+// Copyright 2019 Blues Inc.  All rights reserved.
+// License <here>.
+// (Use Adafruit BMP085 as a good structural example.)
+
+#include <Notecard.h>
+
+// If the Notecard is connected to a Serial port, define it here.  If the Notecard is connected using
+// the I2C interface, leave this commented out.
+//#define serialPort Serial2
+  
+// Tell the Notehub which of its accounts manages this device, and configure how often to upload.
+void setup() {
+
+    // Set up for debug output.  If you open Arduino's serial terminal window, you'll be able to
+    // watch JSON objects being transferred to and from the Notecard for each request.
+    Serial.begin(115200);
+    NoteSetDebugOutputPort(&Serial);
+
+    // Initialize the physical I/O channel to the Notecard
+#ifdef serialPort
+    serialPort.begin(9600);
+    NoteInitSerial(&serialPort);
+#else
+    NoteInitI2C();
+#endif
+
+    // "NoteNewRequest()" uses the bundled "J" json package to allocate a "req", which is a JSON object
+    // for the request to which we will then add Request arguments.
+    J *req = NoteNewRequest("service.set");
+
+    // This argument causes the data to be delivered to the Personal Project in our notehub.io account.
+    JAddStringToObject(req, "product", "YOUR_EMAIL_REGISTERED_WITH_NOTEHUB.IO");
+
+    // This argument causes the modem to power on and connect continuously to the notehub.io service
+    JAddStringToObject(req, "mode", "continuous");
+
+    // Issue the request, telling the Notecard how and how often to access the service.
+    // This results in a JSON message to Notecard formatted like:
+    //     { "req"     : "service.set",
+    //       "product" : "[email protected]",
+    //       "mode"    : "continuous"
+    //     }
+    NoteRequest(req);
+
+}
+  
+// Repeatedly, get some sensor data from the Notecard's own internal sensors, and enqueue 
+// that data as a new Note within a Notefile that will then be synchronized with the service.
+// We can name the JSON fields and the  notefile anything we like.  We add the ".qo" extension
+// to the Notefile name to indicate to the Notecard that this is an "outbound queue" of Notes.
+void loop() {
+    static unsigned messagesSent = 0;
+    double temperature, voltage;
+
+    // Use the temperature sensor on the Notecard to get a sample temperature measurement
+    // This results in a JSON message to Notecard formatted like:
+    //     { "req"     : "card.temp" }
+    NoteGetTemperature(&temperature);
+
+    // Use the voltage ADC on the Notecard to get a sample voltage measurement
+    // This results in a JSON message to Notecard formatted like:
+    //     { "req"     : "card.voltage" }
+    NoteGetVoltage(&voltage);
+
+    // Enqueue the measurement to the Notecard for transmission to the Notehub, indicating that
+    // this is "urgent" so that the data synchronizes immediately rather than being deferred.
+    // This results in a JSON message to Notecard formatted like:
+    //     { "req"  : "note.add",
+    //       "file" : "sensors.qo",
+    //       "body" : { "temperature" : "<temperature value>",
+    //                  "voltage"     : "<voltage value>",
+    //                  "count"       : "<message number>"
+    //                },
+    //       "start" : true
+    //     }
+    J *body = JCreateObject();
+    JAddNumberToObject(body, "temperature", temperature);
+    JAddNumberToObject(body, "voltage", voltage);
+    JAddNumberToObject(body, "count", ++messagesSent);
+    NoteSend("sensors.qo", body, true);
+
+    // Delay between measurements
+    delay(15000);
+
+}