mirror of
https://github.com/apache/nuttx.git
synced 2026-05-29 04:19:37 +08:00
arch/arm64: Add support for PINE64 PinePhone
This PR adds support for PINE64 PinePhone and the Allwinner A64 SoC (based on Arm Cortex-A53). With this PR, PinePhone boots successfully to nsh (via microSD Card) and runs console apps. - `arch/arm64/Kconfig`: Added Allwinner A64 SoC - `boards/Kconfig`: Added PINE64 PinePhone - `arch/arm64/src/a64/Kconfig`: New Kconfig for Allwinner A64 SoC - `boards/arm64/a64/pinephone/Kconfig`: New Kconfig for PINE64 PinePhone - `src/a64/a64_boot.c`, `a64_boot.h`: Boot functions for Allwinner A64 - `src/a64/a64_lowputc.S`: Low-level console output - `src/a64/a64_serial.c`, `a64_serial.h`: A64 Serial Driver - `src/a64/chip.h`: A64 SoC Definitions - `include/a64/chip.h`: A64 Memory Map, Generic Interrupt Controller - `include/a64/irq.h`: A64 Interrupts - `src/a64/Make.defs`: Source files for A64 - `configs/nsh/defconfig`: Board Configuration for `pinephone:nsh` - `src/pinephone_appinit.c`: Init PinePhone - `src/pinephone_boardinit.c`: Init PinePhone - `src/pinephone_bringup.c`: Start PinePhone Drivers - `src/pinephone.h`: PinePhone Declarations - `include/board_memorymap.h`: PinePhone Memory Map - `scripts/dramboot.ld`: PinePhone Linker Script - `scripts/Make.defs`: Source files for PinePhone - `src/Makefile`: PinePhone Makefile - `platforms/arm/a64/boards/pinephone/index.rst`: Building and booting NuttX on PinePhone - `platforms/arm/a64/index.rst`: Overview of Allwinner A64 - `introduction/supported_platforms.rst`: Added Allwinner A64 - `introduction/detailed_support.rst`: Added Allwinner A64
This commit is contained in:
Lee Lup Yuen
Xiang Xiao
@@ -0,0 +1,136 @@
|
||||
================
|
||||
PINE64 PinePhone
|
||||
================
|
||||
|
||||
`PinePhone <https://wiki.pine64.org/index.php/PinePhone>`_ is an ARM64 smartphone created by PINE64.
|
||||
|
||||
Features
|
||||
========
|
||||
|
||||
- **System on Chip:** Allwinner A64
|
||||
- **CPU:** Quad-Core ARM Cortex-A53
|
||||
- **GPU:** ARM Mali400 MP2
|
||||
- **Interrupt Controller:** ARM GIC PL400 (Generic Interrupt Controller v2)
|
||||
- **Display Engine:** Allwinner Display Engine 2.0 (MIPI DSI with DMA)
|
||||
- **Display:** Xingbangda XBD599 HD IPS Capacitive Touchscreen (5.95 inches, 1440x720 resolution, 16M colors)
|
||||
- **LCD Controller:** Sitronix ST7703 (MIPI DSI)
|
||||
- **RAM:** 2GB or 3GB LPDDR3 SDRAM
|
||||
- **Internal Storage:** 16GB or 32GB eMMC, extendable up to 2TB via microSD
|
||||
- **Back Camera:** Single 5MP, 1/4", LED Flash
|
||||
- **Front Camera:** Single 2MP, f/2.8, 1/5"
|
||||
- **Sound:** Loudspeaker, 3.5mm jack & mic (jack doubles as Hardware UART if Privacy Switch 6 is Off)
|
||||
- Modem: Quectel EG25-G
|
||||
- **LTE-FDD, LTE-TDD, WCDMA, GSM**
|
||||
- **GNSS:** GPS / GLONASS / BeiDou / Galileo / QZSS, with A-GPS
|
||||
- 2.4 GHz Wireless: Realtek RTL8723CS
|
||||
- **WLAN:** WiFi 802.11 b/g/n, single-band, hotspot
|
||||
- **Bluetooth:** 4.0, A2DP
|
||||
- **Sensors:** Accelerometer, Gyroscope, Proximity, Ambient Light, Compass
|
||||
- **Privacy Switches:** Modem, WiFi & Bluetooth, Microphone, Cameras, Headphone
|
||||
- **Battery:** Lithium-ion, rated capacity 2800mAh (10.64Wh), typical capacity 3000mAh (11.40Wh)
|
||||
- **I/O:** USB Type-C, USB Host, DisplayPort Alternate Mode output, 15W 5V 3A Quick Charge, follows USB PD specification
|
||||
|
||||
Serial Console
|
||||
==============
|
||||
|
||||
A `PinePhone Serial Debug Cable <https://wiki.pine64.org/index.php/PinePhone#Serial_console>`_
|
||||
is required to run NuttX on PinePhone.
|
||||
|
||||
On PinePhone, set the `Privacy Switch 6 (Headphone) <https://wiki.pine64.org/index.php/PinePhone#Privacy_switch_configuration>`_
|
||||
to **Off**.
|
||||
|
||||
Connect PinePhone to our computer with the Serial Debug Cable.
|
||||
On our computer, start a Serial Terminal and connect to the USB Serial Port
|
||||
at **115.2 kbps**.
|
||||
|
||||
NuttX will appear in the Serial Console when it boots on PinePhone.
|
||||
|
||||
ARM64 Toolchain
|
||||
===============
|
||||
|
||||
Before building NuttX for PinePhone, download the ARM64 Toolchain for
|
||||
**AArch64 Bare-Metal Target** ``aarch64-none-elf`` from
|
||||
`Arm GNU Toolchain Downloads <https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads>`_.
|
||||
(Skip the section for Beta Releases)
|
||||
|
||||
Add the downloaded toolchain ``gcc-arm-...-aarch64-none-elf/bin``
|
||||
to the ``PATH`` Environment Variable.
|
||||
|
||||
Check the ARM64 Toolchain:
|
||||
|
||||
.. code:: console
|
||||
|
||||
$ aarch64-none-elf-gcc -v
|
||||
|
||||
Building
|
||||
========
|
||||
|
||||
To build NuttX for PinePhone, :doc:`install the prerequisites </quickstart/install>` and
|
||||
:doc:`clone the git repositories </quickstart/install>` for ``nuttx`` and ``apps``.
|
||||
|
||||
Configure the NuttX project and build the project:
|
||||
|
||||
.. code:: console
|
||||
|
||||
$ cd nuttx
|
||||
$ tools/configure.sh pinephone:nsh
|
||||
$ make
|
||||
$ cp nuttx.bin Image
|
||||
$ rm -f Image.gz
|
||||
$ gzip Image
|
||||
|
||||
This produces the file ``Image.gz``, which will be copied to PinePhone in the next step.
|
||||
|
||||
If the build fails with the error ``token "@" is not valid in preprocessor``,
|
||||
`apply this patch <https://github.com/apache/incubator-nuttx/pull/7284/commits/518b0eb31cb66f25b590ae9a79ab16c319b96b94#diff-12291efd8a0ded1bc38bad733d99e4840ae5112b465c04287f91ba5169612c73>`_
|
||||
to ``gcc-arm-none-eabi/arm-none-eabi/include/_newlib_version.h``
|
||||
in the ARM64 Toolchain.
|
||||
|
||||
Booting
|
||||
=======
|
||||
|
||||
NuttX boots on PinePhone via a microSD Card. To prepare the microSD Card, download the
|
||||
**PinePhone Jumpdrive Image** ``pine64-pinephone.img.xz`` from
|
||||
`dreemurrs-embedded/Jumpdrive <https://github.com/dreemurrs-embedded/Jumpdrive/releases>`_.
|
||||
|
||||
Write the downloaded image to a microSD Card with
|
||||
`Balena Etcher <https://www.balena.io/etcher/>`_.
|
||||
|
||||
Copy the file ``Image.gz`` from the previous section
|
||||
and overwrite the file on the microSD Card.
|
||||
|
||||
Check that PinePhone is connected to our computer via a
|
||||
`Serial Debug Cable <https://wiki.pine64.org/index.php/PinePhone#Serial_console>`_ at 115.2 kbps.
|
||||
`Privacy Switch 6 (Headphone) <https://wiki.pine64.org/index.php/PinePhone#Privacy_switch_configuration>`_
|
||||
should be set to **Off**.
|
||||
|
||||
Insert the microSD Card into PinePhone and power up PinePhone.
|
||||
NuttX boots on PinePhone and NuttShell (nsh) appears in the Serial Console.
|
||||
|
||||
To see the available commands in NuttShell:
|
||||
|
||||
.. code:: console
|
||||
|
||||
$ help
|
||||
|
||||
Configurations
|
||||
==============
|
||||
|
||||
nsh
|
||||
---
|
||||
|
||||
Basic configuration that runs NuttShell (nsh).
|
||||
This configuration is focused on low level, command-line driver testing.
|
||||
Built-in applications are supported, but none are enabled.
|
||||
Serial Console is enabled on UART0 at 115.2 kbps.
|
||||
|
||||
Peripheral Support
|
||||
==================
|
||||
|
||||
NuttX for PinePhone supports these peripherals:
|
||||
|
||||
=========== ======= =====
|
||||
Peripheral Support NOTES
|
||||
=========== ======= =====
|
||||
UART Yes Only UART0 is supported
|
||||
=========== ======= =====
|
||||
@@ -0,0 +1,19 @@
|
||||
=============
|
||||
Allwinner A64
|
||||
=============
|
||||
|
||||
`Allwinner A64 <https://linux-sunxi.org/A64>`_ is an ARM64 SoC that features:
|
||||
|
||||
- **CPU:** Quad-Core ARM Cortex-A53
|
||||
- **GPU:** ARM Mali400 MP2
|
||||
- **Interrupt Controller:** ARM GIC PL400 (Generic Interrupt Controller v2)
|
||||
- **Display Engine:** Allwinner Display Engine 2.0 (MIPI DSI with DMA)
|
||||
|
||||
Supported Boards
|
||||
================
|
||||
|
||||
.. toctree::
|
||||
:glob:
|
||||
:maxdepth: 1
|
||||
|
||||
boards/*/*
|
||||
Reference in New Issue
Block a user