u-boot/board/freescale/ls1028a
Masahiro Yamada b75d8dc564 treewide: convert bd_t to struct bd_info by coccinelle
The Linux coding style guide (Documentation/process/coding-style.rst)
clearly says:

  It's a **mistake** to use typedef for structures and pointers.

Besides, using typedef for structures is annoying when you try to make
headers self-contained.

Let's say you have the following function declaration in a header:

  void foo(bd_t *bd);

This is not self-contained since bd_t is not defined.

To tell the compiler what 'bd_t' is, you need to include <asm/u-boot.h>

  #include <asm/u-boot.h>
  void foo(bd_t *bd);

Then, the include direcective pulls in more bloat needlessly.

If you use 'struct bd_info' instead, it is enough to put a forward
declaration as follows:

  struct bd_info;
  void foo(struct bd_info *bd);

Right, typedef'ing bd_t is a mistake.

I used coccinelle to generate this commit.

The semantic patch that makes this change is as follows:

  <smpl>
  @@
  typedef bd_t;
  @@
  -bd_t
  +struct bd_info
  </smpl>

Signed-off-by: Masahiro Yamada <masahiroy@kernel.org>
2020-07-17 09:30:13 -04:00
..
ddr.c
Kconfig armv8: ls1028aqds: Add support of LS1028AQDS 2019-05-22 12:24:24 +05:30
ls1028a.c treewide: convert bd_t to struct bd_info by coccinelle 2020-07-17 09:30:13 -04:00
MAINTAINERS configs: ls1028aqds: add lpuart config 2020-04-29 11:10:54 +05:30
Makefile
README armv8: ls1028aqds: Add support of LS1028AQDS 2019-05-22 12:24:24 +05:30

Overview
--------
The LS1028A Reference Design (RDB) is a high-performance computing,
evaluation, and development platform that supports ARM SoC LS1028A and its
derivatives.

LS1028A SoC Overview
--------------------------------------
Please refer arch/arm/cpu/armv8/fsl-layerscape/doc/README.soc

RDB Default Switch Settings (1: ON; 0: OFF)
-------------------------------------------
For XSPI NOR boot (default)
SW2: 1111_1000
SW3: 1111_0000
SW5: 0011_1001

For SD Boot
SW2: 1000_1000
SW3: 1111_0000
SW5: 0011_1001

For eMMC Boot
SW2: 1001_1000
SW3: 1111_0000
SW5: 0011_1001

LS1028ARDB board Overview
-------------------------
Processor
 Two Arm Cortex- A72 processor cores:
  - Based on 64-bit ARMv8 architecture
  - Up to 1.3 GHz operation
  - Single-threaded cores with 48 KB L1 instruction cache and 32 KB L1
    data cache
  - Arranged as a single cluster of two cores sharing a single 1 MB L2
    cache
DDR memory
  - Five onboard 1G x8 discrete memory modules (Four data byte lanes
    ECC)
  - 32-bit data and 4-bit ECC
  - One chip select
  - Data transfer rates of up to 1.6 GT/s
  - Single-bit error correction and double-bit error detection ECC (4-bit
    check word across 32-bit data)
High-speed serial ports(SerDes)
 - Lane 0: Supports one 1 GbE RJ45 SGMII, connected through the
   Qualcomm AR8033 PHY
 - Lane 1: Supports four 1.25 GbE RJ45 QSGMII, each connected
   through the NXP F104S8A PHY
 - Lane 2: Connects to one PCIe M.2 Key-E slot to support PCIe Gen3
   (8 Gbit/s) cards
 - Lane 3: Connects to one PCIe M.2 Key-E slot or one SATA M.2 Key-B
   slot through a register mux to support either PCIe Gen 3 (8 Gbit/s) or
   SATA Gen 3 cards (6 Gbit/s) at a time
eSDHC
 - eSDHC1, eSDHC2
SPI
 - Connects to two mikroBUS sockets to support mikro-click modules,
   such as Bluetooth 4.0, 2.4 GHz IEEE 802.15.4 radio transceiver, near
   field communications (NFC) controller
Octal SPI (XSPI)
 - One 256 MB onboard XSPI serial NOR flash memory
 - One 512 MB onboard XSPI serial NAND flash memory
 - Supports a QSPI emulator for offboard QSPI emulation
