ANT SDK for Universal Windows Platform

_Note: Please check important notes at the bottom to avoid common errors using this sdk_

License and Copyright:
-------------------------

This software is subject to the license described in the License.txt file 
included with this software distribution. You may not use this file except in compliance 
with this license.

Copyright (c) Dynastream Innovations Inc. 2016
All rights reserved.


Project Hierarchy:
---------------------------
                               ANT_Managed_Library for UWP (built libraries)
                                                   |
                                                   |
                                                   |
                                             ANTFS Demo (C#)


The projects in this directory have been created designed and tested on Windows 10 UWP (including Win 10 IOT Core on Raspberry Pi 2) using [Visual Studio 2015 Professional Edition from Microsoft](https://www.visualstudio.com/en-us/products/vs-2015-product-editions.aspx). Ensure your Visual Studio installation has installed the "Universal Windows App Development Tools" feature and sub-features (See this MS page for [IOT Core setup instructions] (https://developer.microsoft.com/en-us/windows/iot/GetStarted.htm))


---------------------------------------------------------------------------------

Description of projects:
=================

ANT_WinUSB.inf
---------------------
The UWP apps require the ANT stick to use the WinUSB driver. This driver is a custom driver that must be installed for the ANT adapter before the libraries will work. See notes below for instructions on installing the driver.


ANT_LIB/ANT_NET_UWP.dll(built library)
-----------------------------
This is the recommended UWP ANT API. See notes below on its dependancies. This library can be referenced directly by UWP applications. Apps will use the ANT_Device and ANT_Channel objects to interact with ANT. This library exposes the same functionality as the PC .Net ANT_Net library, so see the ANT PC SDK for more example code. 


DEMO_ANTFS/ANTFS_Demo.csproj (C#)
-----------------------------------------------------------
Demo project builds a primitive ANTFS host or client with limited functionality.



---------------------------------------------------------------------------------

Important Notes to Avoid Common Errors:
==============================

__Important Note: Installing ANT UWP Drivers__
The ANT UWP libraries communicate with the ANT USB stick using the WinUSB drivers which must be installed for the stick. The standard ANT drivers from Windows Update will not work.
    
    *For IOT Core UWP: 
        * Connect to the device with [Powershell](https://developer.microsoft.com/en-us/windows/iot/GetStarted.htm)
        * Run "devcon dp_add <insert path to your ANT UWP SDK folder>\ANTIoTDriverInstall.inf"
        * To verify installation:
            * Restart the Pi, and ensure an ANT USB-m Stick is plugged in to one of the USB ports
            * Reconnect to the Pi with PowerShell
            * Run "devcon status USB\VID_0FCF"&"PID_1009" and ensure the ANT stick status is displayed
            
    * For standard Windows UWP (Development Only!! because there are no signed UWP drivers): 
        * Because this driver is not signed, you need to do some extra work to allow the install:
            * Hold shift while clicking 'start'>'power'>'restart'
            * Click 'Troubleshoot'
            * Click 'Advanced Options'
            * Click 'Start-up Settings'
            * Click 'Restart'
            * Press 'F7' on 'Startup Settings' screen to reboot with driver signature enforcement disabled
            * Follow below steps to install driver
        * Using device manager find ANT stick (under libusb-win32 devices)
        * Right click on it and select 'Update Driver Software...'
        * Click 'Browse my computer for driver software'
        * Click 'Let me pick from a list of device drivers on my computer'
        * Select the 'ANT_WinUSB.inf' from the ANT UWP SDK
        * Press 'next' to install the driver.

<br>
<br>      
__Important Note: Library Dependencies__  
The ANT_NET_UWP dll requires the ANT.UWPWrappedLib.dll and ANT.UWPWrappedLib.winmd library files to also be present in the same directory. If you have them in the same directory VS 2015 seems to know to automatically copy them into the build output by just referencing ANT_NET_UWP.dll, but if not you may have to include it in the output yourself. (Also note: The ANT.UWPWrappedLib.dll library exposes a more primitive interface wrapping the C++ UWP AntLib implementation, so using this interface directly is not recommended or supported)

<br>
<br>      
__Important Note: How to enable ANT log files for debugging__

Please see https://www.thisisant.com/forum/viewthread/6283/












