Skip to main content
Jump to: navigation, search


Before Installation

  • These instructions apply only to the BeagleBone Black rev C running Debian. Angstrom is not supported by Kura at this time.
  • BeagleBone ships with several web services enabled to assist in setting up the device and doing example projects. These services interfere with Kura and will need to be disabled if the Kura Web UI is to be used. Execute the below commands to disable the BeagleBone web services:
systemctl disable cloud9.service
systemctl disable gateone.service
systemctl disable bonescript.service
systemctl disable bonescript.socket
systemctl disable bonescript-autorun.service
systemctl disable avahi-daemon.service
systemctl disable gdm.service
systemctl disable mpd.service

Installing and Running

  • Kura depends on several Linux packages available in the Debian repository. These packages are:
    • hostapd - Services for access point management.
    • bind9 - Services for DNS management.
    • isc-dhcp-server - Set of tools for managing a DHCP server.
    • iw - Set of wireless tools.
    • monit - System monitoring service.
    • dos2unix - Tool for converting files written in Windows to Linux format.
    • telnet - user interface to the TELNET protocol.
  • Each of these pacakges is available in the Debian repository and can be installed via:
sudo apt-get install <package_name>
  • To install Kura, copy the Debian package to the BeagleBone (ex: /root).
  • Install Kura by running:
sudo dpkg -i <kura_package_name>.deb
  • Once installation is complete, Kura can be started by restarting the BeagleBone or:
sudo /etc/init.d/kura start
  • The status of Kura can be monitored by viewing the log file (ex: tail -f /var/log/kura.log).

Serial Support

  • The recommended method for using serial communication on the BeagleBone is through a USB to Serial adapter. When this adapter is plugged in it should enumerate as /dev/ttyUSB0. You can verify this by issuing the commands:
dmesg | grep tty


[    9.121499] usb 1-1: FTDI USB Serial Device converter now attached to ttyUSB0
ls /dev/ttyUSB*


  • UART1 through UART5 also provide serial ports on the BeagleBone (UART0/ttyO0 is reserved for serial console).

IMPORTANT: The voltage levels on the BeagleBone header pins are 3.3V. You must ensure that the device connecting to the BeagleBone also uses 3.3V or use a logic level converter. Failure to match voltage level could damage the BeagleBone black, the connected device, or both.

  • To enable a UART for serial, open /boot/uboot/uEnv.txt with a text editor. Add the below line to the file:
optargs=quiet drm.debug=7 capemgr.enable_partno=BB-UART5
  • Replace "BB-UART5" with the desired UART number (BB-UART1, BB-UART2, BB-UART3, BB-UART4, BB-UART5).
  • Reboot the BeagleBone.
  • Verify the serial port is available by running the below commands:
dmesg | grep tty


[    0.738547] 481aa000.serial: ttyO5 at MMIO 0x481aa000 (irq = 46) is a OMAP UART5
ls /dev/ttyO*


/dev/ttyO0  /dev/ttyO5

Back to the top