I2C
 - All system devices are accessed via I2C1, which is multiplexed on
   I2C multiplexer PCA9848 to isolate address conflicts and reduce
   capacitive load
 - I2C1 is used for EEPROMs, RTC, INA220 current-power sensor,
   thermal monitor, PCIe/SATA M.2 connectors and mikro-click modules
   1 and 2
CAN
 - The two CAN DB9 ports can support CAN FD fast phase at data rates of
   up to 5 Mbit/s
Serial audio interface(SAI)
 - Audio codec SGTL5000 provides headphone and audio LINEOUT for
   stereo speakers
 - IEEE1588 interface to support audio on SAI4

QDS Default Switch Settings (1: ON; 0: OFF)
-------------------------------------------
For SD Boot
SW1 : 1000_0000
SW2 : 1110_0110
SW3 : 0000_0010
SW4 : 0000_0000
SW5 : 0000_0000
SW6 : 0000_0000
SW7 : 1111_0011
SW8 : 1110_0000
SW9 : 1000_0001
SW10: 1110_0000

For XSPI Boot
SW1 : 1111_0000
SW2 : 0000_0110
SW3 : 0000_0010
SW4 : 0000_0000
SW5 : 0110_0000
SW6 : 0101_0000
SW7 : 1111_0011
SW8 : 1110_0000
SW9 : 1000_0000
SW10: 1110_0000

LS1028AQDS board Overview
-------------------------
Processor
 Two Arm Cortex- A72 processor cores:
  - Based on 64-bit ARMv8 architecture
  - Up to 1.3 GHz operation
  - Single-threaded cores with 48 KB L1 instruction cache and 32 KB L1
    data cache
  - Arranged as a single cluster of two cores sharing a single 1 MB L2
    cache
DDR memory
 - Supports data rates of up to 1.6 GT/s for both, DDR4 and DDR3L
 - Supports a single- or dual-ranked SODIMM or UDIMM connector
 - 32-bit data and 4-bit ECC
 - Supports x8/x16 devices
 - Supports ECC error detection and correction
 - 1.35 V or 1.2 V DDR power supply, with automatic tracking of VTT, to
   all devices in case of DDR3L or DDR4, respectively. Power can
   switch to 1.35 V or 1.2 V, based on the switch settings for DDR3L or
   DDR4 devices, respectively
SerDes (Serializer/Deserializer)
 - Four-lane (0-3) SerDes:
 - Lane 0: supports PCIe Gen1/2/3 with x1, x2, and x4 operation, 10
   Gbit SXGMII, 1 Gbit SGMII
 - Lane 1: supports PCIe Gen1/2/3 with x1, x2, and x4 operation, 1 Gbit
   SGMII, 10 Gbit QXGMII, 5 Gbit QSGMII, 1 Gbit SGMII
 - Lane 2: supports PCIe Gen1/2/3 with x1, x2, and x4 operation, 1 Gbit
   SGMII
 - Lane 3: supports PCIe Gen1/2/3 with x1, x2, and x4 operation, 1 Gbit
   SGMII, SATA 2.0/3.0
 - Four slots on SerDes lanes support PCIe Gen1/2/3, 1 Gbit SGMII
   add-in cards
 - Lane 1 connects to a 2x10 connector with SFP+ through a retimer;
   lane 2 (TX lines) connects to an SMA connector
   Lane 3 connects to 1x7 header to support SATA devices
eSDHC
 - eSDHC1, eSDHC2
SPI
 - SPI1 and SPI2 support three onboard SPI flash memory devices:
    512 Mbit high-speed flash (with speed of up to 108/54 MHz)
    memory for storage
    4 Mbit low-speed flash memory (with speed of up to 40 MHz)
    64 Mbit high-speed flash memory (with speed of up to 104/80
    MHz)
 - SPI3 supports one onboard 64 Mbit SPI flash memory (with speed of
   up to 104/80 MHz)
 - All memories operate at 1.8 V
 - A header is provided on SPI1 to test SPI slave mode
I2C
 - LS1028A supports eight I2C controllers
Serial audio interface(SAI)
 Two SAI ports with audio codec SGTL5000:
  - Include stereo LINEIN with support for external analog input
  - Provide headphone and line output
Display
 - DisplayPort connector to connect the DP data to a 4K display device
   (computer monitor)
 - eDP connector to connect the DP data to a 4K display panel