diff options
author | Kevron Rees <tripzero.kev@gmail.com> | 2015-01-11 23:10:04 -0800 |
---|---|---|
committer | Kevron Rees <tripzero.kev@gmail.com> | 2015-01-11 23:10:04 -0800 |
commit | f506d618a7da2dd80e87842e6641469a486b205f (patch) | |
tree | 7d22be5306aa2f5f722c326e6d875741533ca371 | |
parent | ee6049d25c2a3d21ae31caf0d4fe6e1227354a47 (diff) | |
download | automotive-message-broker-f506d618a7da2dd80e87842e6641469a486b205f.tar.gz |
added new README
-rw-r--r-- | README | 80 | ||||
-rw-r--r-- | README.md | 76 |
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 |