summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKevron Rees <tripzero.kev@gmail.com>2015-01-11 23:10:04 -0800
committerKevron Rees <tripzero.kev@gmail.com>2015-01-11 23:10:04 -0800
commitf506d618a7da2dd80e87842e6641469a486b205f (patch)
tree7d22be5306aa2f5f722c326e6d875741533ca371
parentee6049d25c2a3d21ae31caf0d4fe6e1227354a47 (diff)
downloadautomotive-message-broker-f506d618a7da2dd80e87842e6641469a486b205f.tar.gz
added new README
-rw-r--r--README80
-rw-r--r--README.md76
2 files changed, 76 insertions, 80 deletions
diff --git a/README b/README
deleted file mode 100644
index 90916606..00000000
--- a/README
+++ /dev/null
@@ -1,80 +0,0 @@
-Automotive Message Broker is a vehicle network abstraction system. It brokers information from the vehicle
-to applications. It provides application with a rich API for accessing vehicle data.
-
-Automotive Message Broker is built using CMake and requires libltdl (libtool), libjson-c, and boost packages.
-
-
-About the Git Tree:
-master is expected to be unstable and may not even compile. If you want something more stable, checkout one of the
-release branches (ie, 0.9.0, 0.10, etc)
-
-
-To build:
-
-cd automotive-message-broker
-mkdir build
-cd build
-cmake ..
-make
-
-To install:
-
-sudo make install
-
-To run:
-
-ambd
-
-ambd can load different plugins. The config file specifies what plugins to use. The default config located in
-/etc/ambd/config. You can change this or use your own config to have ambd use your own plugins. For example:
-
-# copy the config to your own config
-cp /etc/ambd/config myconfig
-
-# edit myconfig and specify the path to your plugin:
-# change the line:
-"sources" : [ { "path" : "../plugins/examplesourceplugin.so" } ],
-# to:
-"sources" : [ { "path" : "/path/to/mysourceplugin.so" } ],
-
-Now you can run ambd with:
-
-ambd -c /path/to/myconfig
-
-also see ambd -h
-
-Typically, AMB will be used with the DBus plugin. The DBus plugin automatically makes internal AMB properties
-available over DBus. See the DBus plugin documentation for more information (plugins/dbus/README).
-
-
-Running with other plugins
-
-To learn about running AMB with other plugins, please see the plugins/*/README.
-
-
-Running with the Qt mainloop:
-
-Some source and sink plugins may want to use the Qt-based mainloop to take advantage of Qt features. To enable
-the Qt mainloop, run cmake with -Duse_qtcore=On:
-
-cmake .. -Dqtmainloop=On
-
-You will also need to edit your config to enable the Qt-based mainloop:
-
-{
- "mainloop" : "/usr/lib/automotive-message-broker/qtmainloopplugin.so",
- "sources" : [...],
- "sinks" : [...]
-}
-
-NOTE: by default the glib mainloop will be used.
-
-
-
-Questions/Issues/Comments:
-
-Questions or Comments can be emailed to:
-tripzero.kev@gmail.com
-
-Issues can be submitted on our github page:
-https://github.com/otcshare/automotive-message-broker/issues
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..8de70546
--- /dev/null
+++ b/README.md
@@ -0,0 +1,76 @@
+# Automotive Message Broker
+
+Version 0.13.801
+
+## Introduction
+
+Automotive Message Broker is a vehicle network abstraction system. It brokers information from the vehicle
+to applications. It provides application with a rich API for accessing vehicle data.
+
+Automotive Message Broker is built using CMake and requires libltdl (libtool), libjson-c, and boost packages.
+
+## Git
+About the Git Tree:
+master is expected to be unstable and may not even compile. If you want something more stable, checkout one of the
+release branches (ie, 0.9.0, 0.10, etc)
+
+## Building
+
+To build:
+
+~~~~~~~~~~~~~{.bash}
+cd automotive-message-broker
+mkdir build
+cd build
+cmake ..
+make
+~~~~~~~~~~~~~
+
+## Installing
+
+To install:
+
+~~~~~~~~~~~~~{.bash}
+sudo make install
+~~~~~~~~~~~~~
+
+## Running
+To run:
+
+~~~~~~~~~~~~~{.bash}
+ambd
+~~~~~~~~~~~~~
+
+*also see **ambd -h** for additional command line options*
+
+## Configuration
+
+For information on ambd's configuration, please see ambd-configuration.idl.
+
+## Running with the Qt mainloop:
+
+Some source and sink plugins may want to use the Qt-based mainloop to take advantage of Qt features. To enable
+the Qt mainloop, run cmake with -Duse_qtcore=On:
+
+~~~~~~~~~~~~~{.bash}
+cmake .. -Dqtmainloop=On
+~~~~~~~~~~~~~
+
+You will also need to edit your config to enable the Qt-based mainloop:
+
+~~~~~~~~~~~~~{.json}
+{
+ "mainloop" : "/usr/lib/x86_64-linux-gnu/automotive-message-broker/qtmainloopplugin.so",
+ "plugins" : "/etc/ambd/plugins.d"
+}
+~~~~~~~~~~~~~
+
+NOTE: by default the glib mainloop will be used.
+
+## Questions/Issues/Comments:
+
+Questions or Comments can be emailed to the amb mailing list:
+**amb at lists.01.org**
+
+Issues and Feature requests can be submitted on our github page:
+https://github.com/otcshare/automotive-message-broker/issues