Merge pull request #6 from MicrochipTech/develop

v1.3.0 Release

LICENSE

@@ -1,80 +1,26 @@
-Software License Agreement
-MPLAB Harmony Integrated Software Framework v1.07.01
+© 2016 Microchip Technology Inc. and its subsidiaries.  You may use this
+software and any derivatives exclusively with Microchip products.
 
-See documents/harmony_license_v1.07.01.pdf
+THIS SOFTWARE IS SUPPLIED BY MICROCHIP "AS IS".  NO WARRANTIES, WHETHER EXPRESS,
+IMPLIED OR STATUTORY, APPLY TO THIS SOFTWARE, INCLUDING ANY IMPLIED WARRANTIES
+OF NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE, OR
+ITS INTERACTION WITH MICROCHIP PRODUCTS, COMBINATION WITH ANY OTHER PRODUCTS, OR
+USE IN ANY APPLICATION.
 
-################################################################################
+IN NO EVENT WILL MICROCHIP BE LIABLE FOR ANY INDIRECT, SPECIAL, PUNITIVE,
+INCIDENTAL OR CONSEQUENTIAL LOSS, DAMAGE, COST OR EXPENSE OF ANY KIND WHATSOEVER
+RELATED TO THE SOFTWARE, HOWEVER CAUSED, EVEN IF MICROCHIP HAS BEEN ADVISED OF
+THE POSSIBILITY OR THE DAMAGES ARE FORESEEABLE.  TO THE FULLEST EXTENT ALLOWED
+BY LAW, MICROCHIP'S TOTAL LIABILITY ON ALL CLAIMS IN ANY WAY RELATED TO THIS
+SOFTWARE WILL NOT EXCEED THE AMOUNT OF FEES, IF ANY, THAT YOU HAVE PAID DIRECTLY
+TO MICROCHIP FOR THIS SOFTWARE.
 
-FreeRTOS V8.2.3 - Copyright (C) 2015 Real Time Engineers Ltd.
-All rights reserved
+MICROCHIP PROVIDES THIS SOFTWARE CONDITIONALLY UPON YOUR ACCEPTANCE OF THESE
+TERMS.
 
-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/ )
+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
@@ -95,28 +41,7 @@ mission critical applications that require provable dependability.
  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.
  *

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

@@ -13,10 +13,10 @@ This document will show you where to find the latest _released_ version of the f
 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.08 for your OS from here: [Harmony](http://www.microchip.com/mplab/mplab-harmony)
+- Download and install Microchip MPLAB<sup>&reg;</sup> Harmony Integrated Software Framework v1.08.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) (3.30 tested)
-- Download and install the v1.40 XC32 compiler for your OS from here (Install both v1.40 and v1.40B - Part Patch): [Microchip MPLAB<sup>&reg;</sup> XC32 Compiler](http://www.microchip.com/xc32) (v1.40 with v1.40B part patch tested)
+[Microchip MPLAB<sup>&reg;</sup> X IDE](http://www.microchip.com/mplabx) (3.35 tested)
+- Download and install the v1.42 XC32 compiler for your OS from here: [Microchip MPLAB<sup>&reg;</sup> XC32 Compiler](http://www.microchip.com/xc32) 
 
 More information about Microchip tools can be found on [Microchip's developer help site](http://microchip.wikidot.com/swtools:start)
 
@@ -34,7 +34,7 @@ Example below is shown on MAC OS X, these instructions may vary slightly on diff
 - 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(MHC)%20and%20MPLAB%20Harmony%20Graphics%20Composer.pdf)
 - Open the MHC by clicking  __Tools -> Embedded -> MPLAB Harmony Configurator__ 
-- The MHC will prompt asking to choose a Harmony framework to use, select "Yes" and select the location of your v1.08 Harmony install and click "OK"
+- The MHC will prompt asking to choose a Harmony framework to use, select "Yes" and select the location of your 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)
 - A settings window will pop up, check only the box "Create a backup...":  ![](images/mhc-generate-code-settings.png)
@@ -56,6 +56,3 @@ If you are having trouble, check to make sure that each of the issues bellow are
 
 #### 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).
-
-#### Project won't compile due to errors such as missing ADCxxx registers
-- v1.40 compiler must be updated with the v1.40B which is the "Part Patch".  This installer will update your v1.40 compiler with the required files to compile for the part on the IoT Ethernet Kit.  Again, this can be downloaded at [Microchip MPLAB<sup>&reg;</sup> XC32 Compiler](http://www.microchip.com/xc32).

documents/iot-ethernet-mplab-ipe.md

@@ -15,7 +15,7 @@ You will need the following Microchip development tools to program the Microchip
 
 - Download the latest HEX file 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> X IDE for your OS from here:
-[Microchip MPLAB<sup>&reg;</sup> X IDE](http://www.microchip.com/mplabx) (3.30 tested)
+[Microchip MPLAB<sup>&reg;</sup> X IDE](http://www.microchip.com/mplabx) (3.35 tested)
 - PICKit<sup>&trade;</sup> 3 In-Circuit Debugger/Programmer (or other programmer)
 
 ---

documents/iot-ethernet-out-of-box-guide.md

@@ -25,42 +25,6 @@ You will need the following Microchip development tools to run out of box demo
 
 > NOTE: If you are a **Microchip Employee** we have a corporate AWS account that must be used.  To setup your AWS IoT device please go to https://setup.iot.microchip.com for more information
 
----
-### Setting Up the AWS Command Line Interface
-#### Linux, Unix, and Windows Installations
-Follow the instructions in the [Getting Set Up with the AWS Command Line Interface](http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) for installations for your operating system.
-
-#### Mac OS X Installation
-This assumes that you have not installed previous version of Python, awscli, or openssl; if you have you will need to uninstall those versions.  You will need to use a version of openssl 1.0.0 or later to connect to AWS IoT services as TLS 1.1 is required.  To do this follow the these steps:
-
-1. Use [Homebrew](http://brew.sh/) to install the latest version of openssl with the following commands in a terminal window.  You will need to force the links so that Python will use the right version of openssl.
-
-  ```
-  brew update
-  brew install openssl
-  brew link --force openssl
-  ```
-- Reinstall Python to use the latest openssl:
-
-  ```
-  brew install python --with-brewed-openssl
-  ```
-- To verify that python was updated run the following command and make sure the version os greater than 1.0.2d
-
-  ```
-  python -c 'import ssl; print ssl.OPENSSL_VERSION'
-  ```
-- Install/upgrade the AWS CLI:
-
-  ```
-  pip install --upgrade awscli
-  ```
-- To verify the version of the AWS CLI tool installed run the following command and look for version 1.10.x or greater:
-
-  ```
-  aws --version
-  ```
-
 ---
 ### Setting Up the AWS IoT Service