LEDscape Image Instructions

README.md

LEDscape Arch Image

Download and flash the image

1. Download the image: https://www.dropbox.com/s/aypd417ffrkul26/ledscape-arch-linux.img.xz

2. Flash it to an sd card, where /dev/rdiskN is the device node of your SD card

   xz -dc ledscape-arch-linux.img.xz | sudo dd of=/dev/rdiskN bs=4m

Boot the Beaglebone from the SD Card:

1. Power off the beaglebone,
2. Insert the SD card
3. Hold the BOOT button and power on the Beaglebone

Connect to the installer image

With an FTDI Cable:

1. Connect the FTDI cable to the serial header on the Beaglebone
2. Configure your serial console to 921600 baud
3. Login with ledscape/ledscape

Using SSH with dynamic DNS

1. Ensure the ethernet cable is connected to your network before booting

2. After booting (10s or so), ssh in with password ledscape:

   ssh ledscape@ledscape.local

Using SSH with a static IP

1. Before booting the Beaglebone, connect your computer to the bone with an ethernet cable

2. Configure your computer to have the IP 10.0.44.1 subnet mask 255.255.255.0

3. After booting (10s or so), ssh in with password ledscape:

   ssh ledscape@ledscape.local

Install the Image to the eMMC:

1. Run the eMMC flasher script where new-hostname is the desired hostname for the BBB and ip-address is a static IP to use:

   sudo /home/ledscape/LEDscape/install-to-emmc.sh new-hostname ip-address

2. After the script runs, halt the bbb:

   halt

3. Power off the Beaglebone and remove the SD card

Configure LEDscape

1. Boot the BBB

2. SSH or use an FTDI cable to login as ledscape

3. Remount the root filesystem readwrite with

   remount-rw.sh

4. CD into the LEDscape directory:

   cd /home/ledscape/LEDscape

5. Reset LEDscape master for simplicity:

   git checkout . && git checkout master

6. Remove the malformed PRU mapping JSON:

   rm ./pru/mappings/lap-pru22-v1.json

7. Rebuild LEDscape:

   make clean && make

8. Modify ws281x-config.json to suit your needs (mapping config, number of strips and LEDs)

9. Run LEDscape once while the filesystem is read-write:

   sudo pkill -9 opc-server; sudo ./run-ledscape

10. Reboot the BBB:

    sudo reboot

11. Hopefully everything works!