Annotation of wikisrc/ports/evbarm/allwinner.mdwn, revision 1.45
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.38 wiki 8: - [Cubieboard 4](http://cubieboard.org/model/cb4/) (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
1.37 wiki 30: - A20/A31: integrated RTC, PCF8563
31: - A80: AC100
32: - Audio codec (A20/A31)
1.14 wiki 33: - USB host
1.1 wiki 34: - OHCI
35: - EHCI
1.37 wiki 36: - OTG (A20)
1.1 wiki 37: - SATA (A10/A20)
38: - Gigabit Ethernet (GMAC)
1.45 ! wiki 39: - HDMI
! 40: - DDC / EDID mode detection (A20/A31)
! 41: - Audio support (A20/A31)
! 42: - Framebuffer (A20/A31/A80)
1.39 wiki 43: - IR receiver (A20/A31/A80)
1.2 wiki 44:
1.14 wiki 45: # TODO
1.40 wiki 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
1.45 ! wiki 59: - HDMI (DDC and mode setting; currently relies on U-Boot for setup)
1.40 wiki 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
1.44 wiki 66: - VGA (Cubietruck, Hummingbird A31, Cubieboard4)
1.14 wiki 67:
1.2 wiki 68: # Installation
69:
1.34 wiki 70: ## A10 / A20 / A31 based boards
1.2 wiki 71:
1.33 snj 72: * Start with an ARMv7 image from *evbarm-earmv7hf/binary/gzimg/* such as *beagleboard.img*
1.34 wiki 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/>
1.43 mrg 76: * Write the *u-boot-sunxi-with-spl.bin* loader to the empty space at the start of the base image:
1.2 wiki 77: [[!template id=programlisting text="""
1.33 snj 78: # dd if=u-boot-sunxi-with-spl.bin of=beagleboard.img bs=1k seek=8 conv=notrunc
1.2 wiki 79: """]]
80: * Write the image to an SD card.
1.43 mrg 81: * Copy the kernel (netbsd.ub) for your board to the root of the MS-DOS partition on the SD card.
1.12 wiz 82: * Create or edit uEnv.txt on the MS-DOS partition:
1.2 wiki 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:
1.35 wiki 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:
1.7 wiki 107: # Big (endian) fun
1.5 wiki 108:
109: You can run this boards with a little endian (this is the default and implied by above install instructions)
1.12 wiz 110: or with a big endian kernel and userland. However, kernel and userland endianness needs to match.
1.5 wiki 111:
112: To build a big endian release (or sets) use
113: [[!template id=programlisting text="""
114: ./build.sh -m evbearmv7hf-eb
115: """]]
1.12 wiz 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.
1.17 wiki 117:
1.21 wiki 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:
1.22 wiki 129: Some pre-compiled .bin files can be found here: <http://ftp.netbsd.org/pub/NetBSD/misc/jmcneill/allwinner/fex/>
130:
1.25 wiki 131: # Framebuffer console
132:
133: To use HDMI for the console device, add *console=fb* to bootargs in uEnv.txt.
134:
1.29 wiki 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:
1.27 wiki 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:
1.42 wiki 152: # MAC address
1.17 wiki 153:
1.42 wiki 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*:
1.17 wiki 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