photonvision icon indicating copy to clipboard operation
photonvision copied to clipboard

Add OPi NVME install docs

Open ArchdukeTim opened this issue 1 year ago • 19 comments

Verified working with latest beta

ArchdukeTim avatar Nov 27 '24 02:11 ArchdukeTim

Did we need to install anything back on the opi image? Do we need to tell them to install the os on the sd card then do these commands with the SSD installed? How long should the user expect this to take?

Juniormunk avatar Nov 27 '24 02:11 Juniormunk

No, yes, 5 minutes (added)

ArchdukeTim avatar Nov 27 '24 03:11 ArchdukeTim

Should we recommend a brand name SSD (or at least an example)? Make sure teams don't go buy that $10 SSD?

Juniormunk avatar Nov 27 '24 04:11 Juniormunk

Do we want to qualify this any more strongly? A sd card -will- work, this is just another option.

mcm001 avatar Dec 05 '24 02:12 mcm001

Do we want to qualify this any more strongly? A sd card -will- work, this is just another option.

I think it's fine considering it's in the advanced install section and it says "MicroSD cards are not the best" which is true.

Juniormunk avatar Dec 05 '24 02:12 Juniormunk

I just don't want a bunch of teams cargo culting this because we published it. That might be true, but I don't think that people will necessarily read that sentence that way.

mcm001 avatar Dec 05 '24 02:12 mcm001

Should we call out that the uboot flash is only required once? Once that has been done, you can image the SSD directly with a USB M.2 writer. (I've been working that way the entire off-season, skipping the SD card entirely for updates)

stephenjust avatar Dec 07 '24 19:12 stephenjust

Yeah that would be good to mention.

mcm001 avatar Dec 07 '24 21:12 mcm001

How does this work with reflashing the opi?

Juniormunk avatar Dec 09 '24 03:12 Juniormunk

The key is that the uboot flash process to enable SSD boot writes to an SPI Flash chip soldered to the OPi board itself. It's not changing anything about the OS on the SD card or SSD. Think of it just like changing a BIOS setting to change the boot order. You would need to re-flash the SPI Flash memory explicitly to revert the change.

stephenjust avatar Dec 09 '24 04:12 stephenjust

I found that the uboot flash step works only with the v2.4.0 of the Ubuntu-rockchip image.

Will photonvision be updated to be based off of these or should I update the step to flash one of these to a microsd card as the initial setup image?

ArchdukeTim avatar Dec 19 '24 20:12 ArchdukeTim

We shall please the gods with a note that industrial sd cards are still known to work well.

@Juniormunk In our experience the sd card type wasn't the weak point. It was the form factor. The physical card self-ejected during competition. Industrial or not won't fix that issue.

ArchdukeTim avatar Dec 19 '24 20:12 ArchdukeTim

I made a PR for that https://github.com/PhotonVision/photon-image-modifier/pull/38. I just haven't pushed to get a tag made since there are a few other updates I'd like to make.

crschardt avatar Dec 19 '24 20:12 crschardt

Can we add something that says industrial SD cards work, but if you're experiencing issues with the form factor this could be a possible solution? Or something along those lines.

samfreund avatar Apr 10 '25 19:04 samfreund

Has this been tested recently?

samfreund avatar Aug 20 '25 19:08 samfreund

I'd like to see that it works before we merge.

samfreund avatar Aug 20 '25 19:08 samfreund

Last reports of it working were around April.

Gold856 avatar Aug 20 '25 19:08 Gold856

A brief suggestion for the intro paragraph in the orangepi-nvme docs as well as the note:

Intro: Teams interested in other robust storage options for their Orange Pi can consider NVMe SSDs, which provide strong performance, reliable storage, and secure mounting which can handle the stresses of competition, compared to the spring-loaded slot that microSD cards typically use.

Important! Note afterwards: MicroSD cards, especially industrial-grade ones, remain a solid and widely used option. NVMe SSDs are simply another choice for teams who would like to take advantage of the benefits they offer for their specific setup or needs.

boomermath avatar Aug 20 '25 23:08 boomermath

I had this not work on newer versions of the Orange Pi.

Juniormunk avatar Aug 24 '25 03:08 Juniormunk