KBU4 Ubuntu user documentation

From AAEON Community Wiki
Jump to: navigation, search

How to install your operating system

Install Ubuntu

Download the Ubuntu 16.04 ISO from the Ubuntu download page:


Burn the image on a USB stick. We suggest using Etcher for doing that. You can download it from


Insert the USB installer disk in a empty USB port and proceed with a normal Ubuntu installation. After the system reboots, open a terminal and run:

sudo apt update
sudo apt full-upgrade -y
sudo reboot

Install AAEONC kernel from PPA

After the reboot you need to add our repository and replace the default kernel:

$ sudo add-apt-repository ppa:ubilinux/aaeonc
   PPA containing the kernel and support packages for aaeon community boards
   More info: https://launchpad.net/~ubilinux/+archive/ubuntu/aaeonc
   Press [ENTER] to continue or ctrl-c to cancel adding it
   gpg: keyring `/tmp/tmpeoxw49hz/secring.gpg' created
   gpg: keyring `/tmp/tmpeoxw49hz/pubring.gpg' created
   gpg: requesting key E952D27B from hkp server keyserver.ubuntu.com
   gpg: /tmp/tmpeoxw49hz/trustdb.gpg: trustdb created
   gpg: key E952D27B: public key "Launchpad PPA for ubilinux team" imported
   gpg: Total number processed: 1
   gpg:               imported: 1  (RSA: 1)
$ sudo apt-get update
$ sudo apt-get --purge remove linux-*generic*
$ sudo apt-get install linux-image-generic-hwe-16.04-aaeonc
$ sudo apt-get --purge autoremove
$ sudo reboot

After the reboot you can verify that the kernel is indeed installed by typing:

$ uname -srv
    Linux 4.10.0-42-generic #5000~aaeonc8-Ubuntu SMP Tue Jul 10 15:35:31 UTC 2018

Intel graphics stack

You can install Intel graphics firmware from:

wget https://download.01.org/gfx/ubuntu/16.04/main/pool/main/i/intel-graphics-update-tool/intel-graphics-update-tool_2.0.2_amd64.deb

Change directory to “file path”

$ cd <filepath>/

install gdebi package manager:

$ sudo apt-get install gdebi

Install the package with the following command: for Ubuntu* 16.04(64bits)

$ sudo gdebi intel-graphics-update-tool_2.0.2_amd64.deb

Add PPA repository for stable mesa-utils

$ sudo add-apt-repository ppa:paulo-miguel-dias/pkppa && sudo apt-get update

Once installed, you can find the Intel® Graphics Update Tool for Linux* OS in your application dashboard. Just look for the Intel® logo, or begin typing ‘Intel’.

Or, if you are a power user, you can open a terminal and execute:

$ intel-graphics-update-tool

Follow the instructions to install the driver and wait for the installation. After that, you must to reboot the board.

Brightness Controller for Ubuntu

Install Brightness Controller with the following commands:

$ sudo add-apt-repository ppa:apandada1/brightness-controller
$ sudo apt-get update
$ sudo apt-get install brightness-controller

After installation, search the “Brightness Controller” in your Ubuntu and control the brightness settings.

How to test the single interfaces

F75111 Digital I/O

The DIO connector on the board is managed by a F75111 GPIO controller via i2c.

To enable it under ubuntu do:

  • Remove the i2c_i801 module from blacklist
sudo sed -i 's/blacklist i2c_i801/# &/' /etc/modprobe.d/blacklist.conf
  • add the i2c_i801 modules to /etc/modules
echo -e "\n# Module for i2c gpio\ni2c_i801" | sudo tee -a /etc/modules > /dev/null
  • load the i2c device on startup
sudo sed -i '/exit 0/i echo "f75111 0x37" > /sys/class/i2c-adapter/i2c-0/new_device' /etc/rc.local
  • Restart the system
sudo reboot

Usage Example

Enter as sudo user:

sudo su

To set the DIO input 0 to 1 do:

echo 504 > /sys/class/gpio/export
echo out > /sys/class/gpio/gpio504/direction
echo 1 > /sys/class/gpio/gpio504/value
cat /sys/class/gpio/gpio504/value

To read the DIO input 1:

echo 505 > /sys/class/gpio/export
echo in > /sys/class/gpio/gpio505/direction
cat /sys/class/gpio/gpio505/value

The chip has 4 gpio output from 504 to 507 that can be used.

Hardware monitoring sensors

Use lm-sensors to access:

Step 1. Install lm-sensors.

    $ sudo apt-get install lm-sensors

Step 2. Run sensors-detect and answer YES to “Super I/O sensors” questions.

    $ sudo sensors-detect

Do you want to scan for Super I/O sensors? (YES/no): yes
Probing for Super-I/O at 0x2e/0x2f
Trying family `National Semiconductor/ITE'...               No
Trying family `SMSC'...                                     No
Trying family `VIA/Winbond/Nuvoton/Fintek'...               Yes
Found `Fintek F71889FG/F81801U Super IO Sensors'            Success!
    (address 0xa10, driver `f71882fg')
Probing for Super-I/O at 0x4e/0x4f
Trying family `National Semiconductor/ITE'...               No
Trying family `SMSC'...                                     No
Trying family `VIA/Winbond/Nuvoton/Fintek'...               No
Trying family `ITE'...                                      No

Step 4. Test the sensor output using the lm-sensors utility "sensors".

    $ sensors

You should see one sensor output like:

Adapter: Virtual device
temp1:        +61.0°C  

Adapter: Virtual device
temp1:        +27.8°C  (crit = +119.0°C)
temp2:        +29.8°C  (crit = +119.0°C)

Adapter: ISA adapter
Package id 0:  +60.0°C  (high = +100.0°C, crit = +100.0°C)
Core 0:        +58.0°C  (high = +100.0°C, crit = +100.0°C)
Core 1:        +60.0°C  (high = +100.0°C, crit = +100.0°C)

Adapter: ISA adapter
in0:          +1.70 V  
in1:          +0.57 V  (max =  +2.04 V)
in2:          +1.19 V  
in3:          +1.02 V  
in4:          +0.72 V  
in5:          +0.53 V  
in6:          +0.38 V  
in7:          +1.71 V  
in8:          +1.62 V  
fan1:        1338 RPM
fan2:           0 RPM  ALARM
fan3:           0 RPM  ALARM
temp1:        +56.0°C  (high = +85.0°C, hyst = +81.0°C)
                       (crit = +100.0°C, hyst = +96.0°C)  sensor = transistor
temp2:        +44.0°C  (high = +85.0°C, hyst = +81.0°C)
                       (crit = +100.0°C, hyst = +96.0°C)  sensor = transistor
temp3:          FAULT  (high = +70.0°C, hyst = +68.0°C)
                       (crit = +85.0°C, hyst = +83.0°C)  sensor = transistor



You can use i2c-tools to access i2c bus on EC.

$ sudo apt-get install i2c-tools
$ sudo i2cdetect -l

You should see one i2c device list like that:

 i2c-3	i2c       	i915 gmbus dpd                  	I2C adapter
 i2c-1	i2c       	i915 gmbus dpc                  	I2C adapter
 i2c-4	i2c       	DPDDC-A                         	I2C adapter
 i2c-2	i2c       	i915 gmbus dpb                  	I2C adapter
 i2c-0	smbus     	SMBus I801 adapter at f040      	SMBus adapter



Enter as root user:

$ sudo -i

Reboot after 1 minute:

$ echo 1 > /dev/watchdog