Commit graph

33 commits

Author SHA1 Message Date
Felix Walter
a4463e3653
Merge branch 'feature/interop-test-docs'
See !100
2023-05-12 08:46:06 +02:00
Felix Walter
0b279f9904
Merge branch 'feature/improve-python-venv-setup'
See !95
2023-05-12 08:45:43 +02:00
Felix Walter
06f7a64edd Makefile: Remove pip installation via curl
Even if this uses a secure connection, piping stuff returned by `curl`
into an interpreter is bad practice and can lead to security problems.
We now assume that `pip` and `setuptools` are installed on the target
system, which is reasonable IMO.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2023-05-12 08:24:45 +02:00
Felix Walter
96cef53b76 Makefile: Make it possible to just install the Python dependencies
This moves the commands to install up-to-date versions of all
Python dependencies to the `update-virtualenv` target, so it can be
executed on its own if the user is using an own venv manager.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2023-05-12 08:24:30 +02:00
Felix Walter
6b0b1ddac8 doc: Add ION interop tests to testing.md
Closes: #125

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2023-05-12 08:22:20 +02:00
Felix Walter
b07a653389 AAP: Return bundle creation timestamp and sequence number in bundle ID
See the added description in the AAP documentation - this adds an
internal format to the 64 bit integer value returned as "bundle ID" in
the `SENDCONFIRM` AAP message to uniquely identify the created bundle in
conformance to RFC 9171.

Closes: #60

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2023-05-11 17:03:29 +02:00
Marius Feldmann
691b7c3172 Remove STM32/FreeRTOS support from uD3TN
Former releases of uD3TN have included support for STM32/FreeRTOS.
Having this support from the first moment on was a good thing in
order to optimize for platforms with limited resources. As this
platform is not used in current uD3TN setups and as it results in quite
some maintenance work, it is removed with this commit. The removed parts
cover the implementation itself, tests, tools, documentation, parts of
the build/make scripts as well as licensing information.

Signed-off-by: Marius Feldmann <marius.feldmann@d3tn.com>
2022-03-22 00:05:13 +01:00
Felix Walter
bf4d1b5aca doc: Adapt the manpage to the current state
This adapts the provided manual page so the current command line
arguments are properly reflected, in alphabetical order (like in the
--help output). Furthermore, some typos are fixed and the name of uD3TN
is mentioned consistently.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2022-03-04 15:46:51 +01:00
Felix Walter
312cbfbbb6 doc: Remove superfluous argument from quick start guide
The quick start guide recommends to add a `--dest-eid` argument to the
call to `aap_config.py` when configuring the contact from node A to B.
This is indeed unnecessary as `aap_config.py` can automatically
determine the local configuaration endpoint. The `--dest-eid` argument
is only required in more advanced cases (configuration over multiple
nodes) and implies enabling remote configuration in uD3TN.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2022-02-01 12:53:26 +01:00
Felix Walter
c5680b822b
Merge branch 'hotfix/contact-size-overflow'
See !46
2022-01-28 16:53:47 +01:00
Felix Walter
b8a7d0ca27 doc: Document the concept of infinite-size contacts
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2022-01-28 14:11:34 +01:00
Felix Walter
ea8c18bc3e doc: BIBE: Add trailing slashes to dtn EIDs without demux
As per the BPv7 specification.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2022-01-28 10:55:38 +01:00
Felix Walter
37e39104aa Fix EID validation for dtn and ipn according to BPv7 draft 31
-> https://datatracker.ietf.org/doc/html/draft-ietf-dtn-bpbis-31#section-4.2.5

The previous validation methods were not sufficient to check validity of
dtn as well as ipn EIDs. This adds further functions to easily detect
the EID scheme and validate dtn plus ipn EIDs. Tests for the most common
cases where validity checks should be successful and where they might
fail are added as well.

Due to this change the default EID of uD3TN gets a slash appended, as
dtn EIDs always have to contain the name delimiter '/'.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2022-01-26 21:05:41 +01:00
Felix Walter
449d0bc17c Add proper support for the ipn EID scheme
Previously uD3TN implicitly assumed string EID in many places such as
the agent manager. This adds proper handling for ipn-scheme EIDs,
using numerical service numbers as agent IDs in case uD3TN is started
with an ipn-scheme EID. If the ipn scheme is used, uD3TN always has to
be configured with the service number 0. The config and management agent
IDs can be configured in config.h and are 9000 and 9001, respectively,
to keep the lower range of service numbers free. It is intentional that
agents can register with a service number of zero - uD3TN does not
provide specific functionality under this service number.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2022-01-26 21:05:41 +01:00
Felix Walter
0625c07cbb
Merge branch 'feature/39-implement-bibe'
See !43
2022-01-26 21:04:34 +01:00
Tobias Nöthlich
cfb3ed526c Move BIBE AR creation from bibe_proto to AppAgent
In order to have SENDBIBE and RECVBIBE messages have the same kind of
payload data (BPDUs) the creation of the administrative record needed
for BIBE bundles was moved from the bibe_proto.c file to the application
agent.

Signed-off-by: Tobias Nöthlich <tobias.noethlich@d3tn.com>
2022-01-26 21:04:02 +01:00
Tobias Nöthlich
72c2bf438c Update AAP docs with SEND-/RECVBIBE
This commit updates the AAP docs with explanations for the SEND- and
RECVBIBE message types. It also adds a short note regarding backward
compatibility with older AAP implementations that do not support BIBE.

Signed-off-by: Tobias Nöthlich <tobias.noethlich@d3tn.com>
2022-01-10 13:34:20 +01:00
Tobias Nöthlich
269cabcc56 Update BIBE docs
This commit addresses some issues concerning the documentation of
µD3TN's implementation of Bundle-in-Bundle Encapsulation.

It mostly fixes typos and changes unclear wording to be more precise,
but also expands some parts of the docs with more information.

Signed-off-by: Tobias Nöthlich <tobias.noethlich@d3tn.com>
2022-01-10 11:47:36 +01:00
Tobias Nöthlich
304d26908e Fix typos and remove unnecessary curly brackets
This commit fixes some typos in the BIBE documentation and removes
an unnecessary pair of curly brackets from the bibe_proto.c file.

Signed-off-by: Tobias Nöthlich <tobias.noethlich@d3tn.com>
2021-12-10 19:22:09 +01:00
Tobias Nöthlich
c4c5ba3e9d Update Bundle-in-Bundle Encapsulation_(BIBE).md 2021-12-10 09:48:25 +00:00
Tobias Nöthlich
8bc8879f9e Add first draft of BIBE documentation
In order to make BIBE useable for everyone a short documentation
containing information on what BIBE is, how it works in µD3TN and
how to use it has been added.

Signed-off-by: Tobias Nöthlich <tobias.noethlich@d3tn.com>
2021-12-10 10:34:23 +01:00
Felix Walter
3ab90dcffb Make the remote configuration capability a command line flag
Previously, we had a build-time flag for enabling configuration via
bundles received from other nodes. Thus, changing the flag required a
re-build. As we are depending on it also for our integration tests and
it is often handy in further setups, this change makes it a command
line argument "--allow-remote-config".

As the STM32 platform does not support command line arguments, remote
configuration is enabled by default there via config.h.

See also: !13, #32

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2021-11-11 23:00:09 +01:00
Felix Walter
942db2d257
Merge branch 'feature/deny-remote-time-management'
See !29
2021-07-30 15:48:57 +02:00
Georg Alexander Murzik
c486077fe9 Rewrite README.md
The README.md has been rewritten from scratch to make uD3TN more
appealing and accessible. It comes with a new structure that aims
to provide a gradual introduction starting from the end user
perspective. Some new content has been added compared to the
previous version:

- Overview figure from the end user perspective
- List of implemented IETF standards / drafts
- CLI usage
- Directory structure and entry point
- List of related tools with a brief description

The mood of the text tries to be as short and precise as possible
with as much information as necessary. Bold and italic highlights
are avoided.

Closes #46 and #61.

Signed-off-by: Georg Alexander Murzik <georg.murzik@d3tn.com>
2021-07-30 10:06:58 +02:00
Felix Walter
8aaf7c4358 doc: Mention REMOTE_CONFIGURATION in contacts data format docs
This documents how to compile uD3TN with remote config enabled.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2021-07-27 15:01:40 +02:00
Felix Walter
83f083addb doc: Address review comments in quick start guide
See !23, thanks to @mnitsch!

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2021-04-20 19:04:13 +02:00
Felix Walter
8641e284ff doc: Add POSIX quick start guide
This adds an example-driven quick start guide for Linux and POSIX
systems to the doc/ folder, including the setup of two µD3TN instances
connected to each other.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2021-04-17 13:54:30 +02:00
Maximilian Nitsch
45bbccebb6 Prepare PyPi packages
To distribute the pyD3TN DTN protocol implementations as well as the
uD3TN python utilities on PyPi, the Python code is organized in separate
directories and the PyPi packaging guideline is applied. The
restructuring also requires an adjustment of the imports in the scripts
in tools/ and test/.

Signed-off-by: Maximilian Nitsch <maximilian.nitsch@d3tn.com>
2020-11-19 12:38:39 +01:00
Felix Walter
a971d98f9a doc: Update AAP docs and the dissector with new name
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2020-11-17 15:50:36 +01:00
Felix Walter
8d53addb5e doc: Update config and testing documentation with new name
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2020-11-17 15:50:36 +01:00
Felix Walter
da8cd13548 doc: Update Manpage with new name
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2020-11-17 15:50:36 +01:00
Felix Walter
567d8790dc Update README and testing documentation concerning STM32
This adds some better explanations concerning debugging with the STM32.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2020-11-15 14:22:16 +01:00
Felix Walter
0ce4bee910
Initial import of uPCN v0.8.0 source code
This is the initial commit for uD3TN. uD3TN is a fork of uPCN v0.8.0,
which will be developed and maintained in a public Git repository.

For questions concerning the history of and code provided with uPCN,
please get in touch with us via: contact <at> d3tn <dot> com

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2020-11-14 11:56:40 +01:00