summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKevron Rees <tripzero.kev@gmail.com>2014-12-17 21:29:34 -0800
committerKevron Rees <tripzero.kev@gmail.com>2014-12-17 21:29:34 -0800
commit5f66d2e3e2bc77fed33a9069a8f02fd2142d218f (patch)
tree2df062b1ff95aac6fcee7f85fd5fd7c1c0ec54df
parentd821768a27b1e29f4c3a1da95f8a0fef8f3ba852 (diff)
downloadautomotive-message-broker-5f66d2e3e2bc77fed33a9069a8f02fd2142d218f.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.