Preparing a workshop image - BelaPlatform/Bela GitHub Wiki

This material has been superseded. Visit learn.bela.io for the maintained version.

Prepare it:

  • get your preferred workshop branch (e.g.: topic/xenomai-3-workshop)
  • run scripts/update_board
  • run ssh [email protected] make -C Bela lib
  • zip -r workshop.zip resources scripts examples
  • copy the workshop.zip to BELABOOT
  • safely eject BELABOOT from the host
  • gracefully shutdown the board (e.g.: hold press the Bela button)
  • clone the SD card

Test it out / use it:

  • open the IDE page (IMPORTANT: refresh it if it was already open)
  • copy workshop.zip to your computer
  • unzip it
  • navigate to scripts/ and double click on workshop_watcher. Leave the terminal window open.
  • Open a file in examples/13-workshop/your-favourite-subfolder, edit it, hit save and that project should start building in the IDE window.

NOTE: the IDE must be open for the workshop_watcher to work. When running the workshop it is convenient to make them do a live tour of the IDE, so you make sure they have the tab open before you open the workshop_watcher.

Resize image for smaller eMMCs

Sometimes you deal with older BeagleBones with smaller eMMCs. If that is the case, you shall run the following on the SD card, before flashing the eMMCS, in order to delete ~200MB of unnecessary files:

rm -rf /opt/xenomai-3/ /opt/seasocks/ /opt/dtb-rebuilder/ /opt/bb.org-dtc /opt/bb.org-overlays /opt/am335x_pru_package/ /opt/checkinstall /opt/rtdm_pruss_irq/ /var/lib/apt/lists/

Please DO NOT use such an image for production: use it only for the workshop board with smaller eMMC.