Build Instructions

Collapse instructions

• 1

  Step 1

  To build and run the LCD demo, follow these steps.

  Download the binary RetroBSD package for Fubarino from here: retrobsd-fubarino-2015-05-19.zip

  Alternatively, you can build everything from sources. Follow instructions on page: install-fubarino

• 2

  Step 2

  Transfer the Unix kernel on to the Fubarino. Connect the board via microUSB cable to your computer. To enter a bootloader mode, press the PRG key first, hold it, then press the RESET key. The LED will now flash and your Fubarino is ready to accept new code. Use pic32prog utility to program the flash code. Fubarino in bootloader mode will appear as a virtual COM port on your computer. You will need to know the exact device name to specify for pic32prog (typically /dev/ACM0 on Linux, something like COM12 on Windows, /dev/tty.usbmodemfa131 on Mac OS X).

  Use proper binary for your operating system (included into above retrobsd-fubarino-2015-05-19.zip package):

  • pic32prog.exe - for Windows
  • linux32/pic32prog - for 32-bit Linux
  • linux64/pic32prog - for 64-bit Linux
  • macos/pic32prog - for Mac OS X.

  Unpack the package, go to retrobsd-fubarino-g226 directory and run command (say, for 64-bit Linux):

  linux64/pic32prog -d /dev/ttyACM0 unix.hex

  For Windows, it should be like:

  pic32prog -d COM12 unix.hex

  On Mac OS X:

  macosx/pic32prog -d /dev/tty.usbmodemfa131 unix.hex

  You should see:

  Programmer for Microchip PIC32 microcontrollers, Version 1.112
      Copyright: (C) 2011-2014 Serge Vakulenko
        Adapter: STK500v2 Bootloader
   Program area: 1d000000-1d07ffff
      Processor: Bootloader
   Flash memory: 512 kbytes
           Data: 153384 bytes
          Erase: done
  Program flash: ###################################### done
   Verify flash: ###################################### done
  Rate: 9307 bytes per second
  

  Perfect! You have installed RetroBSD on your Fubarino board.

• 3

  Step 3

  Now transfer the filesystem image sdcard.img on to a SD card using a USB-to-SD reader. On Windows, use Win32DiskImager utility. On Linux or Mac OS X, run:
  

  sudo dd bs=32k if=sdcard.img of=/dev/XYZ

  where XYZ is a name of SD card on your computer (use lsblk or "diskutil list" to obtain).

  Once that is done remove the SD card from card reader and plug it into your Fubarino's SD slot. Your RetroBSD system is ready to run.

View all 7 instructions