Annotation of wikisrc/ports/evbarm/odroid-c1.mdwn, revision 1.35
1.22 wiki 1: [[!meta title="NetBSD/evbarm on Hardkernel ODROID-C1 and ODROID-C1+"]]
1.1 wiki 2:
1.30 snj 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.
1.13 wiki 4:
1.1 wiki 5: [[!toc levels=2]]
6:
1.2 wiki 7: # Supported hardware
1.6 wiki 8: - CPU: Cortex-A5: Amlogic S805 (4-core) at 1.5GHz
1.2 wiki 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
1.23 wiki 14: - Watchdog timer
1.16 wiki 15: - "SDHC" and "SDIO" SD/MMC controllers (DMA)
1.2 wiki 16: - Serial console
1.7 wiki 17: - Framebuffer console
1.2 wiki 18: - USB host (OTG)
19: - Gigabit Ethernet (GMAC)
20: - RTL8211F PHY
21: - Hardware random number generator
1.11 wiki 22: - RTC
1.15 wiki 23: - GPIO
1.2 wiki 24:
25: # TODO
26: - USB device mode
27: - IR receiver
28: - I2C
1.7 wiki 29: - Audio
1.2 wiki 30:
1.29 wiki 31: # Installation (NetBSD 8.0 and later)
1.28 jmcneill 32:
1.31 wiki 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]].
1.34 wiki 34: * Build U-Boot for ODROID-C1 <https://github.com/jaredmcneill/u-boot-odroid>
1.32 wiki 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>
1.28 jmcneill 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
1.32 wiki 42: # dd if=u-boot.bin.odroidc1 of=armv7.img bs=512 seek=64 conv=notrunc
1.28 jmcneill 43: """]]
44: * Write the image to an SD card.
1.35 ! wiki 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
1.28 jmcneill 50:
51: # Installation (NetBSD 7.0/7.1)
1.2 wiki 52:
1.20 wiki 53: * Start with an ARMv7 image from *evbarm-earmv7hf/binary/gzimg/* such as *armv7.img*
1.2 wiki 54: * Build U-Boot for ODROID-C1 <https://github.com/hardkernel/u-boot/tree/odroidc-v2011.03>
1.3 wiki 55: * Pre-built binaries here: <http://ftp.netbsd.org/pub/NetBSD/misc/jmcneill/odroidc1/u-boot-odroidc-v2011.03-20150308.tar.gz>
1.27 sevan 56: * Note the location and size of the FFS partition in the *armv7.img* disklabel:
1.4 wiki 57: [[!template id=programlisting text="""
1.20 wiki 58: # $TOOLDIR/bin/nbdisklabel -M evbarm -B le armv7.img
1.4 wiki 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: """]]
1.2 wiki 68: * Write the bootloader to the empty space at the start of the base image:
69: [[!template id=programlisting text="""
1.20 wiki 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
1.2 wiki 73: """]]
1.4 wiki 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="""
1.20 wiki 76: # $TOOLDIR/bin/armv7--netbsdelf-eabihf-fdisk -u armv7.img
1.4 wiki 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: """]]
1.2 wiki 89: * Write the image to an SD card.
1.21 wiki 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:
1.2 wiki 91: [[!template id=programlisting text="""
92: ODROIDC-UBOOT-CONFIG
93:
1.21 wiki 94: setenv bootargs "root=ld0f awge0.mac-address=${ethaddr} console=fb"
1.2 wiki 95: setenv bootcmd "fatload mmc 0:1 0x21000000 netbsd.ub; bootm 0x21000000"
96: run bootcmd
1.21 wiki 97: """]]
98:
1.5 wiki 99: * On first boot, it will stop because of the wrong device in /etc/fstab. Take this opportunity to grow the root file-system:
1.4 wiki 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: """]]
1.2 wiki 131:
1.9 wiki 132: # HDMI
133:
1.10 wiki 134: ## Framebuffer console
135:
136: Simply add **console=fb** to the *bootargs* variable in *boot.ini*.
137:
1.9 wiki 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:
1.14 wiki 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:
1.9 wiki 156: ## Overscan compensation
1.8 wiki 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:
1.15 wiki 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:
1.24 wiki 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:
1.25 wiki 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:
1.12 wiki 237: # Documentation
238:
239: Amlogic S805 datasheet: <http://dn.odroid.com/S805/Datasheet/S805_Datasheet%20V0.8%2020150126.pdf>
240:
1.1 wiki 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: """]]
1.26 leot 255:
CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb
![[BACK]](/icons/back.gif){kind=icon}
Return to odroid-c1.mdwn CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [NetBSD Developer Wiki] / wikisrc / ports / evbarm