Diff for /wikisrc/ports/evbarm/allwinner.mdwn between versions 1.37 and 1.63

version 1.37, 2014/12/07 14:28:37 version 1.63, 2017/10/08 23:31:37
Line 1 Line 1
 [[!meta title="NetBSD/evbarm on Allwinner Technology SoCs"]]  [[!meta title="NetBSD/evbarm on Allwinner Technology SoCs"]]
   
   NetBSD supports many boards based on Allwinner SoCs. Starting with NetBSD 8.0, FDT is used to configure devices. As a result, a large number of boards and configurations can be supported with a single kernel.
   
   <img src="https://pbs.twimg.com/media/DIRGmsOXcAEJu-j.jpg" width="300">
   <img src="https://pbs.twimg.com/media/DJYA7SCXUAEvEQk.jpg" width="300">
   
 [[!toc levels=2]]  [[!toc levels=2]]
   
 # Supported boards  # Supported SoCs
  - [Banana Pi](http://www.bananapi.org/p/product.html) (BPI)  
  - Cubieboard 2 (CUBIEBOARD)  <table>
  - Cubieboard 4 (ALLWINNER_A80) *NetBSD-current*    <thead>
  - Cubietruck (CUBIETRUCK)      <tr>
  - [Merrii Hummingbird A31](http://www.merrii.com/en/pla_d.asp?id=172) (HUMMINGBIRD_A31)        <th>Family</th>
         <th>SoC</th>
         <th>NetBSD version</th>
         <th>Example boards</th>
         <th>Notes</th>
       </tr>
     </thead>
     <tbody>
       <tr><td>sun4i</td><td>A10</td><td>8.99.3 and later</td><td><a href="https://www.olimex.com/Products/OLinuXino/A10/A10-OLinuXino-LIME/open-source-hardware">Olimex A10-OLinuXino-LIME</a><td></td></tr>
       <tr><td>sun5i</td><td>A10s</td><td>-</td><td></td></tr>
       <tr><td>sun5i</td><td>A13</td><td>8.99.2 and later</td><td></td></tr>
       <tr><td>sun5i</td><td>GR8</td><td>8.99.2 and later</td><td><a href="https://getchip.com/pages/chippro">C.H.I.P. Pro</a></td><td></td></tr>
       <tr><td>sun5i</td><td>R8</td><td>8.99.2 and later</td><td><a href="https://getchip.com/pages/chip">C.H.I.P.</a>, <a href="https://getchip.com/pages/pocketchip">Pocket C.H.I.P.</a></td><td></td></tr>
       <tr><td>sun6i</td><td>A31</td><td>7.0 and later</td><td><a href="http://linux-sunxi.org/Merrii_Hummingbird_A31">Merrii Hummingbird A31</a></td><td></td></tr>
       <tr><td>sun6i</td><td>A31s</td><td>-</td><td></td><td></td></tr>
       <tr><td>sun7i</td><td>A20</td><td>7.0 and later</td><td><a href="https://linux-sunxi.org/Cubietech_Cubieboard2">Cubietech Cubieboard 2</a>, <a href="https://linux-sunxi.org/Cubietruck">Cubietech Cubietruck</a>, <a href="http://linux-sunxi.org/LeMaker_Banana_Pi">LeMaker Banana Pi</a></td><td></td></tr>
       <tr><td>sun8i</td><td>A23</td><td>-</td><td></td></tr>
       <tr><td>sun8i</td><td>A33</td><td>-</td><td></td></tr>
       <tr><td>sun8i</td><td>A83T</td><td>8.0 and later</td><td><a href="http://www.banana-pi.org/m3.html">Sinovoip Banana Pi BPI-M3</a></td><td></td></tr>
       <tr><td>sun8i</td><td>H2+</td><td>8.0 and later</td><td><a href="http://www.orangepi.org/orangepizero/">Xunlong Orange Pi Zero</a></td><td></td></tr>
       <tr><td>sun8i</td><td>H3</td><td>8.0 and later</td><td><a href="http://nanopi.io/nanopi-neo.html">FriendlyARM NanoPi NEO</a>, <a href="http://www.orangepi.org/orangepiplus2e/">Xunlong Orange Pi Plus 2E</a></td><td></td></tr>
       <tr><td>sun9i</td><td>A80</td><td>8.0 and later</td><td><a href="http://linux-sunxi.org/Cubietech_Cubieboard4">Cubietech Cubieboard 4</a></td><td></td></tr>
       <tr><td>sun50i</td><td>A64</td><td>8.99.2 and later</td><td><a href="https://www.pine64.org/?page_id=1194">Pine64</a>, <a href="https://www.pine64.org/?page_id=3707">Pinebook</a></td><td>aarch32 mode</td></tr>
       <tr><td>sun50i</td><td>H5</td><td>-</td><td></td></tr>
       <tr><td>sun50i</td><td>H6</td><td>-</td><td></td></tr>
     </tbody>
   </table>
   
   
 # Supported hardware  # Supported hardware
  - SoCs  
    - Cortex-A7: A20 (2-core), A31 (4-core), A80  
    - Cortex-A7/A15: A80 (4-core A7 + 4-core A15)  
  - SD/MMC controller (DMA)  
  - DMA controller  
  - GPIO  
    - Configuration using FEX scripts is supported  
  - UART  
  - I2C  
  - P2WI (A31) / RSB (A80)  
  - PMU  
    - AXP209 (A20)  
    - AXP221 (A31)  
    - AXP806 (A80)  
    - AXP809 (A80)  
  - Watchdog timer  
  - RTC  
    - A20/A31: integrated RTC, PCF8563  
    - A80: AC100  
  - Audio codec (A20/A31)  
  - USB host  
    - OHCI  
    - EHCI  
    - OTG (A20)  
  - SATA (A10/A20)  
  - Gigabit Ethernet (GMAC)  
  - HDMI (A20/A31)  
    - DDC / EDID mode detection  
    - Audio support  
  - Framebuffer (A20/A31)  
  - IR receiver (A20/A31)  
   
 # TODO  
  - SoCs  
    - Cortex-A8: A10  
    - Cortex-A7/A15: A80 SMP  
  - OTG (A31)  
  - USB device mode  
  - Bluetooth / WiFi (Cubietruck, Hummingbird A31)  
  - 3G (Hummingbird A31)  
  - SD/MMC UHS-I support (needs sdmmc(4) changes)  
  - TV input (Hummingbird A31)  
  - NAND  
  - Fast Ethernet (EMAC)  
  - IR transmitter (A20)  
   
 # Installation  Please refer to the [SUNXI kernel config](https://nxr.netbsd.org/xref/src/sys/arch/evbarm/conf/SUNXI) for a list of supported hardware.
   
 ## A10 / A20 / A31 based boards  # Installation
   
 * Start with an ARMv7 image from *evbarm-earmv7hf/binary/gzimg/* such as *beagleboard.img*  - Download or build **armv7.img** from NetBSD -current
 * Download a U-Boot build for your board  - Write the image to disk: **dd if=armv7.img of=/dev/rld0d bs=1m conv=sync**
   * A10/A20: Download from the linux-sunxi web site <http://dl.linux-sunxi.org/nightly/u-boot-sunxi/u-boot-sunxi/u-boot-sunxi-latest/>  - Install a board-specific U-Boot (2017.07 or later) from pkgsrc to the SD card: **dd if=/usr/pkg/share/u-boot/&lt;boardname&gt;/u-boot-sunxi-with-spl.bin of=/dev/rld0d bs=1k seek=8 conv=sync**
   * A31: The standard u-boot-sunxi tree doesn't support A31 yet. Until sun6i support is merged, a build is available at <http://dis.invisible.ca/allwinner/a31/  
 * Write the *u-boot-sunxi-with-spl.bin* loader to the base image:  
 [[!template  id=programlisting text="""  
 # dd if=u-boot-sunxi-with-spl.bin of=beagleboard.img bs=1k seek=8 conv=notrunc  
 """]]  
 * Write the image to an SD card.  
 * Copy the kernel (netbsd.ub) for your board to the root of the MS-DOS partition.  
 * Create or edit uEnv.txt on the MS-DOS partition:  
 [[!template  id=programlisting text="""  
 bootargs=root=ld0a  
 uenvcmd=mmc dev 0; mmc rescan; fatload mmc 0:1 82000000 netbsd.ub; bootm 82000000  
 """]]  
   
 ## A80 based boards  
   
 * Cubieboard 4 SDK (lubuntu) U-Boot env:  
 [[!template  id=programlisting text="""  
 baudrate=115200  
 boot_normal=fatload mmc 0:1 20007800 uimage;bootm 20007800  
 bootcmd=run setargs_cubie boot_normal  
 bootdelay=3  
 console=ttyS0,115200  
 console1=tty1  
 init=/init  
 loglevel=8  
 mmc_root=/dev/mmcblk0p2  
 setargs_cubie=setenv bootargs console=${console1} console=${console} root=${mmc_root} loglevel=${loglevel}  
 stderr=serial  
 stdin=serial  
 stdout=serial  
 """]]  
   
 # Big (endian) fun  
   
 You can run this boards with a little endian (this is the default and implied by above install instructions)  
 or with a big endian kernel and userland. However, kernel and userland endianness needs to match.  
   
 To build a big endian release (or sets) use   
 [[!template  id=programlisting text="""  
 ./build.sh -m evbearmv7hf-eb   
 """]]  
 where -eb means endianness big, hf is hardware floating point support, and earm is the modern "extended" ABI for ARM CPUs, and finally v7 is version 7 of the supported instruction set.  
   
 # FEX scripts  
   
 Board configuration scripts can be found here: <https://github.com/linux-sunxi/sunxi-boards/blob/master/sys_config>. You can compile them with the "fex2bin" tool found here: <https://github.com/linux-sunxi/sunxi-tools>.  
   
 To use, copy the compiled FEX to your MS-DOS partition, load it with U-Boot, and then tell the kernel where to find it with the "sysconfig=" boot option. For example, uEnv.txt on a Cubieboard2 might look like this:  
   
 [[!template  id=programlisting text="""  
 bootargs=root=ld0a sysconfig=0x43000000  
 uenvcmd=mmc dev 0; mmc rescan; fatload mmc 0:1 43000000 cubieboard2.bin; fatload mmc 0:1 82000000 netbsd.ub; bootm 82000000  
 """]]  
   
 Some pre-compiled .bin files can be found here: <http://ftp.netbsd.org/pub/NetBSD/misc/jmcneill/allwinner/fex/>  
   
 # Framebuffer console  
   
 To use HDMI for the console device, add *console=fb* to bootargs in uEnv.txt.  
   
 If the connected display does not let you disable overscan, you can add a margin to the framebuffer by with the *fb.margin* bootargs option. For example, to set a 25-pixel margin around the screen, add *fb.margin=25* to uEnv.txt  
   
 # HDMI audio  
   
 The default audio device is the analog audio codec. To change the default device, use the *audiocfg* command:  
   
 [[!template  id=programlisting text="""  
 a31# audiocfg list  
 0: [*] audio0 @ awinac0: Allwinner CODEC A31, 2 playback channels  
 1: [ ] audio1 @ awinhdmiaudio0: Allwinner HDMI 1.4, 2 playback channels  
 a31# audiocfg default 1  
 setting default audio device to audio1  
 a31# audiocfg list  
 0: [ ] audio0 @ awinac0: Allwinner CODEC A31, 2 playback channels  
 1: [*] audio1 @ awinhdmiaudio0: Allwinner HDMI 1.4, 2 playback channels  
 """]]  
   
 # Board specific notes  
   
 ## Merrii Hummingbird A31  
   
 There doesn't appear to be a meaningful way to generate a MAC address on these boards. U-Boot from the A31 SDK and from the u-boot-sunxi tree both lack GMAC support, and the Security ID registers (at 0x01c23800) appear to be empty.  
   
 To overcome this, you can specify your own MAC address in *uEnv.txt*:  
 [[!template  id=programlisting text="""  
 bootargs=root=ld0a awge0.mac-address=02:a0:3d:88:1a:1e  
 """]]  

Removed from v.1.37  
changed lines
  Added in v.1.63


CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb