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

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.1       wiki        7:  - Cubieboard, Cubieboard 2 (CUBIEBOARD)
                      8:  - Cubietruck (CUBIETRUCK)
1.10      wiki        9:  - [Merrii Hummingbird A31](http://www.merrii.com/en/pla_d.asp?id=172) (HUMMINGBIRD_A31)
1.1       wiki       10: 
                     11: # Supported hardware
                     12:  - SoCs
                     13:    - Cortex-A8: A10
1.23      wiki       14:    - Cortex-A7: A20 (2-core), A31 (4-core)
1.14      wiki       15:  - SD/MMC controller (DMA)
1.1       wiki       16:  - DMA controller
                     17:  - GPIO
1.20      wiki       18:    - Configuration using FEX scripts is supported
1.1       wiki       19:  - UART
                     20:  - I2C
                     21:  - P2WI (A31)
                     22:  - PMU
                     23:    - AXP209 (A20)
                     24:    - AXP221 (A31)
                     25:  - Watchdog timer
                     26:  - RTC
                     27:  - Audio codec
1.14      wiki       28:  - USB host
1.1       wiki       29:    - OHCI
                     30:    - EHCI
1.14      wiki       31:    - OTG (not yet working on A31)
1.1       wiki       32:  - SATA (A10/A20)
                     33:  - Gigabit Ethernet (GMAC)
1.24      wiki       34:  - HDMI (A20/A31)
1.26    ! wiki       35:    - DDC / EDID mode detection
        !            36:    - Audio support
1.24      wiki       37:  - Framebuffer
1.2       wiki       38: 
1.14      wiki       39: # TODO
                     40:  - OTG (A31)
                     41:  - USB device mode
                     42:  - Bluetooth / WiFi (Cubietruck, Hummingbird A31)
                     43:  - 3G (Hummingbird A31)
                     44:  - SD/MMC UHS-I support (needs sdmmc(4) changes)
1.15      wiki       45:  - TV input (Hummingbird A31)
1.16      wiki       46:  - NAND
1.19      wiki       47:  - Fast Ethernet (EMAC)
1.14      wiki       48: 
1.2       wiki       49: # Installation
                     50: 
                     51: ## A10 / A20 based boards
                     52: 
1.3       wiki       53: * Start with an ARMv7 image from *evbarm-earmv7hf/binary/gzimg/* such as *beaglebone.img*
1.2       wiki       54: * Download a U-Boot build for your board from the linux-sunxi web site <http://dl.linux-sunxi.org/nightly/u-boot-sunxi/u-boot-sunxi/u-boot-sunxi-latest/>
                     55: * Write the *u-boot-sunxi-with-spl.bin* loader to the base image:
                     56: [[!template  id=programlisting text="""
                     57: # dd if=u-boot-sunxi-with-spl.bin of=beaglebone.img bs=1k seek=8 conv=notrunc
                     58: """]]
                     59: * Write the image to an SD card.
1.12      wiz        60: * Copy the kernel (netbsd.ub) for your board to the root of the MS-DOS partition.
                     61: * Create or edit uEnv.txt on the MS-DOS partition:
1.2       wiki       62: [[!template  id=programlisting text="""
                     63: bootargs=root=ld0a
                     64: uenvcmd=mmc dev 0; mmc rescan; fatload mmc 0:1 82000000 netbsd.ub; bootm 82000000
                     65: """]]
                     66: 
                     67: ## A31 based boards
                     68: 
                     69: TBD.
1.5       wiki       70: 
1.7       wiki       71: # Big (endian) fun
1.5       wiki       72: 
                     73: You can run this boards with a little endian (this is the default and implied by above install instructions)
1.12      wiz        74: or with a big endian kernel and userland. However, kernel and userland endianness needs to match.
1.5       wiki       75: 
                     76: To build a big endian release (or sets) use 
                     77: [[!template  id=programlisting text="""
                     78: ./build.sh -m evbearmv7hf-eb 
                     79: """]]
1.12      wiz        80: 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       81: 
1.21      wiki       82: # FEX scripts
                     83: 
                     84: 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>.
                     85: 
                     86: 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:
                     87: 
                     88: [[!template  id=programlisting text="""
                     89: bootargs=root=ld0a sysconfig=0x43000000
                     90: uenvcmd=mmc dev 0; mmc rescan; fatload mmc 0:1 43000000 cubieboard2.bin; fatload mmc 0:1 82000000 netbsd.ub; bootm 82000000
                     91: """]]
                     92: 
1.22      wiki       93: Some pre-compiled .bin files can be found here: <http://ftp.netbsd.org/pub/NetBSD/misc/jmcneill/allwinner/fex/>
                     94: 
1.25      wiki       95: # Framebuffer console
                     96: 
                     97: To use HDMI for the console device, add *console=fb* to bootargs in uEnv.txt.
                     98: 
1.17      wiki       99: # Board specific notes
                    100: 
                    101: ## Merrii Hummingbird A31
                    102: 
                    103: 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.
                    104: 
                    105: To overcome this, you can specify your own MAC address in *uEnv.txt*:
                    106: [[!template  id=programlisting text="""
                    107: bootargs=root=ld0a awge0.mac-address=02:a0:3d:88:1a:1e
                    108: """]]

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