summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKevron Rees <tripzero.kev@gmail.com>2014-12-17 21:29:34 -0800
committerKevron Rees <kevron.m.rees@intel.com>2014-12-23 13:07:49 -0800
commit3a6c006804268cd4f7c2f1d4984f0f707b94f490 (patch)
tree58999a28a17f22fc63af31fd4871ab3549666823
parentdc0dbcb92a2aac565a9ecb252cd6ab89b375def3 (diff)
downloadautomotive-message-broker-3a6c006804268cd4f7c2f1d4984f0f707b94f490.tar.gz
Update testing
-rw-r--r--tests/testing27
1 files changed, 20 insertions, 7 deletions
diff --git a/tests/testing b/tests/testing
index 0e7a149c..55c04fd7 100644
--- a/tests/testing
+++ b/tests/testing
@@ -13,7 +13,10 @@ III. Performance testing
Internal testing
-AMB performs internal testing of core functionality via the "test" plugin[1]. This plugin tests AbstractRoutingEngine methods. If a test failes, ambd will abort. This plugins also prints out the total property capabilities of AMB. This is useful for verifying the addition of core properties to AMB's capabilities. To run the test plugin, simply run ambd with the following example configuration[2]:
+AMB performs internal testing of core functionality via the "test" plugin[1]. This plugin tests
+AbstractRoutingEngine methods. If a test failes, ambd will abort. This plugins also prints out the total
+property capabilities of AMB. This is useful for verifying the addition of core properties to AMB's capabilities.
+To run the test plugin, simply run ambd with the following example configuration[2]:
ambd -c testsourceconfig -d5
@@ -25,13 +28,17 @@ References:
DBus API testing
-AMB exposes a complex API over DBus[1]. This document will only lightly touch on the organization of the API for testing purposes. For a information, please refer to the AMB DBus API documentation. The API has two general interfaces: "Manager", and "DataType". DataType refers to a particular type of vehicle data such as "VehicleSpeed". The easiest way to test the AMB DBus API is to run the example dbus config[3]:
+AMB exposes a complex API over DBus[1]. This document will only lightly touch on the organization of the API for
+testing purposes. For a information, please refer to the AMB DBus API documentation. The API has two general
+interfaces: "Manager", and "DataType". DataType refers to a particular type of vehicle data such as "VehicleSpeed".
+The easiest way to test the AMB DBus API is to run the example dbus config[3]:
ambd -c dbusconfig -d5
Manager testing
-The Manager interfaces[2] is located in "/" with the interface "org.automotive.Manager". Manager is used to create and find DataTypes. It has the following methods:
+The Manager interfaces[2] is located in "/" with the interface "org.automotive.Manager". Manager is used to create
+and find DataTypes. It has the following methods:
List
FindObject
@@ -42,7 +49,8 @@ SourcesForObjectName
Please refer to the Manager documentation for specific explaination on what these methods do.
-To test these methods, dbus-send, which comes with most linux distros can be used. The following is the general pattern:
+To test these methods, dbus-send, which comes with most linux distros can be used. The following is the general
+pattern:
dbus-send --system --print-reply --dest=org.automotive.message.broker / org.automotive.Manager.{METHOD_NAME} ...
@@ -50,7 +58,8 @@ To test the "List" method:
dbus-send --system --print-reply --dest=org.automotive.message.broker / org.automotive.Manager.List
-This should return a list of supported DataTypes that can be used to create and find object paths representing that type.
+This should return a list of supported DataTypes that can be used to create and find object paths representing that
+type.
To test the "FindObject" method:
@@ -67,7 +76,8 @@ amb-set
amb-get-history
amb-listen
-These scripts can be used to get values of objects, set properties on objects, get historic/logged data and listen for changes to objects. For usage, please see [command] -h. For example: "amb-get -h".
+These scripts can be used to get values of objects, set properties on objects, get historic/logged data and listen
+for changes to objects. For usage, please see [command] -h. For example: "amb-get -h".
References:
[1] - DBus API documentation: https://github.com/otcshare/automotive-message-broker/blob/master/docs/README
@@ -76,6 +86,9 @@ References:
Performance Testing
-In addition to general profiling tools, AMB comes with a few ways you can measure performance. When running ambd with the -d1 option, you can see how many property updates are being generated per second and how many are actually being fired because a plugin is subscribed to that property. Coupling this with CPU usage measuring tools can help with measuring performance.
+In addition to general profiling tools, AMB comes with a few ways you can measure performance. When running ambd
+with the -d1 option, you can see how many property updates are being generated per second and how many are actually
+being fired because a plugin is subscribed to that property. Coupling this with CPU usage measuring tools can help
+with measuring performance.