Annotation of wikisrc/ports/evbarm.mdwn, revision 1.86

1.1       mspo        1: [[!template id=port
                      2: port="evbarm"
1.6       mspo        3: port_alt="arm"
1.49      leot        4: port_var1="earm"
                      5: port_var2="earmeb"
                      6: port_var3="earmv6hf"
                      7: port_var4="earmv7hf"
                      8: port_var5="earmv7hfeb"
1.83      mrg         9: port_var6="aarch64"
1.49      leot       10: port_var_install_notes="evbarm-earm"
1.85      martin     11: cur_rel="9.0"
                     12: future_rel="10.0"
                     13: changes_cur="9.0"
                     14: changes_future="10.0"
1.71      leot       15: thumbnail="//www.netbsd.org/images/ports/evbarm/adi_brh.gif"
1.1       mspo       16: about="""
                     17: NetBSD/evbarm is the port of NetBSD to various evaluation and prototyping
                     18: boards based on CPUs implementing the ARM architecture. NetBSD/evbarm also
                     19: supports some specific embedded system products based on prototype board
                     20: designs.
                     21: 
1.42      gdt        22: ### CPU types
                     23: 
1.57      gdt        24: The evbarm port can be built with a variety of CPU options, corresponding to the
                     25: [large array of ARM CPU architectures](https://en.wikipedia.org/wiki/ARM_architecture#Cores).
                     26: There are
1.56      gdt        27: four main variables: the word size, the instruction set, the
                     28: endianness, and whether there is hardware floating point.  By default
1.68      gdt        29: the CPU type is "earm", and this implies aarch32 (32-bit), earmv5 cpu
1.56      gdt        30: architecture, little endian (el when explicitly stated), and soft
1.58      gdt        31: (Emulated) floating point.  Another example, suitable for Raspberry PI
1.56      gdt        32: 2, is earmv7hf, which is aarch32, the v7 instruction set, little
                     33: endian, and hardware floating point.
1.42      gdt        34: 
                     35: Typically, various boards are best compiled with a CPU type that
                     36: matches the board's CPU and floating point support, but generally a
                     37: lower CPU instruction set version is workable on a newer board.  See
                     38: build.sh and look for aliases for the evbarm port.
                     39: 
1.56      gdt        40: Through NetBSD 8, the evbarm port has supported exclusively the
                     41: aarch32 (32-bit CPU) sub-family of the ARM architecture.  Some
                     42: processors, such as many supporting the armv8 CPU architecture, also
                     43: support a 64-bit instruction set, referred to as aarch64.  This is
                     44: sometimes referred to as a distinct port, [[NetBSD/aarch64|aarch64]],
                     45: with code in src/sys/arch/aarch64, but it is built as the evbarm port
                     46: with aarch64 cpu type, and available as the alias evbarm64.
1.50      gdt        47: 
1.58      gdt        48: Note that MACHINE_ARCH=aarch64 currently refers to the A64 instruction
                     49: set and the aarch64 architecture, built for the armv8 architecture.
                     50: (Note also that armv8 is the first architecture to support aarch64, so
                     51: this will not be an issue until at least armv9.)
                     52: 
1.82      wiki       53: ### QEMU
                     54: 
                     55: See the [[NetBSD/evbarm under QEMU|qemu_arm]] page for instructions on how to get started with QEMU.
                     56: 
                     57: ### anita
1.51      gdt        58: 
1.52      gdt        59: anita can be used to test builds.  (In addition to anita, install qemu and dtb-arm-vexpress from pkgsrc.)   The release subdirectory should follow the naming convention on the autobuild cluster, used below.
1.54      gdt        60: 
1.55      gson       61:  - evbarm-earmv7hf uses "qemu-system-arm -M vexpress-a15"
                     62:  - evbarm-aarch64 uses "qemu-system-aarch64 -M virt"
1.53      gdt        63:  - Information on how to test emulated versions of other specific hardware is welcome.
1.51      gdt        64: 
1.84      wiki       65: ### armbsd.org builds
1.78      gdt        66: 
1.84      wiki       67: NetBSD developer Jared McNeill provides [builds of NetBSD 9 and -current for a vast variety of hardware.](https://www.armbsd.org/)   In addition to the standard build, these images have board-specific U-Boot contents.  See also /usr/pkgsrc/sysutils/u-boot*.
1.78      gdt        68: 
1.80      gdt        69: ### Board specific information (often including installation information)
1.38      wiki       70:  - [[Allwinner sunxi family SoCs|Allwinner]]
1.69      sevan      71:  - [[BeagleBone, BeagleBone Black, and PocketBeagle|BeagleBone]]
1.41      wiki       72:  - [[NVIDIA Tegra|Tegra]]
1.27      wiki       73:  - [[ODROID C1 and C1+|ODROID-C1]]
1.40      gdt        74:  - [[Raspberry Pi 1, 2 and 3|Raspberry Pi]]
1.83      mrg        75:  - [[RockChip SoCs|RockChip]]
1.27      wiki       76: 
1.77      gdt        77: ### SSH configuration for installtion
                     78: 
                     79: The default configuration will connect to the local network via DHCP and
                     80: run an SSH server. In order to use the SSH server, we must configure
                     81: users. This can be done by writing to the SD card's MS-DOS partition.
                     82: 
                     83: Create a creds.txt file and use:
                     84: 
                     85:            useradd user password
                     86: 
                     87: <!--TODO: Additional configuration options are available on creds_msdos.8-->
                     88: 
1.79      gdt        89: """
1.1       mspo       90: supported_hardware="""
1.11      wiki       91: 
1.75      maya       92: **NOTE**: This list is incomplete. For a full list of boards, please see the [GENERIC DTS files](http://cvsweb.netbsd.org/bsdweb.cgi/~checkout~/src/sys/arch/evbarm/conf/GENERIC).
1.18      wiki       93: 
1.11      wiki       94: [[!toc startlevel=3]]
                     95: 
1.36      sevan      96: ### ADI Engineering **BRH** ("Big Red Head")
1.12      wiki       97: 
                     98: The BRH is an evaluation and development platform for the Intel **i80200**
                     99: XScale processor. The BRH is based on ADI's **BECC** ("Big Endian Companion
                    100: Chip"). The BRH is capable of both big- and little-endian operation, although
1.21      snj       101: NetBSD currently only supports little-endian operation.
1.12      wiki      102: 
                    103: Support for the BRH was written by Jason Thorpe, and contributed by Wasabi
                    104: Systems, Inc.
                    105: 
                    106:  * On-board NS16550-compatible serial ports (_com_)
                    107:  * On-board Intel i82559 Ethernet on the PCI bus (_fxp_)
                    108:  * On-chip timer on the BECC (used as system clock)
                    109:  * Other devices inserted into the PCI slot
1.5       wiki      110: 
1.12      wiki      111: The BRH comes with 128M of SDRAM. Systems with BECC revision 7 or less are
                    112: limited to 64M due to the layout of the PCI DMA windows. Users of these
                    113: systems should obtain an FPGA upgrade from ADI to revision 8 or later of the
                    114: BECC.
1.5       wiki      115: 
1.39      wiki      116: ### Allwinner Technology
1.15      wiki      117: Various boards based on [[Allwinner]] SoCs are supported, including the BananaPi, Cubieboard 2, Cubietruck, Cubieboard 4, and Merrii Hummingbird A31.
1.10      wiki      118: 
1.12      wiki      119: ### Arcom **Viper**
1.1       mspo      120: 
1.12      wiki      121: The Arcom Viper is a single board computer based on the PXA255 XScale
                    122: processor.
1.1       mspo      123: 
1.12      wiki      124: Support for the Arcom Viper was written by Antti Kantee.
1.1       mspo      125: 
1.12      wiki      126:  * On-chip timers (_saost_ used as system clock)
                    127:  * On-chip serial ports (_com_)
1.36      sevan     128:  * On-board SMC91C111 ethernet (_sm_)
1.1       mspo      129: 
1.3       wiki      130: ### ARM, Ltd. **Integrator**
1.1       mspo      131: 
                    132: The Integrator/AP is an ATX form-factor board that is used for development of
                    133: ARM processor-based designs. It supports up to four processors on plug-in core
                    134: modules, and provides clocks, a bus interface, and interrupt support. The
                    135: Integrator/AP also supports logic modules which provide additional
                    136: peripherals, and can accommodate up to three PCI expansion cards. The
                    137: Integrator/AP can also be inserted into a CompactPCI backplane.
                    138: 
                    139: Support for the Integrator was written by Richard Earnshaw, and contributed by
                    140: ARM, Ltd.
                    141: 
1.2       mspo      142:  * PrimeCell PL010 UARTs in the System Controller FPGA (_plcom_)
                    143:  * PrimeCell PL030 Real-time Clock in the System Controller FPGA (_plrtc_)
1.23      ryoon     144:  * PrimeCell PL181 MultiMedia Card Interface
1.2       mspo      145:  * Other devices inserted into the PCI expansion slots
1.1       mspo      146: 
1.12      wiki      147: ### Atmark Techno **Armadillo-9**
                    148: 
                    149: The Armadillo-9 is a single board computer based on the EP9315 processor.
                    150: 
                    151: Support for the Armadillo-9 was written by Katsuomi Hamajima.
                    152: 
                    153:  * On-CPU RS232 UARTs (2) (_epcom_)
                    154:  * On-CPU 10/100 Ethernet MAC (_epe_)
                    155:  * system clock from on-CPU timers (_epclk_)
                    156:  * CompactFlash socket (_eppcic_)
                    157:  * USB 1.1 ports (_ohci_)
                    158: 
1.19      wiki      159: ### BeagleBoard.org **BeagleBoard** and **BeagleBoard-xM**
                    160: The [[BeagleBoard]] is a low-power open-source hardware single-board computer from BeagleBoard.org.
                    161: 
                    162: ### BeagleBoard.org **BeagleBone** and **BeagleBone Black**
                    163: The [[BeagleBone]] is a low-cost credit-card-sized computer from BeagleBoard.org.
1.12      wiki      164: 
                    165: ### Gumstix, Inc. **gumstix**
                    166: 
                    167: The [gumstix](http://www.gumstix.com/) is a small form-factor motherboard
                    168: based on the PXA255 and PXA270 XScale processor. Supports only PXA255 now.
                    169: 
                    170: Support for the gumstix was written by KIYOHARA Takashi.
                    171: 
                    172:  * basix
                    173:  * cfstix
                    174:  * etherstix
                    175:  * netCF
                    176:  * netDUO
                    177:  * netDUO-mmc
1.36      sevan     178:  * netMMC
1.12      wiki      179: 
                    180: When booting, it is necessary to set these with u-boot dynamically.
                    181: 
                    182: <pre> > go 0xa0200000 busheader=basix</pre>
                    183: 
                    184:  * audiostix
                    185:  * console-st (waysmall - STUART)
                    186:  * console-hw (waysmall)
                    187:  * GPSstix (GPS not test)
                    188:  * tweener
                    189: 
1.26      wiki      190: ### Hardkernel ODROID-C1 and ODROID-C1+
1.16      wiki      191: 
                    192: The [[ODROID-C1]] is a quad core Cortex-A5 small form-factor board from Hardkernel co., Ltd.
                    193: 
1.36      sevan     194: ### Intel **DBPXA250** ("Lubbock")
1.12      wiki      195: 
                    196: DBPXA250 (a.k.a. Lubbock) is an evaluation and development platform for the
                    197: Intel **PXA250** XScale Core application processor. More information about the **DBPXA250** can be found at [Intel website](http://www.intel.com/design/pca/applicationsprocessors/swsup/index.htm).
                    198: 
                    199: Support for the **DBPXA250** was written by Hiroyuki Bessho, and contributed
                    200: by Genetec Corp.
                    201: 
                    202:  * On-chip timers (_saost_ used as system clock)
                    203:  * On-chip 2 serial port (_com_)
                    204:  * On-board SMC91C96 ethernet (_sm_)
                    205:  * On-board SA-1111 StrongArm companion chip (_sacc_)
                    206:  * PS/2 keyboard (_pckbd_)
                    207:  * 640x480 LCD (_lcd_)
                    208:  * PCMCIA and CF card slots
                    209: 
1.3       wiki      210: ### Intel **IQ31244**
1.1       mspo      211: 
                    212: The IQ31244 is a development platform for the Intel **IOP321** I/O Processor
                    213: chipset and the Intel **i31244** SATA controller.
                    214: 
                    215: Initial support for the IQ31244 was written by Jason Thorpe, and contributed
                    216: by Wasabi Systems, Inc.
                    217: 
1.2       mspo      218:  * Quad on-board Intel i31244 SATA controllers on the PCI-X bus (_artsata_)
                    219:  * On-board Intel i82546EB Gigabit Ethernet on the PCI-X bus (_wm_)
                    220:  * On-board NS16550-compatible serial port (_com_)
                    221:  * On-chip timers (TMR0 used as system clock)
                    222:  * On-chip Application Accelerator Unit (_iopaau_)
                    223:  * On-chip watchdog timer (_iopwdog_)
                    224:  * On-board compact flash reader (_wdc_)
                    225:  * Other devices inserted into the PCI-X expansion slot
1.1       mspo      226: 
1.3       wiki      227: ### Intel **IQ80310**
1.1       mspo      228: 
                    229: The IQ80310 is the reference platform for the Intel **IOP310** I/O Processor
                    230: chipset, which is comprised of the i80200 XScale processor and the i80312 I/O
                    231: Companion chip.
                    232: 
                    233: Support for the IQ80310 was written by Jason Thorpe and Allen Briggs, and
                    234: contributed by Wasabi Systems, Inc.
                    235: 
1.2       mspo      236:  * On-board Intel i82559 Ethernet on the PCI bus (_fxp_)
                    237:  * On-board timer in the CPLD (used as system clock)
                    238:  * On-board NS16550-compatible serial ports (_com_)
                    239:  * Other devices inserted into the PCI expansion slots
1.1       mspo      240: 
1.3       wiki      241: ### Intel **IQ80321**
1.1       mspo      242: 
                    243: The IQ80321 is the reference platform for the Intel **IOP321** I/O Processor
                    244: (i80321 XScale processor).
                    245: 
                    246: Support for the IQ80321 was written by Jason Thorpe, and contributed by Wasabi
                    247: Systems, Inc.
                    248: 
1.2       mspo      249:  * On-board Intel i82544EI Gigabit Ethernet on the PCI-X bus (_wm_)
                    250:  * On-board NS16550-compatible serial port (_com_)
                    251:  * On-chip timers (TMR0 used as system clock)
                    252:  * On-chip Application Accelerator Unit (_iopaau_)
                    253:  * On-chip watchdog timer (_iopwdog_)
                    254:  * Other devices inserted into the PCI-X expansion slots
1.1       mspo      255: 
1.3       wiki      256: ### Intel **IXM1200**
1.1       mspo      257: 
                    258: The IXM1200 is the reference platform for the Intel **IXP1200** Network
                    259: Processor.
                    260: 
                    261: Support for the IXM1200 was written by Ichiro FUKUHARA and Naoto Shimazaki.
                    262: 
1.2       mspo      263:  * On-board Intel i82559 Ethernet on the PCI bus (_fxp_)
                    264:  * On-board Intel i21555 Non-Transparent PCI-PCI Bridge (_nppb_)
                    265:  * On-chip timers (ixpclk0 used as system clock)
                    266:  * On-chip serial port (_ixpcom_)
1.1       mspo      267: 
1.36      sevan     268: ### NOVATEC **NTNP425B** ("ZAO425")
1.12      wiki      269: 
                    270: NTNP425B is an evaluation and development platform for the Intel **IXP425**
                    271: XScale Core NetworkProcessor. NTNP425B is based on the reference board of
                    272: Intel **IXDP425**. The **NTNP425B** is capable of only big-endian operation.
                    273: Since the library for micro-engine(NPE) offered from Intel Corp. is big-
                    274: endian. More information about the **NTNP425B** can be found on [product
                    275: catalogue of **NTNP425B**(2.5MB,PDF
                    276: file)](http://www.novatec.co.jp/NTNP425BBrochureE.pdf).
                    277: 
                    278: Support for the NTNP425B was written by Ichiro FUKUHARA.
                    279: 
                    280:  * On-chip timers (_ixpclk0_ used as system clock)
                    281:  * On-chip 2 serial port (_ixpcom0_ and _ixpcom1_)
                    282:  * Other devices inserted into the PCI/mPCI slot
                    283:  * On-chip watchdog timer (_ixpwdog_)
                    284: 
1.20      wiki      285: ### NVIDIA Tegra K1
1.37      snj       286: Support for NVIDIA [[Tegra]] K1 SoCs is present in NetBSD-current and
                    287: 8.0_BETA. The Jetson TK1 board is currently supported.
1.20      wiki      288: 
1.40      gdt       289: ### Raspberry Pi Foundation **Raspberry Pi**/**Raspberry Pi 2**/**Raspberry Pi 3**
                    290: The [[Raspberry Pi]] is a low-cost credit-card-sized computer from the Raspberry Pi Foundation.  The Raspberry Pi, Pi 2, and Pi 3 are supported.
1.12      wiki      291: 
1.81      gdt       292: See the [[Raspberry Pi 1, 2 and 3|Raspberry Pi]] page for much more information.
                    293: 
1.3       wiki      294: ### Samsung **SMDK2410**
1.1       mspo      295: 
                    296: The SMDK2410 is the reference platform for the Samsung **S3C2410** processor,
                    297: which has an ARM920T core.
                    298: 
                    299: More information on the S3C2410 can be found at [Samsung Electronics web page]
                    300: (http://www.samsung.com/Products/Semiconductor/MobileSoC/ApplicationProcessor/
                    301: ARM9Series/S3C2410/S3C2410.htm).
                    302: 
                    303: Support for the SMDK2410 was written by Hiroyuki Bessho, and contributed by
                    304: Genetec Corp.
                    305: 
1.2       mspo      306:  * On-chip serial ports (_sscom_)
                    307:  * On-chip USB host controller (_ohc_)
                    308:  * On-chip timers (used as system clock)
                    309:  * On-chip SPI (_ssspi_, used for other on-board devices)
                    310:  * 240x320 TFT LCD (_lcd_)
                    311:  * keyboard. (_sskbd_)
1.1       mspo      312: 
1.3       wiki      313: ### Samsung **SMDK2800**
1.1       mspo      314: 
                    315: The SMDK2800 is the reference platform for the **Samsung S3C2800** processor,
                    316: which has an ARM920T core.
                    317: 
                    318: S3C2800 has built-in PCI controller, and SMDK2800 has three PCI slots.
                    319: 
                    320: Support for the SMDK2800 was written by Hiroyuki Bessho, and contributed by
                    321: Fujitsu Component Ltd., and Genetec Corp.
                    322: 
1.2       mspo      323:  * On-chip serial ports (_sscom_)
                    324:  * On-chip Host-PCI bridge (_sspci_)
                    325:  * On-chip timers (used as system clock)
1.36      sevan     326:  * Other devices inserted into the PCI slots
1.1       mspo      327: 
1.12      wiki      328: ### Team ASA, Inc. **Npwr**
1.1       mspo      329: 
1.12      wiki      330: The Npwr is an IOP310-based design targeted at the network-attached storage
                    331: space. The Npwr comes in several configurations (single or dual Gigabit
                    332: Ethernet, single or dual Ultra160 SCSI), and can be purchased as a bare board
                    333: or as a small server appliance. More information on the Npwr can be found at
                    334: the [Team ASA web page](http://www.teamasa.com/).
1.1       mspo      335: 
1.12      wiki      336: Support for the Npwr was written by Jason Thorpe and Allen Briggs, and
                    337: contributed by Wasabi Systems, Inc.
1.1       mspo      338: 
1.12      wiki      339:  * On-board Intel i82544 Gigabit Ethernet on the PCI bus (_wm_)
                    340:  * On-board LSI Logic 53c1010 Ultra160 SCSI on the PCI bus (_siop_)
                    341:  * On-board timer in the CPLD (used as system clock)
                    342:  * On-board NS16550-compatible serial port (_com_)
1.1       mspo      343: 
1.12      wiki      344: ### Technologic Systems **TS-7200**
1.1       mspo      345: 
1.12      wiki      346: The TS-7200 is a low-cost mass-produced PC/104 embedded single board computer
                    347: intended as a general purpose core for real embedded applications. The TS-7200
                    348: uses the Cirrus Logic EP9302 ARM9 system-on-chip and comes with a PC/104 (isa)
                    349: bus and can either boot to CompactFlash or onboard flash. The board also has
                    350: general purpose digital IO and optional multichannel analog-to-digital
                    351: converters. More information on the TS-7200 can be found at [Technologic
                    352: Systems](http://www.embeddedarm.com/epc/ts7200-spec-h.html).
1.1       mspo      353: 
1.12      wiki      354: Support for the TS-7200 was written by Jesse Off
1.1       mspo      355: 
1.12      wiki      356: * On-CPU RS232 UARTs (2) (_epcom_)
                    357: * On-CPU 10/100 Ethernet MAC (_epe_)
                    358: * CompactFlash socket (_wdc_)
                    359: * USB 1.1 ports (2) (_ohci_)
                    360: * Watchdog timer on CPLD (_tspld_)
                    361: * TMP124 high precision temperature sensor via sysctl
                    362: * 64Hz system clock from on-CPU timers (_epclk_)
                    363: * HD44780 2x24 text mode LCD (_tslcd_)
                    364: * 4x4 16 button matrix keypad (_wskbd_)
                    365: * TS-5620 battery backed RTC daughter-card (_tsrtc_)
                    366: * 1,2,4 port serial TS-SER daughter cards (_com_)
                    367: * Up to 4 10Mb TS-ETH10 daughter cards (_tscs_)
                    368: * Other devices inserted into the PC/104 (_isa_) expansion slot
1.1       mspo      369: 
                    370: """
1.13      wiki      371: additional="""
1.22      wiki      372:   * The [NetBSD Diskless HOWTO](http://www.netbsd.org/docs/network/netboot/)
1.36      sevan     373:   * [ Porting NetBSD/evbarm to the Arcom Viper](http://www.cs.hut.fi/~pooka/pubs/EuroBSDCon2005/viper.pdf), presented at EuroBSDCon 2005.
1.1       mspo      374: """
                    375: ]]
                    376: [[!tag tier1port]]

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