Skip to content
GitLab
Menu
Projects
Groups
Snippets
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Menu
Open sidebar
f-interop-contributors
agent
Commits
f86ce161
Commit
f86ce161
authored
Jun 01, 2018
by
Federico Sismondi
Browse files
documentation enhacement
parent
bdb8b15c
Changes
1
Hide whitespace changes
Inline
Side-by-side
README.md
View file @
f86ce161
...
@@ -16,6 +16,7 @@ Installation
...
@@ -16,6 +16,7 @@ Installation
------------
------------
create virtual env for not messing up your current environment
create virtual env for not messing up your current environment
```
```
pip install virtualenv
pip install virtualenv
virtualenv -p /usr/bin/python2.7 my_venv
virtualenv -p /usr/bin/python2.7 my_venv
...
@@ -23,6 +24,7 @@ source my_venv/bin/activate
...
@@ -23,6 +24,7 @@ source my_venv/bin/activate
```
```
install ioppytest-agent using pip
install ioppytest-agent using pip
```
```
pip install ioppytest-agent
pip install ioppytest-agent
```
```
...
@@ -49,6 +51,66 @@ Error handling
...
@@ -49,6 +51,66 @@ Error handling
When there is a user interrupt signal (Ctrl-C) the agent should kill
When there is a user interrupt signal (Ctrl-C) the agent should kill
all other components and disconnect as gracefully as possible.
all other components and disconnect as gracefully as possible.
IP tunneling mode (active-probe)
--------------------------------
This mode can be used for communicating two IPv6-based implementations
tunneling all traffic through AMQP messages.
## Running the agent for IP tun
For running the agent you will need privileges on the machine, basically
cause we need to open a virtual interface to tunnel the packets.
The command for executing it will be provided to you by the
GUI or AMQP broker sys admin, it should look something like this:
```
sudo python -m agent connect --url amqp://someUser:somePassword@f-interop.rennes.inria.fr/sessionXX --name coap_client
```
for more info
```
python agent.py --help
python agent.py connect --help
```
```
+----------------+
| |
| AMQP broker |
| |
| |
+----------------+
^ +
| |
data.tun.fromAgent.agent_name | | data.tun.toAgent.agent_name
| |
+ v
+---------------------------------+
| |
| Agent |
| |
| (tun mode) |
| |
| |
| +------tun interface--------+ |
| |
| +----------------------------+ |
| | IPv6-based | |
| | communicating | |
| | piece of software | |
| | (e.g. coap client) | |
| | | |
| +----------------------------+ |
+---------------------------------+
```
Serial mode (with 802.15.4 probe)
Serial mode (with 802.15.4 probe)
---------------------------------
---------------------------------
...
@@ -74,10 +136,11 @@ This mode can be used for connecting two remote (geographically distant)
...
@@ -74,10 +136,11 @@ This mode can be used for connecting two remote (geographically distant)
Active mode probe automatically ACKs messages received by the user
Active mode probe automatically ACKs messages received by the user
device, the 802.15.4 are not forwarded to the AMQP connection.
device, the 802.15.4 are not forwarded to the AMQP connection.
## Running the agent
## Running the agent
(serial mode) w/ active-probe
export AMQP connection variables, and USB params for the serial connection
export AMQP connection variables, and USB params for the serial connection
env vars:
env vars:
`
`
export AMQP_EXCHANGE='amq.topic'
export AMQP_EXCHANGE='amq.topic'
export AMQP_URL="amqp://someUser:somePassword@f-interop.rennes.inria.fr/sessionXX"
export AMQP_URL="amqp://someUser:somePassword@f-interop.rennes.inria.fr/sessionXX"
...
@@ -91,6 +154,7 @@ export FINTEROP_CONNECTOR_BAUDRATE=115200
...
@@ -91,6 +154,7 @@ export FINTEROP_CONNECTOR_BAUDRATE=115200
`
`
then execute (e.g. for a coap_server running under the agent):
then execute (e.g. for a coap_server running under the agent):
`
`
python -m agent connect --url $AMQP_URL --name coap_server --serial
python -m agent connect --url $AMQP_URL --name coap_server --serial
`
`
...
@@ -138,7 +202,7 @@ data.serial.fromAgent.agent_name | | data.serial.toAgent.agent_name
...
@@ -138,7 +202,7 @@ data.serial.fromAgent.agent_name | | data.serial.toAgent.agent_name
This mode can be used for forwarding all sniffed packet in a 802.15.4 network to AMQP broker
This mode can be used for forwarding all sniffed packet in a 802.15.4 network to AMQP broker
and eventually other tools listening to the correct routing keys/topics.
and eventually other tools listening to the correct routing keys/topics.
## Running the agent
## Running the agent
(serial mode) w/ passive-probe
**TBD**
**TBD**
```
```
...
@@ -188,64 +252,3 @@ data.serial.fromAgent.agent_name |
...
@@ -188,64 +252,3 @@ data.serial.fromAgent.agent_name |
+---------------+ +---------------+
+---------------+ +---------------+
```
```
IP tunneling mode (active-probe)
--------------------------------
This mode can be used for communicating two IPv6-based implementations
tunneling all traffic through AMQP messages.
## Running the agent
For running the agent you will need privileges on the machine, basically
cause we need to open a virtual interface to tunnel the packets.
The command for executing it will be provided to you by the
GUI or AMQP broker sys admin, it should look something like this:
```
sudo python -m agent connect --url amqp://someUser:somePassword@f-interop.rennes.inria.fr/sessionXX --name coap_client
```
for more info
```
python agent.py --help
python agent.py connect --help
```
```
+----------------+
| |
| AMQP broker |
| |
| |
+----------------+
^ +
| |
data.tun.fromAgent.agent_name | | data.tun.toAgent.agent_name
| |
+ v
+---------------------------------+
| |
| Agent |
| |
| (tun mode) |
| |
| |
| +------tun interface--------+ |
| |
| +----------------------------+ |
| | IPv6-based | |
| | communicating | |
| | piece of software | |
| | (e.g. coap client) | |
| | | |
| +----------------------------+ |
+---------------------------------+
```
\ No newline at end of file
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment