Documentation/mainboard/kontron/mal10.md

   1 # Kontron mAL10 Computer-on-Modules platform
   2
   3 The Kontron [mAL10] COMe is a credit card sized Computer-on-Modules
   4 platform based on the Intel Atom E3900 Series, Pentium and Celeron
   5 processors.
   6
   7 ## Technology
   8
   9 ```{eval-rst}
  10 +------------------+----------------------------------+
  11 | COMe Type        | mini pin-out type 10             |
  12 +------------------+----------------------------------+
  13 | SoC              | Intel Atom x5-E3940 (4 core)     |
  14 +------------------+----------------------------------+
  15 | GPU              | Intel HD Graphics 500            |
  16 +------------------+----------------------------------+
  17 | Coprocessor      | Intel TXE 3.0                    |
  18 +------------------+----------------------------------+
  19 | RAM              | 8GB DDR3L                        |
  20 +------------------+----------------------------------+
  21 | eMMC Flash       | 32GB eMMC pSLC                   |
  22 +------------------+----------------------------------+
  23 | USB3             | x2                               |
  24 +------------------+----------------------------------+
  25 | USB2             | x6                               |
  26 +------------------+----------------------------------+
  27 | SATA             | x2                               |
  28 +------------------+----------------------------------+
  29 | LAN              | Intel I210IT, I211AT             |
  30 +------------------+----------------------------------+
  31 | Super IO/EC      | Kontron CPLD/EC                  |
  32 +------------------+----------------------------------+
  33 | HWM              | NCT7802                          |
  34 +------------------+----------------------------------+
  35 ```
  36
  37 ## Building coreboot
  38
  39 The following commands will build a working image:
  40
  41 ```bash
  42 make distclean
  43 make defconfig KBUILD_DEFCONFIG=configs/config.kontron_mal10
  44 make
  45 ```
  46 ## Payloads
  47 - SeaBIOS
  48 - edk2
  49 - Linux as payload
  50
  51 ## Flashing coreboot
  52
  53 The SPI flash can be accessed internally using [flashrom].
  54 The following command is used to flash BIOS region.
  55
  56 ```bash
  57 $ flashrom -p internal --ifd -i bios -w coreboot.rom --noverify-all
  58 ```
  59
  60 ## Hardware Monitor
  61
  62 The Nuvoton [NCT7802Y] is a hardware monitoring IC, capable of monitor critical
  63 system parameters including power supply voltages, fan speeds, and temperatures.
  64 The remote inputs can be connected to CPU/GPU thermal diode or any thermal diode
  65 sensors and thermistor.
  66
  67 - 6 temperature sensors;
  68 - 5 voltage sensors;
  69 - 3 fan speed sensors;
  70 - 4 sets of temperature setting points.
  71
  72 PECI is not supported by Apollo Lake Pentium/Celeron/Atom processors and the CPU
  73 temperature value is taken from a thermal resistor (NTC) that is placed very
  74 close to the CPU.
  75
  76 ## Untested
  77
  78 - IGD/LVDS
  79 - SDIO
  80
  81 ## Tested and working
  82
  83 - Kontron CPLD/EC (Serial ports, I2C port, GPIOs)
  84 - NCT7802 [HWM](#Hardware Monitor)
  85 - USB2/3
  86 - Gigabit Ethernet ports
  87 - eMMC
  88 - SATA
  89 - PCIe ports
  90 - IGD/DP
  91
  92 ## TODO
  93 - Onboard audio (codec IDT 92HD73C1X5, currently disabled)
  94 - S3 suspend/resume
  95
  96 [mAL10]: https://www.kontron.com/products/iot/iot-industry-4.0/iot-ready-boards-and-modules/com-express/com-express-mini/come-mal10-e2-.html
  97 [W25Q128FV]: https://www.winbond.com/resource-files/w25q128fv%20rev.m%2005132016%20kms.pdf
  98 [flashrom]: https://flashrom.org/Flashrom
  99 [NCT7802Y]: https://www.nuvoton.com/products/cloud-computing/hardware-monitors/desktop-server-series/nct7802y/?__locale=en
 100 [crashes]: https://pastebin.com/cpCfrPCL