README CONTENTS 
---------------
   
 * Introduction
 * Package Contents
 * How to run provided example
 * Release Notes


INTRODUCTION
------------

This package provides documentation for and example usage of AudioScience's Iyo Dante vendor specific conMon interface.


PACKAGE CONTENTS
----------------

 * docs 
   - asi_conmon_interface_api.html  # vendor specific conMon protocol documentation
 * include
   - asi_iyo_conmon.h              # protocol APIs
 * helper                          # helper functions for building/reading messages
   - asi_iyo_conmon_fns.h
   - asi_iyo_conmon_fns.c
 * test
   - asi_conmon_vendor_example.c   # example app (Windows Dante API SDK required)
   - conmon_vendor_example.vcxproj # Microsoft Visual Studio project file

asi_conmon_interface_api.html details the Dante conmon compatible structures that should be
sent and received using the Audinate provided conmon library interface.

asi_iyo_conmon.h is a compilable header file containing the structures described in the
asi_conmon_interface_api.html document.

The helper sub-directory contains C compilable headers and functions that assist application integration
utilizing AudioScience's Iyo Dante conmon interface.

Finally, the test subdirectory contains a user compilable example that illustrates how to use the
helper functions in a real world Dante conmon application.


HOW TO RUN PROVIDED EXAMPLE
---------------------------

  1) Add an Iyo (running firmware 3.x.x or later) to a Dante network. (see http://www.audioscience.com/internet/products/dante/quickstart_iyo_dante.pdf)
  2) Install the Audinate Dante API SDK on a Windows machine connected to the network.
  3) Open "test > conmon_vendor_example.vcxproj" in Visual Studio and click "Build > Build Solution"
  4) Navigate to the build directory
  5) > conmon_vendor_example.exe [device_name] [direction]
      - [device_name]: the Iyo Dante device name (see Dante Controller)
      - [direction]: 
          * tx - to send control messages to the Iyo (e.g. set gain, set LED brightness)
          * rx - to listen for status messages from the Iyo (e.g. model type, unsolicited responses)


RELEASE NOTES
-------------

v1.1 June 26 2019
-----------------
- initial release
