Skip to content

Commit 12fa201

Browse files
author
Stephen Porter
committed
Initial Commit
1 parent 37bb8c9 commit 12fa201

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

76 files changed

+20049
-2
lines changed

‎.gitignore

+16
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
#### SOFTWARE SECTION ####
2+
# MPLab files
3+
software/**/*.X/build
4+
software/**/*.X/debug
5+
software/**/*.X/dist
6+
software/**/*.X/*.log
7+
software/**/*.X/funclist
8+
software/**/*.X/*.obj
9+
software/**/*.X/nbproject/*.properties
10+
software/**/*.X/nbproject/*.mk
11+
software/**/*.X/nbproject/*.bash
12+
software/**/*.X/nbproject/private
13+
14+
#### HARDWARE SECTION ####
15+
16+
#### DOCUMENTS SECTION ####

‎LICENSE

+138
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,138 @@
1+
Software License Agreement
2+
MPLAB Harmony Integrated Software Framework v1.07.01
3+
4+
See documents/harmony_license_v1.07.01.pdf
5+
6+
################################################################################
7+
8+
FreeRTOS V8.2.3 - Copyright (C) 2015 Real Time Engineers Ltd.
9+
All rights reserved
10+
11+
VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
12+
13+
This file is part of the FreeRTOS distribution.
14+
15+
FreeRTOS is free software; you can redistribute it and/or modify it under
16+
the terms of the GNU General Public License (version 2) as published by the
17+
Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
18+
19+
***************************************************************************
20+
>>! NOTE: The modification to the GPL is included to allow you to !<<
21+
>>! distribute a combined work that includes FreeRTOS without being !<<
22+
>>! obliged to provide the source code for proprietary components !<<
23+
>>! outside of the FreeRTOS kernel. !<<
24+
***************************************************************************
25+
26+
FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
27+
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
28+
FOR A PARTICULAR PURPOSE. Full license text is available on the following
29+
link: http://www.freertos.org/a00114.html
30+
31+
***************************************************************************
32+
* *
33+
* FreeRTOS provides completely free yet professionally developed, *
34+
* robust, strictly quality controlled, supported, and cross *
35+
* platform software that is more than just the market leader, it *
36+
* is the industry's de facto standard. *
37+
* *
38+
* Help yourself get started quickly while simultaneously helping *
39+
* to support the FreeRTOS project by purchasing a FreeRTOS *
40+
* tutorial book, reference manual, or both: *
41+
* http://www.FreeRTOS.org/Documentation *
42+
* *
43+
***************************************************************************
44+
45+
http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading
46+
the FAQ page "My application does not run, what could be wrong?". Have you
47+
defined configASSERT()?
48+
49+
http://www.FreeRTOS.org/support - In return for receiving this top quality
50+
embedded software for free we request you assist our global community by
51+
participating in the support forum.
52+
53+
http://www.FreeRTOS.org/training - Investing in training allows your team to
54+
be as productive as possible as early as possible. Now you can receive
55+
FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
56+
Ltd, and the world's leading authority on the world's leading RTOS.
57+
58+
http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
59+
including FreeRTOS+Trace - an indispensable productivity tool, a DOS
60+
compatible FAT file system, and our tiny thread aware UDP/IP stack.
61+
62+
http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
63+
Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
64+
65+
http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
66+
Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS
67+
licenses offer ticketed support, indemnification and commercial middleware.
68+
69+
http://www.SafeRTOS.com - High Integrity Systems also provide a safety
70+
engineered and independently SIL3 certified version for use in safety and
71+
mission critical applications that require provable dependability.
72+
73+
1 tab == 4 spaces!
74+
75+
################################################################################
76+
77+
Parson ( http://kgabis.github.com/parson/ )
78+
Copyright (c) 2012 - 2015 Krzysztof Gabis
79+
80+
Permission is hereby granted, free of charge, to any person obtaining a copy
81+
of this software and associated documentation files (the "Software"), to deal
82+
in the Software without restriction, including without limitation the rights
83+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
84+
copies of the Software, and to permit persons to whom the Software is
85+
furnished to do so, subject to the following conditions:
86+
87+
The above copyright notice and this permission notice shall be included in
88+
all copies or substantial portions of the Software.
89+
90+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
91+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
92+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
93+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
94+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
95+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
96+
THE SOFTWARE.
97+
98+
################################################################################
99+
100+
* Copyright (C) 2006-2015 wolfSSL Inc.
101+
*
102+
* This file is part of wolfSSL. (formerly known as CyaSSL)
103+
*
104+
* wolfSSL is free software; you can redistribute it and/or modify
105+
* it under the terms of the GNU General Public License as published by
106+
* the Free Software Foundation; either version 2 of the License, or
107+
* (at your option) any later version.
108+
*
109+
* wolfSSL is distributed in the hope that it will be useful,
110+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
111+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
112+
* GNU General Public License for more details.
113+
*
114+
* You should have received a copy of the GNU General Public License
115+
* along with this program; if not, write to the Free Software
116+
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
117+
*/
118+
119+
################################################################################
120+
121+
* Copyright (C) 2006-2016 wolfSSL Inc.
122+
*
123+
* This file is part of wolfMQTT.
124+
*
125+
* wolfMQTT is free software; you can redistribute it and/or modify
126+
* it under the terms of the GNU General Public License as published by
127+
* the Free Software Foundation; either version 2 of the License, or
128+
* (at your option) any later version.
129+
*
130+
* wolfMQTT is distributed in the hope that it will be useful,
131+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
132+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
133+
* GNU General Public License for more details.
134+
*
135+
* You should have received a copy of the GNU General Public License
136+
* along with this program; if not, write to the Free Software
137+
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335, USA
138+
*/

‎README.md

100644100755
+13-2
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,14 @@
1-
### Firmware for the PIC32MZ based IoT demos
1+
### AWS IoT Firmware for PIC32MZ Based Demos
22

3-
This firmware will be released by June 2016.
3+
---
4+
### Introduction
5+
[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).
6+
7+
---
8+
### Out of Box Guides
9+
Select the demo that you are using below to go to the out of box guide:
10+
- [IoT Ethernet Out of Box Guide](documents/iot-ethernet-out-of-box-guide.md)
11+
12+
---
13+
14+
For more information on Microchip's IoT Demos, please visit [Microchip's IoT Page](http://www.microchip.com/iot)

‎documents/harmony_license_v1.07.01.pdf

41.1 KB
Binary file not shown.

‎documents/images/DM990004.png

456 KB
Loading

‎documents/images/generateCode.png

6.52 KB
Loading

‎documents/images/program_icon.png

3.93 KB
Loading

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

+52
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
### IoT Ethernet Firmware
2+
#### Compile and Programing
3+
4+
---
5+
6+
### Introduction
7+
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
8+
9+
---
10+
11+
### Required Tools and Applications
12+
#### Microchip Required Tools and Applications
13+
You will need the following Microchip development tools to program and develop with the Microchip IoT Ethernet.
14+
15+
- Download the latest project for IoT Ethernet from here: [IoT Ethernet Project](https://github.com/MicrochipTech/aws-iot-firmware-pic32mz/releases/latest)
16+
- 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)
17+
- Download and install Microchip MPLAB<sup>&reg;</sup> X IDE for your OS from here:
18+
[Microchip MPLAB<sup>&reg;</sup> X IDE](http://www.microchip.com/mplabx)
19+
- Download and install the latest XC32 compiler for your OS from here: [Microchip MPLAB<sup>&reg;</sup> XC32 Compiler](http://www.microchip.com/xc32)
20+
21+
---
22+
23+
### Compiling and programming the IoT Ethernet Board
24+
25+
#### Compiling the Firmware
26+
1. Extract the zip file downloaded from the git repository to a location of your choice
27+
- Open MPLAB<sup>&reg;</sup> X IDE
28+
- Select __File -> Open Project__
29+
- Navigate to: ` <path-to-your-project>/aws-iot-firmware-pic32mz/software/aws-iot-ethernet/firmware`
30+
- Select the project __aws-iot-ethernet.X__
31+
- With your project opened, right click on the project __aws-iot-ethernet__ in the Projects tab and select __Set as Main Project__
32+
- 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)
33+
- 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"
34+
- 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.
35+
- With the new Harmony framework selected for your project, you will need to regenerate code by clicking the generate code button. ![](images/generateCode.png)
36+
- The MHC merge tool will show differences between code sets. Ignore the differences and hit "Close" for each file
37+
38+
#### Programing the IoT Ethernet Board
39+
1. Connect the PICKit&trade; 3 to your computer using the provided USB cable.
40+
- Connect the PICKit&trade; 3 to the IoT Ethernet ICSP 6-pin header. The pins should match by aligning the triangles.
41+
- 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.
42+
- On the top tab of MPLAB&reg; X, click the __Make and Program Device Main Project__ button. ![](images/program_icon.png)
43+
44+
>MPLAB&reg; X may prompt you to select with programmer to use. Select PICKit&trade; 3 from the prompt and continue.
45+
46+
---
47+
48+
### Troubleshooting
49+
If you are having trouble, check to make sure that each of the issues bellow are resolved.
50+
51+
#### Project won't compile due to missing files
52+
- 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).

0 commit comments

Comments
 (0)