## Set some parameters for the page #pragma section-numbers 2 #pragma keywords HATP, hatp, htn planning, hatpconsole, hatptester #pragma description Homepage for HATP software, an open-source HTN task planner = msgconnector, HATP's middleware = This page presents msgconnector's usage. msgconnector is responsible to carry messages form a module to another. It is also responsible to the connection to other middlewares: OPRS, ORO, YARP. || <>|| /!\ '''The way to install msgconnector is described in [[HATP/install]].''' == Principle == msgconnector is composed of a server (`MsgSever`) that once started allows the different clients to connect. When a client connects it gives its name. This name is then used to carry a message from a client to another. It is possible to declare several clients with the same name, then all the message are repeated to all the clients with the same name. The message passed are using the JSON standard (see [[http://en.wikipedia.org/wiki/JSON|JSON]]). Finally msgconnector can be connected to other middleware to extend the reach of HATP's messages. To do so bridges need to be started. So far the implemented bridge are: * OPRS * ORO * YARP * print (which is in fact just a backend to print all messages that it receives). ''If you need an additionnal bridge put the request on the tracker, see the troubleshooting section at the bottom of this page.'' == Start the server == The default usage for the server is simply: {{{ MsgServer }}} It starts the server on `localhost` and on the port `5500`. The help gives: {{{ MsgServer --help Usage: Default: MsgServer Compact: MsgServer address:port [max_time] Standard: MsgServer address port [max_time] Complete: MsgServer [-a address] [-p port] [-t max_time] [-m max_connections] Allowed options: --help Produce help message -a [ --address ] arg The address of the server (default : localhost) -p [ --port ] arg The port number of the server (default : 5500) -t [ --time ] arg The maximum inactivity time in second before the automatic-shutdown of the server (default : 3600) -m [ --max-clients ] arg Maximum number of clients that can connect at the same time (default : 10) }}} It is indeed possible to change the following parameters: * `adrress`, `port` on which the server starts * `time` which is how long the server will wait after the last message before automatically quitting * `max_clients` which is the number of clients that can be connected at the same time. To connect the !MsgServer over the network the address should be ":" or nothing to connect over the network, not localhost. == Use a bridge == === Use OPRS bridge === <> {{{ msgconnector-OPRS-bridge }}} The parameters are: * ``: Registered name of hatponboard, usually "`HATP`". * ``: Name of this bridge on OPRS's side. * ``: The address of msgconnector's server, usually "`localhost`".* * ``: Name of this bridge on HATP's side, should be the name of the OPRS module you want to talk to. * ``: The address of OPRS's server.* * ``: Can be `0` or `1` to toggle the verbose mode (all message processed are printed out). *: The address can be a hostname like `localhost`. === Use ORO bridge === <> {{{ msgconnector-ORO-bridge }}} The parameters are: * ``: The name of this bridge on HATP's side. * ``: The address of msgconnector's server, usually "`localhost`". * ``: The address of ORO's server. * ``: Can be `0` or `1` to toggle the verbose mode (all message processed are printed out). === Use YARP bridge === <> {{{ msgconnector-YARP-bridge }}} The parameters are: * ``: Name of the HATP's module that will be the target of the bridge messages. * ``: The address of msgconnector's server, usually "`localhost`". * ``: The name of this bridge on HATP's side. * ``: The name of this bridge on YARP's side. * ``: Can be `0` or `1` to toggle the verbose mode (all message processed are printed out). === Use the print bridge === <> {{{ msgconnector-PRINT-bridge }}} The parameters are: * ``: Name of this bridge. * ``: The address of msgconnector's server, usually "`localhost`". == Changelog == === Version 2.0.0 === * Use libhatp to parse solution plan instead of doing it manually * Fix automatic exit after an inactivity time * Message max size in now 96Ko * Add the tool HATPGoalTester that allow to send a request from command line * Fix install/uninstall proccesses * '''Change the name''' of the repository and the project to msgconnector * Add "package" target === Version 2.1.0 === * Add install rules for the bridges === Version 2.2.0 === * Improve packaging system * Fix missing includes (due to update of the compiler) === Version 2.3.0 === * Change from epoll to '''select''' (allow to compile on NetBSD, ...) === Version 2.4.0 === * Fix compilation in NstBSD * Change the isConnected test (change in the API behaviour) * Better error detection in both server and client * Install Findmsgconnector to help CMake find it === Version 2.5.0 === * Change parameters parsing for the server === Version 2.6.0 === * Update OpenPRS bridge to allow to request the database for the initial state === Version 2.7.0 === * Allow to request the whole OpenPRS database at once === Version 2.8.0 === * Fix the binary installation (and RPATH management) === Version 2.8.1 === * Correct the socket-error detection === Version 2.8.2 === * Allow to start the server without a time limit === Version 2.8.3 === * Add the possibility to send broadcast messages * Client no longer automatically connect to localhost, possible to specify the server === Version 2.8.4 === * Server now binds to all addresses: allow to use '''msgconnector over network''' * Socket is now blocking == License, Troubleshooting and Maintainer == HATP is distributed under 2-clause BSD license. ([[http://opensource.org/licenses/BSD-2-Clause|See here for details.]]) The page to report problems or for pull request: [[https://git.openrobots.org/projects/msgconnector|Openrobots/msgconnector]]. Current maintainer(s): * '''Raphaël Lallement''': [[mailto:raphael.lallement [at] laas.fr|raphael.lallement [at] laas.fr]], [[http://homepages.laas.fr/rlalleme|Website]]. ##Later can use <>