Annotation of wikisrc/ports/evbarm/allwinner.mdwn, revision 1.36

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

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