mirror of
https://github.com/cimryan/teslausb.git
synced 2026-03-01 04:30:33 +00:00
Flashable image to get started more quickly
This is a WORK IN PROGRESS, SHOULD BE WORKING.
Notes
- Assumes your Pi has access to Wifi, with internet access (during setup). (But all setup methods do currently.) USB networking still enabled for troubleshooting.
Configure the SD card before first boot of the Pi
- Flash the image from here using Etcher or similar.
- Mount the card again, and in the
bootdirectory create ateslausb_setup_variables.conffile to export the same environment varibles normally needed for setup (including archive, Wifi, and push notifications (if desired).) See the main README for all the variables. I.e. file should contain at a minimum (replace with your own values):export archiveserver=Nautilus export sharename=SailfishCam export shareuser=sailfish export sharepassword=pa$$w0rd export campercent=100 export SSID=your_ssid export WIFIPASS=your_wifi_password - Run the
setup-piForHeadlessBuild.sh(note: notsetup-piForHeadlessSetup.sh):curl https://raw.githubusercontent.com/rtgoodwin/teslausb/headless-patch/headless-scripts/setup-piForHeadlessBuild.sh -o setup-piForHeadlessBuild.sh chmod +x setup-piForHeadlessBuild.sh ./setup-piForHeadlessBuild.sh <location_of_boot_directory> - If all goes well, put card into Pi and boot.
- Wait for the the Pi to come up as a CAM USB drive, if you have it plugged into your computer. If plugged into just a power source, or your car, give it a few minutes until the LED starts pulsing steadily which means the archive loop is running and you're good to go.
What happens under the covers
When the Pi boots the first time:
- A
/boot/teslausb-headless-setup.logfile will be created and stages logged. This takes the place of the "STOP" commands - Marker files will be created in
bootlikeTESLA_USB_SETUP_STARTEDandTESLA_USB_SETUP_FINISHEDto track progress. May use a progress system so the script can pick back up if needed. (This is probably useful for the general/old way of setup too.) - The Pi LED will flash patterns as it gets to each stage (labeled in the setup-teslausb-headless script).
- 10 flashes means setup failed!
- After the final stage and reboot the LED will go back to normal. Remember, the step to remount the filesystem takes a few minutes.
At this point the next boot should start the Dashcam/music drives like normal. If you're watching the LED it will start flashing every 1 second, which is the archive loop running.
NOTE: Don't delete the
TESLAUSB_SETUP_FINISHEDfile. This is how the system knows setup is complete.
Image builder source and patches
For now the image creation work is at:
- Modified pi-gen rtgoodwin's fork of pi-gen in (whatever current branch I'm working at the time).
headless-patchbranch of rtgoodwin fork https://github.com/rtgoodwin/teslausb/tree/headless-patch/headless-scripts
Image creation TODOs
- Patch the hostname to teslausb
- Make it so if someone deletes the
TESLAUSB_SETUP_FINISHEDfile it's handled gracefully. - I still see some errors during pi-gen about locale, may need to be fixed? stage0/01-locale/debconf en_US.UTF-8
- Cache the remount packages? Might mess with first boot like
rsyslog - Any other steps to move into the base image?
- Aspirational TODO: Remove more packages and set services to stopped to make the boot process faster?
- NOTE: I moved all script downloads and variable creation to the initial setup. At this point, I'm designing it to pull the setup scripts dynamically, since development is still ongoing. If/when we reach a good frozen state, we can generate an image that is ready to run. I think it'll also be pretty tricky to do some of the remounting and creating the backing files etc. on the image creation side. Open to suggestions/contributions there though! At the very least we could bake in stable first stage headlessBuild scripts for Mac/Linux/Windows.
Modifications to pi-gen builder from master
Built image on a Raspi running Stretch, for maximum Pi-ception.
- Add SKIP and SKIP_IMAGES files to stage3, 4, and 5 (if present).
- Add a stage6. (There are stages0-5, but may be a stage5 in some cases. This will help keep a clean merge later.)
- Copy the prerun.sh from
stage2. Be SURE to markchmod +xit. - Remove or rename the EXPORT_NOOBS files in all stages. We don't need a NOOBS image built.
- In
stage6, create a00-tweaksfolder, with a00-patchesfolder and patch inside to patchcmdline.txtto remove the resize and add the needed modules. The build process usesquiltfor patching. Note: the path for any patching you do at this stage isstage6/rootfs/FILEPATHwhererootfsrepresents the Pi's/. So,cmdline.txtisstage6/rootfs/boot/cmdline.txt. - Add a patch for the
config.txtfile. - Add a file called
seriesin the patches directory with the name of each.difffile in the order you want them applied. - Add a
filesfolder in stage6 with modifiedrc.local. The modifiedrc.localwill handle pulling down thesetup-teslausb-headlessfile the first time. (Still working on build logic here.) Files are moved into final locations in a00-run.shscript and theinstallcommand. See the script for details. - (Yes at this point you could suggest that just putting the end state files in place instead of patching would be good, but why not be idiomatic? :) )
- Add a script to flash LEDs
- Run
sudo ./build.shfrom thepi-gendirectory. - If you get a failure, it's almost certainly after stage2, so you can add SKIP files in stage2-stage5 present) and rerun
sudo CLEAN=1 ./build.sh