Initial Commit

.gitignore

@@ -0,0 +1,16 @@
+#### SOFTWARE SECTION ####
+# MPLab files
+software/**/*.X/build
+software/**/*.X/debug
+software/**/*.X/dist
+software/**/*.X/*.log
+software/**/*.X/funclist
+software/**/*.X/*.obj
+software/**/*.X/nbproject/*.properties
+software/**/*.X/nbproject/*.mk
+software/**/*.X/nbproject/*.bash
+software/**/*.X/nbproject/private
+
+#### HARDWARE SECTION ####
+
+#### DOCUMENTS SECTION ####

LICENSE

@@ -0,0 +1,138 @@
+Software License Agreement
+MPLAB Harmony Integrated Software Framework v1.07.01
+
+See documents/harmony_license_v1.07.01.pdf
+
+################################################################################
+
+FreeRTOS V8.2.3 - Copyright (C) 2015 Real Time Engineers Ltd.
+All rights reserved
+
+VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+This file is part of the FreeRTOS distribution.
+
+FreeRTOS is free software; you can redistribute it and/or modify it under
+the terms of the GNU General Public License (version 2) as published by the
+Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+***************************************************************************
+>>!   NOTE: The modification to the GPL is included to allow you to     !<<
+>>!   distribute a combined work that includes FreeRTOS without being   !<<
+>>!   obliged to provide the source code for proprietary components     !<<
+>>!   outside of the FreeRTOS kernel.                                   !<<
+***************************************************************************
+
+FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+link: http://www.freertos.org/a00114.html
+
+***************************************************************************
+ *                                                                       *
+ *    FreeRTOS provides completely free yet professionally developed,    *
+ *    robust, strictly quality controlled, supported, and cross          *
+ *    platform software that is more than just the market leader, it     *
+ *    is the industry's de facto standard.                               *
+ *                                                                       *
+ *    Help yourself get started quickly while simultaneously helping     *
+ *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+ *    tutorial book, reference manual, or both:                          *
+ *    http://www.FreeRTOS.org/Documentation                              *
+ *                                                                       *
+***************************************************************************
+
+http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+the FAQ page "My application does not run, what could be wrong?".  Have you
+defined configASSERT()?
+
+http://www.FreeRTOS.org/support - In return for receiving this top quality
+embedded software for free we request you assist our global community by
+participating in the support forum.
+
+http://www.FreeRTOS.org/training - Investing in training allows your team to
+be as productive as possible as early as possible.  Now you can receive
+FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+Ltd, and the world's leading authority on the world's leading RTOS.
+
+http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+licenses offer ticketed support, indemnification and commercial middleware.
+
+http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+engineered and independently SIL3 certified version for use in safety and
+mission critical applications that require provable dependability.
+
+1 tab == 4 spaces!
+
+################################################################################
+
+ Parson ( http://kgabis.github.com/parson/ )
+ Copyright (c) 2012 - 2015 Krzysztof Gabis
+
+ 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.
+
+ ################################################################################
+
+  * Copyright (C) 2006-2015 wolfSSL Inc.
+ *
+ * This file is part of wolfSSL. (formerly known as CyaSSL)
+ *
+ * wolfSSL is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * wolfSSL is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+ ################################################################################
+
+  * Copyright (C) 2006-2016 wolfSSL Inc.
+ *
+ * This file is part of wolfMQTT.
+ *
+ * wolfMQTT is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * wolfMQTT is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335, USA
+ */

README.md

@@ -1,3 +1,14 @@
-### Firmware for the PIC32MZ based IoT demos
+### AWS IoT Firmware for PIC32MZ Based Demos
 
-This firmware will be released by June 2016.
+---
+### Introduction
+[AWS IoT](http://aws.amazon.com/iot/) is a service that will allow internet of things (IoT) devices to be easily and securely connected to Amazon Web Services (AWS).
+
+---
+### Out of Box Guides
+Select the demo that you are using below to go to the out of box guide:
+- [IoT Ethernet Out of Box Guide](documents/iot-ethernet-out-of-box-guide.md)
+
+---
+
+For more information on Microchip's IoT Demos, please visit [Microchip's IoT Page](http://www.microchip.com/iot)

documents/iot-ethernet-firmware-compile-and-program.md

@@ -0,0 +1,52 @@
+### IoT Ethernet Firmware
+#### Compile and Programing
+
+---
+
+### Introduction
+This document will show you where to find the latest _released_ version of the firmware source, how to compile it, and then program it into the IoT Ethernet Kit
+
+---
+
+### Required Tools and Applications
+#### Microchip Required Tools and Applications
+You will need the following Microchip development tools to program and develop with the Microchip IoT Ethernet.
+
+- Download the latest project for IoT Ethernet from here: [IoT Ethernet Project](https://github.com/MicrochipTech/aws-iot-firmware-pic32mz/releases/latest)
+- Download and install Microchip MPLAB<sup>&reg;</sup> Harmony Integrated Software Framework v1.07.01 for your OS from here: [Harmony](http://www.microchip.com/mplab/mplab-harmony)
+- Download and install Microchip MPLAB<sup>&reg;</sup> X IDE for your OS from here:
+[Microchip MPLAB<sup>&reg;</sup> X IDE](http://www.microchip.com/mplabx)
+- Download and install the latest XC32 compiler for your OS from here: [Microchip MPLAB<sup>&reg;</sup> XC32 Compiler](http://www.microchip.com/xc32)
+
+---
+
+### Compiling and programming the IoT Ethernet Board
+
+#### Compiling the Firmware
+1. Extract the zip file downloaded from the git repository to a location of your choice
+- Open MPLAB<sup>&reg;</sup> X IDE
+- Select __File -> Open Project__
+- Navigate to: `  <path-to-your-project>/aws-iot-firmware-pic32mz/software/aws-iot-ethernet/firmware`
+- Select the project __aws-iot-ethernet.X__
+- With your project opened, right click on the project __aws-iot-ethernet__ in the Projects tab and select  __Set as Main Project__
+- Follow these directions to install the Microchip Harmony Configurator (MHC):  [Steps to Install MHC](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLAB%20Harmony%20Configurator%20%28MHC%29%20and%20MPLAB%20Harmony%20Graphics%20Composer%20%28v1.07.01%29.pdf)
+- Open the MHC; The MHC will prompt asking to choose a Harmony framework to use, select "Yes" and select the location of your v1.07.01 Harmony install and click "OK"
+- The MHC will then ask if you want to open the configuration file __IoT-Ethernet.mhc__ for the __aws-iot-ethernet__ project, select "Open" to proceed.
+- With the new Harmony framework selected for your project, you will need to regenerate code by clicking the generate code button. ![](images/generateCode.png)
+- The MHC merge tool will show differences between code sets.  Ignore the differences and hit "Close" for each file
+
+#### Programing the IoT Ethernet Board
+1. Connect the PICKit&trade; 3 to your computer using the provided USB cable.
+- Connect the PICKit&trade; 3 to the IoT Ethernet ICSP 6-pin header.  The pins should match by aligning the triangles.
+- Power on the starter kit by connecting a Micro-USB cable to a power source and changing the power switch on the board to USB.
+- On the top tab of MPLAB&reg; X, click the __Make and Program Device Main Project__ button.  ![](images/program_icon.png)
+
+  >MPLAB&reg; X may prompt you to select with programmer to use.  Select PICKit&trade; 3 from the prompt and continue.
+
+---
+
+### Troubleshooting
+If you are having trouble, check to make sure that each of the issues bellow are resolved.
+
+#### Project won't compile due to missing files
+- Often times a project won't compile if you are on a Windows machine due to a limitation in the path length.  Windows OS has a max path length of 260 characters, so file paths are sometimes truncated when attempting to compile which leads to files not being found by the compiler.  Try putting the project in the topmost directory, usually "C:/".  For more information please see [MSDN article from Microsoft](https://msdn.microsoft.com/en-us/library/aa365247%28VS.85%29.aspx#maxpath).