init
This commit is contained in:
Steven Dan
126
lib_i2c/CHANGELOG.rst
Normal file
126
lib_i2c/CHANGELOG.rst
Normal file
@@ -0,0 +1,126 @@
|
||||
I2C library change log
|
||||
======================
|
||||
|
||||
6.2.0
|
||||
-----
|
||||
|
||||
* ADDED: Support for XCommon CMake build system
|
||||
* REMOVED: Unused dependency lib_logging
|
||||
|
||||
* Changes to dependencies:
|
||||
|
||||
- lib_logging: Removed dependency
|
||||
|
||||
- lib_xassert: 2.0.0 -> 4.2.0
|
||||
|
||||
6.1.1
|
||||
-----
|
||||
|
||||
* RESOLVED: Fixed timing for repeated START condition
|
||||
|
||||
6.1.0
|
||||
-----
|
||||
|
||||
* CHANGED: Use XMOS Public Licence Version 1
|
||||
* CHANGED: Rearrange documentation files
|
||||
|
||||
6.0.1
|
||||
-----
|
||||
|
||||
* CHANGED: Pin Python package versions
|
||||
* REMOVED: not necessary cpanfile
|
||||
|
||||
6.0.0
|
||||
-----
|
||||
|
||||
* CHANGED: Build files updated to support new "xcommon" behaviour in xwaf.
|
||||
|
||||
5.0.1
|
||||
-----
|
||||
|
||||
* CHANGE: Renamed example application directories to have standard "app"
|
||||
prefix.
|
||||
|
||||
5.0.0
|
||||
-----
|
||||
|
||||
* CHANGE: i2c_master_single_port no longer supported on XS1.
|
||||
* CHANGE: Removed the start_read_request() and start_write_request() functions
|
||||
from the i2c_slave_callback_if.
|
||||
* CHANGE: Removed the start_master_read() and start_master_write() functions
|
||||
from the i2c_slave_callback_if.
|
||||
* RESOLVED: Fixed timing of i2c master (both single port and multi-port).
|
||||
* RESOLVED: Fixed bug with the master not coping with clock stretching on
|
||||
start bits.
|
||||
|
||||
4.0.2
|
||||
-----
|
||||
|
||||
* RESOLVED: Make use of Wavedrom in documentation generation offline (fixes
|
||||
automated build due to a known Wavevedrom issue where it would generate zero
|
||||
size PNG)
|
||||
|
||||
4.0.1
|
||||
-----
|
||||
|
||||
* RESOLVED: Suppressed warning "argument 1 of 'i2c_master_async_aux' slices
|
||||
interface preventing analysis of its parallel usage".
|
||||
|
||||
4.0.0
|
||||
-----
|
||||
|
||||
* CHANGE: Register read/write functions are now all MSB first
|
||||
* RESOLVED: i2c slave working properly (versions pre 4.0.0 not suitable for
|
||||
i2c slave)
|
||||
* RESOLVED: Fixed byte ordering of write_reg16_addr8()
|
||||
* RESOLVED: Fixed master transmitting on multi-bit port
|
||||
|
||||
3.1.6
|
||||
-----
|
||||
|
||||
* CHANGE: Change title to remove special characters
|
||||
|
||||
3.1.5
|
||||
-----
|
||||
|
||||
* CHANGE: Update app notes
|
||||
|
||||
3.1.4
|
||||
-----
|
||||
|
||||
* CHANGE: Remove invalid app notes
|
||||
|
||||
3.1.3
|
||||
-----
|
||||
|
||||
* CHANGE: Update to source code license and copyright
|
||||
|
||||
3.1.2
|
||||
-----
|
||||
|
||||
* RESOLVED: Fix incorrect reading of r/w bit in slave component
|
||||
|
||||
3.1.1
|
||||
-----
|
||||
|
||||
* CHANGE: Minor user guide updates
|
||||
|
||||
3.1.0
|
||||
-----
|
||||
|
||||
* ADDED: Add support for reading on i2c_master_single-port for xCORE-200
|
||||
series.
|
||||
* CHANGE: Document reg_read functions more clearly with respect to stop bit
|
||||
behavior.
|
||||
|
||||
3.0.0
|
||||
-----
|
||||
|
||||
* CHANGE: Consolidated version, major rework from previous I2C components.
|
||||
|
||||
* Changes to dependencies:
|
||||
|
||||
- lib_logging: Added dependency 2.0.0
|
||||
|
||||
- lib_xassert: Added dependency 2.0.0
|
||||
|
||||
84
lib_i2c/LICENSE.rst
Normal file
84
lib_i2c/LICENSE.rst
Normal file
@@ -0,0 +1,84 @@
|
||||
*******************************
|
||||
XMOS PUBLIC LICENCE: Version 1
|
||||
*******************************
|
||||
|
||||
Subject to the conditions and limitations below, permission is hereby granted by XMOS LIMITED (“XMOS”), free of charge, to any person or entity obtaining a copy of the XMOS Software.
|
||||
|
||||
**1. Definitions**
|
||||
|
||||
**“Applicable Patent Rights”** means: (a) where XMOS is the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to XMOS and (ii) that cover subject matter contained in the Software, but only to the extent it is necessary to use, reproduce or distribute the Software without infringement; and (b) where you are the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to you and (ii) that cover the subject matter contained in your Derivatives, taken alone or in combination with the Software.
|
||||
|
||||
**“Compiled Code”** means any compiled, binary, machine readable or executable version of the Source Code.
|
||||
|
||||
**“Contributor”** means any person or entity that creates or contributes to the creation of Derivatives.
|
||||
|
||||
**“Derivatives”** means any addition to, deletion from and/or change to the substance, structure of the Software, any previous Derivatives, the combination of the Derivatives and the Software and/or any respective portions thereof.
|
||||
|
||||
**“Source Code”** means the human readable code that is suitable for making modifications but excluding any Compiled Code.
|
||||
|
||||
**“Software”** means the software and associated documentation files which XMOS makes available and which contain a notice identifying the software as original XMOS software and referring to the software being subject to the terms of this XMOS Public Licence.
|
||||
|
||||
This Licence refers to XMOS Software and does not relate to any XMOS hardware or devices which are protected by intellectual property rights (including patent and trade marks) which may be sold to you under a separate agreement.
|
||||
|
||||
|
||||
**2. Licence**
|
||||
|
||||
**Permitted Uses, Conditions and Restrictions.** Subject to the conditions below, XMOS grants you a worldwide, royalty free, non-exclusive licence, to the extent of any Patent Rights to do the following:
|
||||
|
||||
2.1 **Unmodified Software.** You may use, copy, display, publish, distribute and make available unmodified copies of the Software:
|
||||
|
||||
2.1.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.1.2 for commercial purposes provided the Software is at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.1.1 and 2.1.2):
|
||||
|
||||
(a) you must retain and reproduce in all copies of the Software the copyright and proprietary notices and disclaimers of XMOS as they appear in the Software, and keep intact all notices and disclaimers in the Software files that refer to this Licence; and
|
||||
|
||||
(b) you must include a copy of this Licence with every copy of the Software and documentation you publish, distribute and make available and you may not offer or impose any terms on such Software that alter or restrict this Licence or the intent of such Licence, except as permitted below (Additional Terms).
|
||||
|
||||
The licence above does not include any Compiled Code which XMOS may make available under a separate support and licence agreement.
|
||||
|
||||
2.2 **Derivatives.** You may create and modify Derivatives and use, copy, display, publish, distribute and make available Derivatives:
|
||||
|
||||
2.2.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.2.2 for commercial purposes, provided the Derivatives are at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.2.1 and 2.2.2):
|
||||
|
||||
(a) you must comply with the terms of clause 2.1 with respect to the Derivatives;
|
||||
|
||||
(b) you must copy (to the extent it doesn’t already exist) the notice below in each file of the Derivatives, and ensure all the modified files carry prominent notices stating that you have changed the files and the date of any change; and
|
||||
|
||||
(c) if you sublicence, distribute or otherwise make the Software and/or the Derivatives available for commercial purposes, you must provide that the Software and Derivatives are at all times used on a device designed, licensed or developed by XMOS.
|
||||
|
||||
Without limitation to these terms and clause 3 below, the Source Code and Compiled Code to your Derivatives may at your discretion (but without obligation) be released, copied, displayed, published, distributed and made available; and if you elect to do so, it must be under the terms of this Licence including the terms of the licence at clauses 2.2.1, 2.2.2 and clause 3 below.
|
||||
|
||||
2.3 **Distribution of Executable Versions.** If you distribute or make available Derivatives, you must include a prominent notice in the code itself as well as in all related documentation, stating that the Source Code of the Software from which the Derivatives are based is available under the terms of this Licence, with information on how and where to obtain such Source Code.
|
||||
|
||||
**3. Your Grant of Rights.** In consideration and as a condition to this Licence, you grant to any person or entity receiving or distributing any Derivatives, a non-exclusive, royalty free, perpetual, irrevocable license under your Applicable Patent Rights and all other intellectual property rights owned or controlled by you, to use, copy, display, publish, distribute and make available your Derivatives of the same scope and extent as XMOS’s licence under clause 2.2 above.
|
||||
|
||||
**4. Combined Products.** You may create a combined product by combining Software, Derivatives and other code not covered by this Licence as a single application or product. In such instance, you must comply with the requirements of this Licence for any portion of the Software and/or Derivatives.
|
||||
|
||||
**5. Additional Terms.** You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations and/or other rights consistent with the term of this Licence (“Additional Terms”) to any legitimate recipients of the Software and/or Derivatives. The terms on which you provide such Additional Terms are on your sole responsibility and you shall indemnify, defend and hold XMOS harmless against any claims asserted against XMOS.
|
||||
|
||||
**6. New Versions.** XMOS may publish revised and/or new versions of this Licence from time to time to accommodate changes to the Licence terms, new versions, updates and bug fixes of the Software. Each version will be given a distinguishing version number. Once Software has been published under a particular version of this Licence, you may continue to use it under the terms of that version. You may also choose to use the latest version of the Software under any subsequent version published by XMOS. Only XMOS shall have the right to modify these terms.
|
||||
|
||||
**7. IPR and Ownership**
|
||||
Any rights, including all intellectual property rights and all trademarks not expressly granted herein are reserved in full by the authors or copyright holders. Any requests for additional permissions by XMOS including any rights to use XMOS trademarks, should be made (without obligation) to XMOS at **support@xmos.com**
|
||||
|
||||
Nothing herein shall limit any rights that XMOS is otherwise entitled to under the doctrines of patent exhaustion, implied license, or legal estoppel. Neither the name of the authors, the copyright holders or any contributors may be used to endorse or promote any Derivatives from this Software without specific written permission. Any attempt to deal with the Software which does not comply with this Licence shall be void and shall automatically terminate any rights granted under this licence (including any licence of any intellectual property rights granted herein).
|
||||
Subject to the licences granted under this Licence any Contributor retains all rights, title and interest in and to any Derivatives made by Contributor subject to the underlying rights of XMOS in the Software. XMOS shall retain all rights, title and interest in the Software and any Derivatives made by XMOS (“XMOS Derivatives”). XMOS Derivatives will not automatically be subject to this Licence and XMOS shall be entitled to licence such rights on any terms (without obligation) as it sees fit.
|
||||
|
||||
**8. Termination**
|
||||
|
||||
8.1 This Licence will automatically terminate immediately, without notice to you, if:
|
||||
|
||||
(a) you fail to comply with the terms of this Licence; and/or
|
||||
|
||||
(b) you directly or indirectly commence any action for patent or intellectual property right infringement against XMOS, or any parent, group, affiliate or subsidiary of XMOS; provided XMOS did not first commence an action or patent infringement against you in that instance; and/or
|
||||
|
||||
(c) the terms of this Licence are held by any court of competent jurisdiction to be unenforceable in whole or in part.
|
||||
|
||||
**9. Critical Applications.** Unless XMOS has agreed in writing with you an agreement specifically governing use of the Goods in military, aerospace, automotive or medically related functions (collectively and individually hereinafter referred to as "Special Use"), any permitted use of the Software excludes Special Use. Notwithstanding any agreement between XMOS and you for Special Use, Special Use shall be at your own risk, and you shall fully indemnify XMOS against any damages, losses, costs and claims (direct and indirect) arising out of any Special Use.
|
||||
|
||||
**10. NO WARRANTY OR SUPPORT.** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL XMOS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, WARRANTY, CIVIL TORT (INCLUDING NEGLIGENCE), PRODUCTS LIABILITY OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE INCLUDING GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF SUCH PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND NOT WITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE. IN SOME JURISDICTIONS PARTIES ARE UNABLE TO LIMIT LIABILTY IN THIS WAY, IF THIS APPLIES TO YOUR JURISDICTION THIS LIABILITY CLAUSE ABOVE MAY NOT APPLY. NOTWITHSTANDING THE ABOVE, IN NO EVENT SHALL XMOS’s TOTAL LIABILITY TO YOU FOR ALL DAMAGES, LOSS OR OTHERWISE EXCEED $50.
|
||||
|
||||
**11. Governing Law and Jurisdiction.** This Licence constitutes the entire agreement between the parties with respect to the subject matter hereof. The Licence shall be governed by the laws of England and the conflict of laws and UN Convention on Contracts for the International Sale of Goods, shall not apply.
|
||||
62
lib_i2c/README.rst
Normal file
62
lib_i2c/README.rst
Normal file
@@ -0,0 +1,62 @@
|
||||
.. |I2C| replace:: I\ :sup:`2`\ C
|
||||
|
||||
I2C Library
|
||||
===========
|
||||
|
||||
:Version: 6.2.0
|
||||
:Vendor: XMOS
|
||||
|
||||
Summary
|
||||
-------
|
||||
|
||||
A software defined, industry-standard, |I2C| library
|
||||
that allows you to control an |I2C| bus via xCORE ports.
|
||||
|I2C| is a two-wire hardware serial
|
||||
interface, first developed by Philips. The components in the libary
|
||||
are controlled via C using the XMOS multicore extensions (xC) and
|
||||
can either act as |I2C| master or slave.
|
||||
|
||||
The libary is compatible with multiple slave devices existing on the same
|
||||
bus. The |I2C| master component can be used by multiple tasks within
|
||||
the xCORE device (each addressing the same or different slave devices).
|
||||
|
||||
The library can also be used to implement multiple |I2C| physical interfaces
|
||||
on a single xCORE device simultaneously.
|
||||
|
||||
Features
|
||||
........
|
||||
|
||||
* |I2C| master and |I2C| slave modes.
|
||||
* Supports speed up to 400 Kb/s (|I2C| Fast-mode).
|
||||
* Clock stretching support.
|
||||
* Synchronous and asynchronous APIs for efficient usage of processing cores.
|
||||
|
||||
Software version and dependencies
|
||||
.................................
|
||||
|
||||
The CHANGELOG contains information about the current and previous versions.
|
||||
For a list of direct dependencies, look for DEPENDENT_MODULES in lib_i2c/module_build_info.
|
||||
|
||||
Related application notes
|
||||
.........................
|
||||
|
||||
The following application notes use this library:
|
||||
|
||||
* AN00156: How to use the I2C master library
|
||||
* AN00157: How to use the I2C slave library
|
||||
* AN00181: xCORE-200 explorer accelerometer demo
|
||||
|
||||
Required Software (dependencies)
|
||||
================================
|
||||
|
||||
* lib_xassert (www.github.com/xmos/lib_xassert)
|
||||
|
||||
Documentation
|
||||
=============
|
||||
|
||||
You can find the documentation for this software in the /doc directory of the package.
|
||||
|
||||
Support
|
||||
=======
|
||||
|
||||
This package is supported by XMOS Ltd. Issues can be raised against the software at: http://www.xmos.com/support
|
||||
163
lib_i2c/examples/AN00156_i2c_master_example/.cproject
Normal file
163
lib_i2c/examples/AN00156_i2c_master_example/.cproject
Normal file
@@ -0,0 +1,163 @@
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
|
||||
<storageModule moduleId="org.eclipse.cdt.core.settings">
|
||||
<cconfiguration id="com.xmos.cdt.toolchain.868918528">
|
||||
<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="com.xmos.cdt.toolchain.868918528" moduleId="org.eclipse.cdt.core.settings" name="Default">
|
||||
<externalSettings/>
|
||||
<extensions>
|
||||
<extension id="com.xmos.cdt.core.XEBinaryParser" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GNU_ELF" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="com.xmos.cdt.core.XdeErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
</extensions>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<configuration buildProperties="" description="" id="com.xmos.cdt.toolchain.868918528" name="Default" parent="org.eclipse.cdt.build.core.emptycfg">
|
||||
<folderInfo id="com.xmos.cdt.toolchain.868918528.546105188" name="/" resourcePath="">
|
||||
<toolChain id="com.xmos.cdt.toolchain.1900008954" name="com.xmos.cdt.toolchain" superClass="com.xmos.cdt.toolchain">
|
||||
<targetPlatform archList="all" binaryParser="com.xmos.cdt.core.XEBinaryParser;org.eclipse.cdt.core.GNU_ELF" id="com.xmos.cdt.core.platform.2043843281" isAbstract="false" osList="linux,win32,macosx" superClass="com.xmos.cdt.core.platform"/>
|
||||
<builder arguments="CONFIG=Default" id="com.xmos.cdt.builder.base.146082949" keepEnvironmentInBuildfile="false" managedBuildOn="false" superClass="com.xmos.cdt.builder.base">
|
||||
<outputEntries>
|
||||
<entry flags="VALUE_WORKSPACE_PATH" kind="outputPath" name="bin"/>
|
||||
</outputEntries>
|
||||
</builder>
|
||||
<tool id="com.xmos.cdt.xc.compiler.59503268" name="com.xmos.cdt.xc.compiler" superClass="com.xmos.cdt.xc.compiler">
|
||||
<option id="com.xmos.xc.compiler.option.include.paths.1049064054" superClass="com.xmos.xc.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.xc.compiler.input.1844278341" name="XC" superClass="com.xmos.cdt.xc.compiler.input"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.c.compiler.1193858974" name="com.xmos.cdt.c.compiler" superClass="com.xmos.cdt.c.compiler">
|
||||
<option id="com.xmos.c.compiler.option.include.paths.917823278" superClass="com.xmos.c.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.c.compiler.input.c.916493242" name="C" superClass="com.xmos.cdt.c.compiler.input.c"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.cxx.compiler.454071458" name="com.xmos.cdt.cxx.compiler" superClass="com.xmos.cdt.cxx.compiler">
|
||||
<option id="com.xmos.cxx.compiler.option.include.paths.276177407" superClass="com.xmos.cxx.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.cxx.compiler.input.cpp.1714156048" name="C++" superClass="com.xmos.cdt.cxx.compiler.input.cpp"/>
|
||||
</tool>
|
||||
</toolChain>
|
||||
</folderInfo>
|
||||
<sourceEntries>
|
||||
<entry excluding=".build*" flags="VALUE_WORKSPACE_PATH|RESOLVED" kind="sourcePath" name=""/>
|
||||
</sourceEntries>
|
||||
</configuration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.externalSettings"/>
|
||||
</cconfiguration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="scannerConfiguration">
|
||||
<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerFileProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="makefileGenerator">
|
||||
<runAction arguments="-E -P -v -dD" command="" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.cpp" command="g++" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.c" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/${specs_file}"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'g++ -E -P -v -dD "${plugin_state_location}/specs.cpp"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/specs.c"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<project id="AN00156_i2c_master_example.null.1035655509" name="AN00156_i2c_master_example"/>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
|
||||
</cproject>
|
||||
116
lib_i2c/examples/AN00156_i2c_master_example/.project
Normal file
116
lib_i2c/examples/AN00156_i2c_master_example/.project
Normal file
@@ -0,0 +1,116 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<projectDescription>
|
||||
<name>AN00156_i2c_master_example</name>
|
||||
<comment></comment>
|
||||
<projects>
|
||||
</projects>
|
||||
<buildSpec>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.LegacyProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectInfoSyncBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.BuildMarkersBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.IncludePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ModulePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
|
||||
<triggers>clean,full,incremental,</triggers>
|
||||
<arguments>
|
||||
<dictionary>
|
||||
<key>?children?</key>
|
||||
<value>?name?=outputEntries\|?children?=?name?=entry\\\\|\\|\||</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>?name?</key>
|
||||
<value></value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.append_environment</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildArguments</key>
|
||||
<value>CONFIG=Debug</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildCommand</key>
|
||||
<value>xmake</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.cleanBuildTarget</key>
|
||||
<value>clean</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.contents</key>
|
||||
<value>org.eclipse.cdt.make.core.activeConfigSettings</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableAutoBuild</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableCleanBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableFullBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.stopOnError</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.useDefaultBuildCmd</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
|
||||
<triggers>full,incremental,</triggers>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
</buildSpec>
|
||||
<natures>
|
||||
<nature>org.eclipse.cdt.core.cnature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
|
||||
<nature>com.xmos.cdt.core.XdeProjectNature</nature>
|
||||
</natures>
|
||||
<filteredResources>
|
||||
<filter>
|
||||
<id>1406010377704</id>
|
||||
<name></name>
|
||||
<type>26</type>
|
||||
<matcher>
|
||||
<id>org.eclipse.ui.ide.multiFilter</id>
|
||||
<arguments>1.0-name-matches-false-false-.build*</arguments>
|
||||
</matcher>
|
||||
</filter>
|
||||
</filteredResources>
|
||||
</projectDescription>
|
||||
3
lib_i2c/examples/AN00156_i2c_master_example/.xproject
Normal file
3
lib_i2c/examples/AN00156_i2c_master_example/.xproject
Normal file
@@ -0,0 +1,3 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<xproject><version>1.0.3d0000000000</version>
|
||||
</xproject>
|
||||
84
lib_i2c/examples/AN00156_i2c_master_example/LICENSE.rst
Normal file
84
lib_i2c/examples/AN00156_i2c_master_example/LICENSE.rst
Normal file
@@ -0,0 +1,84 @@
|
||||
*******************************
|
||||
XMOS PUBLIC LICENCE: Version 1
|
||||
*******************************
|
||||
|
||||
Subject to the conditions and limitations below, permission is hereby granted by XMOS LIMITED (“XMOS”), free of charge, to any person or entity obtaining a copy of the XMOS Software.
|
||||
|
||||
**1. Definitions**
|
||||
|
||||
**“Applicable Patent Rights”** means: (a) where XMOS is the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to XMOS and (ii) that cover subject matter contained in the Software, but only to the extent it is necessary to use, reproduce or distribute the Software without infringement; and (b) where you are the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to you and (ii) that cover the subject matter contained in your Derivatives, taken alone or in combination with the Software.
|
||||
|
||||
**“Compiled Code”** means any compiled, binary, machine readable or executable version of the Source Code.
|
||||
|
||||
**“Contributor”** means any person or entity that creates or contributes to the creation of Derivatives.
|
||||
|
||||
**“Derivatives”** means any addition to, deletion from and/or change to the substance, structure of the Software, any previous Derivatives, the combination of the Derivatives and the Software and/or any respective portions thereof.
|
||||
|
||||
**“Source Code”** means the human readable code that is suitable for making modifications but excluding any Compiled Code.
|
||||
|
||||
**“Software”** means the software and associated documentation files which XMOS makes available and which contain a notice identifying the software as original XMOS software and referring to the software being subject to the terms of this XMOS Public Licence.
|
||||
|
||||
This Licence refers to XMOS Software and does not relate to any XMOS hardware or devices which are protected by intellectual property rights (including patent and trade marks) which may be sold to you under a separate agreement.
|
||||
|
||||
|
||||
**2. Licence**
|
||||
|
||||
**Permitted Uses, Conditions and Restrictions.** Subject to the conditions below, XMOS grants you a worldwide, royalty free, non-exclusive licence, to the extent of any Patent Rights to do the following:
|
||||
|
||||
2.1 **Unmodified Software.** You may use, copy, display, publish, distribute and make available unmodified copies of the Software:
|
||||
|
||||
2.1.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.1.2 for commercial purposes provided the Software is at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.1.1 and 2.1.2):
|
||||
|
||||
(a) you must retain and reproduce in all copies of the Software the copyright and proprietary notices and disclaimers of XMOS as they appear in the Software, and keep intact all notices and disclaimers in the Software files that refer to this Licence; and
|
||||
|
||||
(b) you must include a copy of this Licence with every copy of the Software and documentation you publish, distribute and make available and you may not offer or impose any terms on such Software that alter or restrict this Licence or the intent of such Licence, except as permitted below (Additional Terms).
|
||||
|
||||
The licence above does not include any Compiled Code which XMOS may make available under a separate support and licence agreement.
|
||||
|
||||
2.2 **Derivatives.** You may create and modify Derivatives and use, copy, display, publish, distribute and make available Derivatives:
|
||||
|
||||
2.2.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.2.2 for commercial purposes, provided the Derivatives are at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.2.1 and 2.2.2):
|
||||
|
||||
(a) you must comply with the terms of clause 2.1 with respect to the Derivatives;
|
||||
|
||||
(b) you must copy (to the extent it doesn’t already exist) the notice below in each file of the Derivatives, and ensure all the modified files carry prominent notices stating that you have changed the files and the date of any change; and
|
||||
|
||||
(c) if you sublicence, distribute or otherwise make the Software and/or the Derivatives available for commercial purposes, you must provide that the Software and Derivatives are at all times used on a device designed, licensed or developed by XMOS.
|
||||
|
||||
Without limitation to these terms and clause 3 below, the Source Code and Compiled Code to your Derivatives may at your discretion (but without obligation) be released, copied, displayed, published, distributed and made available; and if you elect to do so, it must be under the terms of this Licence including the terms of the licence at clauses 2.2.1, 2.2.2 and clause 3 below.
|
||||
|
||||
2.3 **Distribution of Executable Versions.** If you distribute or make available Derivatives, you must include a prominent notice in the code itself as well as in all related documentation, stating that the Source Code of the Software from which the Derivatives are based is available under the terms of this Licence, with information on how and where to obtain such Source Code.
|
||||
|
||||
**3. Your Grant of Rights.** In consideration and as a condition to this Licence, you grant to any person or entity receiving or distributing any Derivatives, a non-exclusive, royalty free, perpetual, irrevocable license under your Applicable Patent Rights and all other intellectual property rights owned or controlled by you, to use, copy, display, publish, distribute and make available your Derivatives of the same scope and extent as XMOS’s licence under clause 2.2 above.
|
||||
|
||||
**4. Combined Products.** You may create a combined product by combining Software, Derivatives and other code not covered by this Licence as a single application or product. In such instance, you must comply with the requirements of this Licence for any portion of the Software and/or Derivatives.
|
||||
|
||||
**5. Additional Terms.** You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations and/or other rights consistent with the term of this Licence (“Additional Terms”) to any legitimate recipients of the Software and/or Derivatives. The terms on which you provide such Additional Terms are on your sole responsibility and you shall indemnify, defend and hold XMOS harmless against any claims asserted against XMOS.
|
||||
|
||||
**6. New Versions.** XMOS may publish revised and/or new versions of this Licence from time to time to accommodate changes to the Licence terms, new versions, updates and bug fixes of the Software. Each version will be given a distinguishing version number. Once Software has been published under a particular version of this Licence, you may continue to use it under the terms of that version. You may also choose to use the latest version of the Software under any subsequent version published by XMOS. Only XMOS shall have the right to modify these terms.
|
||||
|
||||
**7. IPR and Ownership**
|
||||
Any rights, including all intellectual property rights and all trademarks not expressly granted herein are reserved in full by the authors or copyright holders. Any requests for additional permissions by XMOS including any rights to use XMOS trademarks, should be made (without obligation) to XMOS at **support@xmos.com**
|
||||
|
||||
Nothing herein shall limit any rights that XMOS is otherwise entitled to under the doctrines of patent exhaustion, implied license, or legal estoppel. Neither the name of the authors, the copyright holders or any contributors may be used to endorse or promote any Derivatives from this Software without specific written permission. Any attempt to deal with the Software which does not comply with this Licence shall be void and shall automatically terminate any rights granted under this licence (including any licence of any intellectual property rights granted herein).
|
||||
Subject to the licences granted under this Licence any Contributor retains all rights, title and interest in and to any Derivatives made by Contributor subject to the underlying rights of XMOS in the Software. XMOS shall retain all rights, title and interest in the Software and any Derivatives made by XMOS (“XMOS Derivatives”). XMOS Derivatives will not automatically be subject to this Licence and XMOS shall be entitled to licence such rights on any terms (without obligation) as it sees fit.
|
||||
|
||||
**8. Termination**
|
||||
|
||||
8.1 This Licence will automatically terminate immediately, without notice to you, if:
|
||||
|
||||
(a) you fail to comply with the terms of this Licence; and/or
|
||||
|
||||
(b) you directly or indirectly commence any action for patent or intellectual property right infringement against XMOS, or any parent, group, affiliate or subsidiary of XMOS; provided XMOS did not first commence an action or patent infringement against you in that instance; and/or
|
||||
|
||||
(c) the terms of this Licence are held by any court of competent jurisdiction to be unenforceable in whole or in part.
|
||||
|
||||
**9. Critical Applications.** Unless XMOS has agreed in writing with you an agreement specifically governing use of the Goods in military, aerospace, automotive or medically related functions (collectively and individually hereinafter referred to as "Special Use"), any permitted use of the Software excludes Special Use. Notwithstanding any agreement between XMOS and you for Special Use, Special Use shall be at your own risk, and you shall fully indemnify XMOS against any damages, losses, costs and claims (direct and indirect) arising out of any Special Use.
|
||||
|
||||
**10. NO WARRANTY OR SUPPORT.** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL XMOS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, WARRANTY, CIVIL TORT (INCLUDING NEGLIGENCE), PRODUCTS LIABILITY OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE INCLUDING GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF SUCH PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND NOT WITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE. IN SOME JURISDICTIONS PARTIES ARE UNABLE TO LIMIT LIABILTY IN THIS WAY, IF THIS APPLIES TO YOUR JURISDICTION THIS LIABILITY CLAUSE ABOVE MAY NOT APPLY. NOTWITHSTANDING THE ABOVE, IN NO EVENT SHALL XMOS’s TOTAL LIABILITY TO YOU FOR ALL DAMAGES, LOSS OR OTHERWISE EXCEED $50.
|
||||
|
||||
**11. Governing Law and Jurisdiction.** This Licence constitutes the entire agreement between the parties with respect to the subject matter hereof. The Licence shall be governed by the laws of England and the conflict of laws and UN Convention on Contracts for the International Sale of Goods, shall not apply.
|
||||
39
lib_i2c/examples/AN00156_i2c_master_example/Makefile
Normal file
39
lib_i2c/examples/AN00156_i2c_master_example/Makefile
Normal file
@@ -0,0 +1,39 @@
|
||||
# The flags passed to xcc when building the application
|
||||
# You can also set the following to override flags for a particular language:
|
||||
#
|
||||
# XCC_XC_FLAGS, XCC_C_FLAGS, XCC_ASM_FLAGS, XCC_CPP_FLAGS
|
||||
#
|
||||
# If the variable XCC_MAP_FLAGS is set it overrides the flags passed to
|
||||
# xcc for the final link (mapping) stage.
|
||||
|
||||
BUILD_FLAGS = -O2 -g -DDEBUG_PRINT_ENABLE=1 -report
|
||||
|
||||
XCOREAI ?= 0
|
||||
# The TARGET variable determines what target system the application is
|
||||
# compiled for. It either refers to an XN file in the source directories
|
||||
# or a valid argument for the --target option when compiling.
|
||||
ifeq ($(XCOREAI),0)
|
||||
XCC_FLAGS_xs2 = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-200-EXPLORER
|
||||
else
|
||||
XCC_FLAGS_xcoreai = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-AI-EXPLORER
|
||||
endif
|
||||
|
||||
# The APP_NAME variable determines the name of the final .xe file. It should
|
||||
# not include the .xe postfix. If left blank the name will default to
|
||||
# the project name
|
||||
|
||||
APP_NAME =
|
||||
|
||||
|
||||
# The USED_MODULES variable lists other module used by the application.
|
||||
|
||||
USED_MODULES = lib_i2c(>=6.0.0) lib_logging(>=2.1.0)
|
||||
|
||||
#=============================================================================
|
||||
# The following part of the Makefile includes the common build infrastructure
|
||||
# for compiling XMOS applications. You should not need to edit below here.
|
||||
|
||||
XMOS_MAKE_PATH ?= ../..
|
||||
include $(XMOS_MAKE_PATH)/xcommon/module_xcommon/build/Makefile.common
|
||||
34
lib_i2c/examples/AN00156_i2c_master_example/README.rst
Normal file
34
lib_i2c/examples/AN00156_i2c_master_example/README.rst
Normal file
@@ -0,0 +1,34 @@
|
||||
.. |I2C| replace:: I\ :sup:`2`\ C
|
||||
|
||||
How to use the I2C master library
|
||||
=================================
|
||||
|
||||
Summary
|
||||
-------
|
||||
|
||||
Software dependencies
|
||||
.....................
|
||||
|
||||
For a list of direct dependencies, look for USED_MODULES in the Makefile.
|
||||
|
||||
|
||||
Required hardware
|
||||
.................
|
||||
|
||||
The example code provided with the application has been implemented
|
||||
and tested on the xCORE-200 eXplorerKIT.
|
||||
|
||||
Prerequisites
|
||||
.............
|
||||
|
||||
* This document assumes familiarity with the XMOS xCORE architecture,
|
||||
the XMOS tool chain and the xC language. Documentation related to these
|
||||
aspects which are not specific to this application note are linked to in
|
||||
the references appendix.
|
||||
|
||||
* For a description of XMOS related terms found in this document
|
||||
please see the XMOS Glossary [#]_.
|
||||
|
||||
.. [#] http://www.xmos.com/published/glossary
|
||||
|
||||
|
||||
81
lib_i2c/examples/AN00156_i2c_master_example/src/main.xc
Normal file
81
lib_i2c/examples/AN00156_i2c_master_example/src/main.xc
Normal file
@@ -0,0 +1,81 @@
|
||||
// Copyright 2013-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
#include <xs1.h>
|
||||
#include "i2c.h"
|
||||
#include "debug_print.h"
|
||||
|
||||
// I2C interface ports
|
||||
port p_scl = XS1_PORT_1E;
|
||||
port p_sda = XS1_PORT_1F;
|
||||
|
||||
// FXOS8700CQ register address defines
|
||||
#define FXOS8700CQ_I2C_ADDR 0x1E
|
||||
#define FXOS8700CQ_XYZ_DATA_CFG_REG 0x0E
|
||||
#define FXOS8700CQ_CTRL_REG_1 0x2A
|
||||
#define FXOS8700CQ_DR_STATUS 0x0
|
||||
#define FXOS8700CQ_OUT_X_MSB 0x1
|
||||
#define FXOS8700CQ_OUT_Y_MSB 0x3
|
||||
#define FXOS8700CQ_OUT_Z_MSB 0x5
|
||||
|
||||
int read_acceleration(client interface i2c_master_if i2c, int axis) {
|
||||
i2c_regop_res_t result;
|
||||
|
||||
uint8_t msb_data = i2c.read_reg(FXOS8700CQ_I2C_ADDR, axis, result);
|
||||
if (result != I2C_REGOP_SUCCESS) {
|
||||
debug_printf("I2C read reg failed\n");
|
||||
return 0;
|
||||
}
|
||||
|
||||
uint8_t lsb_data = i2c.read_reg(FXOS8700CQ_I2C_ADDR, axis+1, result);
|
||||
if (result != I2C_REGOP_SUCCESS) {
|
||||
debug_printf("I2C read reg failed\n");
|
||||
return 0;
|
||||
}
|
||||
|
||||
int accel_val = (msb_data << 2) | (lsb_data >> 6);
|
||||
if (accel_val & 0x200) {
|
||||
accel_val -= 1023;
|
||||
}
|
||||
return accel_val;
|
||||
}
|
||||
|
||||
void accelerometer(client interface i2c_master_if i2c) {
|
||||
i2c_regop_res_t result;
|
||||
|
||||
// Configure FXOS8700CQ
|
||||
result = i2c.write_reg(FXOS8700CQ_I2C_ADDR, FXOS8700CQ_XYZ_DATA_CFG_REG, 0x01);
|
||||
|
||||
if (result != I2C_REGOP_SUCCESS) {
|
||||
debug_printf("I2C write reg failed\n");
|
||||
}
|
||||
|
||||
// Enable FXOS8700CQ
|
||||
result = i2c.write_reg(FXOS8700CQ_I2C_ADDR, FXOS8700CQ_CTRL_REG_1, 0x01);
|
||||
if (result != I2C_REGOP_SUCCESS) {
|
||||
debug_printf("I2C write reg failed\n");
|
||||
}
|
||||
|
||||
while (1) {
|
||||
// Wait for data ready from FXOS8700CQ
|
||||
char status_data = 0;
|
||||
do {
|
||||
status_data = i2c.read_reg(FXOS8700CQ_I2C_ADDR, FXOS8700CQ_DR_STATUS, result);
|
||||
} while (!status_data & 0x08);
|
||||
|
||||
int x = read_acceleration(i2c, FXOS8700CQ_OUT_X_MSB);
|
||||
int y = read_acceleration(i2c, FXOS8700CQ_OUT_Y_MSB);
|
||||
int z = read_acceleration(i2c, FXOS8700CQ_OUT_Z_MSB);
|
||||
|
||||
debug_printf("X = %d, Y = %d, Z = %d \r", x, y, z);
|
||||
}
|
||||
// End accelerometer
|
||||
}
|
||||
|
||||
int main(void) {
|
||||
i2c_master_if i2c[1];
|
||||
par {
|
||||
i2c_master(i2c, 1, p_scl, p_sda, 10);
|
||||
accelerometer(i2c[0]);
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
417
lib_i2c/examples/AN00157_i2c_slave_example/.cproject
Normal file
417
lib_i2c/examples/AN00157_i2c_slave_example/.cproject
Normal file
@@ -0,0 +1,417 @@
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
|
||||
<storageModule moduleId="org.eclipse.cdt.core.settings">
|
||||
<cconfiguration id="com.xmos.cdt.toolchain.1644196623">
|
||||
<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="com.xmos.cdt.toolchain.1644196623" moduleId="org.eclipse.cdt.core.settings" name="Default">
|
||||
<externalSettings/>
|
||||
<extensions>
|
||||
<extension id="com.xmos.cdt.core.XEBinaryParser" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GNU_ELF" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="com.xmos.cdt.core.XdeErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
</extensions>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<configuration buildProperties="" description="" id="com.xmos.cdt.toolchain.1644196623" name="Default" parent="org.eclipse.cdt.build.core.emptycfg">
|
||||
<folderInfo id="com.xmos.cdt.toolchain.1644196623.806610958" name="/" resourcePath="">
|
||||
<toolChain id="com.xmos.cdt.toolchain.1285456849" name="com.xmos.cdt.toolchain" superClass="com.xmos.cdt.toolchain">
|
||||
<targetPlatform archList="all" binaryParser="com.xmos.cdt.core.XEBinaryParser;org.eclipse.cdt.core.GNU_ELF" id="com.xmos.cdt.core.platform.1009064249" isAbstract="false" osList="linux,win32,macosx" superClass="com.xmos.cdt.core.platform"/>
|
||||
<builder arguments="CONFIG=Default" id="com.xmos.cdt.builder.base.300267421" keepEnvironmentInBuildfile="false" managedBuildOn="false" superClass="com.xmos.cdt.builder.base">
|
||||
<outputEntries>
|
||||
<entry flags="VALUE_WORKSPACE_PATH" kind="outputPath" name="bin"/>
|
||||
</outputEntries>
|
||||
</builder>
|
||||
<tool id="com.xmos.cdt.xc.compiler.1514633776" name="com.xmos.cdt.xc.compiler" superClass="com.xmos.cdt.xc.compiler">
|
||||
<option id="com.xmos.xc.compiler.option.include.paths.727347928" superClass="com.xmos.xc.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
<listOptionValue builtIn="false" value=""${XMOS_TOOL_PATH}/target/include/xc""/>
|
||||
<listOptionValue builtIn="false" value=""${XMOS_TOOL_PATH}/target/include""/>
|
||||
<listOptionValue builtIn="false" value=""${XMOS_TOOL_PATH}/target/include/clang""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/doc/rst}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/doc/pdf}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/doc}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/doc}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc/pdf}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/doc/rst}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc/rst}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/doc/pdf}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc/rst/images}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.xc.compiler.input.1769226104" name="XC" superClass="com.xmos.cdt.xc.compiler.input"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.c.compiler.1254245935" name="com.xmos.cdt.c.compiler" superClass="com.xmos.cdt.c.compiler">
|
||||
<option id="com.xmos.c.compiler.option.include.paths.297313376" superClass="com.xmos.c.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
<listOptionValue builtIn="false" value=""${XMOS_TOOL_PATH}/target/include""/>
|
||||
<listOptionValue builtIn="false" value=""${XMOS_TOOL_PATH}/target/include/clang""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/doc/rst}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/doc/pdf}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/doc}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/doc}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc/pdf}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/doc/rst}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc/rst}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/doc/pdf}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc/rst/images}""/>
|
||||
</option>
|
||||
<option id="com.xmos.c.compiler.option.defined.symbols.736792386" superClass="com.xmos.c.compiler.option.defined.symbols" valueType="definedSymbols">
|
||||
<listOptionValue builtIn="false" value="__llvm__=1"/>
|
||||
<listOptionValue builtIn="false" value="__clang__=1"/>
|
||||
<listOptionValue builtIn="false" value="__clang_major__=3"/>
|
||||
<listOptionValue builtIn="false" value="__clang_minor__=6"/>
|
||||
<listOptionValue builtIn="false" value="__clang_patchlevel__=0"/>
|
||||
<listOptionValue builtIn="false" value="__clang_version__="3.6.0"/>
|
||||
<listOptionValue builtIn="false" value="__GNUC_MINOR__=2"/>
|
||||
<listOptionValue builtIn="false" value="__GNUC_PATCHLEVEL__=1"/>
|
||||
<listOptionValue builtIn="false" value="__GNUC__=4"/>
|
||||
<listOptionValue builtIn="false" value="__GXX_ABI_VERSION=1002"/>
|
||||
<listOptionValue builtIn="false" value="__ATOMIC_RELAXED=0"/>
|
||||
<listOptionValue builtIn="false" value="__ATOMIC_CONSUME=1"/>
|
||||
<listOptionValue builtIn="false" value="__ATOMIC_ACQUIRE=2"/>
|
||||
<listOptionValue builtIn="false" value="__ATOMIC_RELEASE=3"/>
|
||||
<listOptionValue builtIn="false" value="__ATOMIC_ACQ_REL=4"/>
|
||||
<listOptionValue builtIn="false" value="__ATOMIC_SEQ_CST=5"/>
|
||||
<listOptionValue builtIn="false" value="__PRAGMA_REDEFINE_EXTNAME=1"/>
|
||||
<listOptionValue builtIn="false" value="__VERSION__="4.2.1"/>
|
||||
<listOptionValue builtIn="false" value="__CONSTANT_CFSTRINGS__=1"/>
|
||||
<listOptionValue builtIn="false" value="__GXX_RTTI=1"/>
|
||||
<listOptionValue builtIn="false" value="__ORDER_LITTLE_ENDIAN__=1234"/>
|
||||
<listOptionValue builtIn="false" value="__ORDER_BIG_ENDIAN__=4321"/>
|
||||
<listOptionValue builtIn="false" value="__ORDER_PDP_ENDIAN__=3412"/>
|
||||
<listOptionValue builtIn="false" value="__BYTE_ORDER__=__ORDER_LITTLE_ENDIAN__"/>
|
||||
<listOptionValue builtIn="false" value="__LITTLE_ENDIAN__=1"/>
|
||||
<listOptionValue builtIn="false" value="_ILP32=1"/>
|
||||
<listOptionValue builtIn="false" value="__ILP32__=1"/>
|
||||
<listOptionValue builtIn="false" value="__CHAR_BIT__=8"/>
|
||||
<listOptionValue builtIn="false" value="__SCHAR_MAX__=127"/>
|
||||
<listOptionValue builtIn="false" value="__SHRT_MAX__=32767"/>
|
||||
<listOptionValue builtIn="false" value="__INT_MAX__=2147483647"/>
|
||||
<listOptionValue builtIn="false" value="__LONG_MAX__=2147483647L"/>
|
||||
<listOptionValue builtIn="false" value="__LONG_LONG_MAX__=9223372036854775807LL"/>
|
||||
<listOptionValue builtIn="false" value="__WCHAR_MAX__=255"/>
|
||||
<listOptionValue builtIn="false" value="__INTMAX_MAX__=9223372036854775807LL"/>
|
||||
<listOptionValue builtIn="false" value="__SIZE_MAX__=4294967295U"/>
|
||||
<listOptionValue builtIn="false" value="__UINTMAX_MAX__=18446744073709551615ULL"/>
|
||||
<listOptionValue builtIn="false" value="__PTRDIFF_MAX__=2147483647"/>
|
||||
<listOptionValue builtIn="false" value="__INTPTR_MAX__=2147483647"/>
|
||||
<listOptionValue builtIn="false" value="__UINTPTR_MAX__=4294967295U"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_DOUBLE__=8"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_FLOAT__=4"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_INT__=4"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_LONG__=4"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_LONG_DOUBLE__=8"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_LONG_LONG__=8"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_POINTER__=4"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_SHORT__=2"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_PTRDIFF_T__=4"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_SIZE_T__=4"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_WCHAR_T__=1"/>
|
||||
<listOptionValue builtIn="false" value="__SIZEOF_WINT_T__=4"/>
|
||||
<listOptionValue builtIn="false" value="__INTMAX_TYPE__=long"/>
|
||||
<listOptionValue builtIn="false" value="__INTMAX_FMTd__="lld""/>
|
||||
<listOptionValue builtIn="false" value="__INTMAX_FMTi__="lli""/>
|
||||
<listOptionValue builtIn="false" value="__INTMAX_C_SUFFIX__=LL"/>
|
||||
<listOptionValue builtIn="false" value="__UINTMAX_TYPE__=long"/>
|
||||
<listOptionValue builtIn="false" value="__UINTMAX_FMTo__="llo""/>
|
||||
<listOptionValue builtIn="false" value="__UINTMAX_FMTu__="llu""/>
|
||||
<listOptionValue builtIn="false" value="__UINTMAX_FMTx__="llx""/>
|
||||
<listOptionValue builtIn="false" value="__UINTMAX_FMTX__="llX""/>
|
||||
<listOptionValue builtIn="false" value="__UINTMAX_C_SUFFIX__=ULL"/>
|
||||
<listOptionValue builtIn="false" value="__INTMAX_WIDTH__=64"/>
|
||||
<listOptionValue builtIn="false" value="__PTRDIFF_TYPE__=int"/>
|
||||
<listOptionValue builtIn="false" value="__PTRDIFF_FMTd__="d""/>
|
||||
<listOptionValue builtIn="false" value="__PTRDIFF_FMTi__="i""/>
|
||||
<listOptionValue builtIn="false" value="__PTRDIFF_WIDTH__=32"/>
|
||||
<listOptionValue builtIn="false" value="__INTPTR_TYPE__=int"/>
|
||||
<listOptionValue builtIn="false" value="__INTPTR_FMTd__="d""/>
|
||||
<listOptionValue builtIn="false" value="__INTPTR_FMTi__="i""/>
|
||||
<listOptionValue builtIn="false" value="__INTPTR_WIDTH__=32"/>
|
||||
<listOptionValue builtIn="false" value="__SIZE_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__SIZE_FMTo__="o""/>
|
||||
<listOptionValue builtIn="false" value="__SIZE_FMTu__="u""/>
|
||||
<listOptionValue builtIn="false" value="__SIZE_FMTx__="x""/>
|
||||
<listOptionValue builtIn="false" value="__SIZE_FMTX__="X""/>
|
||||
<listOptionValue builtIn="false" value="__SIZE_WIDTH__=32"/>
|
||||
<listOptionValue builtIn="false" value="__WCHAR_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__WCHAR_WIDTH__=8"/>
|
||||
<listOptionValue builtIn="false" value="__WINT_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__WINT_WIDTH__=32"/>
|
||||
<listOptionValue builtIn="false" value="__SIG_ATOMIC_WIDTH__=32"/>
|
||||
<listOptionValue builtIn="false" value="__SIG_ATOMIC_MAX__=2147483647"/>
|
||||
<listOptionValue builtIn="false" value="__CHAR16_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__CHAR32_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__UINTMAX_WIDTH__=64"/>
|
||||
<listOptionValue builtIn="false" value="__UINTPTR_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__UINTPTR_FMTo__="o""/>
|
||||
<listOptionValue builtIn="false" value="__UINTPTR_FMTu__="u""/>
|
||||
<listOptionValue builtIn="false" value="__UINTPTR_FMTx__="x""/>
|
||||
<listOptionValue builtIn="false" value="__UINTPTR_FMTX__="X""/>
|
||||
<listOptionValue builtIn="false" value="__UINTPTR_WIDTH__=32"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_DENORM_MIN__=1.40129846e-45F"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_HAS_DENORM__=1"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_DIG__=6"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_EPSILON__=1.19209290e-7F"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_HAS_INFINITY__=1"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_HAS_QUIET_NAN__=1"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_MANT_DIG__=24"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_MAX_10_EXP__=38"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_MAX_EXP__=128"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_MAX__=3.40282347e+38F"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_MIN_10_EXP__=(-37)"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_MIN_EXP__=(-125)"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_MIN__=1.17549435e-38F"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_DENORM_MIN__=4.9406564584124654e-324"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_HAS_DENORM__=1"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_DIG__=15"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_EPSILON__=2.2204460492503131e-16"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_HAS_INFINITY__=1"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_HAS_QUIET_NAN__=1"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_MANT_DIG__=53"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_MAX_10_EXP__=308"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_MAX_EXP__=1024"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_MAX__=1.7976931348623157e+308"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_MIN_10_EXP__=(-307)"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_MIN_EXP__=(-1021)"/>
|
||||
<listOptionValue builtIn="false" value="__DBL_MIN__=2.2250738585072014e-308"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_DENORM_MIN__=4.9406564584124654e-324L"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_HAS_DENORM__=1"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_DIG__=15"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_EPSILON__=2.2204460492503131e-16L"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_HAS_INFINITY__=1"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_HAS_QUIET_NAN__=1"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_MANT_DIG__=53"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_MAX_10_EXP__=308"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_MAX_EXP__=1024"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_MAX__=1.7976931348623157e+308L"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_MIN_10_EXP__=(-307)"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_MIN_EXP__=(-1021)"/>
|
||||
<listOptionValue builtIn="false" value="__LDBL_MIN__=2.2250738585072014e-308L"/>
|
||||
<listOptionValue builtIn="false" value="__POINTER_WIDTH__=32"/>
|
||||
<listOptionValue builtIn="false" value="__CHAR_UNSIGNED__=1"/>
|
||||
<listOptionValue builtIn="false" value="__WCHAR_UNSIGNED__=1"/>
|
||||
<listOptionValue builtIn="false" value="__WINT_UNSIGNED__=1"/>
|
||||
<listOptionValue builtIn="false" value="__INT8_TYPE__=signed"/>
|
||||
<listOptionValue builtIn="false" value="__INT8_FMTd__="hhd""/>
|
||||
<listOptionValue builtIn="false" value="__INT8_FMTi__="hhi""/>
|
||||
<listOptionValue builtIn="false" value="__INT8_C_SUFFIX__"/>
|
||||
<listOptionValue builtIn="false" value="__INT16_TYPE__=short"/>
|
||||
<listOptionValue builtIn="false" value="__INT16_FMTd__="hd""/>
|
||||
<listOptionValue builtIn="false" value="__INT16_FMTi__="hi""/>
|
||||
<listOptionValue builtIn="false" value="__INT16_C_SUFFIX__"/>
|
||||
<listOptionValue builtIn="false" value="__INT32_TYPE__=int"/>
|
||||
<listOptionValue builtIn="false" value="__INT32_FMTd__="d""/>
|
||||
<listOptionValue builtIn="false" value="__INT32_FMTi__="i""/>
|
||||
<listOptionValue builtIn="false" value="__INT32_C_SUFFIX__"/>
|
||||
<listOptionValue builtIn="false" value="__INT64_TYPE__=long"/>
|
||||
<listOptionValue builtIn="false" value="__INT64_FMTd__="lld""/>
|
||||
<listOptionValue builtIn="false" value="__INT64_FMTi__="lli""/>
|
||||
<listOptionValue builtIn="false" value="__INT64_C_SUFFIX__=LL"/>
|
||||
<listOptionValue builtIn="false" value="__UINT8_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__UINT8_FMTo__="hho""/>
|
||||
<listOptionValue builtIn="false" value="__UINT8_FMTu__="hhu""/>
|
||||
<listOptionValue builtIn="false" value="__UINT8_FMTx__="hhx""/>
|
||||
<listOptionValue builtIn="false" value="__UINT8_FMTX__="hhX""/>
|
||||
<listOptionValue builtIn="false" value="__UINT8_C_SUFFIX__"/>
|
||||
<listOptionValue builtIn="false" value="__UINT8_MAX__=255"/>
|
||||
<listOptionValue builtIn="false" value="__INT8_MAX__=127"/>
|
||||
<listOptionValue builtIn="false" value="__UINT16_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__UINT16_FMTo__="ho""/>
|
||||
<listOptionValue builtIn="false" value="__UINT16_FMTu__="hu""/>
|
||||
<listOptionValue builtIn="false" value="__UINT16_FMTx__="hx""/>
|
||||
<listOptionValue builtIn="false" value="__UINT16_FMTX__="hX""/>
|
||||
<listOptionValue builtIn="false" value="__UINT16_C_SUFFIX__"/>
|
||||
<listOptionValue builtIn="false" value="__UINT16_MAX__=65535"/>
|
||||
<listOptionValue builtIn="false" value="__INT16_MAX__=32767"/>
|
||||
<listOptionValue builtIn="false" value="__UINT32_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__UINT32_FMTo__="o""/>
|
||||
<listOptionValue builtIn="false" value="__UINT32_FMTu__="u""/>
|
||||
<listOptionValue builtIn="false" value="__UINT32_FMTx__="x""/>
|
||||
<listOptionValue builtIn="false" value="__UINT32_FMTX__="X""/>
|
||||
<listOptionValue builtIn="false" value="__UINT32_C_SUFFIX__=U"/>
|
||||
<listOptionValue builtIn="false" value="__UINT32_MAX__=4294967295U"/>
|
||||
<listOptionValue builtIn="false" value="__INT32_MAX__=2147483647"/>
|
||||
<listOptionValue builtIn="false" value="__UINT64_TYPE__=long"/>
|
||||
<listOptionValue builtIn="false" value="__UINT64_FMTo__="llo""/>
|
||||
<listOptionValue builtIn="false" value="__UINT64_FMTu__="llu""/>
|
||||
<listOptionValue builtIn="false" value="__UINT64_FMTx__="llx""/>
|
||||
<listOptionValue builtIn="false" value="__UINT64_FMTX__="llX""/>
|
||||
<listOptionValue builtIn="false" value="__UINT64_C_SUFFIX__=ULL"/>
|
||||
<listOptionValue builtIn="false" value="__UINT64_MAX__=18446744073709551615ULL"/>
|
||||
<listOptionValue builtIn="false" value="__INT64_MAX__=9223372036854775807LL"/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST8_TYPE__=signed"/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST8_MAX__=127"/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST8_FMTd__="hhd""/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST8_FMTi__="hhi""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST8_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST8_MAX__=255"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST8_FMTo__="hho""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST8_FMTu__="hhu""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST8_FMTx__="hhx""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST8_FMTX__="hhX""/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST16_TYPE__=short"/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST16_MAX__=32767"/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST16_FMTd__="hd""/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST16_FMTi__="hi""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST16_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST16_MAX__=65535"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST16_FMTo__="ho""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST16_FMTu__="hu""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST16_FMTx__="hx""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST16_FMTX__="hX""/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST32_TYPE__=int"/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST32_MAX__=2147483647"/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST32_FMTd__="d""/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST32_FMTi__="i""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST32_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST32_MAX__=4294967295U"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST32_FMTo__="o""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST32_FMTu__="u""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST32_FMTx__="x""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST32_FMTX__="X""/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST64_TYPE__=long"/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST64_MAX__=9223372036854775807LL"/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST64_FMTd__="lld""/>
|
||||
<listOptionValue builtIn="false" value="__INT_LEAST64_FMTi__="lli""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST64_TYPE__=long"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST64_MAX__=18446744073709551615ULL"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST64_FMTo__="llo""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST64_FMTu__="llu""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST64_FMTx__="llx""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_LEAST64_FMTX__="llX""/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST8_TYPE__=signed"/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST8_MAX__=127"/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST8_FMTd__="hhd""/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST8_FMTi__="hhi""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST8_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST8_MAX__=255"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST8_FMTo__="hho""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST8_FMTu__="hhu""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST8_FMTx__="hhx""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST8_FMTX__="hhX""/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST16_TYPE__=short"/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST16_MAX__=32767"/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST16_FMTd__="hd""/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST16_FMTi__="hi""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST16_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST16_MAX__=65535"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST16_FMTo__="ho""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST16_FMTu__="hu""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST16_FMTx__="hx""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST16_FMTX__="hX""/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST32_TYPE__=int"/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST32_MAX__=2147483647"/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST32_FMTd__="d""/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST32_FMTi__="i""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST32_TYPE__=unsigned"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST32_MAX__=4294967295U"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST32_FMTo__="o""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST32_FMTu__="u""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST32_FMTx__="x""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST32_FMTX__="X""/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST64_TYPE__=long"/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST64_MAX__=9223372036854775807LL"/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST64_FMTd__="lld""/>
|
||||
<listOptionValue builtIn="false" value="__INT_FAST64_FMTi__="lli""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST64_TYPE__=long"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST64_MAX__=18446744073709551615ULL"/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST64_FMTo__="llo""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST64_FMTu__="llu""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST64_FMTx__="llx""/>
|
||||
<listOptionValue builtIn="false" value="__UINT_FAST64_FMTX__="llX""/>
|
||||
<listOptionValue builtIn="false" value="__USER_LABEL_PREFIX__=_"/>
|
||||
<listOptionValue builtIn="false" value="__FINITE_MATH_ONLY__=0"/>
|
||||
<listOptionValue builtIn="false" value="__GNUC_STDC_INLINE__=1"/>
|
||||
<listOptionValue builtIn="false" value="__GCC_ATOMIC_TEST_AND_SET_TRUEVAL=1"/>
|
||||
<listOptionValue builtIn="false" value="__GCC_ATOMIC_BOOL_LOCK_FREE=1"/>
|
||||
<listOptionValue builtIn="false" value="__GCC_ATOMIC_CHAR_LOCK_FREE=1"/>
|
||||
<listOptionValue builtIn="false" value="__GCC_ATOMIC_CHAR16_T_LOCK_FREE=1"/>
|
||||
<listOptionValue builtIn="false" value="__GCC_ATOMIC_CHAR32_T_LOCK_FREE=1"/>
|
||||
<listOptionValue builtIn="false" value="__GCC_ATOMIC_WCHAR_T_LOCK_FREE=1"/>
|
||||
<listOptionValue builtIn="false" value="__GCC_ATOMIC_SHORT_LOCK_FREE=1"/>
|
||||
<listOptionValue builtIn="false" value="__GCC_ATOMIC_INT_LOCK_FREE=1"/>
|
||||
<listOptionValue builtIn="false" value="__GCC_ATOMIC_LONG_LOCK_FREE=1"/>
|
||||
<listOptionValue builtIn="false" value="__GCC_ATOMIC_LLONG_LOCK_FREE=1"/>
|
||||
<listOptionValue builtIn="false" value="__GCC_ATOMIC_POINTER_LOCK_FREE=1"/>
|
||||
<listOptionValue builtIn="false" value="__NO_INLINE__=1"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_EVAL_METHOD__=0"/>
|
||||
<listOptionValue builtIn="false" value="__FLT_RADIX__=2"/>
|
||||
<listOptionValue builtIn="false" value="__DECIMAL_DIG__=17"/>
|
||||
<listOptionValue builtIn="false" value="__xcore__=1"/>
|
||||
<listOptionValue builtIn="false" value="__XS1B__=1"/>
|
||||
<listOptionValue builtIn="false" value="__STDC__=1"/>
|
||||
<listOptionValue builtIn="false" value="__STDC_HOSTED__=1"/>
|
||||
<listOptionValue builtIn="false" value="__STDC_VERSION__=199901L"/>
|
||||
<listOptionValue builtIn="false" value="__STDC_UTF_16__=1"/>
|
||||
<listOptionValue builtIn="false" value="__STDC_UTF_32__=1"/>
|
||||
<listOptionValue builtIn="false" value="XCC_VERSION_YEAR=15"/>
|
||||
<listOptionValue builtIn="false" value="XCC_VERSION_MONTH=0"/>
|
||||
<listOptionValue builtIn="false" value="XCC_VERSION_MAJOR=1500"/>
|
||||
<listOptionValue builtIn="false" value="XCC_VERSION_MINOR=0"/>
|
||||
<listOptionValue builtIn="false" value="__XCC_HAVE_FLOAT__=1"/>
|
||||
<listOptionValue builtIn="false" value="_XSCOPE_PROBES_INCLUDE_FILE="/var/folders/xc/smwcb83n7gx3zxmpxy063rs00000gn/T//cckC36uT.h""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.c.compiler.input.c.1325795115" name="C" superClass="com.xmos.cdt.c.compiler.input.c"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.cxx.compiler.1576857003" name="com.xmos.cdt.cxx.compiler" superClass="com.xmos.cdt.cxx.compiler">
|
||||
<option id="com.xmos.cxx.compiler.option.include.paths.1532725263" superClass="com.xmos.cxx.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
<listOptionValue builtIn="false" value=""${XMOS_TOOL_PATH}/target/include""/>
|
||||
<listOptionValue builtIn="false" value=""${XMOS_TOOL_PATH}/target/include/clang""/>
|
||||
<listOptionValue builtIn="false" value=""${XMOS_TOOL_PATH}/target/include/c++/v1""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/doc/rst}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/doc/pdf}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/doc}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/doc}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc/pdf}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/doc/rst}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc/rst}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/doc/pdf}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/doc/rst/images}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.cxx.compiler.input.cpp.362248836" name="C++" superClass="com.xmos.cdt.cxx.compiler.input.cpp"/>
|
||||
</tool>
|
||||
</toolChain>
|
||||
</folderInfo>
|
||||
<sourceEntries>
|
||||
<entry excluding=".build*" flags="VALUE_WORKSPACE_PATH|RESOLVED" kind="sourcePath" name=""/>
|
||||
</sourceEntries>
|
||||
</configuration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.externalSettings"/>
|
||||
</cconfiguration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="scannerConfiguration">
|
||||
<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<project id="AN00157_i2c_slave_example.null.1815607668" name="AN00157_i2c_slave_example"/>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
|
||||
</cproject>
|
||||
42
lib_i2c/examples/AN00157_i2c_slave_example/.project
Normal file
42
lib_i2c/examples/AN00157_i2c_slave_example/.project
Normal file
@@ -0,0 +1,42 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<projectDescription>
|
||||
<name>AN00157_i2c_slave_example</name>
|
||||
<comment></comment>
|
||||
<projects>
|
||||
</projects>
|
||||
<buildSpec>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ModulePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.LegacyProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
|
||||
<triggers>clean,full,incremental,</triggers>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectInfoSyncBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
|
||||
<triggers>full,incremental,</triggers>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
</buildSpec>
|
||||
<natures>
|
||||
<nature>org.eclipse.cdt.core.cnature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
|
||||
<nature>com.xmos.cdt.core.XdeProjectNature</nature>
|
||||
</natures>
|
||||
</projectDescription>
|
||||
3
lib_i2c/examples/AN00157_i2c_slave_example/.xproject
Normal file
3
lib_i2c/examples/AN00157_i2c_slave_example/.xproject
Normal file
@@ -0,0 +1,3 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<xproject><version>1.0.3d0000000000</version>
|
||||
</xproject>
|
||||
84
lib_i2c/examples/AN00157_i2c_slave_example/LICENSE.rst
Normal file
84
lib_i2c/examples/AN00157_i2c_slave_example/LICENSE.rst
Normal file
@@ -0,0 +1,84 @@
|
||||
*******************************
|
||||
XMOS PUBLIC LICENCE: Version 1
|
||||
*******************************
|
||||
|
||||
Subject to the conditions and limitations below, permission is hereby granted by XMOS LIMITED (“XMOS”), free of charge, to any person or entity obtaining a copy of the XMOS Software.
|
||||
|
||||
**1. Definitions**
|
||||
|
||||
**“Applicable Patent Rights”** means: (a) where XMOS is the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to XMOS and (ii) that cover subject matter contained in the Software, but only to the extent it is necessary to use, reproduce or distribute the Software without infringement; and (b) where you are the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to you and (ii) that cover the subject matter contained in your Derivatives, taken alone or in combination with the Software.
|
||||
|
||||
**“Compiled Code”** means any compiled, binary, machine readable or executable version of the Source Code.
|
||||
|
||||
**“Contributor”** means any person or entity that creates or contributes to the creation of Derivatives.
|
||||
|
||||
**“Derivatives”** means any addition to, deletion from and/or change to the substance, structure of the Software, any previous Derivatives, the combination of the Derivatives and the Software and/or any respective portions thereof.
|
||||
|
||||
**“Source Code”** means the human readable code that is suitable for making modifications but excluding any Compiled Code.
|
||||
|
||||
**“Software”** means the software and associated documentation files which XMOS makes available and which contain a notice identifying the software as original XMOS software and referring to the software being subject to the terms of this XMOS Public Licence.
|
||||
|
||||
This Licence refers to XMOS Software and does not relate to any XMOS hardware or devices which are protected by intellectual property rights (including patent and trade marks) which may be sold to you under a separate agreement.
|
||||
|
||||
|
||||
**2. Licence**
|
||||
|
||||
**Permitted Uses, Conditions and Restrictions.** Subject to the conditions below, XMOS grants you a worldwide, royalty free, non-exclusive licence, to the extent of any Patent Rights to do the following:
|
||||
|
||||
2.1 **Unmodified Software.** You may use, copy, display, publish, distribute and make available unmodified copies of the Software:
|
||||
|
||||
2.1.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.1.2 for commercial purposes provided the Software is at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.1.1 and 2.1.2):
|
||||
|
||||
(a) you must retain and reproduce in all copies of the Software the copyright and proprietary notices and disclaimers of XMOS as they appear in the Software, and keep intact all notices and disclaimers in the Software files that refer to this Licence; and
|
||||
|
||||
(b) you must include a copy of this Licence with every copy of the Software and documentation you publish, distribute and make available and you may not offer or impose any terms on such Software that alter or restrict this Licence or the intent of such Licence, except as permitted below (Additional Terms).
|
||||
|
||||
The licence above does not include any Compiled Code which XMOS may make available under a separate support and licence agreement.
|
||||
|
||||
2.2 **Derivatives.** You may create and modify Derivatives and use, copy, display, publish, distribute and make available Derivatives:
|
||||
|
||||
2.2.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.2.2 for commercial purposes, provided the Derivatives are at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.2.1 and 2.2.2):
|
||||
|
||||
(a) you must comply with the terms of clause 2.1 with respect to the Derivatives;
|
||||
|
||||
(b) you must copy (to the extent it doesn’t already exist) the notice below in each file of the Derivatives, and ensure all the modified files carry prominent notices stating that you have changed the files and the date of any change; and
|
||||
|
||||
(c) if you sublicence, distribute or otherwise make the Software and/or the Derivatives available for commercial purposes, you must provide that the Software and Derivatives are at all times used on a device designed, licensed or developed by XMOS.
|
||||
|
||||
Without limitation to these terms and clause 3 below, the Source Code and Compiled Code to your Derivatives may at your discretion (but without obligation) be released, copied, displayed, published, distributed and made available; and if you elect to do so, it must be under the terms of this Licence including the terms of the licence at clauses 2.2.1, 2.2.2 and clause 3 below.
|
||||
|
||||
2.3 **Distribution of Executable Versions.** If you distribute or make available Derivatives, you must include a prominent notice in the code itself as well as in all related documentation, stating that the Source Code of the Software from which the Derivatives are based is available under the terms of this Licence, with information on how and where to obtain such Source Code.
|
||||
|
||||
**3. Your Grant of Rights.** In consideration and as a condition to this Licence, you grant to any person or entity receiving or distributing any Derivatives, a non-exclusive, royalty free, perpetual, irrevocable license under your Applicable Patent Rights and all other intellectual property rights owned or controlled by you, to use, copy, display, publish, distribute and make available your Derivatives of the same scope and extent as XMOS’s licence under clause 2.2 above.
|
||||
|
||||
**4. Combined Products.** You may create a combined product by combining Software, Derivatives and other code not covered by this Licence as a single application or product. In such instance, you must comply with the requirements of this Licence for any portion of the Software and/or Derivatives.
|
||||
|
||||
**5. Additional Terms.** You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations and/or other rights consistent with the term of this Licence (“Additional Terms”) to any legitimate recipients of the Software and/or Derivatives. The terms on which you provide such Additional Terms are on your sole responsibility and you shall indemnify, defend and hold XMOS harmless against any claims asserted against XMOS.
|
||||
|
||||
**6. New Versions.** XMOS may publish revised and/or new versions of this Licence from time to time to accommodate changes to the Licence terms, new versions, updates and bug fixes of the Software. Each version will be given a distinguishing version number. Once Software has been published under a particular version of this Licence, you may continue to use it under the terms of that version. You may also choose to use the latest version of the Software under any subsequent version published by XMOS. Only XMOS shall have the right to modify these terms.
|
||||
|
||||
**7. IPR and Ownership**
|
||||
Any rights, including all intellectual property rights and all trademarks not expressly granted herein are reserved in full by the authors or copyright holders. Any requests for additional permissions by XMOS including any rights to use XMOS trademarks, should be made (without obligation) to XMOS at **support@xmos.com**
|
||||
|
||||
Nothing herein shall limit any rights that XMOS is otherwise entitled to under the doctrines of patent exhaustion, implied license, or legal estoppel. Neither the name of the authors, the copyright holders or any contributors may be used to endorse or promote any Derivatives from this Software without specific written permission. Any attempt to deal with the Software which does not comply with this Licence shall be void and shall automatically terminate any rights granted under this licence (including any licence of any intellectual property rights granted herein).
|
||||
Subject to the licences granted under this Licence any Contributor retains all rights, title and interest in and to any Derivatives made by Contributor subject to the underlying rights of XMOS in the Software. XMOS shall retain all rights, title and interest in the Software and any Derivatives made by XMOS (“XMOS Derivatives”). XMOS Derivatives will not automatically be subject to this Licence and XMOS shall be entitled to licence such rights on any terms (without obligation) as it sees fit.
|
||||
|
||||
**8. Termination**
|
||||
|
||||
8.1 This Licence will automatically terminate immediately, without notice to you, if:
|
||||
|
||||
(a) you fail to comply with the terms of this Licence; and/or
|
||||
|
||||
(b) you directly or indirectly commence any action for patent or intellectual property right infringement against XMOS, or any parent, group, affiliate or subsidiary of XMOS; provided XMOS did not first commence an action or patent infringement against you in that instance; and/or
|
||||
|
||||
(c) the terms of this Licence are held by any court of competent jurisdiction to be unenforceable in whole or in part.
|
||||
|
||||
**9. Critical Applications.** Unless XMOS has agreed in writing with you an agreement specifically governing use of the Goods in military, aerospace, automotive or medically related functions (collectively and individually hereinafter referred to as "Special Use"), any permitted use of the Software excludes Special Use. Notwithstanding any agreement between XMOS and you for Special Use, Special Use shall be at your own risk, and you shall fully indemnify XMOS against any damages, losses, costs and claims (direct and indirect) arising out of any Special Use.
|
||||
|
||||
**10. NO WARRANTY OR SUPPORT.** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL XMOS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, WARRANTY, CIVIL TORT (INCLUDING NEGLIGENCE), PRODUCTS LIABILITY OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE INCLUDING GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF SUCH PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND NOT WITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE. IN SOME JURISDICTIONS PARTIES ARE UNABLE TO LIMIT LIABILTY IN THIS WAY, IF THIS APPLIES TO YOUR JURISDICTION THIS LIABILITY CLAUSE ABOVE MAY NOT APPLY. NOTWITHSTANDING THE ABOVE, IN NO EVENT SHALL XMOS’s TOTAL LIABILITY TO YOU FOR ALL DAMAGES, LOSS OR OTHERWISE EXCEED $50.
|
||||
|
||||
**11. Governing Law and Jurisdiction.** This Licence constitutes the entire agreement between the parties with respect to the subject matter hereof. The Licence shall be governed by the laws of England and the conflict of laws and UN Convention on Contracts for the International Sale of Goods, shall not apply.
|
||||
39
lib_i2c/examples/AN00157_i2c_slave_example/Makefile
Normal file
39
lib_i2c/examples/AN00157_i2c_slave_example/Makefile
Normal file
@@ -0,0 +1,39 @@
|
||||
# The flags passed to xcc when building the application
|
||||
# You can also set the following to override flags for a particular language:
|
||||
#
|
||||
# XCC_XC_FLAGS, XCC_C_FLAGS, XCC_ASM_FLAGS, XCC_CPP_FLAGS
|
||||
#
|
||||
# If the variable XCC_MAP_FLAGS is set it overrides the flags passed to
|
||||
# xcc for the final link (mapping) stage.
|
||||
|
||||
BUILD_FLAGS = -O2 -g -DDEBUG_PRINT_ENABLE=1 -report
|
||||
|
||||
XCOREAI ?= 0
|
||||
# The TARGET variable determines what target system the application is
|
||||
# compiled for. It either refers to an XN file in the source directories
|
||||
# or a valid argument for the --target option when compiling.
|
||||
ifeq ($(XCOREAI),0)
|
||||
XCC_FLAGS_xs2 = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-200-EXPLORER
|
||||
else
|
||||
XCC_FLAGS_xcoreai = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-AI-EXPLORER
|
||||
endif
|
||||
|
||||
|
||||
# The APP_NAME variable determines the name of the final .xe file. It should
|
||||
# not include the .xe postfix. If left blank the name will default to
|
||||
# the project name
|
||||
|
||||
APP_NAME =
|
||||
|
||||
# The USED_MODULES variable lists other module used by the application.
|
||||
|
||||
USED_MODULES = lib_i2c(>=6.0.0) lib_logging(>=2.1.0)
|
||||
|
||||
#=============================================================================
|
||||
# The following part of the Makefile includes the common build infrastructure
|
||||
# for compiling XMOS applications. You should not need to edit below here.
|
||||
|
||||
XMOS_MAKE_PATH ?= ../..
|
||||
include $(XMOS_MAKE_PATH)/xcommon/module_xcommon/build/Makefile.common
|
||||
33
lib_i2c/examples/AN00157_i2c_slave_example/README.rst
Normal file
33
lib_i2c/examples/AN00157_i2c_slave_example/README.rst
Normal file
@@ -0,0 +1,33 @@
|
||||
.. |I2C| replace:: I\ :sup:`2`\ C
|
||||
|
||||
How to use the I2C slave library
|
||||
================================
|
||||
|
||||
Summary
|
||||
-------
|
||||
|
||||
Software dependencies
|
||||
.....................
|
||||
|
||||
For a list of direct dependencies, look for USED_MODULES in the Makefile.
|
||||
|
||||
Required hardware
|
||||
.................
|
||||
There is no hardware requirement for this application note. It has been designed
|
||||
to run on the simulator using the loopback plugin.
|
||||
|
||||
Prerequisites
|
||||
.............
|
||||
|
||||
* This document assumes familarity with |I2C| interfaces, the XMOS xCORE
|
||||
architecture, the XMOS tool chain and the xC language. Documentation related
|
||||
to these aspects which are not specific to this application note are linked
|
||||
to in the references appendix.
|
||||
|
||||
* For a description of XMOS related terms found in this document
|
||||
please see the XMOS Glossary [#]_.
|
||||
|
||||
.. [#] http://www.xmos.com/published/glossary
|
||||
|
||||
|
||||
|
||||
183
lib_i2c/examples/AN00157_i2c_slave_example/src/main.xc
Normal file
183
lib_i2c/examples/AN00157_i2c_slave_example/src/main.xc
Normal file
@@ -0,0 +1,183 @@
|
||||
// Copyright 2014-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
#include <xs1.h>
|
||||
#include <syscall.h>
|
||||
|
||||
#include "i2c.h"
|
||||
#include "debug_print.h"
|
||||
|
||||
port p_slave_scl = XS1_PORT_1E;
|
||||
port p_slave_sda = XS1_PORT_1F;
|
||||
|
||||
port p_master_scl = XS1_PORT_1G;
|
||||
port p_master_sda = XS1_PORT_1H;
|
||||
|
||||
/*
|
||||
* Interface definition between user application and I2C slave register file
|
||||
*/
|
||||
typedef interface register_if {
|
||||
/* Set a register value
|
||||
*/
|
||||
void set_register(int regnum, uint8_t data);
|
||||
|
||||
/* Get a register value.
|
||||
*/
|
||||
uint8_t get_register(int regnum);
|
||||
|
||||
/* Get the number of the register that has changed
|
||||
* This will also clear the notification
|
||||
*/
|
||||
[[clears_notification]]
|
||||
unsigned get_changed_regnum();
|
||||
|
||||
/* Notification from the register file to the application that a register
|
||||
* value has changed
|
||||
*/
|
||||
[[notification]]
|
||||
slave void register_changed();
|
||||
} register_if;
|
||||
|
||||
#define NUM_REGISTERS 10
|
||||
|
||||
[[distributable]]
|
||||
void i2c_slave_register_file(server i2c_slave_callback_if i2c,
|
||||
server register_if app)
|
||||
{
|
||||
uint8_t registers[NUM_REGISTERS];
|
||||
|
||||
// This variable is set to -1 if no current register has been selected.
|
||||
// If the I2C master does a write transaction to select the register then
|
||||
// the variable will be updated to the register the master wants to
|
||||
// read/update.
|
||||
int current_regnum = -1;
|
||||
int changed_regnum = -1;
|
||||
while (1) {
|
||||
select {
|
||||
|
||||
// Handle application requests to get/set register values.
|
||||
case app.set_register(int regnum, uint8_t data):
|
||||
if (regnum >= 0 && regnum < NUM_REGISTERS) {
|
||||
registers[regnum] = data;
|
||||
}
|
||||
break;
|
||||
case app.get_register(int regnum) -> uint8_t data:
|
||||
if (regnum >= 0 && regnum < NUM_REGISTERS) {
|
||||
data = registers[regnum];
|
||||
} else {
|
||||
data = 0;
|
||||
}
|
||||
break;
|
||||
case app.get_changed_regnum() -> unsigned regnum:
|
||||
regnum = changed_regnum;
|
||||
break;
|
||||
|
||||
// Handle I2C slave transactions
|
||||
case i2c.ack_read_request(void) -> i2c_slave_ack_t response:
|
||||
// If no register has been selected using a previous write
|
||||
// transaction the NACK, otherwise ACK
|
||||
if (current_regnum == -1) {
|
||||
response = I2C_SLAVE_NACK;
|
||||
} else {
|
||||
response = I2C_SLAVE_ACK;
|
||||
}
|
||||
break;
|
||||
case i2c.ack_write_request(void) -> i2c_slave_ack_t response:
|
||||
// Write requests are always accepted
|
||||
response = I2C_SLAVE_ACK;
|
||||
break;
|
||||
case i2c.master_sent_data(uint8_t data) -> i2c_slave_ack_t response:
|
||||
// The master is trying to write, which will either select a register
|
||||
// or write to a previously selected register
|
||||
if (current_regnum != -1) {
|
||||
registers[current_regnum] = data;
|
||||
debug_printf("REGFILE: reg[%d] <- %x\n", current_regnum, data);
|
||||
|
||||
// Inform the user application that the register has changed
|
||||
changed_regnum = current_regnum;
|
||||
app.register_changed();
|
||||
|
||||
response = I2C_SLAVE_ACK;
|
||||
}
|
||||
else {
|
||||
if (data < NUM_REGISTERS) {
|
||||
current_regnum = data;
|
||||
debug_printf("REGFILE: select reg[%d]\n", current_regnum);
|
||||
response = I2C_SLAVE_ACK;
|
||||
} else {
|
||||
response = I2C_SLAVE_NACK;
|
||||
}
|
||||
}
|
||||
break;
|
||||
case i2c.master_requires_data() -> uint8_t data:
|
||||
// The master is trying to read, if a register is selected then
|
||||
// return the value (other return 0).
|
||||
if (current_regnum != -1) {
|
||||
data = registers[current_regnum];
|
||||
debug_printf("REGFILE: reg[%d] -> %x\n", current_regnum, data);
|
||||
} else {
|
||||
data = 0;
|
||||
}
|
||||
break;
|
||||
case i2c.stop_bit():
|
||||
// The I2C transaction has completed, clear the regnum
|
||||
debug_printf("REGFILE: stop_bit\n");
|
||||
current_regnum = -1;
|
||||
break;
|
||||
} // select
|
||||
}
|
||||
}
|
||||
|
||||
void slave_application(client register_if reg)
|
||||
{
|
||||
// Invert the data of any register that is written
|
||||
while (1) {
|
||||
select {
|
||||
case reg.register_changed():
|
||||
unsigned regnum = reg.get_changed_regnum();
|
||||
unsigned value = reg.get_register(regnum);
|
||||
debug_printf("SLAVE: Change register %d value from %x to %x\n",
|
||||
regnum, value, ~value & 0xff);
|
||||
reg.set_register(regnum, ~value);
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
void master_application(client interface i2c_master_if i2c, uint8_t device_addr)
|
||||
{
|
||||
i2c_regop_res_t reg_result;
|
||||
|
||||
// Write a single register
|
||||
reg_result = i2c.write_reg(device_addr, 0x03, 0x12);
|
||||
if (reg_result != I2C_REGOP_SUCCESS) {
|
||||
debug_printf("Write reg 0x03 failed!\n");
|
||||
}
|
||||
|
||||
// Read a single register and check the result
|
||||
uint8_t data = i2c.read_reg(device_addr, 0x03, reg_result);
|
||||
if (reg_result != I2C_REGOP_SUCCESS) {
|
||||
debug_printf("Read reg 0x03 failed!\n");
|
||||
}
|
||||
debug_printf("MASTER: Read from addr 0x%x, 0x%x %s (got 0x%x, expected 0x%x)\n",
|
||||
device_addr, 0x03, (data == 0xed) ? "SUCCESS" : "FAILED", data, 0xed);
|
||||
|
||||
// Test finished
|
||||
_exit(0);
|
||||
}
|
||||
|
||||
int main() {
|
||||
i2c_slave_callback_if i_i2c;
|
||||
register_if i_reg;
|
||||
i2c_master_if i2c[1];
|
||||
uint8_t device_addr = 0x3c;
|
||||
|
||||
par {
|
||||
i2c_slave_register_file(i_i2c, i_reg);
|
||||
i2c_slave(i_i2c, p_slave_scl, p_slave_sda, device_addr);
|
||||
slave_application(i_reg);
|
||||
|
||||
i2c_master(i2c, 1, p_master_scl, p_master_sda, 200);
|
||||
master_application(i2c[0], device_addr);
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
11
lib_i2c/examples/AN00157_i2c_slave_example/xvcd.xml
Normal file
11
lib_i2c/examples/AN00157_i2c_slave_example/xvcd.xml
Normal file
@@ -0,0 +1,11 @@
|
||||
<Xvcd zoomFactor="3.082876e+04" hScrollPos="0" vScrollPos="0" markerBarPos="7.201406e+05">
|
||||
<Signals>
|
||||
<Signal name="tile[0]_XS1_PORT_1F" radix="HEX"/>
|
||||
<Signal name="tile[0]_XS1_PORT_1E" radix="HEX"/>
|
||||
<Separator name="Direction"/>
|
||||
<Signal name="tile[0]_XS1_PORT_1E_direction" radix="HEX"/>
|
||||
<Signal name="tile[0]_XS1_PORT_1F_direction" radix="HEX"/>
|
||||
<Signal name="tile[0]_XS1_PORT_1G_direction" radix="HEX"/>
|
||||
<Signal name="tile[0]_XS1_PORT_1H_direction" radix="HEX"/>
|
||||
</Signals>
|
||||
</Xvcd>
|
||||
163
lib_i2c/examples/app_simple_asynchronous_master/.cproject
Normal file
163
lib_i2c/examples/app_simple_asynchronous_master/.cproject
Normal file
@@ -0,0 +1,163 @@
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
|
||||
<storageModule moduleId="org.eclipse.cdt.core.settings">
|
||||
<cconfiguration id="com.xmos.cdt.toolchain.868918528">
|
||||
<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="com.xmos.cdt.toolchain.868918528" moduleId="org.eclipse.cdt.core.settings" name="Default">
|
||||
<externalSettings/>
|
||||
<extensions>
|
||||
<extension id="com.xmos.cdt.core.XEBinaryParser" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GNU_ELF" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="com.xmos.cdt.core.XdeErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
</extensions>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<configuration buildProperties="" description="" id="com.xmos.cdt.toolchain.868918528" name="Default" parent="org.eclipse.cdt.build.core.emptycfg">
|
||||
<folderInfo id="com.xmos.cdt.toolchain.868918528.546105188" name="/" resourcePath="">
|
||||
<toolChain id="com.xmos.cdt.toolchain.1900008954" name="com.xmos.cdt.toolchain" superClass="com.xmos.cdt.toolchain">
|
||||
<targetPlatform archList="all" binaryParser="com.xmos.cdt.core.XEBinaryParser;org.eclipse.cdt.core.GNU_ELF" id="com.xmos.cdt.core.platform.2043843281" isAbstract="false" osList="linux,win32,macosx" superClass="com.xmos.cdt.core.platform"/>
|
||||
<builder arguments="CONFIG=Default" id="com.xmos.cdt.builder.base.146082949" keepEnvironmentInBuildfile="false" managedBuildOn="false" superClass="com.xmos.cdt.builder.base">
|
||||
<outputEntries>
|
||||
<entry flags="VALUE_WORKSPACE_PATH" kind="outputPath" name="bin"/>
|
||||
</outputEntries>
|
||||
</builder>
|
||||
<tool id="com.xmos.cdt.xc.compiler.59503268" name="com.xmos.cdt.xc.compiler" superClass="com.xmos.cdt.xc.compiler">
|
||||
<option id="com.xmos.xc.compiler.option.include.paths.1049064054" superClass="com.xmos.xc.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.xc.compiler.input.1844278341" name="XC" superClass="com.xmos.cdt.xc.compiler.input"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.c.compiler.1193858974" name="com.xmos.cdt.c.compiler" superClass="com.xmos.cdt.c.compiler">
|
||||
<option id="com.xmos.c.compiler.option.include.paths.917823278" superClass="com.xmos.c.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.c.compiler.input.c.916493242" name="C" superClass="com.xmos.cdt.c.compiler.input.c"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.cxx.compiler.454071458" name="com.xmos.cdt.cxx.compiler" superClass="com.xmos.cdt.cxx.compiler">
|
||||
<option id="com.xmos.cxx.compiler.option.include.paths.276177407" superClass="com.xmos.cxx.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.cxx.compiler.input.cpp.1714156048" name="C++" superClass="com.xmos.cdt.cxx.compiler.input.cpp"/>
|
||||
</tool>
|
||||
</toolChain>
|
||||
</folderInfo>
|
||||
<sourceEntries>
|
||||
<entry excluding=".build*" flags="VALUE_WORKSPACE_PATH|RESOLVED" kind="sourcePath" name=""/>
|
||||
</sourceEntries>
|
||||
</configuration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.externalSettings"/>
|
||||
</cconfiguration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="scannerConfiguration">
|
||||
<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerFileProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="makefileGenerator">
|
||||
<runAction arguments="-E -P -v -dD" command="" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.cpp" command="g++" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.c" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/${specs_file}"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'g++ -E -P -v -dD "${plugin_state_location}/specs.cpp"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/specs.c"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<project id="AN00156_i2c_master_example.null.1035655509" name="AN00156_i2c_master_example"/>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
|
||||
</cproject>
|
||||
116
lib_i2c/examples/app_simple_asynchronous_master/.project
Normal file
116
lib_i2c/examples/app_simple_asynchronous_master/.project
Normal file
@@ -0,0 +1,116 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<projectDescription>
|
||||
<name>AN00156_i2c_master_example</name>
|
||||
<comment></comment>
|
||||
<projects>
|
||||
</projects>
|
||||
<buildSpec>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.LegacyProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectInfoSyncBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.BuildMarkersBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.IncludePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ModulePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
|
||||
<triggers>clean,full,incremental,</triggers>
|
||||
<arguments>
|
||||
<dictionary>
|
||||
<key>?children?</key>
|
||||
<value>?name?=outputEntries\|?children?=?name?=entry\\\\|\\|\||</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>?name?</key>
|
||||
<value></value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.append_environment</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildArguments</key>
|
||||
<value>CONFIG=Debug</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildCommand</key>
|
||||
<value>xmake</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.cleanBuildTarget</key>
|
||||
<value>clean</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.contents</key>
|
||||
<value>org.eclipse.cdt.make.core.activeConfigSettings</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableAutoBuild</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableCleanBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableFullBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.stopOnError</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.useDefaultBuildCmd</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
|
||||
<triggers>full,incremental,</triggers>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
</buildSpec>
|
||||
<natures>
|
||||
<nature>org.eclipse.cdt.core.cnature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
|
||||
<nature>com.xmos.cdt.core.XdeProjectNature</nature>
|
||||
</natures>
|
||||
<filteredResources>
|
||||
<filter>
|
||||
<id>1406010377704</id>
|
||||
<name></name>
|
||||
<type>26</type>
|
||||
<matcher>
|
||||
<id>org.eclipse.ui.ide.multiFilter</id>
|
||||
<arguments>1.0-name-matches-false-false-.build*</arguments>
|
||||
</matcher>
|
||||
</filter>
|
||||
</filteredResources>
|
||||
</projectDescription>
|
||||
@@ -0,0 +1,3 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<xproject><version>1.0.3d0000000000</version>
|
||||
</xproject>
|
||||
84
lib_i2c/examples/app_simple_asynchronous_master/LICENSE.rst
Normal file
84
lib_i2c/examples/app_simple_asynchronous_master/LICENSE.rst
Normal file
@@ -0,0 +1,84 @@
|
||||
*******************************
|
||||
XMOS PUBLIC LICENCE: Version 1
|
||||
*******************************
|
||||
|
||||
Subject to the conditions and limitations below, permission is hereby granted by XMOS LIMITED (“XMOS”), free of charge, to any person or entity obtaining a copy of the XMOS Software.
|
||||
|
||||
**1. Definitions**
|
||||
|
||||
**“Applicable Patent Rights”** means: (a) where XMOS is the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to XMOS and (ii) that cover subject matter contained in the Software, but only to the extent it is necessary to use, reproduce or distribute the Software without infringement; and (b) where you are the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to you and (ii) that cover the subject matter contained in your Derivatives, taken alone or in combination with the Software.
|
||||
|
||||
**“Compiled Code”** means any compiled, binary, machine readable or executable version of the Source Code.
|
||||
|
||||
**“Contributor”** means any person or entity that creates or contributes to the creation of Derivatives.
|
||||
|
||||
**“Derivatives”** means any addition to, deletion from and/or change to the substance, structure of the Software, any previous Derivatives, the combination of the Derivatives and the Software and/or any respective portions thereof.
|
||||
|
||||
**“Source Code”** means the human readable code that is suitable for making modifications but excluding any Compiled Code.
|
||||
|
||||
**“Software”** means the software and associated documentation files which XMOS makes available and which contain a notice identifying the software as original XMOS software and referring to the software being subject to the terms of this XMOS Public Licence.
|
||||
|
||||
This Licence refers to XMOS Software and does not relate to any XMOS hardware or devices which are protected by intellectual property rights (including patent and trade marks) which may be sold to you under a separate agreement.
|
||||
|
||||
|
||||
**2. Licence**
|
||||
|
||||
**Permitted Uses, Conditions and Restrictions.** Subject to the conditions below, XMOS grants you a worldwide, royalty free, non-exclusive licence, to the extent of any Patent Rights to do the following:
|
||||
|
||||
2.1 **Unmodified Software.** You may use, copy, display, publish, distribute and make available unmodified copies of the Software:
|
||||
|
||||
2.1.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.1.2 for commercial purposes provided the Software is at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.1.1 and 2.1.2):
|
||||
|
||||
(a) you must retain and reproduce in all copies of the Software the copyright and proprietary notices and disclaimers of XMOS as they appear in the Software, and keep intact all notices and disclaimers in the Software files that refer to this Licence; and
|
||||
|
||||
(b) you must include a copy of this Licence with every copy of the Software and documentation you publish, distribute and make available and you may not offer or impose any terms on such Software that alter or restrict this Licence or the intent of such Licence, except as permitted below (Additional Terms).
|
||||
|
||||
The licence above does not include any Compiled Code which XMOS may make available under a separate support and licence agreement.
|
||||
|
||||
2.2 **Derivatives.** You may create and modify Derivatives and use, copy, display, publish, distribute and make available Derivatives:
|
||||
|
||||
2.2.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.2.2 for commercial purposes, provided the Derivatives are at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.2.1 and 2.2.2):
|
||||
|
||||
(a) you must comply with the terms of clause 2.1 with respect to the Derivatives;
|
||||
|
||||
(b) you must copy (to the extent it doesn’t already exist) the notice below in each file of the Derivatives, and ensure all the modified files carry prominent notices stating that you have changed the files and the date of any change; and
|
||||
|
||||
(c) if you sublicence, distribute or otherwise make the Software and/or the Derivatives available for commercial purposes, you must provide that the Software and Derivatives are at all times used on a device designed, licensed or developed by XMOS.
|
||||
|
||||
Without limitation to these terms and clause 3 below, the Source Code and Compiled Code to your Derivatives may at your discretion (but without obligation) be released, copied, displayed, published, distributed and made available; and if you elect to do so, it must be under the terms of this Licence including the terms of the licence at clauses 2.2.1, 2.2.2 and clause 3 below.
|
||||
|
||||
2.3 **Distribution of Executable Versions.** If you distribute or make available Derivatives, you must include a prominent notice in the code itself as well as in all related documentation, stating that the Source Code of the Software from which the Derivatives are based is available under the terms of this Licence, with information on how and where to obtain such Source Code.
|
||||
|
||||
**3. Your Grant of Rights.** In consideration and as a condition to this Licence, you grant to any person or entity receiving or distributing any Derivatives, a non-exclusive, royalty free, perpetual, irrevocable license under your Applicable Patent Rights and all other intellectual property rights owned or controlled by you, to use, copy, display, publish, distribute and make available your Derivatives of the same scope and extent as XMOS’s licence under clause 2.2 above.
|
||||
|
||||
**4. Combined Products.** You may create a combined product by combining Software, Derivatives and other code not covered by this Licence as a single application or product. In such instance, you must comply with the requirements of this Licence for any portion of the Software and/or Derivatives.
|
||||
|
||||
**5. Additional Terms.** You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations and/or other rights consistent with the term of this Licence (“Additional Terms”) to any legitimate recipients of the Software and/or Derivatives. The terms on which you provide such Additional Terms are on your sole responsibility and you shall indemnify, defend and hold XMOS harmless against any claims asserted against XMOS.
|
||||
|
||||
**6. New Versions.** XMOS may publish revised and/or new versions of this Licence from time to time to accommodate changes to the Licence terms, new versions, updates and bug fixes of the Software. Each version will be given a distinguishing version number. Once Software has been published under a particular version of this Licence, you may continue to use it under the terms of that version. You may also choose to use the latest version of the Software under any subsequent version published by XMOS. Only XMOS shall have the right to modify these terms.
|
||||
|
||||
**7. IPR and Ownership**
|
||||
Any rights, including all intellectual property rights and all trademarks not expressly granted herein are reserved in full by the authors or copyright holders. Any requests for additional permissions by XMOS including any rights to use XMOS trademarks, should be made (without obligation) to XMOS at **support@xmos.com**
|
||||
|
||||
Nothing herein shall limit any rights that XMOS is otherwise entitled to under the doctrines of patent exhaustion, implied license, or legal estoppel. Neither the name of the authors, the copyright holders or any contributors may be used to endorse or promote any Derivatives from this Software without specific written permission. Any attempt to deal with the Software which does not comply with this Licence shall be void and shall automatically terminate any rights granted under this licence (including any licence of any intellectual property rights granted herein).
|
||||
Subject to the licences granted under this Licence any Contributor retains all rights, title and interest in and to any Derivatives made by Contributor subject to the underlying rights of XMOS in the Software. XMOS shall retain all rights, title and interest in the Software and any Derivatives made by XMOS (“XMOS Derivatives”). XMOS Derivatives will not automatically be subject to this Licence and XMOS shall be entitled to licence such rights on any terms (without obligation) as it sees fit.
|
||||
|
||||
**8. Termination**
|
||||
|
||||
8.1 This Licence will automatically terminate immediately, without notice to you, if:
|
||||
|
||||
(a) you fail to comply with the terms of this Licence; and/or
|
||||
|
||||
(b) you directly or indirectly commence any action for patent or intellectual property right infringement against XMOS, or any parent, group, affiliate or subsidiary of XMOS; provided XMOS did not first commence an action or patent infringement against you in that instance; and/or
|
||||
|
||||
(c) the terms of this Licence are held by any court of competent jurisdiction to be unenforceable in whole or in part.
|
||||
|
||||
**9. Critical Applications.** Unless XMOS has agreed in writing with you an agreement specifically governing use of the Goods in military, aerospace, automotive or medically related functions (collectively and individually hereinafter referred to as "Special Use"), any permitted use of the Software excludes Special Use. Notwithstanding any agreement between XMOS and you for Special Use, Special Use shall be at your own risk, and you shall fully indemnify XMOS against any damages, losses, costs and claims (direct and indirect) arising out of any Special Use.
|
||||
|
||||
**10. NO WARRANTY OR SUPPORT.** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL XMOS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, WARRANTY, CIVIL TORT (INCLUDING NEGLIGENCE), PRODUCTS LIABILITY OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE INCLUDING GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF SUCH PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND NOT WITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE. IN SOME JURISDICTIONS PARTIES ARE UNABLE TO LIMIT LIABILTY IN THIS WAY, IF THIS APPLIES TO YOUR JURISDICTION THIS LIABILITY CLAUSE ABOVE MAY NOT APPLY. NOTWITHSTANDING THE ABOVE, IN NO EVENT SHALL XMOS’s TOTAL LIABILITY TO YOU FOR ALL DAMAGES, LOSS OR OTHERWISE EXCEED $50.
|
||||
|
||||
**11. Governing Law and Jurisdiction.** This Licence constitutes the entire agreement between the parties with respect to the subject matter hereof. The Licence shall be governed by the laws of England and the conflict of laws and UN Convention on Contracts for the International Sale of Goods, shall not apply.
|
||||
40
lib_i2c/examples/app_simple_asynchronous_master/Makefile
Normal file
40
lib_i2c/examples/app_simple_asynchronous_master/Makefile
Normal file
@@ -0,0 +1,40 @@
|
||||
XCOREAI ?= 0
|
||||
|
||||
# The APP_NAME variable determines the name of the final .xe file. It should
|
||||
# not include the .xe postfix. If left blank the name will default to
|
||||
# the project name
|
||||
|
||||
APP_NAME =
|
||||
|
||||
# The flags passed to xcc when building the application
|
||||
# You can also set the following to override flags for a particular language:
|
||||
#
|
||||
# XCC_XC_FLAGS, XCC_C_FLAGS, XCC_ASM_FLAGS, XCC_CPP_FLAGS
|
||||
#
|
||||
# If the variable XCC_MAP_FLAGS is set it overrides the flags passed to
|
||||
# xcc for the final link (mapping) stage.
|
||||
|
||||
BUILD_FLAGS = -O2 -g -DDEBUG_PRINT_ENABLE=1 -report
|
||||
|
||||
# The TARGET variable determines what target system the application is
|
||||
# compiled for. It either refers to an XN file in the source directories
|
||||
# or a valid argument for the --target option when compiling.
|
||||
ifeq ($(XCOREAI),0)
|
||||
XCC_FLAGS_xs2 = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-200-EXPLORER
|
||||
else
|
||||
XCC_FLAGS_xcoreai = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-AI-EXPLORER
|
||||
endif
|
||||
|
||||
|
||||
# The USED_MODULES variable lists other module used by the application.
|
||||
|
||||
USED_MODULES = lib_i2c(>=6.0.0) lib_logging(>=2.1.0)
|
||||
|
||||
#=============================================================================
|
||||
# The following part of the Makefile includes the common build infrastructure
|
||||
# for compiling XMOS applications. You should not need to edit below here.
|
||||
|
||||
XMOS_MAKE_PATH ?= ../..
|
||||
include $(XMOS_MAKE_PATH)/xcommon/module_xcommon/build/Makefile.common
|
||||
@@ -0,0 +1,75 @@
|
||||
// Copyright 2018-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
|
||||
/* A simple application example used for code snippets in the library
|
||||
* documentation.
|
||||
*/
|
||||
|
||||
#include <xs1.h>
|
||||
#include <stdio.h>
|
||||
#include "i2c.h"
|
||||
|
||||
void my_application(client i2c_master_async_if i2c, uint8_t target_device_addr);
|
||||
void my_application_handle_bus_error(i2c_res_t result);
|
||||
void my_application_fill_buffer(uint8_t buffer[]);
|
||||
|
||||
// I2C interface ports
|
||||
port p_scl = XS1_PORT_1E;
|
||||
port p_sda = XS1_PORT_1F;
|
||||
|
||||
#define BUFFER_BYTES 100
|
||||
|
||||
int main(void) {
|
||||
i2c_master_async_if i2c[1];
|
||||
static const uint8_t target_device_addr = 0x3c;
|
||||
|
||||
par {
|
||||
i2c_master_async(i2c, 1, p_scl, p_sda, 100, BUFFER_BYTES);
|
||||
my_application(i2c[0], target_device_addr);
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
void my_application(client i2c_master_async_if i2c, uint8_t target_device_addr) {
|
||||
uint8_t buffer[BUFFER_BYTES];
|
||||
|
||||
// Create and send initial block of data
|
||||
my_application_fill_buffer(buffer);
|
||||
i2c.write(target_device_addr, buffer, BUFFER_BYTES, 1);
|
||||
|
||||
// Start computing the next block of data
|
||||
my_application_fill_buffer(buffer);
|
||||
|
||||
while (1) {
|
||||
select {
|
||||
case i2c.operation_complete():
|
||||
size_t num_bytes_sent;
|
||||
i2c_res_t result = i2c.get_write_result(num_bytes_sent);
|
||||
if (num_bytes_sent != BUFFER_BYTES) {
|
||||
my_application_handle_bus_error(result);
|
||||
}
|
||||
|
||||
// Offload the next data bytes to be sent
|
||||
i2c.write(target_device_addr, buffer, BUFFER_BYTES, 1);
|
||||
|
||||
// Compute the next block of data
|
||||
my_application_fill_buffer(buffer);
|
||||
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
void my_application_handle_bus_error(i2c_res_t result) {
|
||||
// Ignore for now
|
||||
}
|
||||
|
||||
void my_application_fill_buffer(uint8_t buffer[]) {
|
||||
static int offset = 0;
|
||||
for (int i = 0; i < BUFFER_BYTES; ++i) {
|
||||
buffer[i] = i + offset;
|
||||
}
|
||||
offset += 1;
|
||||
}
|
||||
|
||||
// end
|
||||
163
lib_i2c/examples/app_simple_repeated_start_master/.cproject
Normal file
163
lib_i2c/examples/app_simple_repeated_start_master/.cproject
Normal file
@@ -0,0 +1,163 @@
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
|
||||
<storageModule moduleId="org.eclipse.cdt.core.settings">
|
||||
<cconfiguration id="com.xmos.cdt.toolchain.868918528">
|
||||
<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="com.xmos.cdt.toolchain.868918528" moduleId="org.eclipse.cdt.core.settings" name="Default">
|
||||
<externalSettings/>
|
||||
<extensions>
|
||||
<extension id="com.xmos.cdt.core.XEBinaryParser" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GNU_ELF" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="com.xmos.cdt.core.XdeErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
</extensions>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<configuration buildProperties="" description="" id="com.xmos.cdt.toolchain.868918528" name="Default" parent="org.eclipse.cdt.build.core.emptycfg">
|
||||
<folderInfo id="com.xmos.cdt.toolchain.868918528.546105188" name="/" resourcePath="">
|
||||
<toolChain id="com.xmos.cdt.toolchain.1900008954" name="com.xmos.cdt.toolchain" superClass="com.xmos.cdt.toolchain">
|
||||
<targetPlatform archList="all" binaryParser="com.xmos.cdt.core.XEBinaryParser;org.eclipse.cdt.core.GNU_ELF" id="com.xmos.cdt.core.platform.2043843281" isAbstract="false" osList="linux,win32,macosx" superClass="com.xmos.cdt.core.platform"/>
|
||||
<builder arguments="CONFIG=Default" id="com.xmos.cdt.builder.base.146082949" keepEnvironmentInBuildfile="false" managedBuildOn="false" superClass="com.xmos.cdt.builder.base">
|
||||
<outputEntries>
|
||||
<entry flags="VALUE_WORKSPACE_PATH" kind="outputPath" name="bin"/>
|
||||
</outputEntries>
|
||||
</builder>
|
||||
<tool id="com.xmos.cdt.xc.compiler.59503268" name="com.xmos.cdt.xc.compiler" superClass="com.xmos.cdt.xc.compiler">
|
||||
<option id="com.xmos.xc.compiler.option.include.paths.1049064054" superClass="com.xmos.xc.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.xc.compiler.input.1844278341" name="XC" superClass="com.xmos.cdt.xc.compiler.input"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.c.compiler.1193858974" name="com.xmos.cdt.c.compiler" superClass="com.xmos.cdt.c.compiler">
|
||||
<option id="com.xmos.c.compiler.option.include.paths.917823278" superClass="com.xmos.c.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.c.compiler.input.c.916493242" name="C" superClass="com.xmos.cdt.c.compiler.input.c"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.cxx.compiler.454071458" name="com.xmos.cdt.cxx.compiler" superClass="com.xmos.cdt.cxx.compiler">
|
||||
<option id="com.xmos.cxx.compiler.option.include.paths.276177407" superClass="com.xmos.cxx.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.cxx.compiler.input.cpp.1714156048" name="C++" superClass="com.xmos.cdt.cxx.compiler.input.cpp"/>
|
||||
</tool>
|
||||
</toolChain>
|
||||
</folderInfo>
|
||||
<sourceEntries>
|
||||
<entry excluding=".build*" flags="VALUE_WORKSPACE_PATH|RESOLVED" kind="sourcePath" name=""/>
|
||||
</sourceEntries>
|
||||
</configuration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.externalSettings"/>
|
||||
</cconfiguration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="scannerConfiguration">
|
||||
<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerFileProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="makefileGenerator">
|
||||
<runAction arguments="-E -P -v -dD" command="" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.cpp" command="g++" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.c" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/${specs_file}"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'g++ -E -P -v -dD "${plugin_state_location}/specs.cpp"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/specs.c"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<project id="AN00156_i2c_master_example.null.1035655509" name="AN00156_i2c_master_example"/>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
|
||||
</cproject>
|
||||
116
lib_i2c/examples/app_simple_repeated_start_master/.project
Normal file
116
lib_i2c/examples/app_simple_repeated_start_master/.project
Normal file
@@ -0,0 +1,116 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<projectDescription>
|
||||
<name>AN00156_i2c_master_example</name>
|
||||
<comment></comment>
|
||||
<projects>
|
||||
</projects>
|
||||
<buildSpec>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.LegacyProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectInfoSyncBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.BuildMarkersBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.IncludePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ModulePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
|
||||
<triggers>clean,full,incremental,</triggers>
|
||||
<arguments>
|
||||
<dictionary>
|
||||
<key>?children?</key>
|
||||
<value>?name?=outputEntries\|?children?=?name?=entry\\\\|\\|\||</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>?name?</key>
|
||||
<value></value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.append_environment</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildArguments</key>
|
||||
<value>CONFIG=Debug</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildCommand</key>
|
||||
<value>xmake</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.cleanBuildTarget</key>
|
||||
<value>clean</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.contents</key>
|
||||
<value>org.eclipse.cdt.make.core.activeConfigSettings</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableAutoBuild</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableCleanBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableFullBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.stopOnError</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.useDefaultBuildCmd</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
|
||||
<triggers>full,incremental,</triggers>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
</buildSpec>
|
||||
<natures>
|
||||
<nature>org.eclipse.cdt.core.cnature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
|
||||
<nature>com.xmos.cdt.core.XdeProjectNature</nature>
|
||||
</natures>
|
||||
<filteredResources>
|
||||
<filter>
|
||||
<id>1406010377704</id>
|
||||
<name></name>
|
||||
<type>26</type>
|
||||
<matcher>
|
||||
<id>org.eclipse.ui.ide.multiFilter</id>
|
||||
<arguments>1.0-name-matches-false-false-.build*</arguments>
|
||||
</matcher>
|
||||
</filter>
|
||||
</filteredResources>
|
||||
</projectDescription>
|
||||
@@ -0,0 +1,3 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<xproject><version>1.0.3d0000000000</version>
|
||||
</xproject>
|
||||
@@ -0,0 +1,84 @@
|
||||
*******************************
|
||||
XMOS PUBLIC LICENCE: Version 1
|
||||
*******************************
|
||||
|
||||
Subject to the conditions and limitations below, permission is hereby granted by XMOS LIMITED (“XMOS”), free of charge, to any person or entity obtaining a copy of the XMOS Software.
|
||||
|
||||
**1. Definitions**
|
||||
|
||||
**“Applicable Patent Rights”** means: (a) where XMOS is the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to XMOS and (ii) that cover subject matter contained in the Software, but only to the extent it is necessary to use, reproduce or distribute the Software without infringement; and (b) where you are the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to you and (ii) that cover the subject matter contained in your Derivatives, taken alone or in combination with the Software.
|
||||
|
||||
**“Compiled Code”** means any compiled, binary, machine readable or executable version of the Source Code.
|
||||
|
||||
**“Contributor”** means any person or entity that creates or contributes to the creation of Derivatives.
|
||||
|
||||
**“Derivatives”** means any addition to, deletion from and/or change to the substance, structure of the Software, any previous Derivatives, the combination of the Derivatives and the Software and/or any respective portions thereof.
|
||||
|
||||
**“Source Code”** means the human readable code that is suitable for making modifications but excluding any Compiled Code.
|
||||
|
||||
**“Software”** means the software and associated documentation files which XMOS makes available and which contain a notice identifying the software as original XMOS software and referring to the software being subject to the terms of this XMOS Public Licence.
|
||||
|
||||
This Licence refers to XMOS Software and does not relate to any XMOS hardware or devices which are protected by intellectual property rights (including patent and trade marks) which may be sold to you under a separate agreement.
|
||||
|
||||
|
||||
**2. Licence**
|
||||
|
||||
**Permitted Uses, Conditions and Restrictions.** Subject to the conditions below, XMOS grants you a worldwide, royalty free, non-exclusive licence, to the extent of any Patent Rights to do the following:
|
||||
|
||||
2.1 **Unmodified Software.** You may use, copy, display, publish, distribute and make available unmodified copies of the Software:
|
||||
|
||||
2.1.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.1.2 for commercial purposes provided the Software is at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.1.1 and 2.1.2):
|
||||
|
||||
(a) you must retain and reproduce in all copies of the Software the copyright and proprietary notices and disclaimers of XMOS as they appear in the Software, and keep intact all notices and disclaimers in the Software files that refer to this Licence; and
|
||||
|
||||
(b) you must include a copy of this Licence with every copy of the Software and documentation you publish, distribute and make available and you may not offer or impose any terms on such Software that alter or restrict this Licence or the intent of such Licence, except as permitted below (Additional Terms).
|
||||
|
||||
The licence above does not include any Compiled Code which XMOS may make available under a separate support and licence agreement.
|
||||
|
||||
2.2 **Derivatives.** You may create and modify Derivatives and use, copy, display, publish, distribute and make available Derivatives:
|
||||
|
||||
2.2.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.2.2 for commercial purposes, provided the Derivatives are at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.2.1 and 2.2.2):
|
||||
|
||||
(a) you must comply with the terms of clause 2.1 with respect to the Derivatives;
|
||||
|
||||
(b) you must copy (to the extent it doesn’t already exist) the notice below in each file of the Derivatives, and ensure all the modified files carry prominent notices stating that you have changed the files and the date of any change; and
|
||||
|
||||
(c) if you sublicence, distribute or otherwise make the Software and/or the Derivatives available for commercial purposes, you must provide that the Software and Derivatives are at all times used on a device designed, licensed or developed by XMOS.
|
||||
|
||||
Without limitation to these terms and clause 3 below, the Source Code and Compiled Code to your Derivatives may at your discretion (but without obligation) be released, copied, displayed, published, distributed and made available; and if you elect to do so, it must be under the terms of this Licence including the terms of the licence at clauses 2.2.1, 2.2.2 and clause 3 below.
|
||||
|
||||
2.3 **Distribution of Executable Versions.** If you distribute or make available Derivatives, you must include a prominent notice in the code itself as well as in all related documentation, stating that the Source Code of the Software from which the Derivatives are based is available under the terms of this Licence, with information on how and where to obtain such Source Code.
|
||||
|
||||
**3. Your Grant of Rights.** In consideration and as a condition to this Licence, you grant to any person or entity receiving or distributing any Derivatives, a non-exclusive, royalty free, perpetual, irrevocable license under your Applicable Patent Rights and all other intellectual property rights owned or controlled by you, to use, copy, display, publish, distribute and make available your Derivatives of the same scope and extent as XMOS’s licence under clause 2.2 above.
|
||||
|
||||
**4. Combined Products.** You may create a combined product by combining Software, Derivatives and other code not covered by this Licence as a single application or product. In such instance, you must comply with the requirements of this Licence for any portion of the Software and/or Derivatives.
|
||||
|
||||
**5. Additional Terms.** You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations and/or other rights consistent with the term of this Licence (“Additional Terms”) to any legitimate recipients of the Software and/or Derivatives. The terms on which you provide such Additional Terms are on your sole responsibility and you shall indemnify, defend and hold XMOS harmless against any claims asserted against XMOS.
|
||||
|
||||
**6. New Versions.** XMOS may publish revised and/or new versions of this Licence from time to time to accommodate changes to the Licence terms, new versions, updates and bug fixes of the Software. Each version will be given a distinguishing version number. Once Software has been published under a particular version of this Licence, you may continue to use it under the terms of that version. You may also choose to use the latest version of the Software under any subsequent version published by XMOS. Only XMOS shall have the right to modify these terms.
|
||||
|
||||
**7. IPR and Ownership**
|
||||
Any rights, including all intellectual property rights and all trademarks not expressly granted herein are reserved in full by the authors or copyright holders. Any requests for additional permissions by XMOS including any rights to use XMOS trademarks, should be made (without obligation) to XMOS at **support@xmos.com**
|
||||
|
||||
Nothing herein shall limit any rights that XMOS is otherwise entitled to under the doctrines of patent exhaustion, implied license, or legal estoppel. Neither the name of the authors, the copyright holders or any contributors may be used to endorse or promote any Derivatives from this Software without specific written permission. Any attempt to deal with the Software which does not comply with this Licence shall be void and shall automatically terminate any rights granted under this licence (including any licence of any intellectual property rights granted herein).
|
||||
Subject to the licences granted under this Licence any Contributor retains all rights, title and interest in and to any Derivatives made by Contributor subject to the underlying rights of XMOS in the Software. XMOS shall retain all rights, title and interest in the Software and any Derivatives made by XMOS (“XMOS Derivatives”). XMOS Derivatives will not automatically be subject to this Licence and XMOS shall be entitled to licence such rights on any terms (without obligation) as it sees fit.
|
||||
|
||||
**8. Termination**
|
||||
|
||||
8.1 This Licence will automatically terminate immediately, without notice to you, if:
|
||||
|
||||
(a) you fail to comply with the terms of this Licence; and/or
|
||||
|
||||
(b) you directly or indirectly commence any action for patent or intellectual property right infringement against XMOS, or any parent, group, affiliate or subsidiary of XMOS; provided XMOS did not first commence an action or patent infringement against you in that instance; and/or
|
||||
|
||||
(c) the terms of this Licence are held by any court of competent jurisdiction to be unenforceable in whole or in part.
|
||||
|
||||
**9. Critical Applications.** Unless XMOS has agreed in writing with you an agreement specifically governing use of the Goods in military, aerospace, automotive or medically related functions (collectively and individually hereinafter referred to as "Special Use"), any permitted use of the Software excludes Special Use. Notwithstanding any agreement between XMOS and you for Special Use, Special Use shall be at your own risk, and you shall fully indemnify XMOS against any damages, losses, costs and claims (direct and indirect) arising out of any Special Use.
|
||||
|
||||
**10. NO WARRANTY OR SUPPORT.** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL XMOS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, WARRANTY, CIVIL TORT (INCLUDING NEGLIGENCE), PRODUCTS LIABILITY OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE INCLUDING GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF SUCH PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND NOT WITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE. IN SOME JURISDICTIONS PARTIES ARE UNABLE TO LIMIT LIABILTY IN THIS WAY, IF THIS APPLIES TO YOUR JURISDICTION THIS LIABILITY CLAUSE ABOVE MAY NOT APPLY. NOTWITHSTANDING THE ABOVE, IN NO EVENT SHALL XMOS’s TOTAL LIABILITY TO YOU FOR ALL DAMAGES, LOSS OR OTHERWISE EXCEED $50.
|
||||
|
||||
**11. Governing Law and Jurisdiction.** This Licence constitutes the entire agreement between the parties with respect to the subject matter hereof. The Licence shall be governed by the laws of England and the conflict of laws and UN Convention on Contracts for the International Sale of Goods, shall not apply.
|
||||
39
lib_i2c/examples/app_simple_repeated_start_master/Makefile
Normal file
39
lib_i2c/examples/app_simple_repeated_start_master/Makefile
Normal file
@@ -0,0 +1,39 @@
|
||||
XCOREAI ?= 0
|
||||
|
||||
# The APP_NAME variable determines the name of the final .xe file. It should
|
||||
# not include the .xe postfix. If left blank the name will default to
|
||||
# the project name
|
||||
|
||||
APP_NAME =
|
||||
|
||||
# The flags passed to xcc when building the application
|
||||
# You can also set the following to override flags for a particular language:
|
||||
#
|
||||
# XCC_XC_FLAGS, XCC_C_FLAGS, XCC_ASM_FLAGS, XCC_CPP_FLAGS
|
||||
#
|
||||
# If the variable XCC_MAP_FLAGS is set it overrides the flags passed to
|
||||
# xcc for the final link (mapping) stage.
|
||||
|
||||
BUILD_FLAGS = -O2 -g -DDEBUG_PRINT_ENABLE=1 -report
|
||||
|
||||
# The TARGET variable determines what target system the application is
|
||||
# compiled for. It either refers to an XN file in the source directories
|
||||
# or a valid argument for the --target option when compiling.
|
||||
ifeq ($(XCOREAI),0)
|
||||
XCC_FLAGS_xs2 = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-200-EXPLORER
|
||||
else
|
||||
XCC_FLAGS_xcoreai = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-AI-EXPLORER
|
||||
endif
|
||||
|
||||
# The USED_MODULES variable lists other module used by the application.
|
||||
|
||||
USED_MODULES = lib_i2c(>=6.0.0) lib_logging(>=2.1.0)
|
||||
|
||||
#=============================================================================
|
||||
# The following part of the Makefile includes the common build infrastructure
|
||||
# for compiling XMOS applications. You should not need to edit below here.
|
||||
|
||||
XMOS_MAKE_PATH ?= ../..
|
||||
include $(XMOS_MAKE_PATH)/xcommon/module_xcommon/build/Makefile.common
|
||||
@@ -0,0 +1,41 @@
|
||||
// Copyright 2018-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
|
||||
/* A simple application example used for code snippets in the library
|
||||
* documentation.
|
||||
*/
|
||||
|
||||
#include <xs1.h>
|
||||
#include <stdio.h>
|
||||
#include "i2c.h"
|
||||
|
||||
void my_application(client i2c_master_if i2c, uint8_t target_device_addr);
|
||||
|
||||
// I2C interface ports
|
||||
port p_scl = XS1_PORT_1E;
|
||||
port p_sda = XS1_PORT_1F;
|
||||
|
||||
static const uint8_t target_device_addr = 0x3c;
|
||||
|
||||
int main(void) {
|
||||
i2c_master_if i2c[1];
|
||||
par {
|
||||
i2c_master(i2c, 1, p_scl, p_sda, 100);
|
||||
my_application(i2c[0], target_device_addr);
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
void my_application(client i2c_master_if i2c, uint8_t target_device_addr) {
|
||||
uint8_t data[2] = { 0x1, 0x2 };
|
||||
size_t num_bytes_sent = 0;
|
||||
|
||||
// Do a write operation with no stop bit
|
||||
i2c.write(target_device_addr, data, 2, num_bytes_sent, 0);
|
||||
|
||||
// This operation will begin with a repeated start bit
|
||||
i2c.read(target_device_addr, data, 2, 1);
|
||||
printf("Read data %d, %d from the bus.\n", data[0], data[1]);
|
||||
}
|
||||
|
||||
// end
|
||||
163
lib_i2c/examples/app_simple_single_port_master/.cproject
Normal file
163
lib_i2c/examples/app_simple_single_port_master/.cproject
Normal file
@@ -0,0 +1,163 @@
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
|
||||
<storageModule moduleId="org.eclipse.cdt.core.settings">
|
||||
<cconfiguration id="com.xmos.cdt.toolchain.868918528">
|
||||
<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="com.xmos.cdt.toolchain.868918528" moduleId="org.eclipse.cdt.core.settings" name="Default">
|
||||
<externalSettings/>
|
||||
<extensions>
|
||||
<extension id="com.xmos.cdt.core.XEBinaryParser" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GNU_ELF" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="com.xmos.cdt.core.XdeErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
</extensions>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<configuration buildProperties="" description="" id="com.xmos.cdt.toolchain.868918528" name="Default" parent="org.eclipse.cdt.build.core.emptycfg">
|
||||
<folderInfo id="com.xmos.cdt.toolchain.868918528.546105188" name="/" resourcePath="">
|
||||
<toolChain id="com.xmos.cdt.toolchain.1900008954" name="com.xmos.cdt.toolchain" superClass="com.xmos.cdt.toolchain">
|
||||
<targetPlatform archList="all" binaryParser="com.xmos.cdt.core.XEBinaryParser;org.eclipse.cdt.core.GNU_ELF" id="com.xmos.cdt.core.platform.2043843281" isAbstract="false" osList="linux,win32,macosx" superClass="com.xmos.cdt.core.platform"/>
|
||||
<builder arguments="CONFIG=Default" id="com.xmos.cdt.builder.base.146082949" keepEnvironmentInBuildfile="false" managedBuildOn="false" superClass="com.xmos.cdt.builder.base">
|
||||
<outputEntries>
|
||||
<entry flags="VALUE_WORKSPACE_PATH" kind="outputPath" name="bin"/>
|
||||
</outputEntries>
|
||||
</builder>
|
||||
<tool id="com.xmos.cdt.xc.compiler.59503268" name="com.xmos.cdt.xc.compiler" superClass="com.xmos.cdt.xc.compiler">
|
||||
<option id="com.xmos.xc.compiler.option.include.paths.1049064054" superClass="com.xmos.xc.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.xc.compiler.input.1844278341" name="XC" superClass="com.xmos.cdt.xc.compiler.input"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.c.compiler.1193858974" name="com.xmos.cdt.c.compiler" superClass="com.xmos.cdt.c.compiler">
|
||||
<option id="com.xmos.c.compiler.option.include.paths.917823278" superClass="com.xmos.c.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.c.compiler.input.c.916493242" name="C" superClass="com.xmos.cdt.c.compiler.input.c"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.cxx.compiler.454071458" name="com.xmos.cdt.cxx.compiler" superClass="com.xmos.cdt.cxx.compiler">
|
||||
<option id="com.xmos.cxx.compiler.option.include.paths.276177407" superClass="com.xmos.cxx.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.cxx.compiler.input.cpp.1714156048" name="C++" superClass="com.xmos.cdt.cxx.compiler.input.cpp"/>
|
||||
</tool>
|
||||
</toolChain>
|
||||
</folderInfo>
|
||||
<sourceEntries>
|
||||
<entry excluding=".build*" flags="VALUE_WORKSPACE_PATH|RESOLVED" kind="sourcePath" name=""/>
|
||||
</sourceEntries>
|
||||
</configuration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.externalSettings"/>
|
||||
</cconfiguration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="scannerConfiguration">
|
||||
<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerFileProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="makefileGenerator">
|
||||
<runAction arguments="-E -P -v -dD" command="" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.cpp" command="g++" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.c" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/${specs_file}"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'g++ -E -P -v -dD "${plugin_state_location}/specs.cpp"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/specs.c"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<project id="AN00156_i2c_master_example.null.1035655509" name="AN00156_i2c_master_example"/>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
|
||||
</cproject>
|
||||
116
lib_i2c/examples/app_simple_single_port_master/.project
Normal file
116
lib_i2c/examples/app_simple_single_port_master/.project
Normal file
@@ -0,0 +1,116 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<projectDescription>
|
||||
<name>AN00156_i2c_master_example</name>
|
||||
<comment></comment>
|
||||
<projects>
|
||||
</projects>
|
||||
<buildSpec>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.LegacyProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectInfoSyncBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.BuildMarkersBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.IncludePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ModulePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
|
||||
<triggers>clean,full,incremental,</triggers>
|
||||
<arguments>
|
||||
<dictionary>
|
||||
<key>?children?</key>
|
||||
<value>?name?=outputEntries\|?children?=?name?=entry\\\\|\\|\||</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>?name?</key>
|
||||
<value></value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.append_environment</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildArguments</key>
|
||||
<value>CONFIG=Debug</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildCommand</key>
|
||||
<value>xmake</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.cleanBuildTarget</key>
|
||||
<value>clean</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.contents</key>
|
||||
<value>org.eclipse.cdt.make.core.activeConfigSettings</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableAutoBuild</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableCleanBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableFullBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.stopOnError</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.useDefaultBuildCmd</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
|
||||
<triggers>full,incremental,</triggers>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
</buildSpec>
|
||||
<natures>
|
||||
<nature>org.eclipse.cdt.core.cnature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
|
||||
<nature>com.xmos.cdt.core.XdeProjectNature</nature>
|
||||
</natures>
|
||||
<filteredResources>
|
||||
<filter>
|
||||
<id>1406010377704</id>
|
||||
<name></name>
|
||||
<type>26</type>
|
||||
<matcher>
|
||||
<id>org.eclipse.ui.ide.multiFilter</id>
|
||||
<arguments>1.0-name-matches-false-false-.build*</arguments>
|
||||
</matcher>
|
||||
</filter>
|
||||
</filteredResources>
|
||||
</projectDescription>
|
||||
3
lib_i2c/examples/app_simple_single_port_master/.xproject
Normal file
3
lib_i2c/examples/app_simple_single_port_master/.xproject
Normal file
@@ -0,0 +1,3 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<xproject><version>1.0.3d0000000000</version>
|
||||
</xproject>
|
||||
84
lib_i2c/examples/app_simple_single_port_master/LICENSE.rst
Normal file
84
lib_i2c/examples/app_simple_single_port_master/LICENSE.rst
Normal file
@@ -0,0 +1,84 @@
|
||||
*******************************
|
||||
XMOS PUBLIC LICENCE: Version 1
|
||||
*******************************
|
||||
|
||||
Subject to the conditions and limitations below, permission is hereby granted by XMOS LIMITED (“XMOS”), free of charge, to any person or entity obtaining a copy of the XMOS Software.
|
||||
|
||||
**1. Definitions**
|
||||
|
||||
**“Applicable Patent Rights”** means: (a) where XMOS is the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to XMOS and (ii) that cover subject matter contained in the Software, but only to the extent it is necessary to use, reproduce or distribute the Software without infringement; and (b) where you are the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to you and (ii) that cover the subject matter contained in your Derivatives, taken alone or in combination with the Software.
|
||||
|
||||
**“Compiled Code”** means any compiled, binary, machine readable or executable version of the Source Code.
|
||||
|
||||
**“Contributor”** means any person or entity that creates or contributes to the creation of Derivatives.
|
||||
|
||||
**“Derivatives”** means any addition to, deletion from and/or change to the substance, structure of the Software, any previous Derivatives, the combination of the Derivatives and the Software and/or any respective portions thereof.
|
||||
|
||||
**“Source Code”** means the human readable code that is suitable for making modifications but excluding any Compiled Code.
|
||||
|
||||
**“Software”** means the software and associated documentation files which XMOS makes available and which contain a notice identifying the software as original XMOS software and referring to the software being subject to the terms of this XMOS Public Licence.
|
||||
|
||||
This Licence refers to XMOS Software and does not relate to any XMOS hardware or devices which are protected by intellectual property rights (including patent and trade marks) which may be sold to you under a separate agreement.
|
||||
|
||||
|
||||
**2. Licence**
|
||||
|
||||
**Permitted Uses, Conditions and Restrictions.** Subject to the conditions below, XMOS grants you a worldwide, royalty free, non-exclusive licence, to the extent of any Patent Rights to do the following:
|
||||
|
||||
2.1 **Unmodified Software.** You may use, copy, display, publish, distribute and make available unmodified copies of the Software:
|
||||
|
||||
2.1.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.1.2 for commercial purposes provided the Software is at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.1.1 and 2.1.2):
|
||||
|
||||
(a) you must retain and reproduce in all copies of the Software the copyright and proprietary notices and disclaimers of XMOS as they appear in the Software, and keep intact all notices and disclaimers in the Software files that refer to this Licence; and
|
||||
|
||||
(b) you must include a copy of this Licence with every copy of the Software and documentation you publish, distribute and make available and you may not offer or impose any terms on such Software that alter or restrict this Licence or the intent of such Licence, except as permitted below (Additional Terms).
|
||||
|
||||
The licence above does not include any Compiled Code which XMOS may make available under a separate support and licence agreement.
|
||||
|
||||
2.2 **Derivatives.** You may create and modify Derivatives and use, copy, display, publish, distribute and make available Derivatives:
|
||||
|
||||
2.2.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.2.2 for commercial purposes, provided the Derivatives are at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.2.1 and 2.2.2):
|
||||
|
||||
(a) you must comply with the terms of clause 2.1 with respect to the Derivatives;
|
||||
|
||||
(b) you must copy (to the extent it doesn’t already exist) the notice below in each file of the Derivatives, and ensure all the modified files carry prominent notices stating that you have changed the files and the date of any change; and
|
||||
|
||||
(c) if you sublicence, distribute or otherwise make the Software and/or the Derivatives available for commercial purposes, you must provide that the Software and Derivatives are at all times used on a device designed, licensed or developed by XMOS.
|
||||
|
||||
Without limitation to these terms and clause 3 below, the Source Code and Compiled Code to your Derivatives may at your discretion (but without obligation) be released, copied, displayed, published, distributed and made available; and if you elect to do so, it must be under the terms of this Licence including the terms of the licence at clauses 2.2.1, 2.2.2 and clause 3 below.
|
||||
|
||||
2.3 **Distribution of Executable Versions.** If you distribute or make available Derivatives, you must include a prominent notice in the code itself as well as in all related documentation, stating that the Source Code of the Software from which the Derivatives are based is available under the terms of this Licence, with information on how and where to obtain such Source Code.
|
||||
|
||||
**3. Your Grant of Rights.** In consideration and as a condition to this Licence, you grant to any person or entity receiving or distributing any Derivatives, a non-exclusive, royalty free, perpetual, irrevocable license under your Applicable Patent Rights and all other intellectual property rights owned or controlled by you, to use, copy, display, publish, distribute and make available your Derivatives of the same scope and extent as XMOS’s licence under clause 2.2 above.
|
||||
|
||||
**4. Combined Products.** You may create a combined product by combining Software, Derivatives and other code not covered by this Licence as a single application or product. In such instance, you must comply with the requirements of this Licence for any portion of the Software and/or Derivatives.
|
||||
|
||||
**5. Additional Terms.** You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations and/or other rights consistent with the term of this Licence (“Additional Terms”) to any legitimate recipients of the Software and/or Derivatives. The terms on which you provide such Additional Terms are on your sole responsibility and you shall indemnify, defend and hold XMOS harmless against any claims asserted against XMOS.
|
||||
|
||||
**6. New Versions.** XMOS may publish revised and/or new versions of this Licence from time to time to accommodate changes to the Licence terms, new versions, updates and bug fixes of the Software. Each version will be given a distinguishing version number. Once Software has been published under a particular version of this Licence, you may continue to use it under the terms of that version. You may also choose to use the latest version of the Software under any subsequent version published by XMOS. Only XMOS shall have the right to modify these terms.
|
||||
|
||||
**7. IPR and Ownership**
|
||||
Any rights, including all intellectual property rights and all trademarks not expressly granted herein are reserved in full by the authors or copyright holders. Any requests for additional permissions by XMOS including any rights to use XMOS trademarks, should be made (without obligation) to XMOS at **support@xmos.com**
|
||||
|
||||
Nothing herein shall limit any rights that XMOS is otherwise entitled to under the doctrines of patent exhaustion, implied license, or legal estoppel. Neither the name of the authors, the copyright holders or any contributors may be used to endorse or promote any Derivatives from this Software without specific written permission. Any attempt to deal with the Software which does not comply with this Licence shall be void and shall automatically terminate any rights granted under this licence (including any licence of any intellectual property rights granted herein).
|
||||
Subject to the licences granted under this Licence any Contributor retains all rights, title and interest in and to any Derivatives made by Contributor subject to the underlying rights of XMOS in the Software. XMOS shall retain all rights, title and interest in the Software and any Derivatives made by XMOS (“XMOS Derivatives”). XMOS Derivatives will not automatically be subject to this Licence and XMOS shall be entitled to licence such rights on any terms (without obligation) as it sees fit.
|
||||
|
||||
**8. Termination**
|
||||
|
||||
8.1 This Licence will automatically terminate immediately, without notice to you, if:
|
||||
|
||||
(a) you fail to comply with the terms of this Licence; and/or
|
||||
|
||||
(b) you directly or indirectly commence any action for patent or intellectual property right infringement against XMOS, or any parent, group, affiliate or subsidiary of XMOS; provided XMOS did not first commence an action or patent infringement against you in that instance; and/or
|
||||
|
||||
(c) the terms of this Licence are held by any court of competent jurisdiction to be unenforceable in whole or in part.
|
||||
|
||||
**9. Critical Applications.** Unless XMOS has agreed in writing with you an agreement specifically governing use of the Goods in military, aerospace, automotive or medically related functions (collectively and individually hereinafter referred to as "Special Use"), any permitted use of the Software excludes Special Use. Notwithstanding any agreement between XMOS and you for Special Use, Special Use shall be at your own risk, and you shall fully indemnify XMOS against any damages, losses, costs and claims (direct and indirect) arising out of any Special Use.
|
||||
|
||||
**10. NO WARRANTY OR SUPPORT.** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL XMOS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, WARRANTY, CIVIL TORT (INCLUDING NEGLIGENCE), PRODUCTS LIABILITY OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE INCLUDING GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF SUCH PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND NOT WITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE. IN SOME JURISDICTIONS PARTIES ARE UNABLE TO LIMIT LIABILTY IN THIS WAY, IF THIS APPLIES TO YOUR JURISDICTION THIS LIABILITY CLAUSE ABOVE MAY NOT APPLY. NOTWITHSTANDING THE ABOVE, IN NO EVENT SHALL XMOS’s TOTAL LIABILITY TO YOU FOR ALL DAMAGES, LOSS OR OTHERWISE EXCEED $50.
|
||||
|
||||
**11. Governing Law and Jurisdiction.** This Licence constitutes the entire agreement between the parties with respect to the subject matter hereof. The Licence shall be governed by the laws of England and the conflict of laws and UN Convention on Contracts for the International Sale of Goods, shall not apply.
|
||||
41
lib_i2c/examples/app_simple_single_port_master/Makefile
Normal file
41
lib_i2c/examples/app_simple_single_port_master/Makefile
Normal file
@@ -0,0 +1,41 @@
|
||||
XCOREAI ?= 0
|
||||
|
||||
# The APP_NAME variable determines the name of the final .xe file. It should
|
||||
# not include the .xe postfix. If left blank the name will default to
|
||||
# the project name
|
||||
|
||||
APP_NAME =
|
||||
|
||||
# The flags passed to xcc when building the application
|
||||
# You can also set the following to override flags for a particular language:
|
||||
#
|
||||
# XCC_XC_FLAGS, XCC_C_FLAGS, XCC_ASM_FLAGS, XCC_CPP_FLAGS
|
||||
#
|
||||
# If the variable XCC_MAP_FLAGS is set it overrides the flags passed to
|
||||
# xcc for the final link (mapping) stage.
|
||||
|
||||
BUILD_FLAGS = -O2 -g -DDEBUG_PRINT_ENABLE=1 -report
|
||||
|
||||
# The TARGET variable determines what target system the application is
|
||||
# compiled for. It either refers to an XN file in the source directories
|
||||
# or a valid argument for the --target option when compiling.
|
||||
ifeq ($(XCOREAI),0)
|
||||
XCC_FLAGS_xs2 = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-200-EXPLORER
|
||||
else
|
||||
XCC_FLAGS_xcoreai = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-AI-EXPLORER
|
||||
endif
|
||||
|
||||
|
||||
|
||||
# The USED_MODULES variable lists other module used by the application.
|
||||
|
||||
USED_MODULES = lib_i2c(>=6.0.0) lib_logging(>=2.1.0)
|
||||
|
||||
#=============================================================================
|
||||
# The following part of the Makefile includes the common build infrastructure
|
||||
# for compiling XMOS applications. You should not need to edit below here.
|
||||
|
||||
XMOS_MAKE_PATH ?= ../..
|
||||
include $(XMOS_MAKE_PATH)/xcommon/module_xcommon/build/Makefile.common
|
||||
@@ -0,0 +1,34 @@
|
||||
// Copyright 2018-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
|
||||
/* A simple application example used for code snippets in the library
|
||||
* documentation.
|
||||
*/
|
||||
|
||||
#include <xs1.h>
|
||||
#include <stdio.h>
|
||||
#include "i2c.h"
|
||||
|
||||
void my_application(client i2c_master_if i2c, uint8_t target_device_addr);
|
||||
|
||||
// I2C interface ports
|
||||
port p_i2c = XS1_PORT_4C;
|
||||
|
||||
int main(void) {
|
||||
i2c_master_if i2c[1];
|
||||
static const uint8_t target_device_addr = 0x3c;
|
||||
|
||||
par {
|
||||
i2c_master_single_port(i2c, 1, p_i2c, 100, 1, 3, 0);
|
||||
my_application(i2c[0], target_device_addr);
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
void my_application(client i2c_master_if i2c, uint8_t target_device_addr) {
|
||||
uint8_t data[2];
|
||||
i2c.read(target_device_addr, data, 2, 1);
|
||||
printf("Read data %d, %d from the bus.\n", data[0], data[1]);
|
||||
}
|
||||
|
||||
// end
|
||||
163
lib_i2c/examples/app_simple_slave/.cproject
Normal file
163
lib_i2c/examples/app_simple_slave/.cproject
Normal file
@@ -0,0 +1,163 @@
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
|
||||
<storageModule moduleId="org.eclipse.cdt.core.settings">
|
||||
<cconfiguration id="com.xmos.cdt.toolchain.868918528">
|
||||
<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="com.xmos.cdt.toolchain.868918528" moduleId="org.eclipse.cdt.core.settings" name="Default">
|
||||
<externalSettings/>
|
||||
<extensions>
|
||||
<extension id="com.xmos.cdt.core.XEBinaryParser" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GNU_ELF" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="com.xmos.cdt.core.XdeErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
</extensions>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<configuration buildProperties="" description="" id="com.xmos.cdt.toolchain.868918528" name="Default" parent="org.eclipse.cdt.build.core.emptycfg">
|
||||
<folderInfo id="com.xmos.cdt.toolchain.868918528.546105188" name="/" resourcePath="">
|
||||
<toolChain id="com.xmos.cdt.toolchain.1900008954" name="com.xmos.cdt.toolchain" superClass="com.xmos.cdt.toolchain">
|
||||
<targetPlatform archList="all" binaryParser="com.xmos.cdt.core.XEBinaryParser;org.eclipse.cdt.core.GNU_ELF" id="com.xmos.cdt.core.platform.2043843281" isAbstract="false" osList="linux,win32,macosx" superClass="com.xmos.cdt.core.platform"/>
|
||||
<builder arguments="CONFIG=Default" id="com.xmos.cdt.builder.base.146082949" keepEnvironmentInBuildfile="false" managedBuildOn="false" superClass="com.xmos.cdt.builder.base">
|
||||
<outputEntries>
|
||||
<entry flags="VALUE_WORKSPACE_PATH" kind="outputPath" name="bin"/>
|
||||
</outputEntries>
|
||||
</builder>
|
||||
<tool id="com.xmos.cdt.xc.compiler.59503268" name="com.xmos.cdt.xc.compiler" superClass="com.xmos.cdt.xc.compiler">
|
||||
<option id="com.xmos.xc.compiler.option.include.paths.1049064054" superClass="com.xmos.xc.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.xc.compiler.input.1844278341" name="XC" superClass="com.xmos.cdt.xc.compiler.input"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.c.compiler.1193858974" name="com.xmos.cdt.c.compiler" superClass="com.xmos.cdt.c.compiler">
|
||||
<option id="com.xmos.c.compiler.option.include.paths.917823278" superClass="com.xmos.c.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.c.compiler.input.c.916493242" name="C" superClass="com.xmos.cdt.c.compiler.input.c"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.cxx.compiler.454071458" name="com.xmos.cdt.cxx.compiler" superClass="com.xmos.cdt.cxx.compiler">
|
||||
<option id="com.xmos.cxx.compiler.option.include.paths.276177407" superClass="com.xmos.cxx.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.cxx.compiler.input.cpp.1714156048" name="C++" superClass="com.xmos.cdt.cxx.compiler.input.cpp"/>
|
||||
</tool>
|
||||
</toolChain>
|
||||
</folderInfo>
|
||||
<sourceEntries>
|
||||
<entry excluding=".build*" flags="VALUE_WORKSPACE_PATH|RESOLVED" kind="sourcePath" name=""/>
|
||||
</sourceEntries>
|
||||
</configuration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.externalSettings"/>
|
||||
</cconfiguration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="scannerConfiguration">
|
||||
<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerFileProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="makefileGenerator">
|
||||
<runAction arguments="-E -P -v -dD" command="" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.cpp" command="g++" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.c" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/${specs_file}"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'g++ -E -P -v -dD "${plugin_state_location}/specs.cpp"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/specs.c"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<project id="AN00156_i2c_master_example.null.1035655509" name="AN00156_i2c_master_example"/>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
|
||||
</cproject>
|
||||
116
lib_i2c/examples/app_simple_slave/.project
Normal file
116
lib_i2c/examples/app_simple_slave/.project
Normal file
@@ -0,0 +1,116 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<projectDescription>
|
||||
<name>AN00156_i2c_master_example</name>
|
||||
<comment></comment>
|
||||
<projects>
|
||||
</projects>
|
||||
<buildSpec>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.LegacyProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectInfoSyncBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.BuildMarkersBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.IncludePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ModulePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
|
||||
<triggers>clean,full,incremental,</triggers>
|
||||
<arguments>
|
||||
<dictionary>
|
||||
<key>?children?</key>
|
||||
<value>?name?=outputEntries\|?children?=?name?=entry\\\\|\\|\||</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>?name?</key>
|
||||
<value></value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.append_environment</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildArguments</key>
|
||||
<value>CONFIG=Debug</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildCommand</key>
|
||||
<value>xmake</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.cleanBuildTarget</key>
|
||||
<value>clean</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.contents</key>
|
||||
<value>org.eclipse.cdt.make.core.activeConfigSettings</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableAutoBuild</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableCleanBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableFullBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.stopOnError</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.useDefaultBuildCmd</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
|
||||
<triggers>full,incremental,</triggers>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
</buildSpec>
|
||||
<natures>
|
||||
<nature>org.eclipse.cdt.core.cnature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
|
||||
<nature>com.xmos.cdt.core.XdeProjectNature</nature>
|
||||
</natures>
|
||||
<filteredResources>
|
||||
<filter>
|
||||
<id>1406010377704</id>
|
||||
<name></name>
|
||||
<type>26</type>
|
||||
<matcher>
|
||||
<id>org.eclipse.ui.ide.multiFilter</id>
|
||||
<arguments>1.0-name-matches-false-false-.build*</arguments>
|
||||
</matcher>
|
||||
</filter>
|
||||
</filteredResources>
|
||||
</projectDescription>
|
||||
3
lib_i2c/examples/app_simple_slave/.xproject
Normal file
3
lib_i2c/examples/app_simple_slave/.xproject
Normal file
@@ -0,0 +1,3 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<xproject><version>1.0.3d0000000000</version>
|
||||
</xproject>
|
||||
84
lib_i2c/examples/app_simple_slave/LICENSE.rst
Normal file
84
lib_i2c/examples/app_simple_slave/LICENSE.rst
Normal file
@@ -0,0 +1,84 @@
|
||||
*******************************
|
||||
XMOS PUBLIC LICENCE: Version 1
|
||||
*******************************
|
||||
|
||||
Subject to the conditions and limitations below, permission is hereby granted by XMOS LIMITED (“XMOS”), free of charge, to any person or entity obtaining a copy of the XMOS Software.
|
||||
|
||||
**1. Definitions**
|
||||
|
||||
**“Applicable Patent Rights”** means: (a) where XMOS is the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to XMOS and (ii) that cover subject matter contained in the Software, but only to the extent it is necessary to use, reproduce or distribute the Software without infringement; and (b) where you are the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to you and (ii) that cover the subject matter contained in your Derivatives, taken alone or in combination with the Software.
|
||||
|
||||
**“Compiled Code”** means any compiled, binary, machine readable or executable version of the Source Code.
|
||||
|
||||
**“Contributor”** means any person or entity that creates or contributes to the creation of Derivatives.
|
||||
|
||||
**“Derivatives”** means any addition to, deletion from and/or change to the substance, structure of the Software, any previous Derivatives, the combination of the Derivatives and the Software and/or any respective portions thereof.
|
||||
|
||||
**“Source Code”** means the human readable code that is suitable for making modifications but excluding any Compiled Code.
|
||||
|
||||
**“Software”** means the software and associated documentation files which XMOS makes available and which contain a notice identifying the software as original XMOS software and referring to the software being subject to the terms of this XMOS Public Licence.
|
||||
|
||||
This Licence refers to XMOS Software and does not relate to any XMOS hardware or devices which are protected by intellectual property rights (including patent and trade marks) which may be sold to you under a separate agreement.
|
||||
|
||||
|
||||
**2. Licence**
|
||||
|
||||
**Permitted Uses, Conditions and Restrictions.** Subject to the conditions below, XMOS grants you a worldwide, royalty free, non-exclusive licence, to the extent of any Patent Rights to do the following:
|
||||
|
||||
2.1 **Unmodified Software.** You may use, copy, display, publish, distribute and make available unmodified copies of the Software:
|
||||
|
||||
2.1.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.1.2 for commercial purposes provided the Software is at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.1.1 and 2.1.2):
|
||||
|
||||
(a) you must retain and reproduce in all copies of the Software the copyright and proprietary notices and disclaimers of XMOS as they appear in the Software, and keep intact all notices and disclaimers in the Software files that refer to this Licence; and
|
||||
|
||||
(b) you must include a copy of this Licence with every copy of the Software and documentation you publish, distribute and make available and you may not offer or impose any terms on such Software that alter or restrict this Licence or the intent of such Licence, except as permitted below (Additional Terms).
|
||||
|
||||
The licence above does not include any Compiled Code which XMOS may make available under a separate support and licence agreement.
|
||||
|
||||
2.2 **Derivatives.** You may create and modify Derivatives and use, copy, display, publish, distribute and make available Derivatives:
|
||||
|
||||
2.2.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.2.2 for commercial purposes, provided the Derivatives are at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.2.1 and 2.2.2):
|
||||
|
||||
(a) you must comply with the terms of clause 2.1 with respect to the Derivatives;
|
||||
|
||||
(b) you must copy (to the extent it doesn’t already exist) the notice below in each file of the Derivatives, and ensure all the modified files carry prominent notices stating that you have changed the files and the date of any change; and
|
||||
|
||||
(c) if you sublicence, distribute or otherwise make the Software and/or the Derivatives available for commercial purposes, you must provide that the Software and Derivatives are at all times used on a device designed, licensed or developed by XMOS.
|
||||
|
||||
Without limitation to these terms and clause 3 below, the Source Code and Compiled Code to your Derivatives may at your discretion (but without obligation) be released, copied, displayed, published, distributed and made available; and if you elect to do so, it must be under the terms of this Licence including the terms of the licence at clauses 2.2.1, 2.2.2 and clause 3 below.
|
||||
|
||||
2.3 **Distribution of Executable Versions.** If you distribute or make available Derivatives, you must include a prominent notice in the code itself as well as in all related documentation, stating that the Source Code of the Software from which the Derivatives are based is available under the terms of this Licence, with information on how and where to obtain such Source Code.
|
||||
|
||||
**3. Your Grant of Rights.** In consideration and as a condition to this Licence, you grant to any person or entity receiving or distributing any Derivatives, a non-exclusive, royalty free, perpetual, irrevocable license under your Applicable Patent Rights and all other intellectual property rights owned or controlled by you, to use, copy, display, publish, distribute and make available your Derivatives of the same scope and extent as XMOS’s licence under clause 2.2 above.
|
||||
|
||||
**4. Combined Products.** You may create a combined product by combining Software, Derivatives and other code not covered by this Licence as a single application or product. In such instance, you must comply with the requirements of this Licence for any portion of the Software and/or Derivatives.
|
||||
|
||||
**5. Additional Terms.** You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations and/or other rights consistent with the term of this Licence (“Additional Terms”) to any legitimate recipients of the Software and/or Derivatives. The terms on which you provide such Additional Terms are on your sole responsibility and you shall indemnify, defend and hold XMOS harmless against any claims asserted against XMOS.
|
||||
|
||||
**6. New Versions.** XMOS may publish revised and/or new versions of this Licence from time to time to accommodate changes to the Licence terms, new versions, updates and bug fixes of the Software. Each version will be given a distinguishing version number. Once Software has been published under a particular version of this Licence, you may continue to use it under the terms of that version. You may also choose to use the latest version of the Software under any subsequent version published by XMOS. Only XMOS shall have the right to modify these terms.
|
||||
|
||||
**7. IPR and Ownership**
|
||||
Any rights, including all intellectual property rights and all trademarks not expressly granted herein are reserved in full by the authors or copyright holders. Any requests for additional permissions by XMOS including any rights to use XMOS trademarks, should be made (without obligation) to XMOS at **support@xmos.com**
|
||||
|
||||
Nothing herein shall limit any rights that XMOS is otherwise entitled to under the doctrines of patent exhaustion, implied license, or legal estoppel. Neither the name of the authors, the copyright holders or any contributors may be used to endorse or promote any Derivatives from this Software without specific written permission. Any attempt to deal with the Software which does not comply with this Licence shall be void and shall automatically terminate any rights granted under this licence (including any licence of any intellectual property rights granted herein).
|
||||
Subject to the licences granted under this Licence any Contributor retains all rights, title and interest in and to any Derivatives made by Contributor subject to the underlying rights of XMOS in the Software. XMOS shall retain all rights, title and interest in the Software and any Derivatives made by XMOS (“XMOS Derivatives”). XMOS Derivatives will not automatically be subject to this Licence and XMOS shall be entitled to licence such rights on any terms (without obligation) as it sees fit.
|
||||
|
||||
**8. Termination**
|
||||
|
||||
8.1 This Licence will automatically terminate immediately, without notice to you, if:
|
||||
|
||||
(a) you fail to comply with the terms of this Licence; and/or
|
||||
|
||||
(b) you directly or indirectly commence any action for patent or intellectual property right infringement against XMOS, or any parent, group, affiliate or subsidiary of XMOS; provided XMOS did not first commence an action or patent infringement against you in that instance; and/or
|
||||
|
||||
(c) the terms of this Licence are held by any court of competent jurisdiction to be unenforceable in whole or in part.
|
||||
|
||||
**9. Critical Applications.** Unless XMOS has agreed in writing with you an agreement specifically governing use of the Goods in military, aerospace, automotive or medically related functions (collectively and individually hereinafter referred to as "Special Use"), any permitted use of the Software excludes Special Use. Notwithstanding any agreement between XMOS and you for Special Use, Special Use shall be at your own risk, and you shall fully indemnify XMOS against any damages, losses, costs and claims (direct and indirect) arising out of any Special Use.
|
||||
|
||||
**10. NO WARRANTY OR SUPPORT.** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL XMOS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, WARRANTY, CIVIL TORT (INCLUDING NEGLIGENCE), PRODUCTS LIABILITY OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE INCLUDING GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF SUCH PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND NOT WITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE. IN SOME JURISDICTIONS PARTIES ARE UNABLE TO LIMIT LIABILTY IN THIS WAY, IF THIS APPLIES TO YOUR JURISDICTION THIS LIABILITY CLAUSE ABOVE MAY NOT APPLY. NOTWITHSTANDING THE ABOVE, IN NO EVENT SHALL XMOS’s TOTAL LIABILITY TO YOU FOR ALL DAMAGES, LOSS OR OTHERWISE EXCEED $50.
|
||||
|
||||
**11. Governing Law and Jurisdiction.** This Licence constitutes the entire agreement between the parties with respect to the subject matter hereof. The Licence shall be governed by the laws of England and the conflict of laws and UN Convention on Contracts for the International Sale of Goods, shall not apply.
|
||||
39
lib_i2c/examples/app_simple_slave/Makefile
Normal file
39
lib_i2c/examples/app_simple_slave/Makefile
Normal file
@@ -0,0 +1,39 @@
|
||||
XCOREAI ?= 0
|
||||
|
||||
# The APP_NAME variable determines the name of the final .xe file. It should
|
||||
# not include the .xe postfix. If left blank the name will default to
|
||||
# the project name
|
||||
|
||||
APP_NAME =
|
||||
|
||||
# The flags passed to xcc when building the application
|
||||
# You can also set the following to override flags for a particular language:
|
||||
#
|
||||
# XCC_XC_FLAGS, XCC_C_FLAGS, XCC_ASM_FLAGS, XCC_CPP_FLAGS
|
||||
#
|
||||
# If the variable XCC_MAP_FLAGS is set it overrides the flags passed to
|
||||
# xcc for the final link (mapping) stage.
|
||||
|
||||
BUILD_FLAGS = -O2 -g -DDEBUG_PRINT_ENABLE=1 -report
|
||||
|
||||
# The TARGET variable determines what target system the application is
|
||||
# compiled for. It either refers to an XN file in the source directories
|
||||
# or a valid argument for the --target option when compiling.
|
||||
ifeq ($(XCOREAI),0)
|
||||
XCC_FLAGS_xs2 = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-200-EXPLORER
|
||||
else
|
||||
XCC_FLAGS_xcoreai = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-AI-EXPLORER
|
||||
endif
|
||||
|
||||
# The USED_MODULES variable lists other module used by the application.
|
||||
|
||||
USED_MODULES = lib_i2c(>=6.0.0) lib_logging(>=2.1.0)
|
||||
|
||||
#=============================================================================
|
||||
# The following part of the Makefile includes the common build infrastructure
|
||||
# for compiling XMOS applications. You should not need to edit below here.
|
||||
|
||||
XMOS_MAKE_PATH ?= ../..
|
||||
include $(XMOS_MAKE_PATH)/xcommon/module_xcommon/build/Makefile.common
|
||||
52
lib_i2c/examples/app_simple_slave/src/simple_slave.xc
Normal file
52
lib_i2c/examples/app_simple_slave/src/simple_slave.xc
Normal file
@@ -0,0 +1,52 @@
|
||||
// Copyright 2018-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
|
||||
/* A simple application example used for code snippets in the library
|
||||
* documentation.
|
||||
*/
|
||||
|
||||
#include <xs1.h>
|
||||
#include <stdio.h>
|
||||
#include "i2c.h"
|
||||
|
||||
void my_application(server i2c_slave_callback_if i2c);
|
||||
|
||||
// I2C interface ports
|
||||
port p_scl = XS1_PORT_1E;
|
||||
port p_sda = XS1_PORT_1F;
|
||||
|
||||
int main(void) {
|
||||
static const uint8_t device_addr = 0x3c;
|
||||
i2c_slave_callback_if i2c;
|
||||
|
||||
par {
|
||||
i2c_slave(i2c, p_scl, p_sda, device_addr);
|
||||
my_application(i2c);
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
void my_application(server i2c_slave_callback_if i2c) {
|
||||
while (1) {
|
||||
select {
|
||||
case i2c.ack_read_request() -> i2c_slave_ack_t response:
|
||||
response = I2C_SLAVE_ACK;
|
||||
break;
|
||||
case i2c.ack_write_request() -> i2c_slave_ack_t response:
|
||||
response = I2C_SLAVE_ACK;
|
||||
break;
|
||||
case i2c.master_sent_data(uint8_t data) -> i2c_slave_ack_t response:
|
||||
// handle write to device here, set response to NACK for the
|
||||
// last byte of data in the transaction.
|
||||
break;
|
||||
case i2c.master_requires_data() -> uint8_t data:
|
||||
// handle read from device here
|
||||
break;
|
||||
case i2c.stop_bit():
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// end
|
||||
163
lib_i2c/examples/app_simple_synchronous_master/.cproject
Normal file
163
lib_i2c/examples/app_simple_synchronous_master/.cproject
Normal file
@@ -0,0 +1,163 @@
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
|
||||
<storageModule moduleId="org.eclipse.cdt.core.settings">
|
||||
<cconfiguration id="com.xmos.cdt.toolchain.868918528">
|
||||
<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="com.xmos.cdt.toolchain.868918528" moduleId="org.eclipse.cdt.core.settings" name="Default">
|
||||
<externalSettings/>
|
||||
<extensions>
|
||||
<extension id="com.xmos.cdt.core.XEBinaryParser" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GNU_ELF" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="com.xmos.cdt.core.XdeErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
</extensions>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<configuration buildProperties="" description="" id="com.xmos.cdt.toolchain.868918528" name="Default" parent="org.eclipse.cdt.build.core.emptycfg">
|
||||
<folderInfo id="com.xmos.cdt.toolchain.868918528.546105188" name="/" resourcePath="">
|
||||
<toolChain id="com.xmos.cdt.toolchain.1900008954" name="com.xmos.cdt.toolchain" superClass="com.xmos.cdt.toolchain">
|
||||
<targetPlatform archList="all" binaryParser="com.xmos.cdt.core.XEBinaryParser;org.eclipse.cdt.core.GNU_ELF" id="com.xmos.cdt.core.platform.2043843281" isAbstract="false" osList="linux,win32,macosx" superClass="com.xmos.cdt.core.platform"/>
|
||||
<builder arguments="CONFIG=Default" id="com.xmos.cdt.builder.base.146082949" keepEnvironmentInBuildfile="false" managedBuildOn="false" superClass="com.xmos.cdt.builder.base">
|
||||
<outputEntries>
|
||||
<entry flags="VALUE_WORKSPACE_PATH" kind="outputPath" name="bin"/>
|
||||
</outputEntries>
|
||||
</builder>
|
||||
<tool id="com.xmos.cdt.xc.compiler.59503268" name="com.xmos.cdt.xc.compiler" superClass="com.xmos.cdt.xc.compiler">
|
||||
<option id="com.xmos.xc.compiler.option.include.paths.1049064054" superClass="com.xmos.xc.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.xc.compiler.input.1844278341" name="XC" superClass="com.xmos.cdt.xc.compiler.input"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.c.compiler.1193858974" name="com.xmos.cdt.c.compiler" superClass="com.xmos.cdt.c.compiler">
|
||||
<option id="com.xmos.c.compiler.option.include.paths.917823278" superClass="com.xmos.c.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.c.compiler.input.c.916493242" name="C" superClass="com.xmos.cdt.c.compiler.input.c"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.cxx.compiler.454071458" name="com.xmos.cdt.cxx.compiler" superClass="com.xmos.cdt.cxx.compiler">
|
||||
<option id="com.xmos.cxx.compiler.option.include.paths.276177407" superClass="com.xmos.cxx.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_i2c}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.cxx.compiler.input.cpp.1714156048" name="C++" superClass="com.xmos.cdt.cxx.compiler.input.cpp"/>
|
||||
</tool>
|
||||
</toolChain>
|
||||
</folderInfo>
|
||||
<sourceEntries>
|
||||
<entry excluding=".build*" flags="VALUE_WORKSPACE_PATH|RESOLVED" kind="sourcePath" name=""/>
|
||||
</sourceEntries>
|
||||
</configuration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.externalSettings"/>
|
||||
</cconfiguration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="scannerConfiguration">
|
||||
<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerFileProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="makefileGenerator">
|
||||
<runAction arguments="-E -P -v -dD" command="" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.cpp" command="g++" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.c" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/${specs_file}"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'g++ -E -P -v -dD "${plugin_state_location}/specs.cpp"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/specs.c"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<project id="AN00156_i2c_master_example.null.1035655509" name="AN00156_i2c_master_example"/>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
|
||||
</cproject>
|
||||
116
lib_i2c/examples/app_simple_synchronous_master/.project
Normal file
116
lib_i2c/examples/app_simple_synchronous_master/.project
Normal file
@@ -0,0 +1,116 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<projectDescription>
|
||||
<name>AN00156_i2c_master_example</name>
|
||||
<comment></comment>
|
||||
<projects>
|
||||
</projects>
|
||||
<buildSpec>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.LegacyProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectInfoSyncBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.BuildMarkersBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.IncludePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ModulePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
|
||||
<triggers>clean,full,incremental,</triggers>
|
||||
<arguments>
|
||||
<dictionary>
|
||||
<key>?children?</key>
|
||||
<value>?name?=outputEntries\|?children?=?name?=entry\\\\|\\|\||</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>?name?</key>
|
||||
<value></value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.append_environment</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildArguments</key>
|
||||
<value>CONFIG=Debug</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildCommand</key>
|
||||
<value>xmake</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.cleanBuildTarget</key>
|
||||
<value>clean</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.contents</key>
|
||||
<value>org.eclipse.cdt.make.core.activeConfigSettings</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableAutoBuild</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableCleanBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableFullBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.stopOnError</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.useDefaultBuildCmd</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
|
||||
<triggers>full,incremental,</triggers>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
</buildSpec>
|
||||
<natures>
|
||||
<nature>org.eclipse.cdt.core.cnature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
|
||||
<nature>com.xmos.cdt.core.XdeProjectNature</nature>
|
||||
</natures>
|
||||
<filteredResources>
|
||||
<filter>
|
||||
<id>1406010377704</id>
|
||||
<name></name>
|
||||
<type>26</type>
|
||||
<matcher>
|
||||
<id>org.eclipse.ui.ide.multiFilter</id>
|
||||
<arguments>1.0-name-matches-false-false-.build*</arguments>
|
||||
</matcher>
|
||||
</filter>
|
||||
</filteredResources>
|
||||
</projectDescription>
|
||||
3
lib_i2c/examples/app_simple_synchronous_master/.xproject
Normal file
3
lib_i2c/examples/app_simple_synchronous_master/.xproject
Normal file
@@ -0,0 +1,3 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<xproject><version>1.0.3d0000000000</version>
|
||||
</xproject>
|
||||
84
lib_i2c/examples/app_simple_synchronous_master/LICENSE.rst
Normal file
84
lib_i2c/examples/app_simple_synchronous_master/LICENSE.rst
Normal file
@@ -0,0 +1,84 @@
|
||||
*******************************
|
||||
XMOS PUBLIC LICENCE: Version 1
|
||||
*******************************
|
||||
|
||||
Subject to the conditions and limitations below, permission is hereby granted by XMOS LIMITED (“XMOS”), free of charge, to any person or entity obtaining a copy of the XMOS Software.
|
||||
|
||||
**1. Definitions**
|
||||
|
||||
**“Applicable Patent Rights”** means: (a) where XMOS is the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to XMOS and (ii) that cover subject matter contained in the Software, but only to the extent it is necessary to use, reproduce or distribute the Software without infringement; and (b) where you are the grantor of the rights, (i) claims of patents that are now or in future owned by or assigned to you and (ii) that cover the subject matter contained in your Derivatives, taken alone or in combination with the Software.
|
||||
|
||||
**“Compiled Code”** means any compiled, binary, machine readable or executable version of the Source Code.
|
||||
|
||||
**“Contributor”** means any person or entity that creates or contributes to the creation of Derivatives.
|
||||
|
||||
**“Derivatives”** means any addition to, deletion from and/or change to the substance, structure of the Software, any previous Derivatives, the combination of the Derivatives and the Software and/or any respective portions thereof.
|
||||
|
||||
**“Source Code”** means the human readable code that is suitable for making modifications but excluding any Compiled Code.
|
||||
|
||||
**“Software”** means the software and associated documentation files which XMOS makes available and which contain a notice identifying the software as original XMOS software and referring to the software being subject to the terms of this XMOS Public Licence.
|
||||
|
||||
This Licence refers to XMOS Software and does not relate to any XMOS hardware or devices which are protected by intellectual property rights (including patent and trade marks) which may be sold to you under a separate agreement.
|
||||
|
||||
|
||||
**2. Licence**
|
||||
|
||||
**Permitted Uses, Conditions and Restrictions.** Subject to the conditions below, XMOS grants you a worldwide, royalty free, non-exclusive licence, to the extent of any Patent Rights to do the following:
|
||||
|
||||
2.1 **Unmodified Software.** You may use, copy, display, publish, distribute and make available unmodified copies of the Software:
|
||||
|
||||
2.1.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.1.2 for commercial purposes provided the Software is at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.1.1 and 2.1.2):
|
||||
|
||||
(a) you must retain and reproduce in all copies of the Software the copyright and proprietary notices and disclaimers of XMOS as they appear in the Software, and keep intact all notices and disclaimers in the Software files that refer to this Licence; and
|
||||
|
||||
(b) you must include a copy of this Licence with every copy of the Software and documentation you publish, distribute and make available and you may not offer or impose any terms on such Software that alter or restrict this Licence or the intent of such Licence, except as permitted below (Additional Terms).
|
||||
|
||||
The licence above does not include any Compiled Code which XMOS may make available under a separate support and licence agreement.
|
||||
|
||||
2.2 **Derivatives.** You may create and modify Derivatives and use, copy, display, publish, distribute and make available Derivatives:
|
||||
|
||||
2.2.1 for personal or academic, non-commercial purposes; or
|
||||
|
||||
2.2.2 for commercial purposes, provided the Derivatives are at all times used on a device designed, licensed or developed by XMOS and, provided that in each instance (2.2.1 and 2.2.2):
|
||||
|
||||
(a) you must comply with the terms of clause 2.1 with respect to the Derivatives;
|
||||
|
||||
(b) you must copy (to the extent it doesn’t already exist) the notice below in each file of the Derivatives, and ensure all the modified files carry prominent notices stating that you have changed the files and the date of any change; and
|
||||
|
||||
(c) if you sublicence, distribute or otherwise make the Software and/or the Derivatives available for commercial purposes, you must provide that the Software and Derivatives are at all times used on a device designed, licensed or developed by XMOS.
|
||||
|
||||
Without limitation to these terms and clause 3 below, the Source Code and Compiled Code to your Derivatives may at your discretion (but without obligation) be released, copied, displayed, published, distributed and made available; and if you elect to do so, it must be under the terms of this Licence including the terms of the licence at clauses 2.2.1, 2.2.2 and clause 3 below.
|
||||
|
||||
2.3 **Distribution of Executable Versions.** If you distribute or make available Derivatives, you must include a prominent notice in the code itself as well as in all related documentation, stating that the Source Code of the Software from which the Derivatives are based is available under the terms of this Licence, with information on how and where to obtain such Source Code.
|
||||
|
||||
**3. Your Grant of Rights.** In consideration and as a condition to this Licence, you grant to any person or entity receiving or distributing any Derivatives, a non-exclusive, royalty free, perpetual, irrevocable license under your Applicable Patent Rights and all other intellectual property rights owned or controlled by you, to use, copy, display, publish, distribute and make available your Derivatives of the same scope and extent as XMOS’s licence under clause 2.2 above.
|
||||
|
||||
**4. Combined Products.** You may create a combined product by combining Software, Derivatives and other code not covered by this Licence as a single application or product. In such instance, you must comply with the requirements of this Licence for any portion of the Software and/or Derivatives.
|
||||
|
||||
**5. Additional Terms.** You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations and/or other rights consistent with the term of this Licence (“Additional Terms”) to any legitimate recipients of the Software and/or Derivatives. The terms on which you provide such Additional Terms are on your sole responsibility and you shall indemnify, defend and hold XMOS harmless against any claims asserted against XMOS.
|
||||
|
||||
**6. New Versions.** XMOS may publish revised and/or new versions of this Licence from time to time to accommodate changes to the Licence terms, new versions, updates and bug fixes of the Software. Each version will be given a distinguishing version number. Once Software has been published under a particular version of this Licence, you may continue to use it under the terms of that version. You may also choose to use the latest version of the Software under any subsequent version published by XMOS. Only XMOS shall have the right to modify these terms.
|
||||
|
||||
**7. IPR and Ownership**
|
||||
Any rights, including all intellectual property rights and all trademarks not expressly granted herein are reserved in full by the authors or copyright holders. Any requests for additional permissions by XMOS including any rights to use XMOS trademarks, should be made (without obligation) to XMOS at **support@xmos.com**
|
||||
|
||||
Nothing herein shall limit any rights that XMOS is otherwise entitled to under the doctrines of patent exhaustion, implied license, or legal estoppel. Neither the name of the authors, the copyright holders or any contributors may be used to endorse or promote any Derivatives from this Software without specific written permission. Any attempt to deal with the Software which does not comply with this Licence shall be void and shall automatically terminate any rights granted under this licence (including any licence of any intellectual property rights granted herein).
|
||||
Subject to the licences granted under this Licence any Contributor retains all rights, title and interest in and to any Derivatives made by Contributor subject to the underlying rights of XMOS in the Software. XMOS shall retain all rights, title and interest in the Software and any Derivatives made by XMOS (“XMOS Derivatives”). XMOS Derivatives will not automatically be subject to this Licence and XMOS shall be entitled to licence such rights on any terms (without obligation) as it sees fit.
|
||||
|
||||
**8. Termination**
|
||||
|
||||
8.1 This Licence will automatically terminate immediately, without notice to you, if:
|
||||
|
||||
(a) you fail to comply with the terms of this Licence; and/or
|
||||
|
||||
(b) you directly or indirectly commence any action for patent or intellectual property right infringement against XMOS, or any parent, group, affiliate or subsidiary of XMOS; provided XMOS did not first commence an action or patent infringement against you in that instance; and/or
|
||||
|
||||
(c) the terms of this Licence are held by any court of competent jurisdiction to be unenforceable in whole or in part.
|
||||
|
||||
**9. Critical Applications.** Unless XMOS has agreed in writing with you an agreement specifically governing use of the Goods in military, aerospace, automotive or medically related functions (collectively and individually hereinafter referred to as "Special Use"), any permitted use of the Software excludes Special Use. Notwithstanding any agreement between XMOS and you for Special Use, Special Use shall be at your own risk, and you shall fully indemnify XMOS against any damages, losses, costs and claims (direct and indirect) arising out of any Special Use.
|
||||
|
||||
**10. NO WARRANTY OR SUPPORT.** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL XMOS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, WARRANTY, CIVIL TORT (INCLUDING NEGLIGENCE), PRODUCTS LIABILITY OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE INCLUDING GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF SUCH PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND NOT WITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE. IN SOME JURISDICTIONS PARTIES ARE UNABLE TO LIMIT LIABILTY IN THIS WAY, IF THIS APPLIES TO YOUR JURISDICTION THIS LIABILITY CLAUSE ABOVE MAY NOT APPLY. NOTWITHSTANDING THE ABOVE, IN NO EVENT SHALL XMOS’s TOTAL LIABILITY TO YOU FOR ALL DAMAGES, LOSS OR OTHERWISE EXCEED $50.
|
||||
|
||||
**11. Governing Law and Jurisdiction.** This Licence constitutes the entire agreement between the parties with respect to the subject matter hereof. The Licence shall be governed by the laws of England and the conflict of laws and UN Convention on Contracts for the International Sale of Goods, shall not apply.
|
||||
40
lib_i2c/examples/app_simple_synchronous_master/Makefile
Normal file
40
lib_i2c/examples/app_simple_synchronous_master/Makefile
Normal file
@@ -0,0 +1,40 @@
|
||||
XCOREAI ?= 0
|
||||
|
||||
# The APP_NAME variable determines the name of the final .xe file. It should
|
||||
# not include the .xe postfix. If left blank the name will default to
|
||||
# the project name
|
||||
|
||||
APP_NAME =
|
||||
|
||||
# The flags passed to xcc when building the application
|
||||
# You can also set the following to override flags for a particular language:
|
||||
#
|
||||
# XCC_XC_FLAGS, XCC_C_FLAGS, XCC_ASM_FLAGS, XCC_CPP_FLAGS
|
||||
#
|
||||
# If the variable XCC_MAP_FLAGS is set it overrides the flags passed to
|
||||
# xcc for the final link (mapping) stage.
|
||||
|
||||
BUILD_FLAGS = -O2 -g -DDEBUG_PRINT_ENABLE=1 -report
|
||||
|
||||
# The TARGET variable determines what target system the application is
|
||||
# compiled for. It either refers to an XN file in the source directories
|
||||
# or a valid argument for the --target option when compiling.
|
||||
ifeq ($(XCOREAI),0)
|
||||
XCC_FLAGS_xs2 = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-200-EXPLORER
|
||||
else
|
||||
XCC_FLAGS_xcoreai = $(BUILD_FLAGS)
|
||||
TARGET = XCORE-AI-EXPLORER
|
||||
endif
|
||||
|
||||
|
||||
# The USED_MODULES variable lists other module used by the application.
|
||||
|
||||
USED_MODULES = lib_i2c(>=6.0.0) lib_logging(>=2.1.0)
|
||||
|
||||
#=============================================================================
|
||||
# The following part of the Makefile includes the common build infrastructure
|
||||
# for compiling XMOS applications. You should not need to edit below here.
|
||||
|
||||
XMOS_MAKE_PATH ?= ../..
|
||||
include $(XMOS_MAKE_PATH)/xcommon/module_xcommon/build/Makefile.common
|
||||
@@ -0,0 +1,35 @@
|
||||
// Copyright 2018-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
|
||||
/* A simple application example used for code snippets in the library
|
||||
* documentation.
|
||||
*/
|
||||
|
||||
#include <xs1.h>
|
||||
#include <stdio.h>
|
||||
#include "i2c.h"
|
||||
|
||||
void my_application(client i2c_master_if i2c, uint8_t target_device_addr);
|
||||
|
||||
// I2C interface ports
|
||||
port p_scl = XS1_PORT_1E;
|
||||
port p_sda = XS1_PORT_1F;
|
||||
|
||||
int main(void) {
|
||||
i2c_master_if i2c[1];
|
||||
static const uint8_t target_device_addr = 0x3c;
|
||||
|
||||
par {
|
||||
i2c_master(i2c, 1, p_scl, p_sda, 100);
|
||||
my_application(i2c[0], target_device_addr);
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
void my_application(client i2c_master_if i2c, uint8_t target_device_addr) {
|
||||
uint8_t data[2];
|
||||
i2c.read(target_device_addr, data, 2, 1);
|
||||
printf("Read data %d, %d from the bus.\n", data[0], data[1]);
|
||||
}
|
||||
|
||||
// end
|
||||
154
lib_i2c/lib_i2c/.cproject
Normal file
154
lib_i2c/lib_i2c/.cproject
Normal file
@@ -0,0 +1,154 @@
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
|
||||
<storageModule moduleId="org.eclipse.cdt.core.settings">
|
||||
<cconfiguration id="com.xmos.cdt.toolchain.854505739">
|
||||
<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="com.xmos.cdt.toolchain.854505739" moduleId="org.eclipse.cdt.core.settings" name="Default">
|
||||
<externalSettings/>
|
||||
<extensions>
|
||||
<extension id="com.xmos.cdt.core.XEBinaryParser" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GNU_ELF" point="org.eclipse.cdt.core.BinaryParser"/>
|
||||
<extension id="com.xmos.cdt.core.XdeErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
|
||||
</extensions>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<configuration buildProperties="" description="" id="com.xmos.cdt.toolchain.854505739" name="Default" parent="org.eclipse.cdt.build.core.emptycfg">
|
||||
<folderInfo id="com.xmos.cdt.toolchain.854505739.1680930365" name="/" resourcePath="">
|
||||
<toolChain id="com.xmos.cdt.toolchain.1700184562" name="com.xmos.cdt.toolchain" superClass="com.xmos.cdt.toolchain">
|
||||
<targetPlatform archList="all" binaryParser="com.xmos.cdt.core.XEBinaryParser;org.eclipse.cdt.core.GNU_ELF" id="com.xmos.cdt.core.platform.482398777" isAbstract="false" osList="linux,win32,macosx" superClass="com.xmos.cdt.core.platform"/>
|
||||
<builder arguments="-f .makefile" id="com.xmos.cdt.builder.base.621132499" keepEnvironmentInBuildfile="false" managedBuildOn="false" superClass="com.xmos.cdt.builder.base">
|
||||
<outputEntries>
|
||||
<entry flags="VALUE_WORKSPACE_PATH" kind="outputPath" name="bin"/>
|
||||
</outputEntries>
|
||||
</builder>
|
||||
<tool id="com.xmos.cdt.xc.compiler.277328952" name="com.xmos.cdt.xc.compiler" superClass="com.xmos.cdt.xc.compiler">
|
||||
<option id="com.xmos.xc.compiler.option.include.paths.713968690" superClass="com.xmos.xc.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.xc.compiler.input.1007607740" name="XC" superClass="com.xmos.cdt.xc.compiler.input"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.c.compiler.1384555284" name="com.xmos.cdt.c.compiler" superClass="com.xmos.cdt.c.compiler">
|
||||
<option id="com.xmos.c.compiler.option.include.paths.168966593" superClass="com.xmos.c.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.c.compiler.input.c.25685430" name="C" superClass="com.xmos.cdt.c.compiler.input.c"/>
|
||||
</tool>
|
||||
<tool id="com.xmos.cdt.cxx.compiler.163182848" name="com.xmos.cdt.cxx.compiler" superClass="com.xmos.cdt.cxx.compiler">
|
||||
<option id="com.xmos.cxx.compiler.option.include.paths.1925843647" superClass="com.xmos.cxx.compiler.option.include.paths" valueType="includePath">
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_logging/api}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/src}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert}""/>
|
||||
<listOptionValue builtIn="false" value=""${workspace_loc:/lib_xassert/api}""/>
|
||||
</option>
|
||||
<inputType id="com.xmos.cdt.cxx.compiler.input.cpp.377092751" name="C++" superClass="com.xmos.cdt.cxx.compiler.input.cpp"/>
|
||||
</tool>
|
||||
</toolChain>
|
||||
</folderInfo>
|
||||
<sourceEntries>
|
||||
<entry excluding=".build*" flags="VALUE_WORKSPACE_PATH|RESOLVED" kind="sourcePath" name=""/>
|
||||
</sourceEntries>
|
||||
</configuration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.externalSettings"/>
|
||||
</cconfiguration>
|
||||
</storageModule>
|
||||
<storageModule moduleId="scannerConfiguration">
|
||||
<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.make.core.GCCStandardMakePerFileProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="makefileGenerator">
|
||||
<runAction arguments="-E -P -v -dD" command="" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/${specs_file}" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.cpp" command="g++" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-E -P -v -dD ${plugin_state_location}/specs.c" command="gcc" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfile">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/${specs_file}"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileCPP">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'g++ -E -P -v -dD "${plugin_state_location}/specs.cpp"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
<profile id="org.eclipse.cdt.managedbuilder.core.GCCWinManagedMakePerProjectProfileC">
|
||||
<buildOutputProvider>
|
||||
<openAction enabled="true" filePath=""/>
|
||||
<parser enabled="true"/>
|
||||
</buildOutputProvider>
|
||||
<scannerInfoProvider id="specsFile">
|
||||
<runAction arguments="-c 'gcc -E -P -v -dD "${plugin_state_location}/specs.c"'" command="sh" useDefault="true"/>
|
||||
<parser enabled="true"/>
|
||||
</scannerInfoProvider>
|
||||
</profile>
|
||||
</storageModule>
|
||||
<storageModule moduleId="cdtBuildSystem" version="4.0.0">
|
||||
<project id="lib_i2c.null.793113907" name="lib_i2c"/>
|
||||
</storageModule>
|
||||
<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
|
||||
</cproject>
|
||||
8
lib_i2c/lib_i2c/.makefile
Normal file
8
lib_i2c/lib_i2c/.makefile
Normal file
@@ -0,0 +1,8 @@
|
||||
all:
|
||||
@echo "** Module only - only builds as part of application **"
|
||||
|
||||
|
||||
clean:
|
||||
@echo "** Module only - only builds as part of application **"
|
||||
|
||||
|
||||
105
lib_i2c/lib_i2c/.project
Normal file
105
lib_i2c/lib_i2c/.project
Normal file
@@ -0,0 +1,105 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<projectDescription>
|
||||
<name>lib_i2c</name>
|
||||
<comment></comment>
|
||||
<projects>
|
||||
</projects>
|
||||
<buildSpec>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.LegacyProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectCheckerBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.BuildMarkersBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ProjectInfoSyncBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.IncludePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>com.xmos.cdt.core.ModulePathBuilder</name>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
|
||||
<triggers>clean,full,incremental,</triggers>
|
||||
<arguments>
|
||||
<dictionary>
|
||||
<key>?children?</key>
|
||||
<value>?name?=outputEntries\|?children?=?name?=entry\\\\|\\|\||</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>?name?</key>
|
||||
<value></value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.append_environment</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildArguments</key>
|
||||
<value>CONFIG=Debug</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.buildCommand</key>
|
||||
<value>xmake</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.cleanBuildTarget</key>
|
||||
<value>clean</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.contents</key>
|
||||
<value>org.eclipse.cdt.make.core.activeConfigSettings</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableAutoBuild</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableCleanBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.enableFullBuild</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.stopOnError</key>
|
||||
<value>true</value>
|
||||
</dictionary>
|
||||
<dictionary>
|
||||
<key>org.eclipse.cdt.make.core.useDefaultBuildCmd</key>
|
||||
<value>false</value>
|
||||
</dictionary>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
<buildCommand>
|
||||
<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
|
||||
<triggers>full,incremental,</triggers>
|
||||
<arguments>
|
||||
</arguments>
|
||||
</buildCommand>
|
||||
</buildSpec>
|
||||
<natures>
|
||||
<nature>org.eclipse.cdt.core.cnature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
|
||||
<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
|
||||
<nature>com.xmos.cdt.core.XdeProjectNature</nature>
|
||||
</natures>
|
||||
</projectDescription>
|
||||
4
lib_i2c/lib_i2c/.xproject
Normal file
4
lib_i2c/lib_i2c/.xproject
Normal file
@@ -0,0 +1,4 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<xproject><repository>lib_i2c</repository>
|
||||
<version>5.0.0dc6fb354094</version>
|
||||
</xproject>
|
||||
676
lib_i2c/lib_i2c/api/i2c.h
Normal file
676
lib_i2c/lib_i2c/api/i2c.h
Normal file
@@ -0,0 +1,676 @@
|
||||
// Copyright 2014-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
#ifndef _i2c_h_
|
||||
#define _i2c_h_
|
||||
|
||||
#include <stddef.h>
|
||||
#include <stdint.h>
|
||||
|
||||
/** This type is used in I2C functions to report back on whether the
|
||||
* slave performed an ACK or NACK on the last piece of data sent
|
||||
* to it.
|
||||
*/
|
||||
typedef enum {
|
||||
I2C_NACK, ///< the slave has NACKed the last byte
|
||||
I2C_ACK, ///< the slave has ACKed the last byte
|
||||
} i2c_res_t;
|
||||
|
||||
#ifdef __XC__
|
||||
|
||||
#define BIT_TIME(KBITS_PER_SEC) ((XS1_TIMER_MHZ * 1000) / KBITS_PER_SEC)
|
||||
#define BIT_MASK(BIT_POS) (1 << BIT_POS)
|
||||
|
||||
/** This interface is used to communication with an I2C master component.
|
||||
* It provides facilities for reading and writing to the bus.
|
||||
*
|
||||
*/
|
||||
typedef interface i2c_master_if {
|
||||
|
||||
/** Write data to an I2C bus.
|
||||
*
|
||||
* \param device_addr the address of the slave device to write to.
|
||||
* \param buf the buffer containing data to write.
|
||||
* \param n the number of bytes to write.
|
||||
* \param num_bytes_sent the function will set this value to the
|
||||
* number of bytes actually sent. On success, this
|
||||
* will be equal to ``n`` but it will be less if the
|
||||
* slave sends an early NACK on the bus and the
|
||||
* transaction fails.
|
||||
* \param send_stop_bit if this is non-zero then a stop bit
|
||||
* will be sent on the bus after the transaction.
|
||||
* This is usually required for normal operation. If
|
||||
* this parameter is zero then no stop bit will
|
||||
* be omitted. In this case, no other task can use
|
||||
* the component until a stop bit has been sent.
|
||||
*
|
||||
* \returns ``I2C_ACK`` if the write was acknowledged by the slave
|
||||
* device, otherwise ``I2C_NACK``.
|
||||
*/
|
||||
[[guarded]]
|
||||
i2c_res_t write(uint8_t device_addr, uint8_t buf[n], size_t n,
|
||||
size_t &num_bytes_sent, int send_stop_bit);
|
||||
|
||||
/** Read data from an I2C bus.
|
||||
*
|
||||
* \param device_addr the address of the slave device to read from
|
||||
* \param buf the buffer to fill with data
|
||||
* \param n the number of bytes to read
|
||||
* \param send_stop_bit if this is non-zero then a stop bit
|
||||
* will be sent on the bus after the transaction.
|
||||
* This is usually required for normal operation. If
|
||||
* this parameter is zero then no stop bit will
|
||||
* be omitted. In this case, no other task can use
|
||||
* the component until a stop bit has been sent.
|
||||
*
|
||||
* \returns ``I2C_ACK`` if the read was acknowledged by the slave
|
||||
* device, otherwise ``I2C_NACK``.
|
||||
*/
|
||||
[[guarded]]
|
||||
i2c_res_t read(uint8_t device_addr, uint8_t buf[n], size_t n,
|
||||
int send_stop_bit);
|
||||
|
||||
/** Send a stop bit.
|
||||
*
|
||||
* This function will cause a stop bit to be sent on the bus. It should
|
||||
* be used to complete/abort a transaction if the ``send_stop_bit`` argument
|
||||
* was not set when calling the read() or write() functions.
|
||||
*/
|
||||
void send_stop_bit(void);
|
||||
|
||||
/** Shutdown the I2C component.
|
||||
*
|
||||
* This function will cause the I2C task to shutdown and return.
|
||||
*/
|
||||
void shutdown();
|
||||
} i2c_master_if;
|
||||
|
||||
/** This type is used by the supplementary I2C register read/write functions to
|
||||
* report back on whether the operation was a success or not.
|
||||
*/
|
||||
typedef enum {
|
||||
I2C_REGOP_SUCCESS, ///< the operation was successful
|
||||
I2C_REGOP_DEVICE_NACK, ///< the operation was NACKed when sending the device address, so either the device is missing or busy
|
||||
I2C_REGOP_INCOMPLETE ///< the operation was NACKed halfway through by the slave
|
||||
} i2c_regop_res_t;
|
||||
|
||||
|
||||
extends client interface i2c_master_if : {
|
||||
|
||||
/** Read an 8-bit register on a slave device.
|
||||
*
|
||||
* This function reads an 8-bit addressed, 8-bit register from the i2c
|
||||
* bus. The function reads data by
|
||||
* transmitting the register addr and then reading the data from the slave
|
||||
* device.
|
||||
*
|
||||
* Note that no stop bit is transmitted between the write and the read.
|
||||
* The operation is performed as one transaction using a repeated start.
|
||||
*
|
||||
* \param i the interface to the I2C master
|
||||
* \param device_addr the address of the slave device to read from
|
||||
* \param reg the address of the register to read
|
||||
* \param result indicates whether the read completed successfully. Will
|
||||
* be set to ``I2C_REGOP_DEVICE_NACK`` if the slave NACKed,
|
||||
* and ``I2C_REGOP_SUCCESS`` on successful completion of the
|
||||
* read.
|
||||
*
|
||||
* \returns the value of the register
|
||||
*/
|
||||
inline uint8_t read_reg(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint8_t reg,
|
||||
i2c_regop_res_t &result) {
|
||||
uint8_t a_reg[1] = {reg};
|
||||
uint8_t data[1] = {0};
|
||||
size_t n;
|
||||
i2c_res_t res;
|
||||
res = i.write(device_addr, a_reg, 1, n, 0);
|
||||
if (n != 1) {
|
||||
result = I2C_REGOP_DEVICE_NACK;
|
||||
i.send_stop_bit();
|
||||
return 0;
|
||||
}
|
||||
res = i.read(device_addr, data, 1, 1);
|
||||
if (res == I2C_ACK) {
|
||||
result = I2C_REGOP_SUCCESS;
|
||||
} else {
|
||||
result = I2C_REGOP_DEVICE_NACK;
|
||||
}
|
||||
return data[0];
|
||||
}
|
||||
|
||||
/** Write an 8-bit register on a slave device.
|
||||
*
|
||||
* This function writes an 8-bit addressed, 8-bit register from the i2c
|
||||
* bus. The function writes data by
|
||||
* transmitting the register addr and then
|
||||
* transmitting the data to the slave device.
|
||||
*
|
||||
* \param i the interface to the I2C master
|
||||
* \param device_addr the address of the slave device to write to
|
||||
* \param reg the address of the register to write
|
||||
* \param data the 8-bit value to write
|
||||
*/
|
||||
inline i2c_regop_res_t write_reg(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint8_t reg, uint8_t data)
|
||||
{
|
||||
uint8_t a_data[2] = {reg, data};
|
||||
size_t n;
|
||||
i.write(device_addr, a_data, 2, n, 1);
|
||||
if (n == 0) {
|
||||
return I2C_REGOP_DEVICE_NACK;
|
||||
}
|
||||
if (n < 2) {
|
||||
return I2C_REGOP_INCOMPLETE;
|
||||
}
|
||||
return I2C_REGOP_SUCCESS;
|
||||
}
|
||||
|
||||
/** Read an 8-bit register on a slave device from a 16-bit register address.
|
||||
*
|
||||
* This function reads a 16-bit addressed, 8-bit register from the i2c
|
||||
* bus. The function reads data by
|
||||
* transmitting the register addr and then reading the data from the slave
|
||||
* device.
|
||||
*
|
||||
* Note that no stop bit is transmitted between the write and the read.
|
||||
* The operation is performed as one transaction using a repeated start.
|
||||
*
|
||||
* \param i the interface to the I2C master
|
||||
* \param device_addr the address of the slave device to read from
|
||||
* \param reg the 16-bit address of the register to read
|
||||
* (most significant byte first)
|
||||
* \param result indicates whether the read completed successfully. Will
|
||||
* be set to ``I2C_REGOP_DEVICE_NACK`` if the slave NACKed,
|
||||
* and ``I2C_REGOP_SUCCESS`` on successful completion of the
|
||||
* read.
|
||||
*
|
||||
* \returns the value of the register
|
||||
*/
|
||||
inline uint8_t read_reg8_addr16(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint16_t reg,
|
||||
i2c_regop_res_t &result)
|
||||
{
|
||||
uint8_t a_reg[2] = {reg >> 8, reg};
|
||||
uint8_t data[1];
|
||||
size_t n;
|
||||
i2c_res_t res;
|
||||
i.write(device_addr, a_reg, 2, n, 0);
|
||||
if (n != 2) {
|
||||
result = I2C_REGOP_DEVICE_NACK;
|
||||
i.send_stop_bit();
|
||||
return 0;
|
||||
}
|
||||
res = i.read(device_addr, data, 1, 1);
|
||||
if (res == I2C_NACK) {
|
||||
result = I2C_REGOP_DEVICE_NACK;
|
||||
} else {
|
||||
result = I2C_REGOP_SUCCESS;
|
||||
}
|
||||
return data[0];
|
||||
}
|
||||
|
||||
/** Write an 8-bit register on a slave device from a 16-bit register address.
|
||||
*
|
||||
* This function writes a 16-bit addressed, 8-bit register from the i2c
|
||||
* bus. The function writes data by
|
||||
* transmitting the register addr and then
|
||||
* transmitting the data to the slave device.
|
||||
*
|
||||
* \param i the interface to the I2C master
|
||||
* \param device_addr the address of the slave device to write to
|
||||
* \param reg the 16-bit address of the register to write
|
||||
* (most significant byte first)
|
||||
* \param data the 8-bit value to write
|
||||
*/
|
||||
inline i2c_regop_res_t write_reg8_addr16(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint16_t reg,
|
||||
uint8_t data) {
|
||||
uint8_t a_data[3] = {reg >> 8, reg, data};
|
||||
size_t n;
|
||||
i.write(device_addr, a_data, 3, n, 1);
|
||||
if (n == 0) {
|
||||
return I2C_REGOP_DEVICE_NACK;
|
||||
}
|
||||
if (n < 3) {
|
||||
return I2C_REGOP_INCOMPLETE;
|
||||
}
|
||||
return I2C_REGOP_SUCCESS;
|
||||
}
|
||||
|
||||
/** Read an 16-bit register on a slave device from a 16-bit register address.
|
||||
*
|
||||
* This function reads a 16-bit addressed, 16-bit register from the i2c
|
||||
* bus. The function reads data by transmitting the register addr and then
|
||||
* reading the data from the slave device. It is assumed the data is returned
|
||||
* most significant byte first on the bus.
|
||||
*
|
||||
* Note that no stop bit is transmitted between the write and the read.
|
||||
* The operation is performed as one transaction using a repeated start.
|
||||
*
|
||||
* \param i the interface to the I2C master
|
||||
* \param device_addr the address of the slave device to read from
|
||||
* \param reg the address of the register to read (most
|
||||
* significant byte first)
|
||||
* \param result indicates whether the read completed successfully. Will
|
||||
* be set to ``I2C_REGOP_DEVICE_NACK`` if the slave NACKed,
|
||||
* and ``I2C_REGOP_SUCCESS`` on successful completion of the
|
||||
* read.
|
||||
*
|
||||
* \returns the 16-bit value of the register
|
||||
*/
|
||||
inline uint16_t read_reg16(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint16_t reg,
|
||||
i2c_regop_res_t &result)
|
||||
{
|
||||
uint8_t a_reg[2] = {reg >> 8, reg};
|
||||
uint8_t data[2];
|
||||
size_t n;
|
||||
i2c_res_t res;
|
||||
i.write(device_addr, a_reg, 2, n, 0);
|
||||
if (n != 2) {
|
||||
result = I2C_REGOP_DEVICE_NACK;
|
||||
i.send_stop_bit();
|
||||
return 0;
|
||||
}
|
||||
res = i.read(device_addr, data, 2, 1);
|
||||
if (res == I2C_NACK) {
|
||||
result = I2C_REGOP_DEVICE_NACK;
|
||||
} else {
|
||||
result = I2C_REGOP_SUCCESS;
|
||||
}
|
||||
return ((uint16_t) data[0] << 8) | data[1];
|
||||
}
|
||||
|
||||
/** Write an 16-bit register on a slave device from a 16-bit register address.
|
||||
*
|
||||
* This function writes a 16-bit addressed, 16-bit register from the i2c
|
||||
* bus. The function writes data by transmitting the register addr and then
|
||||
* transmitting the data to the slave device.
|
||||
*
|
||||
* \param i the interface to the I2C master
|
||||
* \param device_addr the address of the slave device to write to
|
||||
* \param reg the 16-bit address of the register to write
|
||||
* (most significant byte first)
|
||||
* \param data the 16-bit value to write (most significant
|
||||
* byte first)
|
||||
*
|
||||
* \returns ``I2C_REGOP_DEVICE_NACK`` if the address is NACKed,
|
||||
* ``I2C_REGOP_INCOMPLETE`` if not all data was ACKed and
|
||||
* ``I2C_REGOP_SUCCESS`` on successful completion of the
|
||||
* write with every byte being ACKed.
|
||||
*/
|
||||
inline i2c_regop_res_t write_reg16(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint16_t reg,
|
||||
uint16_t data) {
|
||||
uint8_t a_data[4] = {reg >> 8, reg, data >> 8, data};
|
||||
size_t n;
|
||||
i.write(device_addr, a_data, 4, n, 1);
|
||||
if (n == 0) {
|
||||
return I2C_REGOP_DEVICE_NACK;
|
||||
}
|
||||
if (n < 4) {
|
||||
return I2C_REGOP_INCOMPLETE;
|
||||
}
|
||||
return I2C_REGOP_SUCCESS;
|
||||
}
|
||||
|
||||
/** Read an 16-bit register on a slave device from a 8-bit register address.
|
||||
*
|
||||
* This function reads a 8-bit addressed, 16-bit register from the i2c
|
||||
* bus. The function reads data by transmitting the register addr and
|
||||
* then reading the data from the slave device. It is assumed that the data
|
||||
* is return most significant byte first on the bus.
|
||||
*
|
||||
* Note that no stop bit is transmitted between the write and the read.
|
||||
* The operation is performed as one transaction using a repeated start.
|
||||
*
|
||||
* \param i the interface to the I2C master
|
||||
* \param device_addr the address of the slave device to read from
|
||||
* \param reg the address of the register to read
|
||||
* \param result indicates whether the read completed successfully. Will
|
||||
* be set to ``I2C_REGOP_DEVICE_NACK`` if the slave NACKed,
|
||||
* and ``I2C_REGOP_SUCCESS`` on successful completion of the
|
||||
* read.
|
||||
*
|
||||
* \returns the 16-bit value of the register
|
||||
*/
|
||||
inline uint16_t read_reg16_addr8(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint8_t reg,
|
||||
i2c_regop_res_t &result)
|
||||
{
|
||||
uint8_t a_reg[1] = {reg};
|
||||
uint8_t data[2];
|
||||
size_t n;
|
||||
i2c_res_t res;
|
||||
i.write(device_addr, a_reg, 1, n, 0);
|
||||
if (n != 1) {
|
||||
result = I2C_REGOP_DEVICE_NACK;
|
||||
i.send_stop_bit();
|
||||
return 0;
|
||||
}
|
||||
res = i.read(device_addr, data, 2, 1);
|
||||
if (res == I2C_NACK) {
|
||||
result = I2C_REGOP_DEVICE_NACK;
|
||||
} else {
|
||||
result = I2C_REGOP_SUCCESS;
|
||||
}
|
||||
return ((uint16_t) data[0] << 8) | data[1];
|
||||
}
|
||||
|
||||
/** Write an 16-bit register on a slave device from a 8-bit register address.
|
||||
*
|
||||
* This function writes a 8-bit addressed, 16-bit register from the i2c
|
||||
* bus. The function writes data by transmitting the register addr and then
|
||||
* transmitting the data to the slave device.
|
||||
*
|
||||
* \param i the interface to the I2C master
|
||||
* \param device_addr the address of the slave device to write to
|
||||
* \param reg the address of the register to write
|
||||
* \param data the 16-bit value to write (most significant byte first)
|
||||
*
|
||||
* \returns ``I2C_REGOP_DEVICE_NACK`` if the address is NACKed,
|
||||
* ``I2C_REGOP_INCOMPLETE`` if not all data was ACKed and
|
||||
* ``I2C_REGOP_SUCCESS`` on successful completion of the
|
||||
* write with every byte being ACKed.
|
||||
*/
|
||||
inline i2c_regop_res_t write_reg16_addr8(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint8_t reg,
|
||||
uint16_t data) {
|
||||
uint8_t a_data[3] = {reg, data >> 8, data};
|
||||
size_t n;
|
||||
i.write(device_addr, a_data, 3, n, 1);
|
||||
if (n == 0) {
|
||||
return I2C_REGOP_DEVICE_NACK;
|
||||
}
|
||||
if (n < 3) {
|
||||
return I2C_REGOP_INCOMPLETE;
|
||||
}
|
||||
return I2C_REGOP_SUCCESS;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/** Implements I2C on the i2c_master_if interface using two ports.
|
||||
*
|
||||
* \param i an array of server interface connections for clients
|
||||
* to connect to
|
||||
* \param n the number of clients connected
|
||||
* \param p_scl the SCL port of the I2C bus
|
||||
* \param p_sda the SDA port of the I2C bus
|
||||
* \param kbits_per_second the speed of the I2C bus
|
||||
**/
|
||||
[[distributable]] void i2c_master(server interface i2c_master_if i[n],
|
||||
size_t n,
|
||||
port p_scl, port p_sda,
|
||||
static const unsigned kbits_per_second);
|
||||
|
||||
#if (defined(__XS2A__) || defined(__XS3A__) || defined(__DOXYGEN__))
|
||||
/** Implements I2C on a single multi-bit port.
|
||||
*
|
||||
* This function implements an I2C master bus using a single port. It is only
|
||||
* supported on xCORE-200 devices.
|
||||
*
|
||||
* \param c an array of server interface connections for clients
|
||||
* to connect to
|
||||
* \param n the number of clients connected
|
||||
* \param p_i2c the multi-bit port containing both SCL and SDA.
|
||||
* the bit positions of SDA and SCL are configured using the
|
||||
* ``sda_bit_position`` and ``scl_bit_position`` arguments.
|
||||
* \param kbits_per_second the speed of the I2C bus
|
||||
* \param sda_bit_position the bit of the SDA line on the port
|
||||
* \param scl_bit_position the bit of the SCL line on the port
|
||||
* \param other_bits_mask a value that is ORed into the port value driven
|
||||
* to ``p_i2c``. The SDA and SCL bit values for this
|
||||
* variable must be set to 0. Note that ``p_i2c`` is
|
||||
* configured with set_port_drive_low() and
|
||||
* therefore external pullup resistors are required
|
||||
* to produce a value 1 on a bit.
|
||||
*/
|
||||
[[distributable]]
|
||||
void i2c_master_single_port(server interface i2c_master_if c[n], static const size_t n,
|
||||
port p_i2c, static const unsigned kbits_per_second,
|
||||
static const unsigned scl_bit_position,
|
||||
static const unsigned sda_bit_position,
|
||||
static const unsigned other_bits_mask);
|
||||
#endif
|
||||
|
||||
|
||||
/** This interface is used to communicate with an I2C master component
|
||||
* asynchronously.
|
||||
* It provides facilities for reading and writing to the bus.
|
||||
*
|
||||
*/
|
||||
typedef interface i2c_master_async_if {
|
||||
|
||||
/** Initialize a write to an I2C bus.
|
||||
*
|
||||
* \param device_addr the address of the slave device to write to
|
||||
* \param buf the buffer containing data to write
|
||||
* \param n the number of bytes to write
|
||||
* \param send_stop_bit if this is non-zero then a stop bit
|
||||
* will be sent on the bus after the transaction.
|
||||
* This is usually required for normal operation. If
|
||||
* this parameter is zero then no stop bit will
|
||||
* be omitted. In this case, no other task can use
|
||||
* the component until a stop bit has been sent.
|
||||
*/
|
||||
[[guarded]]
|
||||
void write(uint8_t device_addr, uint8_t buf[n], size_t n,
|
||||
int send_stop_bit);
|
||||
|
||||
/** Initialize a read to an I2C bus.
|
||||
*
|
||||
* \param device_addr the address of the slave device to read from.
|
||||
* \param n the number of bytes to read.
|
||||
* \param send_stop_bit if this is non-zero then a stop bit
|
||||
* will be sent on the bus after the transaction.
|
||||
* This is usually required for normal operation. If
|
||||
* this parameter is zero then no stop bit will
|
||||
* be omitted. In this case, no other task can use
|
||||
* the component until a stop bit has been sent.
|
||||
*/
|
||||
[[guarded]]
|
||||
void read(uint8_t device_addr, size_t n, int send_stop_bit);
|
||||
|
||||
/** Completed operation notification.
|
||||
*
|
||||
* This notification will fire when a read or write is completed.
|
||||
*/
|
||||
[[notification]]
|
||||
slave void operation_complete(void);
|
||||
|
||||
/** Get write result.
|
||||
*
|
||||
* This function should be called after a write has completed.
|
||||
*
|
||||
* \param num_bytes_sent the function will set this value to the
|
||||
* number of bytes actually sent. On success, this
|
||||
* will be equal to ``n`` but it will be less if the
|
||||
* slave sends an early NACK on the bus and the
|
||||
* transaction fails.
|
||||
*
|
||||
* \returns ``I2C_ACK`` if the write was acknowledged by the slave
|
||||
* device, otherwise ``I2C_NACK``.
|
||||
*/
|
||||
[[clears_notification]]
|
||||
i2c_res_t get_write_result(size_t &num_bytes_sent);
|
||||
|
||||
|
||||
/** Get read result.
|
||||
*
|
||||
* This function should be called after a read has completed.
|
||||
*
|
||||
* \param buf the buffer to fill with data.
|
||||
* \param n the number of bytes to read, this should be the same
|
||||
* as the number of bytes specified in read(),
|
||||
* otherwise the behavior is undefined.
|
||||
*
|
||||
* \returns ``I2C_ACK`` if the write was acknowledged by the slave
|
||||
* device, otherwise ``I2C_NACK``.
|
||||
*/
|
||||
[[clears_notification]]
|
||||
i2c_res_t get_read_data(uint8_t buf[n], size_t n);
|
||||
|
||||
/** Send a stop bit.
|
||||
*
|
||||
* This function will cause a stop bit to be sent on the bus. It should
|
||||
* be used to complete/abort a transaction if the ``send_stop_bit`` argument
|
||||
* was not set when calling the read() or write() functions.
|
||||
*/
|
||||
void send_stop_bit(void);
|
||||
|
||||
|
||||
/** Shutdown the I2C component.
|
||||
*
|
||||
* This function will cause the I2C task to shutdown and return.
|
||||
*/
|
||||
void shutdown();
|
||||
} i2c_master_async_if;
|
||||
|
||||
/** I2C master component (asynchronous API).
|
||||
*
|
||||
* This function implements I2C and allows clients to asynchronously
|
||||
* perform operations on the bus.
|
||||
*
|
||||
* \param i the interfaces to connect the component to its clients
|
||||
* \param n the number of clients connected to the component
|
||||
* \param p_scl the SCL port of the I2C bus
|
||||
* \param p_sda the SDA port of the I2C bus
|
||||
* \param kbits_per_second the speed of the I2C bus
|
||||
* \param max_transaction_size the size of the local buffer in bytes. Any
|
||||
* transactions exceeding this size will cause a
|
||||
* run-time exception.
|
||||
*
|
||||
*/
|
||||
void i2c_master_async(server interface i2c_master_async_if i[n],
|
||||
size_t n,
|
||||
port p_scl, port p_sda,
|
||||
static const unsigned kbits_per_second,
|
||||
static const size_t max_transaction_size);
|
||||
|
||||
/** I2C master component (asynchronous API, combinable).
|
||||
*
|
||||
* This function implements I2C and allows clients to asynchronously
|
||||
* perform operations on the bus.
|
||||
* Note that this component can be run on the same logical core as other
|
||||
* tasks (i.e. it is [[combinable]]). However, care must be taken that the
|
||||
* other tasks do not take too long in their select cases otherwise this
|
||||
* component may miss I2C transactions.
|
||||
*
|
||||
* \param i the interfaces to connect the component to its clients
|
||||
* \param n the number of clients connected to the component
|
||||
* \param p_scl the SCL port of the I2C bus
|
||||
* \param p_sda the SDA port of the I2C bus
|
||||
* \param kbits_per_second the speed of the I2C bus
|
||||
* \param max_transaction_size the size of the local buffer in bytes. Any
|
||||
* transactions exceeding this size will cause a
|
||||
* run-time exception.
|
||||
*/
|
||||
[[combinable]]
|
||||
void i2c_master_async_comb(server interface i2c_master_async_if i[n],
|
||||
size_t n,
|
||||
port p_scl, port p_sda,
|
||||
static const unsigned kbits_per_second,
|
||||
static const size_t max_transaction_size);
|
||||
|
||||
|
||||
|
||||
typedef enum i2c_slave_ack_t {
|
||||
I2C_SLAVE_ACK,
|
||||
I2C_SLAVE_NACK,
|
||||
} i2c_slave_ack_t;
|
||||
|
||||
/** This interface is used to communicate with an I2C slave component.
|
||||
* It provides facilities for reading and writing to the bus. The I2C slave
|
||||
* component acts a *client* to this interface. So the application must
|
||||
* respond to these calls (i.e. the members of the interface are callbacks
|
||||
* to the application).
|
||||
*
|
||||
*/
|
||||
typedef interface i2c_slave_callback_if {
|
||||
|
||||
/** Master has requested a read.
|
||||
*
|
||||
* This callback function is called by the component
|
||||
* if the bus master requests a read from this slave device.
|
||||
*
|
||||
* At this point the slave can choose to accept the request (and
|
||||
* drive an ACK signal back to the master) or not (and drive a NACK
|
||||
* signal).
|
||||
*
|
||||
* \returns the callback must return either ``I2C_SLAVE_ACK`` or
|
||||
* ``I2C_SLAVE_NACK``.
|
||||
*/
|
||||
[[guarded]]
|
||||
i2c_slave_ack_t ack_read_request(void);
|
||||
|
||||
|
||||
/** Master has requested a write.
|
||||
*
|
||||
* This callback function is called by the component
|
||||
* if the bus master requests a write from this slave device.
|
||||
*
|
||||
* At this point the slave can choose to accept the request (and
|
||||
* drive an ACK signal back to the master) or not (and drive a NACK
|
||||
* signal).
|
||||
*
|
||||
* \returns the callback must return either ``I2C_SLAVE_ACK`` or
|
||||
* ``I2C_SLAVE_NACK``.
|
||||
*/
|
||||
[[guarded]]
|
||||
i2c_slave_ack_t ack_write_request(void);
|
||||
|
||||
/** Master requires data.
|
||||
*
|
||||
* This callback function will be called when the I2C master requires data
|
||||
* from the slave.
|
||||
*
|
||||
* \return the data to pass to the master.
|
||||
*/
|
||||
[[guarded]]
|
||||
uint8_t master_requires_data();
|
||||
|
||||
/** Master has sent some data.
|
||||
*
|
||||
* This callback function will be called when the I2C master has transferred
|
||||
* a byte of data to the slave.
|
||||
*/
|
||||
[[guarded]]
|
||||
i2c_slave_ack_t master_sent_data(uint8_t data);
|
||||
|
||||
|
||||
/** Stop bit.
|
||||
*
|
||||
* This callback function will be called by the component when a stop bit
|
||||
* is sent by the master.
|
||||
*/
|
||||
void stop_bit(void);
|
||||
|
||||
/** Shutdown the I2C component.
|
||||
*
|
||||
* This function will cause the I2C slave task to shutdown and return.
|
||||
*/
|
||||
[[notification]] slave void shutdown();
|
||||
} i2c_slave_callback_if;
|
||||
|
||||
|
||||
/** I2C slave task.
|
||||
*
|
||||
* This function instantiates an i2c_slave component.
|
||||
*
|
||||
* \param i the client end of the i2c_slave_callback_if interface. The component
|
||||
* takes the client end and will make calls on the interface when
|
||||
* the master performs reads or writes.
|
||||
* \param p_scl the SCL port of the I2C bus
|
||||
* \param p_sda the SDA port of the I2C bus
|
||||
* \param device_addr the address of the slave device
|
||||
*
|
||||
*/
|
||||
[[combinable]]
|
||||
void i2c_slave(client i2c_slave_callback_if i,
|
||||
port p_scl, port p_sda,
|
||||
uint8_t device_addr);
|
||||
|
||||
#endif // __XC__
|
||||
|
||||
#endif
|
||||
7
lib_i2c/lib_i2c/lib_build_info.cmake
Normal file
7
lib_i2c/lib_i2c/lib_build_info.cmake
Normal file
@@ -0,0 +1,7 @@
|
||||
set(LIB_NAME lib_i2c)
|
||||
set(LIB_VERSION 6.2.0)
|
||||
set(LIB_INCLUDES api)
|
||||
set(LIB_DEPENDENT_MODULES "lib_xassert(4.2.0)")
|
||||
set(LIB_COMPILER_FLAGS -Os)
|
||||
|
||||
XMOS_REGISTER_MODULE()
|
||||
14
lib_i2c/lib_i2c/module_build_info
Normal file
14
lib_i2c/lib_i2c/module_build_info
Normal file
@@ -0,0 +1,14 @@
|
||||
VERSION = 6.2.0
|
||||
|
||||
DEPENDENT_MODULES = lib_xassert(>=4.2.0)
|
||||
|
||||
MODULE_XCC_FLAGS = $(XCC_FLAGS) \
|
||||
-Os
|
||||
|
||||
OPTIONAL_HEADERS +=
|
||||
|
||||
EXPORT_INCLUDE_DIRS = api
|
||||
|
||||
INCLUDE_DIRS = $(EXPORT_INCLUDE_DIRS)
|
||||
|
||||
SOURCE_DIRS = src
|
||||
294
lib_i2c/lib_i2c/src/i2c_master.xc
Normal file
294
lib_i2c/lib_i2c/src/i2c_master.xc
Normal file
@@ -0,0 +1,294 @@
|
||||
// Copyright 2011-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
#include <i2c.h>
|
||||
#include <xs1.h>
|
||||
#include <xclib.h>
|
||||
#include <timer.h>
|
||||
|
||||
#include "xassert.h"
|
||||
|
||||
/* NOTE: the kbits_per_second needs to be passed around due to the fact that the
|
||||
* compiler won't compute a new static const from a static const.
|
||||
*/
|
||||
|
||||
/** Return the number of 10ns timer ticks required to meet the timing as defined
|
||||
* in the standards.
|
||||
*/
|
||||
static const unsigned inline compute_low_period_ticks(
|
||||
static const unsigned kbits_per_second)
|
||||
{
|
||||
unsigned ticks = 0;
|
||||
if (kbits_per_second <= 100) {
|
||||
const unsigned four_point_seven_micro_seconds_in_ticks = 470;
|
||||
ticks = four_point_seven_micro_seconds_in_ticks;
|
||||
} else if (kbits_per_second <= 400) {
|
||||
const unsigned one_point_three_micro_seconds_in_ticks = 130;
|
||||
ticks = one_point_three_micro_seconds_in_ticks;
|
||||
} else {
|
||||
fail("Fast-mode Plus not implemented");
|
||||
}
|
||||
|
||||
// There is some jitter on the falling edges of the clock. In order to ensure
|
||||
// that the low period is respected we need to extend the minimum low period.
|
||||
const unsigned jitter_ticks = 3;
|
||||
return ticks + jitter_ticks;
|
||||
}
|
||||
|
||||
static const unsigned inline compute_bus_off_ticks(
|
||||
static const unsigned kbits_per_second)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
|
||||
// Ensure the bus off time is respected. This is just over 1/2 bit time in
|
||||
// the case of the Fast-mode I2C so adding bit_time/16 ensures the timing
|
||||
// will be enforced
|
||||
return bit_time/2 + bit_time/16;
|
||||
}
|
||||
|
||||
/** Releases the SCL line, reads it back and waits until it goes high (in
|
||||
* case the slave is clock stretching).
|
||||
* Since the line going high may be delayed, the fall_time value may
|
||||
* need to be adjusted
|
||||
*/
|
||||
static void release_clock_and_wait(
|
||||
port p_scl,
|
||||
unsigned &fall_time,
|
||||
unsigned delay)
|
||||
{
|
||||
p_scl when pinseq(1) :> void;
|
||||
|
||||
timer tmr;
|
||||
unsigned time;
|
||||
tmr when timerafter(fall_time + delay) :> time;
|
||||
|
||||
// Adjust timing due to support clock stretching without clock drift in the
|
||||
// normal case.
|
||||
|
||||
// If the time is beyond the time it takes simply to wake up and start
|
||||
// executing then the clock needs to be adjusted
|
||||
const int wake_up_ticks = 10;
|
||||
if (time > fall_time + delay + wake_up_ticks) {
|
||||
fall_time = time - delay - wake_up_ticks;
|
||||
}
|
||||
}
|
||||
|
||||
/** 'Pulse' the clock line high and in the middle of the high period
|
||||
* sample the data line (if required). Timing is done via the fall_time
|
||||
* reference and bit_time period supplied.
|
||||
*/
|
||||
[[always_inline]]
|
||||
static int inline high_pulse_sample(
|
||||
port p_scl,
|
||||
port p_sda,
|
||||
static const unsigned kbits_per_second,
|
||||
unsigned &fall_time)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
|
||||
int sample_value = 0;
|
||||
timer tmr;
|
||||
p_sda :> int _;
|
||||
tmr when timerafter(fall_time + compute_low_period_ticks(kbits_per_second)) :> void;
|
||||
release_clock_and_wait(p_scl, fall_time, (bit_time * 3) / 4);
|
||||
p_sda :> sample_value;
|
||||
fall_time = fall_time + bit_time;
|
||||
tmr when timerafter(fall_time) :> void;
|
||||
p_scl <: 0;
|
||||
// Mask off all but lowest bit of input - allows use of bit[0] of multibit port
|
||||
return sample_value & 1;
|
||||
}
|
||||
|
||||
/** 'Pulse' the clock line high. Timing is done via the fall_time
|
||||
* reference and bit_time period supplied.
|
||||
*/
|
||||
[[always_inline]]
|
||||
static void inline high_pulse(
|
||||
port p_scl,
|
||||
static const unsigned kbits_per_second,
|
||||
unsigned &fall_time)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
|
||||
timer tmr;
|
||||
tmr when timerafter(fall_time + compute_low_period_ticks(kbits_per_second)) :> void;
|
||||
release_clock_and_wait(p_scl, fall_time, (bit_time * 3) / 4);
|
||||
fall_time = fall_time + bit_time;
|
||||
tmr when timerafter(fall_time) :> void;
|
||||
p_scl <: 0;
|
||||
}
|
||||
|
||||
/** Output a start bit. The function returns the 'fall time' i.e. the
|
||||
* reference clock time when the SCL line transitions to low.
|
||||
*/
|
||||
static void start_bit(
|
||||
port p_scl,
|
||||
port p_sda,
|
||||
static const unsigned kbits_per_second,
|
||||
unsigned &fall_time,
|
||||
int stopped)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
|
||||
timer tmr;
|
||||
|
||||
if (!stopped) {
|
||||
fall_time += compute_low_period_ticks(kbits_per_second);
|
||||
tmr when timerafter(fall_time) :> fall_time;
|
||||
release_clock_and_wait(p_scl, fall_time, compute_bus_off_ticks(kbits_per_second));
|
||||
}
|
||||
|
||||
// Drive SDA low
|
||||
p_sda <: 0;
|
||||
delay_ticks(bit_time / 2);
|
||||
// Drive SCL low
|
||||
p_scl <: 0;
|
||||
|
||||
// Record
|
||||
tmr :> fall_time;
|
||||
}
|
||||
|
||||
/** Output a stop bit.
|
||||
*/
|
||||
static void stop_bit(
|
||||
port p_scl,
|
||||
port p_sda,
|
||||
static const unsigned kbits_per_second,
|
||||
unsigned &fall_time)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
|
||||
timer tmr;
|
||||
p_sda <: 0;
|
||||
tmr when timerafter(fall_time + compute_low_period_ticks(kbits_per_second)) :> void;
|
||||
release_clock_and_wait(p_scl, fall_time, bit_time);
|
||||
p_sda :> void;
|
||||
delay_ticks(compute_bus_off_ticks(kbits_per_second));
|
||||
}
|
||||
|
||||
/** Transmit 8 bits of data, then read the ack back from the slave and return
|
||||
* that value.
|
||||
*/
|
||||
static int tx8(
|
||||
port p_scl,
|
||||
port p_sda,
|
||||
unsigned data,
|
||||
static const unsigned kbits_per_second,
|
||||
unsigned &fall_time)
|
||||
{
|
||||
// Data is transmitted MSB first
|
||||
data = bitrev(data) >> 24;
|
||||
for (int i = 8; i != 0; i--) {
|
||||
p_sda <: data & 0x1;
|
||||
data >>= 1;
|
||||
high_pulse(p_scl, kbits_per_second, fall_time);
|
||||
}
|
||||
return high_pulse_sample(p_scl, p_sda, kbits_per_second, fall_time);
|
||||
}
|
||||
|
||||
[[distributable]]
|
||||
void i2c_master(
|
||||
server interface i2c_master_if c[n],
|
||||
size_t n,
|
||||
port p_scl,
|
||||
port p_sda,
|
||||
static const unsigned kbits_per_second)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
|
||||
unsigned last_fall_time = 0;
|
||||
unsigned locked_client = -1;
|
||||
p_scl :> void;
|
||||
p_sda :> void;
|
||||
while (1) {
|
||||
select {
|
||||
|
||||
case (size_t i =0; i < n; i++)
|
||||
(n == 1 || (locked_client == -1 || i == locked_client)) =>
|
||||
c[i].read(uint8_t device, uint8_t buf[m], size_t m,
|
||||
int send_stop_bit) -> i2c_res_t result:
|
||||
|
||||
const int stopped = locked_client == -1;
|
||||
unsigned fall_time = last_fall_time;
|
||||
start_bit(p_scl, p_sda, kbits_per_second, fall_time, stopped);
|
||||
int ack = tx8(p_scl, p_sda, (device << 1) | 1, kbits_per_second, fall_time);
|
||||
|
||||
if (ack == 0) {
|
||||
for (int j = 0; j < m; j++){
|
||||
unsigned char data = 0;
|
||||
timer tmr;
|
||||
for (int i = 8; i != 0; i--) {
|
||||
int temp = high_pulse_sample(p_scl, p_sda, kbits_per_second, fall_time);
|
||||
data = (data << 1) | temp;
|
||||
}
|
||||
buf[j] = data;
|
||||
|
||||
tmr when timerafter(fall_time + bit_time/4) :> void;
|
||||
// ACK after every read byte until the final byte then NACK.
|
||||
if (j == m-1)
|
||||
p_sda :> void;
|
||||
else {
|
||||
p_sda <: 0;
|
||||
}
|
||||
// High pulse but make sure SDA is not driving before lowering SCL
|
||||
tmr when timerafter(fall_time + compute_low_period_ticks(kbits_per_second)) :> void;
|
||||
high_pulse(p_scl, kbits_per_second, fall_time);
|
||||
p_sda :> void;
|
||||
}
|
||||
}
|
||||
if (send_stop_bit) {
|
||||
stop_bit(p_scl, p_sda, kbits_per_second, fall_time);
|
||||
locked_client = -1;
|
||||
}
|
||||
else {
|
||||
locked_client = i;
|
||||
}
|
||||
|
||||
result = (ack == 0) ? I2C_ACK : I2C_NACK;
|
||||
|
||||
// Remember the last fall time to ensure the next start bit is valid
|
||||
last_fall_time = fall_time;
|
||||
break;
|
||||
|
||||
case (size_t i = 0; i < n; i++)
|
||||
(n == 1 || (locked_client == -1 || i == locked_client)) =>
|
||||
c[i].write(uint8_t device, uint8_t buf[n], size_t n,
|
||||
size_t &num_bytes_sent,
|
||||
int send_stop_bit) -> i2c_res_t result:
|
||||
unsigned fall_time = last_fall_time;
|
||||
const int stopped = locked_client == -1;
|
||||
start_bit(p_scl, p_sda, kbits_per_second, fall_time, stopped);
|
||||
int ack = tx8(p_scl, p_sda, (device << 1), kbits_per_second, fall_time);
|
||||
int j = 0;
|
||||
for (; j < n; j++) {
|
||||
if (ack != 0) {
|
||||
break;
|
||||
}
|
||||
ack = tx8(p_scl, p_sda, buf[j], kbits_per_second, fall_time);
|
||||
}
|
||||
if (send_stop_bit) {
|
||||
stop_bit(p_scl, p_sda, kbits_per_second, fall_time);
|
||||
locked_client = -1;
|
||||
} else {
|
||||
locked_client = i;
|
||||
}
|
||||
num_bytes_sent = j;
|
||||
result = (ack == 0) ? I2C_ACK : I2C_NACK;
|
||||
|
||||
// Remember the last fall time to ensure the next start bit is valid
|
||||
last_fall_time = fall_time;
|
||||
break;
|
||||
|
||||
case c[int i].send_stop_bit(void):
|
||||
timer tmr;
|
||||
unsigned fall_time;
|
||||
tmr :> fall_time;
|
||||
stop_bit(p_scl, p_sda, kbits_per_second, fall_time);
|
||||
locked_client = -1;
|
||||
break;
|
||||
|
||||
case c[int i].shutdown(void):
|
||||
return;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
526
lib_i2c/lib_i2c/src/i2c_master_async.xc
Normal file
526
lib_i2c/lib_i2c/src/i2c_master_async.xc
Normal file
@@ -0,0 +1,526 @@
|
||||
// Copyright 2015-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
#include <i2c.h>
|
||||
#include <xs1.h>
|
||||
#include <string.h>
|
||||
#include <print.h>
|
||||
#include <syscall.h>
|
||||
#include <xassert.h>
|
||||
|
||||
enum i2c_async_master_state_t {
|
||||
IDLE,
|
||||
REPEATED_START_CLOCK_LOW,
|
||||
REPEATED_START_WAIT_FOR_CLOCK_HIGH,
|
||||
REPEATED_START_HOLD_CLOCK_HIGH,
|
||||
START_BIT_0,
|
||||
START_BIT_1,
|
||||
WRITE_0,
|
||||
WRITE_1,
|
||||
WRITE_ACK_0,
|
||||
WRITE_ACK_1,
|
||||
WRITE_ACK_2,
|
||||
READ_0,
|
||||
READ_1,
|
||||
READ_2,
|
||||
READ_ACK_0,
|
||||
READ_ACK_1,
|
||||
STOP_BIT_0,
|
||||
STOP_BIT_1,
|
||||
STOP_BIT_2,
|
||||
STOP_BIT_3,
|
||||
STOP_BIT_4,
|
||||
DONE_NO_STOP,
|
||||
};
|
||||
|
||||
enum optype_t {
|
||||
WRITE = 0, READ = 1, SEND_STOP_BIT = 2
|
||||
};
|
||||
|
||||
enum ack_t {
|
||||
ACKED = 0, NACKED = 1,
|
||||
};
|
||||
|
||||
|
||||
void i2c_master_async_aux(
|
||||
server interface i2c_master_async_if i[n],
|
||||
size_t n,
|
||||
client interface i2c_master_if i2c,
|
||||
static const size_t max_transaction_size)
|
||||
{
|
||||
uint8_t buf[max_transaction_size];
|
||||
uint8_t device_addr;
|
||||
size_t num_bytes, num_bytes_sent;
|
||||
int send_stop_bit = 0;
|
||||
int optype = 0;
|
||||
int cur_client = -1;
|
||||
i2c_res_t res = I2C_ACK;
|
||||
|
||||
while (1) {
|
||||
select {
|
||||
case i[int j].write(uint8_t addr, uint8_t buf0[n], size_t n,
|
||||
int ssb):
|
||||
device_addr = addr;
|
||||
send_stop_bit = ssb;
|
||||
optype = WRITE;
|
||||
num_bytes = n;
|
||||
memcpy(buf, buf0, n);
|
||||
cur_client = j;
|
||||
break;
|
||||
case i[int j].read(uint8_t addr, size_t n, int ssb):
|
||||
device_addr = addr;
|
||||
send_stop_bit = ssb;
|
||||
optype = READ;
|
||||
num_bytes = n;
|
||||
cur_client = j;
|
||||
break;
|
||||
case i[int j].send_stop_bit():
|
||||
optype = WRITE;
|
||||
cur_client = j;
|
||||
break;
|
||||
case i[int j].shutdown():
|
||||
return;
|
||||
case i[int j].get_write_result(size_t &nbs) -> i2c_res_t result:
|
||||
// ERROR
|
||||
break;
|
||||
case i[int j].get_read_data(uint8_t buf0[n], size_t n) -> i2c_res_t result:
|
||||
// ERROR
|
||||
break;
|
||||
|
||||
}
|
||||
switch (optype) {
|
||||
case WRITE:
|
||||
res = i2c.write(device_addr, buf, num_bytes, num_bytes_sent,
|
||||
send_stop_bit);
|
||||
break;
|
||||
case READ:
|
||||
res = i2c.read(device_addr, buf, num_bytes, send_stop_bit);
|
||||
break;
|
||||
case SEND_STOP_BIT:
|
||||
i2c.send_stop_bit();
|
||||
break;
|
||||
}
|
||||
|
||||
i[cur_client].operation_complete();
|
||||
|
||||
select {
|
||||
case i[int j].get_write_result(size_t &nbs) -> i2c_res_t result:
|
||||
nbs = num_bytes_sent;
|
||||
result = res;
|
||||
break;
|
||||
case i[int j].get_read_data(uint8_t buf0[n], size_t n) -> i2c_res_t result:
|
||||
memcpy(buf0, buf, n);
|
||||
result = res;
|
||||
break;
|
||||
case i[int j].shutdown():
|
||||
return;
|
||||
case i[int j].send_stop_bit():
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
void i2c_master_async(
|
||||
server interface i2c_master_async_if i[n],
|
||||
size_t n,
|
||||
port p_scl, port p_sda,
|
||||
static const unsigned kbits_per_second,
|
||||
static const size_t max_transaction_size)
|
||||
{
|
||||
i2c_master_if i2c_dist[1];
|
||||
par {
|
||||
i2c_master(i2c_dist, 1, p_scl, p_sda, kbits_per_second);
|
||||
// Disable 'slices interface preventing analysis' warning
|
||||
#pragma warning disable
|
||||
i2c_master_async_aux(i, n, i2c_dist[0], max_transaction_size);
|
||||
#pragma warning enable
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/* Adjust for time slip.
|
||||
*
|
||||
* All timings of the state machine in i2c_master_async_comb are made
|
||||
* w.r.t the measured fall_time of the SCL line.
|
||||
* If the task keeps up then we will get the speed requested. However,
|
||||
* if the task falls behind due to other processing on the core then
|
||||
* this function will adjust both the next event time and the fall time
|
||||
* reference to slip so that subsequent timings are correct.
|
||||
*/
|
||||
static void inline adjust_for_slip(
|
||||
int now,
|
||||
int &event_time,
|
||||
int &?fall_time)
|
||||
{
|
||||
// This value is the minimum number of timer ticks we estimate we can
|
||||
// get to a new event to from now.
|
||||
const int SLIP_THRESHOLD = 100;
|
||||
if (event_time - now < SLIP_THRESHOLD) {
|
||||
int new_event_time = now + SLIP_THRESHOLD;
|
||||
if (!isnull(fall_time)) {
|
||||
fall_time += new_event_time - event_time;
|
||||
}
|
||||
event_time = new_event_time;
|
||||
}
|
||||
}
|
||||
|
||||
static int inline adjust_fall(
|
||||
int event_time,
|
||||
int now,
|
||||
int fall_time)
|
||||
{
|
||||
const int SLIP_THRESHOLD = 100;
|
||||
if (now - event_time > SLIP_THRESHOLD) {
|
||||
fall_time = fall_time + (now - event_time);
|
||||
}
|
||||
return fall_time;
|
||||
}
|
||||
|
||||
[[combinable]]
|
||||
void i2c_master_async_comb(
|
||||
server interface i2c_master_async_if i[n],
|
||||
size_t n,
|
||||
port p_scl, port p_sda,
|
||||
static const unsigned kbits_per_second,
|
||||
static const size_t max_transaction_size)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
|
||||
uint8_t buf[max_transaction_size] = {};
|
||||
timer tmr;
|
||||
int state = IDLE;
|
||||
int waiting_for_clock_release = 0, timer_enabled = 0;
|
||||
int optype = 0;
|
||||
int fall_time = 0;
|
||||
int data = 0;
|
||||
int bitnum = 0;
|
||||
int bytes_sent = 0;
|
||||
int num_bytes = 0;
|
||||
int event_time = 0;
|
||||
int cur_client = -1;
|
||||
int send_stop_bit = 0;
|
||||
int stopped = 1;
|
||||
i2c_res_t res = I2C_ACK;
|
||||
|
||||
/* These select cases represent the main state machine for the I2C master
|
||||
component. The state machine will change state based on a timer event to
|
||||
progress the transaction or on an event from the SCL line when waiting
|
||||
for the clock to be released (supporting clock stretching). */
|
||||
while (1) {
|
||||
select {
|
||||
|
||||
case waiting_for_clock_release => p_scl when pinseq(1) :> void:
|
||||
int now;
|
||||
tmr :> now;
|
||||
switch (state) {
|
||||
case WRITE_0:
|
||||
case WRITE_ACK_0:
|
||||
case READ_ACK_0:
|
||||
case STOP_BIT_0:
|
||||
case REPEATED_START_WAIT_FOR_CLOCK_HIGH:
|
||||
case READ_0:
|
||||
fall_time = fall_time + bit_time;
|
||||
event_time = fall_time;
|
||||
adjust_for_slip(now, event_time, fall_time);
|
||||
break;
|
||||
case WRITE_ACK_1:
|
||||
fall_time = fall_time + bit_time;
|
||||
event_time = fall_time - bit_time / 4;
|
||||
adjust_for_slip(now, event_time, fall_time);
|
||||
state = WRITE_ACK_2;
|
||||
break;
|
||||
case STOP_BIT_2:
|
||||
event_time = now + bit_time / 2;
|
||||
adjust_for_slip(now, event_time, null);
|
||||
state = STOP_BIT_3;
|
||||
break;
|
||||
case READ_1:
|
||||
fall_time = fall_time + bit_time;
|
||||
event_time = fall_time - bit_time / 4;
|
||||
adjust_for_slip(now, event_time, fall_time);
|
||||
state = READ_2;
|
||||
break;
|
||||
}
|
||||
waiting_for_clock_release = 0;
|
||||
timer_enabled = 1;
|
||||
break;
|
||||
|
||||
case timer_enabled => tmr when timerafter(event_time) :> int now:
|
||||
switch (state) {
|
||||
case REPEATED_START_CLOCK_LOW:
|
||||
// The operation is finished, but no stop bit is being written
|
||||
p_scl <: 0;
|
||||
event_time = now + bit_time / 2;
|
||||
state = REPEATED_START_WAIT_FOR_CLOCK_HIGH;
|
||||
break;
|
||||
case REPEATED_START_WAIT_FOR_CLOCK_HIGH:
|
||||
p_scl :> void;
|
||||
timer_enabled = 0;
|
||||
waiting_for_clock_release = 1;
|
||||
state = REPEATED_START_HOLD_CLOCK_HIGH;
|
||||
break;
|
||||
case REPEATED_START_HOLD_CLOCK_HIGH:
|
||||
event_time = now + bit_time / 2;
|
||||
state = START_BIT_0;
|
||||
break;
|
||||
case START_BIT_0:
|
||||
p_sda <: 0;
|
||||
event_time = now + bit_time / 2;
|
||||
state = START_BIT_1;
|
||||
break;
|
||||
#pragma fallthrough
|
||||
case START_BIT_1:
|
||||
fall_time = now;
|
||||
// Fallthrough to WRITE_0 state
|
||||
case WRITE_0:
|
||||
p_scl <: 0;
|
||||
fall_time = adjust_fall(event_time, now, fall_time);
|
||||
p_sda <: data >> 7;
|
||||
data <<= 1;
|
||||
bitnum++;
|
||||
state = WRITE_1;
|
||||
event_time = fall_time + bit_time / 2 + bit_time / 32;
|
||||
adjust_for_slip(now, event_time, fall_time);
|
||||
break;
|
||||
case WRITE_1:
|
||||
p_scl :> void;
|
||||
timer_enabled = 0;
|
||||
waiting_for_clock_release = 1;
|
||||
if (bitnum == 8) {
|
||||
state = WRITE_ACK_0;
|
||||
} else {
|
||||
state = WRITE_0;
|
||||
}
|
||||
break;
|
||||
case WRITE_ACK_0:
|
||||
p_scl <: 0;
|
||||
p_sda :> void;
|
||||
fall_time = adjust_fall(event_time, now, fall_time);
|
||||
event_time = fall_time + bit_time / 2 + bit_time / 32;
|
||||
adjust_for_slip(now, event_time, fall_time);
|
||||
state = WRITE_ACK_1;
|
||||
break;
|
||||
case WRITE_ACK_1:
|
||||
p_scl :> void;
|
||||
timer_enabled = 0;
|
||||
waiting_for_clock_release = 1;
|
||||
break;
|
||||
case WRITE_ACK_2:
|
||||
int ack;
|
||||
p_sda :> ack;
|
||||
event_time = fall_time;
|
||||
adjust_for_slip(now, event_time, fall_time);
|
||||
if (ack == ACKED && optype == WRITE) {
|
||||
bytes_sent++;
|
||||
int all_data_sent = (bytes_sent == num_bytes);
|
||||
if (all_data_sent) {
|
||||
// The master and slave disagree since the slave should nack
|
||||
// the last byte.
|
||||
res = I2C_ACK;
|
||||
if (send_stop_bit) {
|
||||
state = STOP_BIT_0;
|
||||
} else {
|
||||
state = DONE_NO_STOP;
|
||||
}
|
||||
} else {
|
||||
// get next byte of data.
|
||||
data = buf[bytes_sent];
|
||||
bitnum = 0;
|
||||
// Now go back to the transmitting
|
||||
state = WRITE_0;
|
||||
}
|
||||
} else if (ack == NACKED && optype == WRITE) {
|
||||
bytes_sent++;
|
||||
int all_data_sent = (bytes_sent == num_bytes);
|
||||
if (all_data_sent) {
|
||||
// The master and slave agree that this is the end of the operation.
|
||||
res = I2C_NACK;
|
||||
if (send_stop_bit) {
|
||||
state = STOP_BIT_0;
|
||||
} else {
|
||||
state = DONE_NO_STOP;
|
||||
}
|
||||
} else {
|
||||
// The slave has aborted the operation.
|
||||
res = I2C_NACK;
|
||||
if (send_stop_bit) {
|
||||
state = STOP_BIT_0;
|
||||
} else {
|
||||
state = DONE_NO_STOP;
|
||||
}
|
||||
}
|
||||
} else if (ack == ACKED && optype == READ) {
|
||||
// The slave has acked the addr, we can go ahead with the operation.
|
||||
data = 0;
|
||||
bitnum = 0;
|
||||
bytes_sent++;
|
||||
state = READ_0;
|
||||
res = I2C_ACK;
|
||||
} else if (ack == NACKED && optype == READ) {
|
||||
// The slave has nacked the addr (or the slave isn't there). Abort.
|
||||
res = I2C_NACK;
|
||||
if (send_stop_bit) {
|
||||
state = STOP_BIT_0;
|
||||
} else {
|
||||
state = DONE_NO_STOP;
|
||||
}
|
||||
}
|
||||
break;
|
||||
case READ_0:
|
||||
p_scl <: 0;
|
||||
p_sda :> void;
|
||||
fall_time = adjust_fall(event_time, now, fall_time);
|
||||
bitnum++;
|
||||
state = READ_1;
|
||||
event_time = fall_time + bit_time / 2 + bit_time / 32;
|
||||
adjust_for_slip(now, event_time, fall_time);
|
||||
break;
|
||||
case READ_1:
|
||||
p_scl :> void;
|
||||
timer_enabled = 0;
|
||||
waiting_for_clock_release = 1;
|
||||
break;
|
||||
case READ_2:
|
||||
int bit;
|
||||
p_sda :> bit;
|
||||
data <<= 1;
|
||||
data += bit&1;
|
||||
event_time = fall_time;
|
||||
adjust_for_slip(now, event_time, fall_time);
|
||||
if (bitnum == 8) {
|
||||
buf[bytes_sent] = data;
|
||||
bytes_sent++;
|
||||
state = READ_ACK_0;
|
||||
} else {
|
||||
state = READ_0;
|
||||
}
|
||||
break;
|
||||
case READ_ACK_0:
|
||||
p_scl <: 0;
|
||||
if (bytes_sent == num_bytes) {
|
||||
p_sda :> void;
|
||||
} else {
|
||||
p_sda <: 0;
|
||||
}
|
||||
fall_time = adjust_fall(event_time, now, fall_time);
|
||||
state = READ_ACK_1;
|
||||
event_time = fall_time + bit_time / 2 + bit_time / 32;
|
||||
adjust_for_slip(now, event_time, fall_time);
|
||||
break;
|
||||
case READ_ACK_1:
|
||||
p_scl :> void;
|
||||
timer_enabled = 0;
|
||||
waiting_for_clock_release = 1;
|
||||
if (bytes_sent == num_bytes) {
|
||||
if (send_stop_bit) {
|
||||
state = STOP_BIT_0;
|
||||
} else {
|
||||
state = DONE_NO_STOP;
|
||||
}
|
||||
} else {
|
||||
data = 0;
|
||||
bitnum = 0;
|
||||
state = READ_0;
|
||||
}
|
||||
break;
|
||||
case STOP_BIT_0:
|
||||
p_scl <: 0;
|
||||
fall_time = adjust_fall(event_time, now, fall_time);
|
||||
event_time = fall_time + bit_time / 4;
|
||||
adjust_for_slip(now, event_time, fall_time);
|
||||
state = STOP_BIT_1;
|
||||
break;
|
||||
case STOP_BIT_1:
|
||||
p_sda <: 0;
|
||||
event_time = fall_time + bit_time / 2;
|
||||
adjust_for_slip(now, event_time, fall_time);
|
||||
state = STOP_BIT_2;
|
||||
break;
|
||||
case STOP_BIT_2:
|
||||
p_scl :> void;
|
||||
timer_enabled = 0;
|
||||
waiting_for_clock_release = 1;
|
||||
break;
|
||||
case STOP_BIT_3:
|
||||
p_sda :> void;
|
||||
event_time = now + bit_time/4;
|
||||
state = STOP_BIT_4;
|
||||
|
||||
// Know that the next transaction can start from the stopped state
|
||||
stopped = 1;
|
||||
break;
|
||||
#pragma fallthrough
|
||||
case DONE_NO_STOP:
|
||||
// Know that the next transaction needs to create a repeated start
|
||||
stopped = 0;
|
||||
// Fallthrough to STOP_BIT_4 code
|
||||
case STOP_BIT_4:
|
||||
i[cur_client].operation_complete();
|
||||
cur_client = -1;
|
||||
timer_enabled = 0;
|
||||
state = IDLE;
|
||||
break;
|
||||
case IDLE:
|
||||
fail("");
|
||||
break;
|
||||
}
|
||||
break;
|
||||
|
||||
case i[int j].write(uint8_t device_addr, uint8_t buf0[n], size_t n,
|
||||
int _send_stop_bit):
|
||||
data = (device_addr << 1) | 0;
|
||||
bitnum = 0;
|
||||
optype = WRITE;
|
||||
num_bytes = n;
|
||||
send_stop_bit = _send_stop_bit;
|
||||
memcpy(buf, buf0, n);
|
||||
// The 'bytes_sent' variable gets increment after every byte *including*
|
||||
// the addr bytes. So we set it to -1 to be 0 after the addr byte.
|
||||
bytes_sent = -1;
|
||||
timer_enabled = 1;
|
||||
cur_client = j;
|
||||
tmr :> event_time;
|
||||
if (!stopped) {
|
||||
state = REPEATED_START_CLOCK_LOW;
|
||||
} else {
|
||||
state = START_BIT_0;
|
||||
}
|
||||
break;
|
||||
|
||||
case i[int j].read(uint8_t device_addr, size_t n, int _send_stop_bit):
|
||||
data = (device_addr << 1) | 1;
|
||||
bitnum = 0;
|
||||
optype = READ;
|
||||
num_bytes = n;
|
||||
send_stop_bit = _send_stop_bit;
|
||||
// The 'bytes_sent' variable gets increment after every byte *including*
|
||||
// the addr bytes. So we set it to -1 to be 0 after the addr byte.
|
||||
bytes_sent = -1;
|
||||
timer_enabled = 1;
|
||||
cur_client = j;
|
||||
tmr :> event_time;
|
||||
if (!stopped) {
|
||||
state = REPEATED_START_CLOCK_LOW;
|
||||
} else {
|
||||
state = START_BIT_0;
|
||||
}
|
||||
break;
|
||||
|
||||
case i[int j].send_stop_bit():
|
||||
break;
|
||||
|
||||
case i[int j].get_write_result(size_t &num_bytes_sent) -> i2c_res_t result:
|
||||
num_bytes_sent = bytes_sent;
|
||||
result = res;
|
||||
break;
|
||||
|
||||
case i[int j].get_read_data(uint8_t buf0[n], size_t n) -> i2c_res_t result:
|
||||
memcpy(buf0, buf, n);
|
||||
result = res;
|
||||
break;
|
||||
|
||||
case i[int j].shutdown():
|
||||
return;
|
||||
}
|
||||
}
|
||||
}
|
||||
57
lib_i2c/lib_i2c/src/i2c_master_ext.xc
Normal file
57
lib_i2c/lib_i2c/src/i2c_master_ext.xc
Normal file
@@ -0,0 +1,57 @@
|
||||
// Copyright 2014-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
#include <i2c.h>
|
||||
|
||||
/* This file provides external definitions for the inline functions declared in
|
||||
i2c.h (using C99 inlining semantics) */
|
||||
|
||||
extends client interface i2c_master_if : {
|
||||
extern inline uint8_t read_reg_8_8(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint8_t reg,
|
||||
i2c_regop_res_t &res);
|
||||
|
||||
extern inline uint8_t read_reg(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint8_t reg,
|
||||
i2c_regop_res_t &res);
|
||||
|
||||
extern inline i2c_regop_res_t write_reg_n_m(client interface i2c_master_if i,
|
||||
uint8_t device_addr,
|
||||
uint8_t reg[m],
|
||||
size_t m,
|
||||
uint8_t data[n],
|
||||
size_t n);
|
||||
|
||||
extern inline i2c_regop_res_t write_reg_8_8(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint8_t reg,
|
||||
uint8_t data);
|
||||
|
||||
extern inline i2c_regop_res_t write_reg(client interface i2c_master_if i,
|
||||
uint8_t device_addr,
|
||||
uint8_t reg, uint8_t data);
|
||||
|
||||
extern inline uint8_t read_reg8_addr16(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint16_t reg,
|
||||
i2c_regop_res_t &res);
|
||||
|
||||
extern inline i2c_regop_res_t write_reg8_addr16(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint16_t reg,
|
||||
uint8_t data);
|
||||
|
||||
extern inline uint16_t read_reg16(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint16_t reg,
|
||||
i2c_regop_res_t &res);
|
||||
|
||||
extern inline i2c_regop_res_t write_reg16(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint16_t reg,
|
||||
uint16_t data);
|
||||
|
||||
extern inline i2c_regop_res_t write_reg16_addr8(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint8_t reg,
|
||||
uint16_t data);
|
||||
|
||||
extern inline uint16_t read_reg16_addr8(client interface i2c_master_if i,
|
||||
uint8_t device_addr, uint8_t reg,
|
||||
i2c_regop_res_t &result);
|
||||
|
||||
|
||||
}
|
||||
324
lib_i2c/lib_i2c/src/i2c_master_single_port.xc
Normal file
324
lib_i2c/lib_i2c/src/i2c_master_single_port.xc
Normal file
@@ -0,0 +1,324 @@
|
||||
// Copyright 2013-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
#if (defined(__XS2A__) || defined(__XS3A__))
|
||||
|
||||
#include "i2c.h"
|
||||
#include <xs1.h>
|
||||
#include <xclib.h>
|
||||
#include <stdio.h>
|
||||
#include <timer.h>
|
||||
|
||||
#include "xassert.h"
|
||||
|
||||
#define SDA_LOW 0
|
||||
#define SCL_LOW 0
|
||||
|
||||
/* NOTE: the kbits_per_second needs to be passed around due to the fact that the
|
||||
* compiler won't compute a new static const from a static const.
|
||||
*/
|
||||
|
||||
/** Return the number of 10ns timer ticks required to meet the timing as defined
|
||||
* in the standards.
|
||||
*/
|
||||
static const unsigned inline compute_low_period_ticks(
|
||||
static const unsigned kbits_per_second)
|
||||
{
|
||||
unsigned ticks = 0;
|
||||
if (kbits_per_second <= 100) {
|
||||
const unsigned four_point_seven_micro_seconds_in_ticks = 470;
|
||||
ticks = four_point_seven_micro_seconds_in_ticks;
|
||||
} else if (kbits_per_second <= 400) {
|
||||
const unsigned one_point_three_micro_seconds_in_ticks = 130;
|
||||
ticks = one_point_three_micro_seconds_in_ticks;
|
||||
} else {
|
||||
fail("Fast-mode Plus not implemented");
|
||||
}
|
||||
|
||||
// There is some jitter on the falling edges of the clock. In order to ensure
|
||||
// that the low period is respected we need to extend the minimum low period.
|
||||
const unsigned jitter_ticks = 3;
|
||||
return ticks + jitter_ticks;
|
||||
}
|
||||
|
||||
static const unsigned inline compute_bus_off_ticks(
|
||||
static const unsigned kbits_per_second)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
|
||||
// Ensure the bus off time is respected. This is just over 1/2 bit time in
|
||||
// the case of the Fast-mode I2C so adding bit_time/16 ensures the timing
|
||||
// will be enforced
|
||||
return bit_time/2 + bit_time/16;
|
||||
}
|
||||
|
||||
/** Reads back the SCL line, waiting until it goes high (in
|
||||
* case the slave is clock stretching). It is assumed that the clock
|
||||
* line has been release (driven high) before calling this function.
|
||||
* Since the line going high may be delayed, the fall_time value may
|
||||
* need to be adjusted
|
||||
*/
|
||||
static void wait_for_clock_high(
|
||||
port p_i2c,
|
||||
static const unsigned scl_bit_position,
|
||||
unsigned &fall_time,
|
||||
unsigned delay)
|
||||
{
|
||||
const unsigned SCL_HIGH = BIT_MASK(scl_bit_position);
|
||||
|
||||
unsigned val = peek(p_i2c);
|
||||
while (!(val & SCL_HIGH)) {
|
||||
val = peek(p_i2c);
|
||||
}
|
||||
|
||||
timer tmr;
|
||||
unsigned time;
|
||||
tmr when timerafter(fall_time + delay) :> time;
|
||||
|
||||
// Adjust timing due to support clock stretching without clock drift in the
|
||||
// normal case.
|
||||
|
||||
// If the time is beyond the time it takes simply to wake up and start
|
||||
// executing then the clock needs to be adjusted
|
||||
const int wake_up_ticks = 10;
|
||||
if (time > fall_time + delay + wake_up_ticks) {
|
||||
fall_time = time - delay - wake_up_ticks;
|
||||
}
|
||||
}
|
||||
|
||||
static void high_pulse_drive(
|
||||
port p_i2c,
|
||||
int sdaValue,
|
||||
static const unsigned kbits_per_second,
|
||||
static const unsigned scl_bit_position,
|
||||
static const unsigned sda_bit_position,
|
||||
static const unsigned other_bits_mask,
|
||||
unsigned &fall_time)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
const unsigned SCL_HIGH = BIT_MASK(scl_bit_position);
|
||||
const unsigned SDA_HIGH = BIT_MASK(sda_bit_position);
|
||||
|
||||
timer tmr;
|
||||
sdaValue = sdaValue ? SDA_HIGH : SDA_LOW;
|
||||
p_i2c <: SCL_LOW | sdaValue | other_bits_mask;
|
||||
tmr when timerafter(fall_time + compute_low_period_ticks(kbits_per_second)) :> void;
|
||||
p_i2c <: SCL_HIGH | sdaValue | other_bits_mask;
|
||||
wait_for_clock_high(p_i2c, scl_bit_position, fall_time, (bit_time * 3) / 4);
|
||||
fall_time = fall_time + bit_time;
|
||||
tmr when timerafter(fall_time) :> void;
|
||||
p_i2c <: SCL_LOW | sdaValue | other_bits_mask;
|
||||
}
|
||||
|
||||
static int high_pulse_sample(
|
||||
port p_i2c,
|
||||
static const unsigned kbits_per_second,
|
||||
static const unsigned scl_bit_position,
|
||||
static const unsigned sda_bit_position,
|
||||
static const unsigned other_bits_mask,
|
||||
unsigned &fall_time)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
const unsigned SCL_HIGH = BIT_MASK(scl_bit_position);
|
||||
const unsigned SDA_HIGH = BIT_MASK(sda_bit_position);
|
||||
|
||||
timer tmr;
|
||||
|
||||
p_i2c <: SCL_LOW | SDA_HIGH | other_bits_mask;
|
||||
tmr when timerafter(fall_time + compute_low_period_ticks(kbits_per_second)) :> void;
|
||||
p_i2c <: SCL_HIGH | SDA_HIGH | other_bits_mask;
|
||||
wait_for_clock_high(p_i2c, scl_bit_position, fall_time, (bit_time * 3) / 4);
|
||||
|
||||
int sample_value = peek(p_i2c);
|
||||
if (sample_value & SDA_HIGH)
|
||||
sample_value = 1;
|
||||
else
|
||||
sample_value = 0;
|
||||
|
||||
fall_time = fall_time + bit_time;
|
||||
tmr when timerafter(fall_time) :> void;
|
||||
p_i2c <: SCL_LOW | SDA_HIGH | other_bits_mask;
|
||||
|
||||
return sample_value;
|
||||
}
|
||||
|
||||
static void start_bit(
|
||||
port p_i2c,
|
||||
static const unsigned kbits_per_second,
|
||||
static const unsigned scl_bit_position,
|
||||
static const unsigned sda_bit_position,
|
||||
static const unsigned other_bits_mask,
|
||||
unsigned &fall_time,
|
||||
int stopped)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
const unsigned SCL_HIGH = BIT_MASK(scl_bit_position);
|
||||
const unsigned SDA_HIGH = BIT_MASK(sda_bit_position);
|
||||
|
||||
timer tmr;
|
||||
|
||||
if (!stopped) {
|
||||
fall_time += compute_low_period_ticks(kbits_per_second);
|
||||
tmr when timerafter(fall_time) :> fall_time;
|
||||
p_i2c <: SCL_HIGH | SDA_HIGH | other_bits_mask;
|
||||
wait_for_clock_high(p_i2c, scl_bit_position, fall_time, compute_bus_off_ticks(kbits_per_second));
|
||||
}
|
||||
|
||||
p_i2c <: SCL_HIGH | SDA_LOW | other_bits_mask;
|
||||
delay_ticks(bit_time / 2);
|
||||
p_i2c <: SCL_LOW | SDA_LOW | other_bits_mask;
|
||||
tmr :> fall_time;
|
||||
}
|
||||
|
||||
static void stop_bit(
|
||||
port p_i2c,
|
||||
static const unsigned kbits_per_second,
|
||||
static const unsigned scl_bit_position,
|
||||
static const unsigned sda_bit_position,
|
||||
static const unsigned other_bits_mask,
|
||||
unsigned fall_time)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
const unsigned SCL_HIGH = BIT_MASK(scl_bit_position);
|
||||
const unsigned SDA_HIGH = BIT_MASK(sda_bit_position);
|
||||
|
||||
timer tmr;
|
||||
|
||||
p_i2c <: SCL_LOW | SDA_LOW | other_bits_mask;
|
||||
tmr when timerafter(fall_time + compute_low_period_ticks(kbits_per_second)) :> void;
|
||||
p_i2c <: SCL_HIGH | SDA_LOW | other_bits_mask;
|
||||
wait_for_clock_high(p_i2c, scl_bit_position, fall_time, bit_time);
|
||||
p_i2c <: SCL_HIGH | SDA_HIGH | other_bits_mask;
|
||||
delay_ticks(compute_bus_off_ticks(kbits_per_second));
|
||||
}
|
||||
|
||||
static int tx8(
|
||||
port p_i2c, unsigned data,
|
||||
static const unsigned kbits_per_second,
|
||||
static const unsigned scl_bit_position,
|
||||
static const unsigned sda_bit_position,
|
||||
static const unsigned other_bits_mask,
|
||||
unsigned &fall_time)
|
||||
{
|
||||
unsigned bit_rev_data = ((unsigned) bitrev(data)) >> 24;
|
||||
for (int i = 8; i != 0; i--) {
|
||||
high_pulse_drive(p_i2c, bit_rev_data & 1, kbits_per_second, scl_bit_position, sda_bit_position, other_bits_mask, fall_time);
|
||||
bit_rev_data >>= 1;
|
||||
}
|
||||
return high_pulse_sample(p_i2c, kbits_per_second, scl_bit_position, sda_bit_position, other_bits_mask, fall_time);
|
||||
}
|
||||
|
||||
[[distributable]]
|
||||
void i2c_master_single_port(
|
||||
server interface i2c_master_if c[n],
|
||||
static const size_t n,
|
||||
port p_i2c,
|
||||
static const unsigned kbits_per_second,
|
||||
static const unsigned scl_bit_position,
|
||||
static const unsigned sda_bit_position,
|
||||
static const unsigned other_bits_mask)
|
||||
{
|
||||
const unsigned bit_time = BIT_TIME(kbits_per_second);
|
||||
const unsigned SCL_HIGH = BIT_MASK(scl_bit_position);
|
||||
const unsigned SDA_HIGH = BIT_MASK(sda_bit_position);
|
||||
|
||||
unsigned last_fall_time = 0;
|
||||
unsigned locked_client = -1;
|
||||
set_port_drive_low(p_i2c);
|
||||
p_i2c <: SCL_HIGH | SDA_HIGH | other_bits_mask;
|
||||
|
||||
while (1) {
|
||||
select {
|
||||
case (size_t i =0; i < n; i++)
|
||||
(n == 1 || (locked_client == -1 || i == locked_client)) =>
|
||||
c[i].read(uint8_t device, uint8_t buf[m], size_t m,
|
||||
int send_stop_bit) -> i2c_res_t result:
|
||||
|
||||
const int stopped = locked_client == -1;
|
||||
unsigned fall_time = last_fall_time;
|
||||
start_bit(p_i2c, kbits_per_second, scl_bit_position, sda_bit_position, other_bits_mask, fall_time, stopped);
|
||||
int ack = tx8(p_i2c, (device << 1) | 1, kbits_per_second, scl_bit_position, sda_bit_position, other_bits_mask, fall_time);
|
||||
if (ack == 0) {
|
||||
for (int j = 0; j < m; j++){
|
||||
unsigned char data = 0;
|
||||
timer tmr;
|
||||
for (int i = 8; i != 0; i--) {
|
||||
int temp = high_pulse_sample(p_i2c, kbits_per_second, scl_bit_position, sda_bit_position, other_bits_mask, fall_time);
|
||||
data = (data << 1) | temp;
|
||||
}
|
||||
buf[j] = data;
|
||||
|
||||
// ACK after every read byte until the final byte then NACK.
|
||||
unsigned sda = SDA_LOW;
|
||||
if (j == m-1) {
|
||||
sda = SDA_HIGH;
|
||||
}
|
||||
|
||||
p_i2c <: SCL_LOW | sda | other_bits_mask;
|
||||
tmr when timerafter(fall_time + compute_low_period_ticks(kbits_per_second)) :> void;
|
||||
p_i2c <: SCL_HIGH | sda | other_bits_mask;
|
||||
wait_for_clock_high(p_i2c, scl_bit_position, fall_time, (bit_time * 3) / 4);
|
||||
fall_time = fall_time + bit_time;
|
||||
tmr when timerafter(fall_time) :> void;
|
||||
|
||||
// Release the data bus
|
||||
p_i2c <: SCL_LOW | SDA_HIGH | other_bits_mask;
|
||||
}
|
||||
}
|
||||
if (send_stop_bit) {
|
||||
stop_bit(p_i2c, kbits_per_second, scl_bit_position, sda_bit_position, other_bits_mask, fall_time);
|
||||
locked_client = -1;
|
||||
} else {
|
||||
locked_client = i;
|
||||
}
|
||||
|
||||
result = (ack == 0) ? I2C_ACK : I2C_NACK;
|
||||
|
||||
// Remember the last fall time to ensure the next start bit is valid
|
||||
last_fall_time = fall_time;
|
||||
break;
|
||||
|
||||
case (size_t i = 0; i < n; i++)
|
||||
(n == 1 || (locked_client == -1 || i == locked_client)) =>
|
||||
c[i].write(uint8_t device, uint8_t buf[n], size_t n,
|
||||
size_t &num_bytes_sent,
|
||||
int send_stop_bit) -> i2c_res_t result:
|
||||
|
||||
const int stopped = locked_client == -1;
|
||||
unsigned fall_time = last_fall_time;
|
||||
start_bit(p_i2c, kbits_per_second, scl_bit_position, sda_bit_position, other_bits_mask, fall_time, stopped);
|
||||
int ack = tx8(p_i2c, device<<1, kbits_per_second, scl_bit_position, sda_bit_position, other_bits_mask, fall_time);
|
||||
int j = 0;
|
||||
for (; j < n; j++) {
|
||||
if (ack != 0)
|
||||
break;
|
||||
|
||||
ack = tx8(p_i2c, buf[j], kbits_per_second, scl_bit_position, sda_bit_position, other_bits_mask, fall_time);
|
||||
}
|
||||
if (send_stop_bit) {
|
||||
stop_bit(p_i2c, kbits_per_second, scl_bit_position, sda_bit_position, other_bits_mask, fall_time);
|
||||
locked_client = -1;
|
||||
} else {
|
||||
locked_client = i;
|
||||
}
|
||||
num_bytes_sent = j;
|
||||
result = (ack == 0) ? I2C_ACK : I2C_NACK;
|
||||
|
||||
// Remember the last fall time to ensure the next start bit is valid
|
||||
last_fall_time = fall_time;
|
||||
break;
|
||||
|
||||
case c[int i].send_stop_bit(void):
|
||||
timer tmr;
|
||||
unsigned fall_time;
|
||||
tmr :> fall_time;
|
||||
stop_bit(p_i2c, kbits_per_second, scl_bit_position, sda_bit_position, other_bits_mask, fall_time);
|
||||
locked_client = -1;
|
||||
break;
|
||||
|
||||
case c[int i].shutdown():
|
||||
return;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
#endif
|
||||
265
lib_i2c/lib_i2c/src/i2c_slave.xc
Normal file
265
lib_i2c/lib_i2c/src/i2c_slave.xc
Normal file
@@ -0,0 +1,265 @@
|
||||
// Copyright 2014-2021 XMOS LIMITED.
|
||||
// This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
#include <i2c.h>
|
||||
#include <xs1.h>
|
||||
#include <xclib.h>
|
||||
|
||||
enum i2c_slave_state {
|
||||
WAITING_FOR_START_OR_STOP,
|
||||
READING_ADDR,
|
||||
ACK_ADDR,
|
||||
ACK_WAIT_HIGH,
|
||||
ACK_WAIT_LOW,
|
||||
IGNORE_ACK,
|
||||
MASTER_WRITE,
|
||||
MASTER_READ
|
||||
};
|
||||
|
||||
static inline void ensure_setup_time()
|
||||
{
|
||||
// The I2C spec requires a 100ns setup time
|
||||
delay_ticks(10);
|
||||
}
|
||||
|
||||
[[combinable]]
|
||||
void i2c_slave(client i2c_slave_callback_if i,
|
||||
port p_scl, port p_sda,
|
||||
uint8_t device_addr)
|
||||
{
|
||||
enum i2c_slave_state state = WAITING_FOR_START_OR_STOP;
|
||||
enum i2c_slave_state next_state = WAITING_FOR_START_OR_STOP;
|
||||
int sda_val = 0;
|
||||
int scl_val;
|
||||
int bitnum = 0;
|
||||
int data;
|
||||
int rw = 0;
|
||||
int stop_bit_check = 0;
|
||||
int ignore_stop_bit = 1;
|
||||
p_sda when pinseq(1) :> void;
|
||||
while (1) {
|
||||
select {
|
||||
case i.shutdown():
|
||||
return;
|
||||
case state != WAITING_FOR_START_OR_STOP => p_scl when pinseq(scl_val) :> void:
|
||||
switch (state) {
|
||||
case READING_ADDR:
|
||||
// If clock has gone low, wait for it to go high before doing anything
|
||||
if (scl_val == 0) {
|
||||
scl_val = 1;
|
||||
break;
|
||||
}
|
||||
|
||||
int bit;
|
||||
p_sda :> bit;
|
||||
if (bitnum < 7) {
|
||||
data = (data << 1) | bit;
|
||||
bitnum++;
|
||||
scl_val = 0;
|
||||
break;
|
||||
}
|
||||
|
||||
// We have gathered the whole device address sent by the master
|
||||
if (data != device_addr) {
|
||||
state = IGNORE_ACK;
|
||||
} else {
|
||||
state = ACK_ADDR;
|
||||
rw = bit;
|
||||
}
|
||||
scl_val = 0;
|
||||
break;
|
||||
|
||||
case IGNORE_ACK:
|
||||
// This request is not for us, ignore the ACK
|
||||
next_state = WAITING_FOR_START_OR_STOP;
|
||||
scl_val = 1;
|
||||
state = ACK_WAIT_HIGH;
|
||||
break;
|
||||
|
||||
case ACK_ADDR:
|
||||
// Stretch clock (hold low) while application code is called
|
||||
p_scl <: 0;
|
||||
|
||||
// Callback to the application to determine whether to ACK
|
||||
// or NACK the address.
|
||||
int ack;
|
||||
if (rw) {
|
||||
ack = i.ack_read_request();
|
||||
} else {
|
||||
ack = i.ack_write_request();
|
||||
}
|
||||
|
||||
ignore_stop_bit = 0;
|
||||
if (ack == I2C_SLAVE_NACK) {
|
||||
// Release the data line so that it is pulled high
|
||||
p_sda :> void;
|
||||
next_state = WAITING_FOR_START_OR_STOP;
|
||||
} else {
|
||||
// Drive the ACK low
|
||||
p_sda <: 0;
|
||||
if (rw) {
|
||||
next_state = MASTER_READ;
|
||||
} else {
|
||||
next_state = MASTER_WRITE;
|
||||
}
|
||||
}
|
||||
scl_val = 1;
|
||||
state = ACK_WAIT_HIGH;
|
||||
|
||||
ensure_setup_time();
|
||||
|
||||
// Release the clock
|
||||
p_scl :> void;
|
||||
break;
|
||||
|
||||
case ACK_WAIT_HIGH:
|
||||
// Rising edge of clock, hold ack to the falling edge
|
||||
state = ACK_WAIT_LOW;
|
||||
scl_val = 0;
|
||||
break;
|
||||
|
||||
case ACK_WAIT_LOW:
|
||||
// ACK done, release the data line
|
||||
p_sda :> void;
|
||||
if (next_state == MASTER_READ) {
|
||||
scl_val = 0;
|
||||
} else if (next_state == MASTER_WRITE) {
|
||||
data = 0;
|
||||
scl_val = 1;
|
||||
} else { // WAITING_FOR_START_OR_STOP
|
||||
sda_val = 0;
|
||||
}
|
||||
state = next_state;
|
||||
bitnum = 0;
|
||||
break;
|
||||
|
||||
case MASTER_READ:
|
||||
if (scl_val == 1) {
|
||||
// Rising edge
|
||||
if (bitnum == 8) {
|
||||
// Sample ack from master
|
||||
int bit;
|
||||
p_sda :> bit;
|
||||
if (bit) {
|
||||
// Master has NACKed so the transaction is finished
|
||||
state = WAITING_FOR_START_OR_STOP;
|
||||
sda_val = 0;
|
||||
} else {
|
||||
bitnum = 0;
|
||||
scl_val = 0;
|
||||
}
|
||||
} else {
|
||||
// Wait for next falling edge
|
||||
scl_val = 0;
|
||||
bitnum++;
|
||||
}
|
||||
} else {
|
||||
// Falling edge, drive data
|
||||
if (bitnum < 8) {
|
||||
if (bitnum == 0) {
|
||||
// Stretch clock (hold low) while application code is called
|
||||
p_scl <: 0;
|
||||
data = i.master_requires_data();
|
||||
// Data is transmitted MSB first
|
||||
data = bitrev(data) >> 24;
|
||||
|
||||
// Send first bit of data
|
||||
p_sda <: data & 0x1;
|
||||
|
||||
ensure_setup_time();
|
||||
|
||||
// Release the clock
|
||||
p_scl :> void;
|
||||
} else {
|
||||
p_sda <: data & 0x1;
|
||||
}
|
||||
data >>= 1;
|
||||
} else {
|
||||
// Release the bus for the master to be able to ACK/NACK
|
||||
p_sda :> void;
|
||||
}
|
||||
scl_val = 1;
|
||||
}
|
||||
break;
|
||||
|
||||
case MASTER_WRITE:
|
||||
if (scl_val == 1) {
|
||||
// Rising edge
|
||||
int bit;
|
||||
p_sda :> bit;
|
||||
data = (data << 1) | (bit & 0x1);
|
||||
if (bitnum == 0) {
|
||||
if (bit) {
|
||||
sda_val = 0;
|
||||
} else {
|
||||
sda_val = 1;
|
||||
}
|
||||
// First bit could be a start or stop bit
|
||||
stop_bit_check = 1;
|
||||
}
|
||||
scl_val = 0;
|
||||
bitnum++;
|
||||
} else {
|
||||
// Falling edge
|
||||
|
||||
// Not a start or stop bit
|
||||
stop_bit_check = 0;
|
||||
|
||||
if (bitnum == 8) {
|
||||
// Stretch clock (hold low) while application code is called
|
||||
p_scl <: 0;
|
||||
int ack = i.master_sent_data(data);
|
||||
if (ack == I2C_SLAVE_NACK) {
|
||||
// Release the data bus so it is pulled high to signal NACK
|
||||
p_sda :> void;
|
||||
} else {
|
||||
// Drive data bus low to signal ACK
|
||||
p_sda <: 0;
|
||||
}
|
||||
state = ACK_WAIT_HIGH;
|
||||
|
||||
ensure_setup_time();
|
||||
|
||||
// Release the clock
|
||||
p_scl :> void;
|
||||
}
|
||||
scl_val = 1;
|
||||
}
|
||||
break;
|
||||
}
|
||||
break;
|
||||
|
||||
case (state == WAITING_FOR_START_OR_STOP) || stop_bit_check =>
|
||||
p_sda when pinseq(sda_val) :> void:
|
||||
if (sda_val == 1) {
|
||||
// SDA has transitioned from low to high, if SCL is high
|
||||
// then it is a stop bit.
|
||||
int val;
|
||||
p_scl :> val;
|
||||
if (val) {
|
||||
if (!ignore_stop_bit) {
|
||||
i.stop_bit();
|
||||
}
|
||||
state = WAITING_FOR_START_OR_STOP;
|
||||
ignore_stop_bit = 1;
|
||||
stop_bit_check = 0;
|
||||
}
|
||||
sda_val = 0;
|
||||
} else {
|
||||
// SDA has transitioned from high to low, if SCL is high
|
||||
// then it is a start bit.
|
||||
int val;
|
||||
p_scl :> val;
|
||||
if (val == 1) {
|
||||
state = READING_ADDR;
|
||||
bitnum = 0;
|
||||
data = 0;
|
||||
scl_val = 0;
|
||||
stop_bit_check = 0;
|
||||
} else {
|
||||
sda_val = 1;
|
||||
}
|
||||
}
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
20
lib_i2c/python/setup.py
Normal file
20
lib_i2c/python/setup.py
Normal file
@@ -0,0 +1,20 @@
|
||||
# Copyright 2020-2021 XMOS LIMITED.
|
||||
# This Software is subject to the terms of the XMOS Public Licence: Version 1.
|
||||
import setuptools
|
||||
|
||||
# Another repository might depend on python code defined in this one. The
|
||||
# procedure to set up a suitable python environment for that repository may
|
||||
# pip-install this one as editable using this setup.py file. To minimise the
|
||||
# chance of version conflicts while ensuring a minimal degree of conformity,
|
||||
# the 3rd-party modules listed here require the same major version and at
|
||||
# least the same minor version as specified in the requirements.txt file.
|
||||
# The same modules should appear in the requirements.txt file as given below.
|
||||
setuptools.setup(
|
||||
name='lib_i2c',
|
||||
packages=setuptools.find_packages(),
|
||||
install_requires=[
|
||||
'flake8~=3.8',
|
||||
],
|
||||
dependency_links=[
|
||||
],
|
||||
)
|
||||
Reference in New Issue
Block a user