Skip to content

Latest commit

 

History

History
153 lines (107 loc) · 5.25 KB

RELEASENOTES.md

File metadata and controls

153 lines (107 loc) · 5.25 KB

Release Notes for SystemC CCI 1.0.1

CONTENTS

Overview

This package contains the reference implementation for the SystemC Configuration, Control and Inspection (CCI) standard. It works optimally with SystemC 2.3.3 utilizing its hierarchical name registry to detect and mitigate parameter name collisions. On prior versions of SystemC, it doesn't address name collisions but otherwise works fine.

Supported platforms and tool dependencies

Supported platforms

This release is supported on the following platform combinations for which it has been tested:

  • 64-bit Linux (x86_64) (RedHat Enterprise 6; SuSE Enterprise Linux 11; Debian 9)

    • GNU C++ compiler versions gcc-4.2.2 through gcc-8.2.0
    • Clang C++ compiler versions clang-3.4 through clang-6.0
    • Intel C++ Compiler (ICC 15.0.0)

  • 64-bit Linux (x86_64) with 32-bit compiler (--host=i686-linux-gnu) (SuSE Enterprise Linux 11)

    • GNU C++ compiler versions gcc-4.2.2 through gcc-8.2.0
    • Intel C++ Compiler (ICC 15.0.0)

  • 64-bit Linux (aarch64) (Ubuntu 16.04)

    • GNU C++ compiler version gcc-4.5.0

  • 64-bit Mac OS X (x86_64) (10.12 Sierra)

    • Apple LLVM version 8.0 (clang-800.0.42.1)
    • GNU C++ compiler (MacPorts) versions gcc-4.9.0, gcc-5.4.0, gcc-6.3.0

  • Microsoft Windows 10

    • Microsoft Visual Studio 2010 (10.0) (Win32 and x64)
    • Microsoft Visual Studio 2013 (12.0) (Win32 and x64)
    • Microsoft Visual Studio 2015 (14.0) (Win32 and x64)
    • Microsoft Visual Studio 2017 (14.1) (Win32 and x64)

Warning: The fixed-point datatypes are not working as defined on MSVC 2015/2017 (x64) in Release mode. See RELEASENOTES.

  • Windows Server 2008 (WoW64), Msys 1.0.17(0.48/3/2)
    • MinGW-w64 GNU C++ compiler version 4.9.2 (x86_64)

Formerly supported platforms

This release has not yet been tested or is known not to work as expected on the following formerly supported platforms:

  • GNU C++ compiler versions prior to 4.2.x (all platforms)
  • FreeBSD 9.0 or later (x86, x86_64) with GNU C++ compiler
  • HP-UX 11.00 or later with GNU C++ or HP C++ compiler
  • Sun/Oracle Solaris, with GNU C++ or Sun/Solaris Studio compiler
  • Mac OS X prior to 10.12 (Sierra) and/or on the x86, PowerPC architectures
  • Microsoft Visual C++ versions prior to 10.0 (2010)
  • Cygwin 1.7 or later (x86, x86_64) with GNU C++ compiler
  • Msys/MinGW32 GNU C++ compiler

Tool dependencies

SystemC CCI requires the following additional tools

(In)compatibility note

While it is possible to build SystemC and CCI as a shared library (both on ELF-based systems and well as a DLL on Windows), there is no explicitly defined binary interface across different

  • SystemC and CCI implementations (e.g. from multiple vendors)
  • SystemC and CCI library versions
  • Compilers or compiler versions
  • Operating systems or OS versions

Some differences might be caught at link time, while other incompatibilities could just silently lead to undefined behavior during simulation. Please carefully ensure a consistent build configuration, when integrating binary SystemC and CCI models built from separate sources.

What's new in this release?

Compared to the previous release, 1.0.1 is a minor release containing the following enhancements and bug fixes:

  • Introduced Automake configuration and build flow (configure, make, make install) for the CCI reference implementation and the examples

  • RapidJSON has become an external package dependency and needs to be added as part of the configuration or using environment variable RAPIDJSON_HOME.

  • Improved build flow using Microsoft Visual C++ IDE, compiler and linker for Windows, for the CCI reference implementation and examples.

  • Improved checking of the CCI examples.

  • Updated platform support, see the README.md.

  • Updated documentation.

Known problems

  • Convenience functions have been added to cci_broker_handle to register callbacks based on an object and a member function. This is now consistent with parameter handle callback registration. This is not documented in the CCI 1.0 LRM but will be added in the next revision.

  • Parameter names may be registered in the future when a preset value is provided to the broker. This would allow earlier detection of name collisions.

Reporting Bugs and Suggestions

Please report bugs and suggestions about this library using the Accellera forums:

https://forums.accellera.org/forum/41-systemc-cci-configuration-control-inspection/