vh/forgefirm
1
0
Fork 0
mirror of https://github.com/openglow-org/forgefirm.git synced 2026-09-28 09:11:11 -07:00
Code Issues Packages Projects Releases Wiki Activity

scripts/docs: fail loudly, fix names, document bring-up-only status

Browse Source 
install-forgefirm.sh completed silently broken when the download, flash
write, mount or uEnv rewrite failed - add die() checks around every
critical step (audit N13/M12) and download the release asset under the
exact Scarthgap artifact name (forgefirm-image-glowforge.rootfs.wic.gz)
so uploads need no renaming. ffboot no longer depends on the never-
provisioned /etc/fw_env_mmcblk2.config: it falls back to
/etc/fw_env.config (which both the factory and ForgeFIRM images ship,
pointing at the eMMC env) and checks fw_setenv results (audit N16).
BUILD.md gets the real artifact name and marks the built u-boot
reference-only; INSTALL.md drops the stale script/ogboot names and the
cloud-connect promise, stating the image is bring-up-only (audit N11).
This commit is contained in:
ScottW514
2026-07-26 16:15:25 -04:00
parent e92cce2b7e
commit 83627a6aea
4 changed files with 56 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files
INSTALL.md
+8 -3
View File
@@ -47,7 +47,7 @@ After these steps have completed, you will be prompted to reboot:
### Stage 2
After the device reboots, login as root and run the script again:
```bash
./install-openglow.sh
./install-forgefirm.sh
```
This will complete the installation process by performing the following steps:
@@ -56,7 +56,7 @@ This will complete the installation process by performing the following steps:
* Restarting the network services.
* Downloads the [latest OpenGlow image](https://github.com/ScottW514/forgefirm/releases) from GitHub.
* Writes the OpenGlow image to the flash (this takes a bit, be patient)
* Installs the ```/data/ogboot``` utility so you can switch between OpenGlow and factory images.
* Installs the ```/data/ffboot``` utility so you can switch between ForgeFIRM and factory images.
Hit any key to reboot into your fancy new OpenGlow image.
@@ -68,7 +68,12 @@ Hit any key to reboot into your fancy new OpenGlow image.
Login is ```root```, no password. You can also connect via SSH - same user, no password (obviously, you should change this).
The unit will automatically connect to the Glowforge service upon boot, and begin the homing sequence. You can use it from the GFUI like normal (mostly, don't try fancy stuff like setting the focus, snap marks, pass through, or the calibration tool).
> **Current status: this image is bring-up-only.** No controller or cloud
> client starts at boot — the machine boots to an idle shell with the kernel
> driver, hardware libraries (gfhardware/gfutilities), and camera tooling
> installed. The grblHAL controller (forgectrl) is under development; the
> legacy cloud client (gfui-client) is deliberately not shipped. Nothing
> homes, moves, or connects anywhere until you start it yourself.
You can easily switch back and forth between factory and OpenGlow images:
```bash