File:  [NetBSD Developer Wiki] / wikisrc / ports / evbarm / allwinner.mdwn
Revision 1.45: download - view: text, annotated - select for diffs
Sun Dec 21 23:08:18 2014 UTC (6 years, 4 months ago) by wiki
Branches: MAIN
CVS tags: HEAD
web commit by jmcneill: Note A80 basic framebuffer support

    1: [[!meta title="NetBSD/evbarm on Allwinner Technology SoCs"]]
    2: 
    3: [[!toc levels=2]]
    4: 
    5: # Supported boards
    6:  - [Banana Pi](http://www.bananapi.org/p/product.html) (BPI)
    7:  - Cubieboard 2 (CUBIEBOARD)
    8:  - [Cubieboard 4](http://cubieboard.org/model/cb4/) (ALLWINNER_A80) *NetBSD-current*
    9:  - Cubietruck (CUBIETRUCK)
   10:  - [Merrii Hummingbird A31](http://www.merrii.com/en/pla_d.asp?id=172) (HUMMINGBIRD_A31)
   11: 
   12: # Supported hardware
   13:  - SoCs
   14:    - Cortex-A7: A20 (2-core), A31 (4-core), A80
   15:    - Cortex-A7/A15: A80 (4-core A7 + 4-core A15)
   16:  - SD/MMC controller (DMA)
   17:  - DMA controller
   18:  - GPIO
   19:    - Configuration using FEX scripts is supported
   20:  - UART
   21:  - I2C
   22:  - P2WI (A31) / RSB (A80)
   23:  - PMU
   24:    - AXP209 (A20)
   25:    - AXP221 (A31)
   26:    - AXP806 (A80)
   27:    - AXP809 (A80)
   28:  - Watchdog timer
   29:  - RTC
   30:    - A20/A31: integrated RTC, PCF8563
   31:    - A80: AC100
   32:  - Audio codec (A20/A31)
   33:  - USB host
   34:    - OHCI
   35:    - EHCI
   36:    - OTG (A20)
   37:  - SATA (A10/A20)
   38:  - Gigabit Ethernet (GMAC)
   39:  - HDMI
   40:    - DDC / EDID mode detection (A20/A31)
   41:    - Audio support (A20/A31)
   42:  - Framebuffer (A20/A31/A80)
   43:  - IR receiver (A20/A31/A80)
   44: 
   45: # TODO
   46:  - A10
   47:    - Interrupt controller
   48:    - EMAC
   49:  - A31
   50:    - OTG
   51:    - IR transmitter
   52:    - 3G module
   53:    - TV input
   54:  - A80
   55:    - MP
   56:    - big.LITTLE support
   57:    - USB3 (OTG and XHCI)
   58:    - IR transmitter
   59:    - HDMI (DDC and mode setting; currently relies on U-Boot for setup)
   60:    - Audio codec
   61:  - All
   62:    - USB device mode
   63:    - SD/MMC UHS-I support (needs sdmmc(4) changes)
   64:    - SDIO (Bluetooth / WiFi)
   65:    - NAND
   66:    - VGA (Cubietruck, Hummingbird A31, Cubieboard4)
   67: 
   68: # Installation
   69: 
   70: ## A10 / A20 / A31 based boards
   71: 
   72: * Start with an ARMv7 image from *evbarm-earmv7hf/binary/gzimg/* such as *beagleboard.img*
   73: * Download a U-Boot build for your board
   74:   * 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/>
   75:   * 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/> 
   76: * Write the *u-boot-sunxi-with-spl.bin* loader to the empty space at the start of the base image:
   77: [[!template  id=programlisting text="""
   78: # dd if=u-boot-sunxi-with-spl.bin of=beagleboard.img bs=1k seek=8 conv=notrunc
   79: """]]
   80: * Write the image to an SD card.
   81: * Copy the kernel (netbsd.ub) for your board to the root of the MS-DOS partition on the SD card.
   82: * Create or edit uEnv.txt on the MS-DOS partition:
   83: [[!template  id=programlisting text="""
   84: bootargs=root=ld0a
   85: uenvcmd=mmc dev 0; mmc rescan; fatload mmc 0:1 82000000 netbsd.ub; bootm 82000000
   86: """]]
   87: 
   88: ## A80 based boards
   89: 
   90: * Cubieboard 4 SDK (lubuntu) U-Boot env:
   91: [[!template  id=programlisting text="""
   92: baudrate=115200
   93: boot_normal=fatload mmc 0:1 20007800 uimage;bootm 20007800
   94: bootcmd=run setargs_cubie boot_normal
   95: bootdelay=3
   96: console=ttyS0,115200
   97: console1=tty1
   98: init=/init
   99: loglevel=8
  100: mmc_root=/dev/mmcblk0p2
  101: setargs_cubie=setenv bootargs console=${console1} console=${console} root=${mmc_root} loglevel=${loglevel}
  102: stderr=serial
  103: stdin=serial
  104: stdout=serial
  105: """]]
  106: 
  107: # Big (endian) fun
  108: 
  109: You can run this boards with a little endian (this is the default and implied by above install instructions)
  110: or with a big endian kernel and userland. However, kernel and userland endianness needs to match.
  111: 
  112: To build a big endian release (or sets) use 
  113: [[!template  id=programlisting text="""
  114: ./build.sh -m evbearmv7hf-eb 
  115: """]]
  116: 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.
  117: 
  118: # FEX scripts
  119: 
  120: 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>.
  121: 
  122: 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:
  123: 
  124: [[!template  id=programlisting text="""
  125: bootargs=root=ld0a sysconfig=0x43000000
  126: uenvcmd=mmc dev 0; mmc rescan; fatload mmc 0:1 43000000 cubieboard2.bin; fatload mmc 0:1 82000000 netbsd.ub; bootm 82000000
  127: """]]
  128: 
  129: Some pre-compiled .bin files can be found here: <http://ftp.netbsd.org/pub/NetBSD/misc/jmcneill/allwinner/fex/>
  130: 
  131: # Framebuffer console
  132: 
  133: To use HDMI for the console device, add *console=fb* to bootargs in uEnv.txt.
  134: 
  135: 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
  136: 
  137: # HDMI audio
  138: 
  139: The default audio device is the analog audio codec. To change the default device, use the *audiocfg* command:
  140: 
  141: [[!template  id=programlisting text="""
  142: a31# audiocfg list
  143: 0: [*] audio0 @ awinac0: Allwinner CODEC A31, 2 playback channels
  144: 1: [ ] audio1 @ awinhdmiaudio0: Allwinner HDMI 1.4, 2 playback channels
  145: a31# audiocfg default 1
  146: setting default audio device to audio1
  147: a31# audiocfg list
  148: 0: [ ] audio0 @ awinac0: Allwinner CODEC A31, 2 playback channels
  149: 1: [*] audio1 @ awinhdmiaudio0: Allwinner HDMI 1.4, 2 playback channels
  150: """]]
  151: 
  152: # MAC address
  153: 
  154: On boards where the ethernet MAC address cannot be determmined, a random MAC address will be generated every boot. You can override this behaviour by specifying a MAC address in *uEnv.txt*:
  155: [[!template  id=programlisting text="""
  156: bootargs=root=ld0a awge0.mac-address=02:a0:3d:88:1a:1e
  157: """]]

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