Saturday 1 March 2014

How to install MachineKit BeagleBone LinuxCNC in MacOSX

Recently I wanted to use Beaglebone black for my Chinese CNC 3040 router, trying to installing it is bit complicated.  Here is my learning....

You will not able to use MachinceKit directly because the setup_sdcard.sh script only work on linux. So the first thing you need it todo is to install VMWare.   Once you have the VMware install, you need to install Ubuntu.

Make sure you share your work area in mac to VMWare using the Sharing feature in setting:


Once you share your mac directory to vmware, the director will be located at /mnt/hgfs/<name of directory you share>.

You can't build the image and write to it directly. You need to create the image file in vmware, then write the image to the sdcard manually.

Here is the command I use to create the image file, please note that you need to use the --img-4gb option, the default is 2gb and will not be enough to hold all the file.

sudo ./setup_sdcard.sh  --uboot bone_dtb --img-4gb kk.img

depend on your ubuntu build, you may need to download other program, please read the screen for error message and see if you need to install more program.

Once your image is build, go back to terminal in mac and follow the step to install OS image to usb drive.

Here is my step, please know your location may be difference.


  1. use  df -h to location your usb drive, my usb drive is located at /dev/disk2s1
  2. unmount the usb drive using sudo diskutil unmount /dev/disk2s1
  3. use sudo dd bs=1m if=./kk-4gb.img of=/dev/rdisk2 to write the image to usb drive

Once you done writing the file to usb drive, you will need install the file to beagle bone black, the process of writing and updating beagle bone black take some time.  You will know you are success when you login to your update BBB and see 3.8.13xenomai-bone33 in the login message. 



Or you can run BBB as standalone machine: