============================================ About Microchip DV102412 Exosite Cloud Demo

This project is for Microchip DV102412 using a Microchip WiFi MRF24WG0MA module to demo Exosite's cloud
connectivity to send and receive data to/from Exosite's Cloud Data Platform.

Project functionality includes:

1. New device activation on Exosite cloud and save CIK to NVMemory.
   
2. Periodically sends 'Heart Beat' data to draw a triangle wave to Exosite cloud.
   
3. Sends button press report to Exosite cloud to trigger an email alert.
   
4. Reads 'LED' data source on Exosite cloud to turn device LED1 on and off.
   

License is BSD, Copyright 2013, Exosite LLC (see LICENSE file)

Tested and developed on IDE MPLAB X IDE v1.90 (1.80 also works) for DV102412.

======================================== Validate Firmware and Hardware Versions

1. Firmware - based on Microchip library "microchip_solutions_v2013-02-15" and TCP/IP Stack version "v5.42.06 Feb 2013".
   NOTE: Find version information in "Microchip/TCPIP Stack/TCPIP Stack Version.txt".
   
2. Hardware - Microchip DV102412, and WiFi module MRF24WG0MA 124145D.
   

======================================== Quick Start

1. Install MPLAB XC32 Compiler v1.21.
   http://www.microchip.com/mplabxc32windows
   
2. Install MPLAB X IDE v1.90 for DV102412.
   http://www.microchip.com/mplabx-ide-windows-installer
   
3. Download the latest project repository from "https://github.com/exosite-garage/mcp_dv102412_cloud/archive/master.zip".
   
4. Extract the project and open the project folder "mcp_dv102412_cloud/TCPIP/WiFiGDemo/WiFiGDemoBoard" with MPLAB X.
   
5. Confirm power switch is ON and AAA batteries are installed, then plug in the PICKit3 and USB cable to your PC.
   
6. Compile the project and download the program to the board (Run -> Run Project). This process might take several minutes.
   
7. Use a smart phone or laptop that can select the WiFi Access Point labeled "MCHP_G_****" to provision device AP.
   
8. Open http://192.168.1.3, to load Configure Network page, click "Display Scan Results", select your SSID, input your passphrase and save.
   NOTE: If you see a "Future home of Mchp error notification." message during your AP setup, you should reboot your device and scan for APs again.
   Every time you want to turn on the dv102412, please confirm the AP is on-line, otherwise you'll waste many time for waiting
   
9. LED1 will blink 2 times and the device will auto reboot. Make sure that LED2 blinks 4 times to signify that the board has the correct firmware version.
   NOTE: View 'Device Status' section below for more information about LED messages.
   
10. When LED0 blinks rapidly for a couple of seconds, the WiFi Access Point has been set successfully.
    
11. Create a free account on microchip.exosite.com.
    
12. Activate your account.
    
13. Log in, and click the "Add Device" link from the home page.
    
14. Add a "DV102412 - Wi-Fi G Demo Board" device and input the MAC address shown on the welcome webpage of Microchip Wifi module.
    
15. Wait up to 40 seconds for the device to activate on your account.
    
16. Click the device on the "Your Devices" widget.
    
17. Control the LED using the On/Off switch widget.
    
18. When the module is connected and activated, the device will send a "ping" value periodically.
    
19. When you need to change the WiFi Access Point after the device provision, you should check the SSID and IP on datasource of portal.
    
20. Use a smart phone or laptop that can select the WiFi Access Point, and the device's current SSID/IP(Local IP, Local SSID) is indicate on portal.
    
21. Connect to the current IP of device, to load Configure Network page, replay the option 2.
    

======================================== Device Status

LED0

• Blinks continually = WiFi is operational

LED1 - reset WiFi

• Blinks 2 times = WiFi Access Point has been set. Also reboots the device.
• Blinks 3 times = WiFi Access Point has been erased.

LED2 - device bootup

• Blinks 2 times = WiFi module firmware version is 0x30.
• Blinks 4 times = WiFi module firmware version is 0x31.
• Blinks 6 times = WiFi module firmware version is unknown.

LED2 - runtime

• No Blinks = Device cannot connect to the Internet
• 1 Blink, continually = Cloud read, write and provision successful
• 2 Blinks, continually = No Internet connection
• 3 Blinks, continually = Device owner not found, no cloud identity
• 4 Blinks, continually = Device Client Interface Key is invalid

======================================== Release Info

---

Release 2013-12-04

--) slowed down the heartbeat posting
--) used the timer tick to handle the LED2 blinky rate
--) improved the tcp stability

---

Release 2013-09-25

--) updated to support MPLAB X v1.90

---

Release 2013-06-07

--) improved network performance, and added TCPWasReset to check TCP status
--) cleaned up code in Exosite_Demo.c

---

Release 2013-05-24

--) MAC Address now shown on welcome webpage

---

Release 2013-05-16

--) initial release