APL4 Ubuntu user documentation
Contents
How to install your operating system
Install Ubuntu
Download the Ubuntu 16.04 ISO from the Ubuntu download page:
https://www.ubuntu.com/download/desktop
Burn the image on a USB stick. We suggest using Etcher for doing that. You can download it from
https://etcher.io
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) OK
$ 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~aaeonc9-Ubuntu SMP Tue Sep 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 259 > /sys/class/gpio/export echo out > /sys/class/gpio/gpio259/direction echo 1 > /sys/class/gpio/gpio259/value cat /sys/class/gpio/gpio259/value
To read the DIO input 1:
echo 260 > /sys/class/gpio/export echo in > /sys/class/gpio/gpio260/direction cat /sys/class/gpio/gpio260/value
The chip has 4 gpio output from 259 to 263 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:
pch_skylake-virtual-0 Adapter: Virtual device temp1: +61.0°C acpitz-virtual-0 Adapter: Virtual device temp1: +27.8°C (crit = +119.0°C) temp2: +29.8°C (crit = +119.0°C) coretemp-isa-0000 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) f81801u-isa-0a10 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
I2C
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
Watchdog
Enter as root user:
$ sudo -i
Reboot after 1 minute:
$ echo 1 > /dev/watchdog