u-boot/board/bosch/shc
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
..
board.c treewide: convert bd_t to struct bd_info by coccinelle 2020-07-17 09:30:13 -04:00
board.h SPDX: Convert all of our single license tags to Linux Kernel style 2018-05-07 09:34:12 -04:00
Kconfig am335x, shc: kconfig: Fix misspelled choice default 2018-02-05 20:58:11 -05:00
MAINTAINERS am335x, shc: adapt shc board to DM 2019-02-01 09:09:40 -05:00
Makefile SPDX: Convert all of our single license tags to Linux Kernel style 2018-05-07 09:34:12 -04:00
mux.c common: Move hang() to the same header as panic() 2020-01-17 17:53:40 -05:00
README

Summary
=======

This document covers various features of the 'am335x_shc' build.

Hardware
========

AM335X based board:

I2C:   ready
DRAM:  512 MiB
Enabling the D-Cache
MMC:   OMAP SD/MMC: 0 @ 26 MHz, OMAP SD/MMC: 1 @ 26 MHz
Net:   cpsw

Following boot options are possible:

2 Jumpers:

Jumper 1 Jumper 2 Bootmode
off      off    eMMC boot
on       off    SD boot
off      on     Net boot

Compiling
=========

$ make am335x_shc_defconfig
  HOSTCC  scripts/basic/fixdep
  HOSTCC  scripts/kconfig/conf.o
  SHIPPED scripts/kconfig/zconf.tab.c
  SHIPPED scripts/kconfig/zconf.lex.c
  SHIPPED scripts/kconfig/zconf.hash.c
  HOSTCC  scripts/kconfig/zconf.tab.o
  HOSTLD  scripts/kconfig/conf
#
# configuration written to .config
#
$ make -s all

-> now you have the MLO and the u-boot.img file, you can put
on your SD card or eMMC.

Configuring
===========

There are a lot of board versions and boot configurations, which
can be selected through "make menuconfig"

ARM architecture  --->
  enable different boot versions for the shc board (enable eMMC)  --->
   (X) enable eMMC
   ( ) enable ICT
   ( ) enable NETBOOT
   ( ) enable SDBOOT

  enable different board versions for the shc board (C3 Sample board version)  --->
   ( ) B Sample board version
   ( ) B2 Sample board version
   ( ) C Sample board version
   ( ) C2 Sample board version
   (X) C3 Sample board version
   ( ) Series board version

Netboot
=======
- see also doc/SPL/README.am335x-network

- set the jumper into netboot mode
- compile the U-boot sources with:
  make am335x_shc_netboot_defconfig
  make all
- copy the images into your tftp boot directory
  cp spl/u-boot-spl.bin /tftpboot/.../u-boot-spl-restore.bin
  cp u-boot.img /tftpboot/.../u-boot-restore.img
- power on the board, and you should get something like this:

U-Boot SPL 2016.05-rc2-00016-gf23b960-dirty (Apr 26 2016 - 09:02:18)
#### NETBOOT ####
SHC
MPU reference clock runs at 6 MHz
Setting MPU clock to 594 MHz
Enabling Spread Spectrum of 18 permille for MPU
Trying to boot from net
Using default environment

<ethaddr> not set. Validating first E-fuse MAC
cpsw
cpsw Waiting for PHY auto negotiation to complete... done
link up on port 0, speed 100, full duplex
BOOTP broadcast 1
BOOTP broadcast 2
DHCP client bound to address 192.168.20.91 (258 ms)
Using cpsw device
TFTP from server 192.168.1.1; our IP address is 192.168.20.91
Filename 'shc/u-boot-restore.img'.
Load address: 0x807fffc0
Loading: ##################
         1.2 MiB/s
done
Bytes transferred = 262480 (40150 hex)


U-Boot 2016.05-rc2-00016-gf23b960-dirty (Apr 26 2016 - 09:02:18 +0200)

       Watchdog enabled
I2C:   ready
DRAM:  512 MiB
MMC:   OMAP SD/MMC: 0, OMAP SD/MMC: 1
*** Warning - bad CRC, using default environment

Net:   cpsw
switch to partitions #0, OK