1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
Introduction
============
Many aspects of many of Tegra's pins can configure via the pinmux and GPIO
controllers. This project exists to assist with software's handling of the
configuration of those controllers.
Submitting Changes
==================
To submit patches to this project, please use the following commands:
* git format-patch --subject-prefix="pinmux scripts PATCH"
Creates a patch file from your git commit.
* git send-email --to linux-tegra@vger.kernel.org *.patch
Sends the patch by email to the Tegra mailing list.
Even though the primary upstream repository for this project is hosted on
github, contributions aren't accepted via github pull requests. Github pull
requests would bypass public code review on the project mailing list.
Patches should be signed off (include a signed-off-by line) to indicate your
acceptance of the code's license (see the license header in each file). See
http://developercertificate.org/ for details of what signed-off-by implies.
Data files
==========
SoC definition
The exact set of configurable options varies from chip to chip. This project
contains a data file for each chip, which describes the available pins on
the chip, along with their parameters, such as the set of available pinmux
functions the pin supports.
An example is configs/tegra124.soc.
Board configuration
Much of the programming of these controllers is directly driven by the board
design. This project contains a data file for each board, which describes
the required configuration for each pin.
An example is configs/jetson-tk1.board.
Converter Scripts
=================
soc-to-kernel-pinctrl-driver.py
Reads an SoC definition data file, and emits the source code for a Linux
kernel pinctrl driver, e.g. drivers/pinctrl/pinctrl-tegra124.c.
soc-to-uboot-driver.py
Reads an SoC definition data file, and emits the source code for a U-Boot
pinmux driver, e.g. arch/arm/include/asm/arch-tegra124/pinmux.h,
arch/arm/cpu/tegra124-common/pinmux.c
csv-to-board-tegra124-xlsx.py
Part of the output from the board design process is a spreadsheet that
describes the required configuration for each pin. This script extracts the
final pinmux configuration from (a CSV representation of) such spreadsheets
and creates a board configuration such as configs/jetson-tk1.board.
board-to-kernel-dt.py
Reads a board configuration data file, and emits a device tree fragment
suitable for inclusion in a board's device tree file. For example, the
output may form part of arch/arm/boot/dts/tegra124-jetson-tk1.dts.
Note that when at all possible, it is far preferable for the kernel not to
program the pinmux controller, but rather to rely upon system software to
have set it up. This reduces duplicate processing of pinmux data, and is
consistent with a model where the first software to touch any I/O controller
programs the pinmux configuration en mass, to avoid any potential output
data glitches.
board-to-uboot.py
Reads a board configuration data file, and emits a header file suitable for
use with U-Boot's pinmux driver. For example,
board/nvidia/jetson-tk1/pinmux-config-jetson-tk1.h. Note also the function
pinmux_init() in jetson-tk1.c in that same directory.
|
