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

Tutorial docs #283

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

Tutorial docs #283

wants to merge 2 commits into from

Conversation

joonho3020
Copy link
Contributor

No description provided.

@@ -110,6 +110,76 @@ known good output of "Hello World!".

.. todo:: Add (or link to) more detailed examples of bare-metal and rocc workloads.


Using the same directory structure for both bare-metal and buildroot
-----------------------------------------------------------------------
Copy link
Contributor

Choose a reason for hiding this comment

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

Nit: Newline after this.


.. include:: example-workloads/example-br/run.sh
:code: bash

Copy link
Contributor

Choose a reason for hiding this comment

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

Nit: Consistent newlines (use 2 or 1 between paragraphs)

@@ -110,6 +110,76 @@ known good output of "Hello World!".

.. todo:: Add (or link to) more detailed examples of bare-metal and rocc workloads.


Using the same directory structure for both bare-metal and buildroot
Copy link
Contributor

Choose a reason for hiding this comment

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

Looking at the other tutorials here (https://firemarshal.readthedocs.io/en/latest/Tutorials/custom.html), it looks like we really just need to add one on BuildRoot and not baremetal. Even then, the Fedora tutorial describes much of what you want... so I think if the docs really want to get fixed I would do the following:

  1. Re-order the "Custom Workloads" tutorials to be 1. BuildRoot Linux Hello World (w/ descriptions of parameters probably taken from the existing Fedora tutorial), 2. Baremetal Hello World 3. Fedora Hello World.

  2. For sharing, I think the test/bare.yaml workload already implements the baremetal hello world... instead of copying that we should repurpose it for the tutorial (I think that workload compile could be simplified). OR we can symlink the example from the test area (or vice version).

Comment on lines +154 to +159
We are ready to build and install the workload for FireSim!

::

./marshal -v build example-workloads/example-br.json
./marshal -v install example-workloads/example-br.json
Copy link
Contributor

Choose a reason for hiding this comment

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

I would add this as a .. note:: since FireMarshal is separate from FireSim in the documentation.

Copy link
Contributor

Choose a reason for hiding this comment

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

This Makefile only works for baremetal not Linux since you are using the unknown-elf compiler.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants