Add OPi NVME install docs
Verified working with latest beta
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?
No, yes, 5 minutes (added)
Should we recommend a brand name SSD (or at least an example)? Make sure teams don't go buy that $10 SSD?
Do we want to qualify this any more strongly? A sd card -will- work, this is just another option.
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.
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.
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)
Yeah that would be good to mention.
How does this work with reflashing the opi?
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.
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?
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.
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.
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.
Has this been tested recently?
I'd like to see that it works before we merge.
Last reports of it working were around April.
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.
I had this not work on newer versions of the Orange Pi.