summaryrefslogtreecommitdiff
path: root/src/systemc/tests/tlm/README.txt
diff options
context:
space:
mode:
authorGabe Black <gabeblack@google.com>2018-05-24 01:37:55 -0700
committerGabe Black <gabeblack@google.com>2018-08-08 10:09:54 +0000
commit16fa8d7cc8c92f5ab879e4cf9c6c0bbb3567860f (patch)
tree7b6faaacb4574a555e561534aa4a8508c0624c32 /src/systemc/tests/tlm/README.txt
parent7235d3b5211d0ba8f528d930a4c1e7ad62eec51a (diff)
downloadgem5-16fa8d7cc8c92f5ab879e4cf9c6c0bbb3567860f.tar.xz
systemc: Import tests from the Accellera systemc distribution.
Change-Id: Iad76b398949a55d768a34d027a2d8e3739953da6 Reviewed-on: https://gem5-review.googlesource.com/10845 Reviewed-by: Giacomo Travaglini <giacomo.travaglini@arm.com> Maintainer: Gabe Black <gabeblack@google.com>
Diffstat (limited to 'src/systemc/tests/tlm/README.txt')
-rw-r--r--src/systemc/tests/tlm/README.txt89
1 files changed, 89 insertions, 0 deletions
diff --git a/src/systemc/tests/tlm/README.txt b/src/systemc/tests/tlm/README.txt
new file mode 100644
index 000000000..33def095a
--- /dev/null
+++ b/src/systemc/tests/tlm/README.txt
@@ -0,0 +1,89 @@
+
+TLM-2.0 unit tests
+==================
+
+Dir: tests/tlm/
+SubDirs:
+ bus/
+ bus_dmi/
+ cancel_all/
+ common/
+ endian_conv/
+ multi_sockets/
+ nb2b_adapter/
+ p2p/
+ static_extensions/
+ update_original/
+
+Files: README.txt
+
+
+Comments
+========
+
+Running the tests:
+------------------
+
+See the main README and README_windows.txt files.
+
+
+The tests:
+----------
+
+All tests are build using a set of models that can be found in the subdirectory
+common/include/models. For a description of the models see the README.txt in
+that subdirectory.
+
+The test themselves can be found in the following subdirectories:
+bus/ :
+ test system using a TLM2 compliant AT bus model and a combination of
+ LT and AT targets and initiators, with and without temporal decoupling.
+
+bus_dmi/ :
+ test system using a similar system as in the bus/ test but now with DMI
+ support added for the LT initiators and targets.
+
+cancel_all/ :
+ Tests the cancel_all() methods of the two PEQs, peq_with_cb_and_phase and peq_with_get.
+ Along the way, it also tests the basic operation of each PEQ.
+
+endian_conv/ :
+ unit test for the endianness conversion ftions, there is only a build for
+ linux provided, the C++ test performs a single conversion, there is a
+ python script using the program to do a more extensive test
+
+multi_sockets/ :
+ test system using a TLM2 compliant AT busmodel using a single socket to
+ bind all targets and initiators to, in combination with LT and AT
+ initiators and targets. This test also uses instance specific extentions
+ in the generic payload
+
+nb2b_adapter/ :
+ Primarily a regression test for a bug in the nb2b adapter of the simple_target_socket.
+ Tests the operation of the nb2b adapter, and also exercises the peq_with_cb_and_phase
+ and the instance_specific_extension.
+
+p2p/ :
+ BaseSocketLT/ :
+ simple point to point test for LT initiator and target
+ CoreDecoupling/
+ simple test for using the LT initiator with temporal decoupling
+ EndEventLT/
+ ??
+ HierarchicalSocket/
+ tests sockets on hierachical modules
+ RegisterSocketProcessLT/
+ simple test for initiator and target using callback registry in sockets
+ SimpleAT/
+ simple point to point test for AT initiator and target using GP
+ AT phases and TLM_ACCEPTED
+ SimpleAT_TA/
+ simple point to point test for AT initiator and target using GP
+ AT phases and TLM_UPDATED
+
+static_extentions/ :
+ contains 3 unit tests to verify the GP extention mechanism
+
+update_original/ :
+ Tests the deep_copy_from() and update_original_from() methods of tlm_generic_payload.
+ Along the way, it also tests the use of byte enables for read and write commands.