Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

examples/gnrc_border_router: pass variables to docker #20618

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

maribu
Copy link
Member

@maribu maribu commented Apr 24, 2024

Contribution description

This passes environment variables used to configure e.g. the uplink of the border router to the docker container, so that configuration works with BUILD_IN_DOCKER=1.

Testing procedure

Run:

USEMODULE="sock_dns gnrc_ipv6_nib_dns" make -C examples/gnrc_border_router BOARD=esp32-mh-et-live-minikit BUILD_IN_DOCKER=1 UPLINK=wifi WIFI_SSID=foobar WIFI_PASS=foobar1337 flash term
make: Entering directory '/home/maribu/Repos/software/RIOT/master/examples/gnrc_border_router'

In master, you'll see "crazy" serial output, as the build system on the host expects normal stdio and WiFi as uplink, but the build system in the docker container expected slip as uplink and multiplexes the uplink with stdio.

With this PR, the serial is no longer multiplexed with the uplink, but WiFi is used as configured.

Issues/PRs references

None

This allows configuration of the app as described even when using
`BUILD_IN_DOCKER=1`.
@github-actions github-actions bot added Area: build system Area: Build system Area: examples Area: Example Applications labels Apr 24, 2024
@MrKevinWeiss
Copy link
Contributor

Ahh, that makes sense :)

@maribu maribu added Type: enhancement The issue suggests enhanceable parts / The PR enhances parts of the codebase / documentation CI: ready for build If set, CI server will compile all applications for all available boards for the labeled PR labels Apr 25, 2024
@riot-ci
Copy link

riot-ci commented Apr 25, 2024

Murdock results

✔️ PASSED

276ad18 examples/gnrc_border_router: pass UPLINK etc to docker

Success Failures Total Runtime
10065 0 10066 20m:56s

Artifacts

@maribu maribu enabled auto-merge April 25, 2024 10:56
Comment on lines +73 to +74
WIFI_PASS \
WIFI_SSID \
Copy link
Contributor

Choose a reason for hiding this comment

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

Are those defined and documented anywhere in a generic way? grepping through the RIOT repo only shows them being mentioned in esp-common and atwinc15x0 driver documentation, where they are expected to be passed within CFLAGS anyway.

So instead of adding them here, I would use the same approach as for the other Makefile variables just for examples/gnrc_border_router.

Copy link
Member Author

Choose a reason for hiding this comment

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

They are actually not used by the example, but used by the only two WIFI drivers (ESP* and ATWINC15x0) we have.

They are documented separately in both drivers.

Copy link
Contributor

Choose a reason for hiding this comment

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

I'm not sure I follow. The example defines the environment variables in https://github.com/RIOT-OS/RIOT/blob/master/examples/gnrc_border_router/Makefile#L19-L20 and uses them in https://github.com/RIOT-OS/RIOT/blob/master/examples/gnrc_border_router/Makefile.wifi.conf to add them to CFLAGS.

The documentation of both ESP* and the ATWINC15x0 explicitly adds them to CFLAGS as well (e.g., https://github.com/RIOT-OS/RIOT/blob/master/cpu/esp32/doc.txt#L1639). The only other example I could find that uses these environment variables is examples/paho-mqtt which also explicitly adds them to CFLAGS later on: https://github.com/RIOT-OS/RIOT/blob/master/examples/paho-mqtt/Makefile#L62-L63.

So my point was that the environment variables themselves are not generically defined, but only custom to specific examples, and therefore I think those examples should add the respective DOCKER_ENV_VARS themselves.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Area: build system Area: Build system Area: examples Area: Example Applications CI: ready for build If set, CI server will compile all applications for all available boards for the labeled PR Type: enhancement The issue suggests enhanceable parts / The PR enhances parts of the codebase / documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants