boards/native/doc: Update architecture description #78993
Merged
+150
−99
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
aescolar
force-pushed
the
arch_soc_docs
branch
from
0255f62
to
f92cb07
Compare
aescolar
requested review from
kartben,
carlescufi,
hermabe,
jori-nordic and
theob-pro
jori-nordic
previously approved these changes
Sep 25, 2024
boards/native/doc/arch_soc.rst
Outdated
| can be resolved inside that library will be resolved. And that, after, all these library symbols, | ||
| except a selected few marked with an special annotation, will be hidden from further linking. | ||
| In this way, the runner link stage will not link to or conflict with any of these hidden symbols, | ||
| neither from the runner itself or from other embedded CPUs libraries. |
There was a problem hiding this comment.
what do you mean exactly by "embedded CPU libraries"? The pre-linked lib that has the embedded context, or some other library
There was a problem hiding this comment.
I mean "The pre-linked lib that has the embedded context" :)
I rephrased it a bit hoping it will be less ambiguous.
boards/native/doc/arch_soc.rst
Outdated
| But from the runner context only the symbols from the embedded context annotated with the | ||
| ``NATIVE_SIMULATOR_IF`` macro will be linkable. | ||
|
|
||
| From Zephyr's build system it is possible to request a file to be build in the runner context by |
boards/native/doc/arch_soc.rst
Outdated
|
|
||
| * Set up the Zephyr build to produce an static library for the host architecture to be later | ||
| used with the native simulator build and linked with the native simulator runner. | ||
| * Provides a thin adaptation between the API the Zephyr kernel expects from an architecture |
There was a problem hiding this comment.
"Provide" to match "Set up"
theob-pro
previously approved these changes
Sep 25, 2024
The architecture description was quite out of date in some parts, specially those which changed with the introduction of the native simulator. Let's update it. Signed-off-by: Alberto Escolar Piedras <alberto.escolar.piedras@nordicsemi.no>
aescolar
dismissed stale reviews from theob-pro and jori-nordic
via
6cc346f
aescolar
force-pushed
the
arch_soc_docs
branch
from
f92cb07
to
6cc346f
Compare
|
Thanks for the reviews so far @jori-nordic & @theob-pro . I updated it based on @jori-nordic feedback. |
theob-pro
approved these changes
Sep 26, 2024
jori-nordic
approved these changes
Sep 26, 2024
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
The architecture description was quite out of date in some parts, specially those which changed with the introduction of the native simulator.
Let's update it.
Link to rendered docs (when completed)
https://builds.zephyrproject.io/zephyr/pr/78993/docs/boards/native/doc/arch_soc.html