wikisrc/ports/evbarm/odroid-c1.mdwn - view

File: [NetBSD Developer Wiki] / wikisrc / ports / evbarm / odroid-c1.mdwn
Revision 1.35: download - view: text, annotated - select for diffs
Mon Feb 22 01:47:18 2021 UTC (16 months, 1 week ago) by wiki
Branches: MAIN
CVS tags: HEAD

web commit by christos

1: [[!meta title="NetBSD/evbarm on Hardkernel ODROID-C1 and ODROID-C1+"]] 2: 3: [ODROID-C1](https://www.hardkernel.com/shop/odroid-c1-2/) was a $35 quad-core SBC from Hardkernel. ODROID-C1 support was introduced in NetBSD 7.0. It has been succeeded by the [ODROID-C1+](https://www.hardkernel.com/shop/odroid-c1/), which is supported by the same NetBSD kernel. 4: 5: [[!toc levels=2]] 6: 7: # Supported hardware 8: - CPU: Cortex-A5: Amlogic S805 (4-core) at 1.5GHz 9: - CPU frequency scaling is supported with machdep.cpu sysctl tree 10: - SMP supported 11: - PL310 L2 cache controller 12: - GIC 13: - A5 global timer 14: - Watchdog timer 15: - "SDHC" and "SDIO" SD/MMC controllers (DMA) 16: - Serial console 17: - Framebuffer console 18: - USB host (OTG) 19: - Gigabit Ethernet (GMAC) 20: - RTL8211F PHY 21: - Hardware random number generator 22: - RTC 23: - GPIO 24: 25: # TODO 26: - USB device mode 27: - IR receiver 28: - I2C 29: - Audio 30: 31: # Installation (NetBSD 8.0 and later) 32: 33: * Start with an ARMv7 image from *evbarm-earmv7hf/binary/gzimg/* such as *armv7.img*, the latest is [[here|https://nycdn.netbsd.org/pub/NetBSD-daily/HEAD/latest/evbarm-earmv7hf/binary/gzimg/armv7.img]]. 34: * Build U-Boot for ODROID-C1 <https://github.com/jaredmcneill/u-boot-odroid> 35: * Pre-built binaries here: 36: <http://ftp.netbsd.org/pub/NetBSD/misc/jmcneill/odroidc1/u-boot-odroidc-v2011.03-20150308.tar.gz> 37: <http://www.netbsd.org/~jmcneill/u-boot.bin.odroidc1> 38: * Write the bootloader to the empty space at the start of the base image: 39: [[!template id=programlisting text=""" 40: # dd if=bl1.bin.hardkernel of=armv7.img bs=1 count=442 conv=notrunc 41: # dd if=bl1.bin.hardkernel of=armv7.img bs=512 skip=1 seek=1 conv=notrunc 42: # dd if=u-boot.bin.odroidc1 of=armv7.img bs=512 seek=64 conv=notrunc 43: """]] 44: * Write the image to an SD card. 45: 46: - Tested 2021-02-19 with NetBSD-current, christos 47: - serial fights with ucb keyboard. (avoid by short circuiting cngetc in meson_uart.c to return -1) 48: - awge0 does not work reliably (can't even get a dhcp address, stops receiving packets after less than a minute) 49: - machine crashes under load 50: 51: # Installation (NetBSD 7.0/7.1) 52: 53: * Start with an ARMv7 image from *evbarm-earmv7hf/binary/gzimg/* such as *armv7.img* 54: * Build U-Boot for ODROID-C1 <https://github.com/hardkernel/u-boot/tree/odroidc-v2011.03> 55: * Pre-built binaries here: <http://ftp.netbsd.org/pub/NetBSD/misc/jmcneill/odroidc1/u-boot-odroidc-v2011.03-20150308.tar.gz> 56: * Note the location and size of the FFS partition in the *armv7.img* disklabel: 57: [[!template id=programlisting text=""" 58: # $TOOLDIR/bin/nbdisklabel -M evbarm -B le armv7.img 59: ... 60: 8 partitions: 61: # size offset fstype [fsize bsize cpg/sgs] 62: a: 1359312 385024 4.2BSD 0 0 0 # (Cyl. 188 - 851*) 63: b: 262144 122880 swap # (Cyl. 60 - 187) 64: c: 1744336 0 unused 0 0 # (Cyl. 0 - 851*) 65: d: 1744336 0 unused 0 0 # (Cyl. 0 - 851*) 66: e: 114688 8192 MSDOS # (Cyl. 4 - 59) 67: """]] 68: * Write the bootloader to the empty space at the start of the base image: 69: [[!template id=programlisting text=""" 70: # dd if=bl1.bin.hardkernel of=armv7.img bs=1 count=442 conv=notrunc 71: # dd if=bl1.bin.hardkernel of=armv7.img bs=512 skip=1 seek=1 conv=notrunc 72: # dd if=u-boot.bin of=armv7.img bs=512 seek=64 conv=notrunc 73: """]] 74: * Since the bootloader has overwritten the disklabel, we need to re-add partition "a" from the disklabel to the MBR partition table: 75: [[!template id=programlisting text=""" 76: # $TOOLDIR/bin/armv7--netbsdelf-eabihf-fdisk -u armv7.img 77: ... 78: Which partition do you want to change?: [none] 1 79: The data for partition 1 is: 80: <UNUSED> 81: sysid: [0..255 default: 169] 82: start: [0..109cyl default: 63, 0cyl, 0MB] 385024 83: size: [0..85cyl default: 1359312, 85cyl, 664MB] 1359312 84: ... 85: Which partition do you want to change?: [none] 86: ... 87: Should we write new partition table? [n] y 88: """]] 89: * Write the image to an SD card. 90: * Edit *boot.ini* on the MS-DOS partition. Note that the default boot.ini has `console=fb` in `bootargs`, which you should remove if you want serial console: 91: [[!template id=programlisting text=""" 92: ODROIDC-UBOOT-CONFIG 93: 94: setenv bootargs "root=ld0f awge0.mac-address=${ethaddr} console=fb" 95: setenv bootcmd "fatload mmc 0:1 0x21000000 netbsd.ub; bootm 0x21000000" 96: run bootcmd 97: """]] 98: 99: * On first boot, it will stop because of the wrong device in /etc/fstab. Take this opportunity to grow the root file-system: 100: [[!template id=programlisting text=""" 101: # fdisk -u ld0 102: ... 103: Which partition do you want to change?: [none] 1 104: The data for partition 1 is: 105: NetBSD (sysid 169) 106: start 385024, size 1359312 (664 MB, Cyls 23/246/32-108/147/55) 107: PBR is not bootable: All bytes are identical (0x00) 108: sysid: [0..255 default: 169] 109: start: [0..966cyl default: 385024, 24cyl, 188MB] 110: size: [0..942cyl default: 1359312, 85cyl, 664MB] $ 111: ... 112: Which partition do you want to change?: [none] 113: ... 114: Should we write new partition table? [n] y 115: # resize_ffs -y /dev/rld0f 116: # reboot 117: """]] 118: * Next boot, create a new /etc/fstab: 119: [[!template id=programlisting text=""" 120: # mount -u -o rw /dev/ld0f / 121: # cat > /etc/fstab << EOF 122: /dev/ld0f / ffs rw 1 1 123: /dev/ld0e /boot msdos rw 1 1 124: kernfs /kern kernfs rw 125: ptyfs /dev/pts ptyfs rw 126: procfs /proc procfs rw 127: tmpfs /var/shm tmpfs rw,-m1777,-sram%25 128: EOF 129: # reboot 130: """]] 131: 132: # HDMI 133: 134: ## Framebuffer console 135: 136: Simply add **console=fb** to the *bootargs* variable in *boot.ini*. 137: 138: ## Video mode 139: 140: HDMI video mode can be selected in U-Boot with the *video* command, e.g.: 141: 142: [[!template id=programlisting text=""" 143: odroidc#video dev open 1080P 144: """]] 145: 146: To make this change permanent, add it to the *bootcmd* variable in *boot.ini*: 147: 148: [[!template id=programlisting text=""" 149: setenv bootcmd "video dev open 1080P; fatload mmc 0:1 0x21000000 netbsd.ub; bootm 0x21000000" 150: """]] 151: 152: ## 16 or 24 bpp? 153: 154: ODROID-C1 defaults to 16bpp. If you want to try 24bpp, add **fb.depth=24** to the kernel cmdline options in *boot.ini*. There are some issues with 24bpp mode and Xorg; see <http://gnats.netbsd.org/49812>. 155: 156: ## Overscan compensation 157: 158: If you have ODROID-C1 plugged into a TV, the edges of the screen may not be visible. You can scale down the framebuffer console with the **hw.genfb0.scale** sysctl, e.g.: 159: 160: [[!template id=programlisting text=""" 161: # sysctl -w hw.genfb0.scale=95 162: """]] 163: 164: Setting *scale* to 100 disables scaling, any other value enables the scaler. Values between 10 and 100 are allowed. 165: 166: To set this value at boot, you can add **fb.scale=95** to the kernel cmdline options in *boot.ini*. 167: 168: # SYS_LED 169: 170: The blue SYS_LED on the board is wired to GPIOAO_13. To control the LED from userland, set **gpio=YES** in rc.conf and add this to */etc/gpio.conf*: 171: 172: [[!template id=programlisting text=""" 173: gpio4 13 set out sys_led 174: """]] 175: 176: After rebooting, the LED state can be controlled with [[!template id=man name="gpioctl" section="8"]]. 177: 178: [[!template id=programlisting text=""" 179: # turn the light on 180: gpioctl gpio4 sys_led on 181: 182: # turn the light off 183: gpioctl gpio4 sys_led off 184: 185: # toggle the light state 186: gpioctl gpio4 sys_led toggle 187: """]] 188: 189: # U-Boot Environment 190: 191: To read/write U-Boot environment variables from NetBSD, download and compile the following program: <http://ftp.netbsd.org/pub/NetBSD/misc/jmcneill/odroidc1/uenv.c> 192: 193: # Automatically booting a backup kernel 194: 195: *These instructions assume the kernels live on eMMC. Adjust devices accordingly for SD card setup.* 196: 197: To setup an ODROID-C1 to fall back to a recovery kernel in the event of a boot failure, install the recovery kernel as /boot/onetbsd.ub. 198: 199: Create /boot/boot.ini as follows: 200: [[!template id=programlisting text=""" 201: ODROIDC-UBOOT-CONFIG 202: setenv bootargs "root=ld0f awge0.mac-address=${ethaddr}" 203: fatload mmc 0:1 0x22000000 boot.scr 204: source 0x22000000 205: """]] 206: 207: Create /boot/boot.txt: 208: [[!template id=programlisting text=""" 209: # regenerate with: 210: # mkubootimage -A arm -C none -O netbsd -T script -a 0 -n "NetBSD/odroidc1 boot" boot.txt boot.scr 211: 212: setenv rescue_kernel "onetbsd.ub" 213: setenv kernel "netbsd.ub" 214: 215: if test ${boot_rescue} = false; then 216: setenv boot_rescue true 217: saveenv 218: fatload mmc 0:1 0x21000000 ${kernel} 219: mw.l c1109900 0f08ffff # arm watchdog 220: bootm 0x21000000 221: else 222: fatload mmc 0:1 0x21000000 ${rescue_kernel} 223: bootm 0x21000000 224: fi 225: """]] 226: 227: Generate boot.scr from boot.txt: 228: [[!template id=programlisting text=""" 229: mkubootimage -A arm -C none -O netbsd -T script -a 0 -n "NetBSD/odroidc1 boot" /boot/boot.txt /boot/boot.scr 230: """]] 231: 232: Install the **uenv** tool from above and add the following to root's crontab: 233: [[!template id=programlisting text=""" 234: @reboot /usr/local/sbin/uenv ld0 boot_rescue false 235: """]] 236: 237: # Documentation 238: 239: Amlogic S805 datasheet: <http://dn.odroid.com/S805/Datasheet/S805_Datasheet%20V0.8%2020150126.pdf> 240: 241: # ODROID-C1 UART pins 242: 243: From [ODROID Forum](http://forum.odroid.com/viewtopic.php?f=115&t=7684): 244: 245: [[!template id=programlisting text=""" 246: ___UART____ 247: |Pin 4 - GND| 248: |Pin 3 - RXD| 249: |Pin 2 - TXD| 250: |Pin 1 - VCC| 251: \___________| 252: 253: 3.3V LVTTL 254: """]] 255: