Skip to content

products/adsp/setup: update getting started for bringup bundle and Fedora rootfs - #573

Open
katiaTsaruk wants to merge 2 commits into
mainfrom
add-fedora
Open

products/adsp/setup: update getting started for bringup bundle and Fedora rootfs#573
katiaTsaruk wants to merge 2 commits into
mainfrom
add-fedora

Conversation

@katiaTsaruk

Copy link
Copy Markdown
Contributor
  • Replace the two-step bootstrap/debug archive download with the new
    single images-bringup-* bundle that combines bootstrap, debug, and
    Fedora rootfs artifacts
  • Document the new eMMC installer menu that lets the user choose between
    Buildroot-only or Buildroot with Fedora root filesystem
  • Replace the root login section with the first-boot user setup flow
    that creates a user account and displays the board IP for SSH access

The CI now publishes a single images-bringup-* archive that combines the
bootstrap, debug, and Fedora rootfs artifacts.

Signed-off-by: Kateryna Tsaruk <kateryna.tsaruk@analog.com>
@katiaTsaruk katiaTsaruk self-assigned this Aug 12, 2026
@ozan956 ozan956 moved this to In Development in ADSP Aug 12, 2026
Comment thread docs/products/adsp/setup.rst Outdated
Comment on lines +325 to +326
the installer also downloads and extracts ``adsp-sc598-rootfs.tar.zst`` to the
Fedora root partition.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Downloads from where?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

from the same archive where everything else, now all of the files needed are packed in the same folder

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

for emmc.img.gz it says:

downloads emmc.img.gz from your PC

Thats why I confused. I think one is coming from my PC, and the other one is from internet.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

editted to have this note for both files

Comment on lines +373 to +374
Waiting for network....
SSH: ssh <username>@<board-ip>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Cant we just use the console or console appears after those messages ? Its bit hard to understand now, from a user perspective I would think that I have to ssh to acces to board.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

You do need to ssh to access the board, as the console issue is still there I just shut it down so it does not spam and you can create a user.

Comment on lines +310 to +312
1) Buildroot kernel and root filesystem
2) Buildroot kernel and Fedora root filesystem
0) Skip

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

1
2
0

is this the type of ordering in other formatters as well? Like making the negative selection as zero in the bottom?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I thought it is nice to have the skip option as the last in the list and 0 is kind of neutral choice, so it is clear that it is not like another option, especially if we will add more options soon. I can also flip it if you think it will be better like that

Navigate to the :git-br2-external:`br2-external releases page <releases+>` and
download both release archives that match your hardware (``images-bootstrap-*``
and ``images-debug-*``), then extract them into the same directory:
download the bringup archive (``images-bringup-*``). This single archive

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

with this superartifact, who will be still asking for bootstrap artifact? What whould be the thing that bootstrap artifact can do and bringup cannot?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The same question is for debug and rootfs, so it can do everything which those 3 smaller artifacts can do, as it just downloads them and packs into a single directory so it is easier for the end users. There still can be use cases when u do not need all 3 things and can just download the signle one.

The installer now prompts to choose between Buildroot-only or
Buildroot with Fedora root filesystem before asking for the PC IP.
On first boot, a setup service creates a user account and displays
the board IP for SSH access instead of a root login prompt.

Signed-off-by: Kateryna Tsaruk <kateryna.tsaruk@analog.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: In Development

Development

Successfully merging this pull request may close these issues.

2 participants