Skip to content

07-multi-hop: Add detailed documentation#85

Merged
miri64 merged 1 commit intoRIOT-OS:masterfrom
MrKevinWeiss:pr/task7
Jan 29, 2019
Merged

07-multi-hop: Add detailed documentation#85
miri64 merged 1 commit intoRIOT-OS:masterfrom
MrKevinWeiss:pr/task7

Conversation

@MrKevinWeiss
Copy link
Copy Markdown
Contributor

This commit helps clarify individual steps to take to run the test.
It adds documentation on how to use the shell commands.

Copy link
Copy Markdown
Member

@miri64 miri64 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some questions

Comment thread 07-multi-hop/07-multi-hop.md Outdated
Comment thread 07-multi-hop/07-multi-hop.md Outdated
Comment thread 07-multi-hop/07-multi-hop.md Outdated
@MrKevinWeiss
Copy link
Copy Markdown
Contributor Author

@miri64 How about I separate this out as a possible way to run it? Maybe move it to example1.md? Would that be easier?

@miri64
Copy link
Copy Markdown
Member

miri64 commented Nov 12, 2018

@miri64 How about I separate this out as a possible way to run it? Maybe move it to example1.md? Would that be easier?

I mostly agree with what you propose, I just find the choice of configuration questionable for an official release testing procedure: The packet buffer is way too small for routers (if you try to send larger packets you will see that), the amount of configurable addresses way too big. The only thing that is a matter of taste is the number of IoT-LAB nodes picked.

@MrKevinWeiss
Copy link
Copy Markdown
Contributor Author

I broke it out as a guide (a possible way to test). I also removed the packet_buf flag as it was added due to my ignorance and reduce the configurable addresses a bit. I think other people can add there own versions (like adding the blacklisting, I think that would be useful for automated tests). However, at this time I don't know how that is done.

Comment thread 07-multi-hop/example_test_guide.md Outdated
@MrKevinWeiss
Copy link
Copy Markdown
Contributor Author

@miri64, I don't want to spend more time on this. I think the best way to make everyone happy is to just leave it as an unmerged PR (so I can refer back to it). Then next release I can rerun with all your recommendations (so with blacklisting and default values). Then re-document/adapt to that.

Copy link
Copy Markdown
Contributor

@aabadie aabadie left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it make sense to have those 'testing procedure' suggestions inlined in the main document ? Like it is proposed in this PR, it's a bit hidden.

@miri64
Copy link
Copy Markdown
Member

miri64 commented Jan 18, 2019

There still need to be ironed out some kinks regardless of that. Mainly, the unnecessary configuration of the number of interface IPv6 addresses -DGNRC_NETIF_IPV6_ADDRS_NUMOF=15 is still there.

@MrKevinWeiss
Copy link
Copy Markdown
Contributor Author

MrKevinWeiss commented Jan 18, 2019

Yup I will update and retest soon

@miri64
Copy link
Copy Markdown
Member

miri64 commented Jan 18, 2019

I think 10-icmpv6-error provides a good template how to integrate the testing procedures into the specification.

@MrKevinWeiss
Copy link
Copy Markdown
Contributor Author

@miri64 I updated to do it the l2filter_whitelist way. This way we can keep default values for everything. Please advise on how you would like me to proceed (should I keep this as an example and we leave the actual test more generic or make this the test?).

Copy link
Copy Markdown
Member

@cgundogan cgundogan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like this test guide. It will definitely help an uninformed tester. I left a few nitpicking comments.

Comment thread 07-multi-hop/example_test_guide.md Outdated
Comment thread 07-multi-hop/example_test_guide.md Outdated
@cgundogan cgundogan mentioned this pull request Jan 27, 2019
68 tasks
Comment thread 07-multi-hop/example_test_guide.md
Comment thread 07-multi-hop/example_test_guide.md Outdated
This commit helps clarify individual steps to take to run the test.
It is meant as a guide to and not a specification.
Adds documentation on how to use the shell commands.
@miri64 miri64 merged commit c8e4cf4 into RIOT-OS:master Jan 29, 2019
@MrKevinWeiss
Copy link
Copy Markdown
Contributor Author

Thanks @miri64 and @cgundogan!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants