== Welcome to TTool-AMS ==


'''What is TTool-AMS?'''

TTool-AMS from LIP6 is an extension to [https://ttool.telecom-paris.fr TTool] from Télécom Paris.
This extension allows the edition of diagrams representing [http://www.accellera.org SystemC-AMS] clusters, 
and simulation of generated virtual protoytpes under SystemC-AMS.

The SoCLib version (2019) is part of the main TTool distribution. 

A recent, experimental version integrating SystemC-AMS ELN generation and new features in a virtual machine, can be found here:

[wiki:dvcon march 2025 version]

This version does not require the installation of Soclib and runs under Linux.

Currently supported is the combination of the following two simulators:

[http://www.accellera.org  SystemC 2.3.3, from Accellera Systems Initiative]
and
[http://www.coseda.com SystemC AMS extensions PoC2.3 Library, hosted by COSEDA]


'''Who should use TTool-AMS?'''

Anyone interested by a free and open-source environment for modeling embedded systems - hardware or software elements - including digital and analog/mixed signal components. The particular strength of TTool-AMS is that it allows running embedded software on the digital part. Full-system simulation with an embedded micro-kernel [https://www.mutekh.org MutekH] and the [http://www.soclib.org SoCLib] library is supported. All these are free software.

'''How can I use TTool-AMS?'''

TTool-AMS is an extension to [https://ttool.telecom-paris.fr TTool], an open-source software that can be installed and executed under most Operating Systems. More precisely, it has been tested under  Windows, MacOS, Linux. 

We do encourage you to contact the team at TPT if necessary (see the support section for more information) for problems like installating TTool, using a specific profile, performing formal proofs, and so on. For questions concerning the AMS extension and the SoCLib virtual prototype generation, please contact daniela.genius@lip6.fr.
for MIPS32
Links: [https://ttool.telecom-paris.fr/installation.html installing TTool], [https://ttool.telecom-paris.fr/download.html downloading TTool]


'''Outside the VM, on workstation'''

Older version containing  which runs outside a VM: ​ftp://ftp-asim.lip6.fr/outgoing/genius/TTool-AMS.tgz

This version requires the installation of cross compilers, Soclib, and a micro-kernel. Below fin the link to the documentation.

[wiki:documentation Installation and User documentation]

[wiki:installation Installation documentation for co-simulation with SoCLib]


Requirements:

Java (tested versions) : 11.0.16
Gradle (tested version) : gradle-8.12.1

SystemC 2.3.3 must be installed 
Systemc-ams-2.1 must be installed 

The jar file for TTool is generated by
make ttool (for faster generation without tests: make ttoolnotest)


Paths can be modified in systemc-env.sh (per default $HOME)

source systemc-env.sh

The generated SystemC-AMS files can be compiled by using the generated Makefile

The SystemC-AMS proof-of-concept is provided in
https://www.coseda-tech.com/systemc-ams-proof-of-concept


[wiki:publications Publications]

'''Credits'''

The virtual machine, based on Ubuntu 2022, offers a pre-installed environment containing a regularly updated version of TTool with stable AMS features, SoCLib, SystemC, SysteC-AMS
(credits go to [www.accellera.org Accellera]) and cross-compilers for MIPS32. 

It can be extended by other cross-compilers (see [wiki:installation documentation]).
 
A virtual machine of the SoCLib version [ftp://ftp-asim.lip6.fr/outgoing/genius/TToolVM.ova virtual machine] is available from our ftp server. See [wiki:VMdocumentation Virtual machine documentation] for VM documentation.