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 (7 months 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: 

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