Intel Joule

Ubuntu Core

We will walk you through the steps of flashing Ubuntu Core on an Intel Joule. At the end of this process, you will have a board ready for production or testing snaps.

User account prerequisites

An Ubuntu SSO account is required to create the first user on an Ubuntu Core installation.

  1. Start by creating an Ubuntu SSO account
  2. Import an SSH Key into your Ubuntu SSO account on this page. Instructions to generate an SSH Key on your computer can be found here

Hardware and software requirements

  • An Intel® Joule
    • The board needs to have its BIOS updated to version #193, which is available here. BIOS update instructions can be found here
  • 2 USB 2.0 or 3.0 flash drives (2GB min.)
  • A monitor with an HDMI interface
  • A Mini HDMI to HDMI cable
  • A USB keyboard and a mouse
  • A USB Hub for all the above USB pieces (4)
  • An 802.11 a/b/g/n WiFi network with Internet access
  • An Ubuntu Desktop 16.04.2 LTS image
  • An Ubuntu Core image

Ubuntu Core image

Ubuntu Core 16 image for Intel Joule

  • MD5SUM: 03adc0bce55ed1d87c10f79bf5b7e2fa

Installation instructions

  1. Download and copy the Ubuntu Desktop 16.04.1 LTS image on the first USB flash drive by following the Live USB Ubuntu Desktop instuctions for Ubuntu | Windows | Mac OS X
  2. Download the Ubuntu Core image for Intel Joule and copy the file on the second USB drive
  3. Connect your USB hub, keyboard, mouse, monitor to the Joule
  4. Insert the first USB flash drive, containing Ubuntu Desktop 16.04.1 LTS
  5. Power-up the Joule board, boot-up the device from USB and select “Try Ubuntu without installing” in the first boot menu
  6. Once the system is ready, insert the second USB flash drive
  7. Open a terminal and run the following command, where <disk label> is the name of the second USB flash drive:

    xzcat /media/ubuntu/<disk label>/ubuntu-core-16-joule.img.xz | sudo dd of=/dev/mmcblk0 bs=32M status=progress; sync
    
  8. Remove all USB flash drives and reboot the system, it will reboot from the internal memory now containing Ubuntu Core

First boot

  1. The system will boot then become ready to configure
  2. The device will display the prompt “Press enter to configure”
  3. Press enter then select “Start” to begin configuring your network and an administrator account. Follow the instructions on the screen, you will be asked to configure your network and enter your Ubuntu SSO credentials
  4. At the end of the process, you will see your credentials to access your Ubuntu Core machine:
    This device is registered to <Ubuntu SSO email address>.
    Remote access was enabled via authentication with the SSO user <Ubuntu SSO user name>
    Public SSH keys were added to the device for remote access.
    

User login

Once setup is done, you can login with SSH into Ubuntu Core, from a machine on the same network, using the following command:

ssh <Ubuntu SSO user name>@<device IP address>

The user name is your Ubuntu SSO user name, it has been reminded to you at the end of the account configuration step.

First boot tips
  • During setup,console-conf will download the SSH key registered with your Store account and configure it so you can log into the device via ssh <Ubuntu SSO account name>@<device IP address> without a password.
  • There is no default ubuntu user on these images, but you can run sudo passwd <account name> to set a password in case you need a local console login.

Install and develop snaps

Your board is ready to have snaps installed — get started with the snap command

You can install a classic Ubuntu environment on top of Ubuntu Core to have a fully-fledged development environment and develop snaps on target ›


Ubuntu Desktop

As an alternative to Ubuntu Core, you can install Ubuntu Desktop 16.04 LTS, where you can use your favourite development tools to create and run snaps.

  • The board needs to have its BIOS updated to version #193, which is available here. BIOS update instructions can be found here

Ubuntu image

Intel Joule - Ubuntu Desktop 16.04 LTS image

  • MD5SUM: 07e4895b2921117288ff611c6f5fea28

Download and copy the image on an USB flash drive by following the installation media instructions.

Installation instructions

Booting the board from the USB flash drive will start the Ubuntu installer.

  1. Boot the system from the USB flash drive
  2. The system will automatically execute the first stage of installation, including eMMC storage partitioning and image installation. After installation is complete, a prompt dialog will be shown and you will need to restart the system
  3. Boot the system on the eMMC storage and finish the install configuration
  4. Follow the instructions and enter appropriate options for language, WiFi, location (timezone), and keyboard layout
  5. Pick a hostname, user account and password
  6. Wait for the configuration to finish. If you connected to a WiFi network at step 4, it will take several minutes to download and apply additional updates. You can now reboot the system
  7. Ubuntu is installed. Use your account and password to log in

Change the default audio output

In the current release, the analog audio port on mezzanine board is chosen as the default audio output. To use HDMI audio, you need to modify the Joule sound configuration file: /etc/modprobe.d/joule-snd.conf.

Edit configuration

  1. Open an editor to modify the configuration file:

    $ sudo nano /etc/modprobe.d/joule-snd.conf
    
  2. To use HDMI audio, uncomment the line #blacklist snd_sock_skl and comment the line softdep snd_hda_intel pre: snd_sock_skl. You can revert these changes if you want to change your sound output back to defaults.

  3. Reboot the system to apply the new setting.