From aff60aba6c44770fab8f2694ae81bafde6d22998 Mon Sep 17 00:00:00 2001 From: Sean Anderson Date: Wed, 7 Oct 2020 14:37:43 -0400 Subject: doc: Document timer API This adds kerneldocs for . I don't know who should maintain doc/api/timer.rst, since the timer subsystem seems to be maintained by SoC maintainers. MAINTAINERS is left un-updated for the moment. Signed-off-by: Sean Anderson Reviewed-by: Simon Glass --- doc/api/index.rst | 1 + doc/api/timer.rst | 8 ++++++++ 2 files changed, 9 insertions(+) create mode 100644 doc/api/timer.rst (limited to 'doc') diff --git a/doc/api/index.rst b/doc/api/index.rst index 1c261bcb73f..787b6778e59 100644 --- a/doc/api/index.rst +++ b/doc/api/index.rst @@ -12,4 +12,5 @@ U-Boot API documentation pinctrl rng serial + timer unicode diff --git a/doc/api/timer.rst b/doc/api/timer.rst new file mode 100644 index 00000000000..b0695174d7d --- /dev/null +++ b/doc/api/timer.rst @@ -0,0 +1,8 @@ +.. SPDX-License-Identifier: GPL-2.0+ +.. Copyright (C) 2020 Sean Anderson + +Timer Subsystem +=============== + +.. kernel-doc:: include/timer.h + :internal: -- cgit v1.2.3 From 367ea426a51886f6815e520f8b75a010cfa1bdfb Mon Sep 17 00:00:00 2001 From: Robert Marko Date: Thu, 8 Oct 2020 22:05:09 +0200 Subject: spi: Add Qualcomm QUP SPI controller driver This patch adds support for the Qualcomm QUP SPI controller that is commonly found in most of Qualcomm SoC-s. Driver currently supports v1.1.1, v2.1.1 and v2.2.1 HW. FIFO and Block modes are supported, no support for DMA mode is planned. Signed-off-by: Robert Marko Signed-off-by: Luka Kovacic Cc: Luka Perkov --- doc/device-tree-bindings/spi/spi-qup.txt | 33 ++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 doc/device-tree-bindings/spi/spi-qup.txt (limited to 'doc') diff --git a/doc/device-tree-bindings/spi/spi-qup.txt b/doc/device-tree-bindings/spi/spi-qup.txt new file mode 100644 index 00000000000..3697df26310 --- /dev/null +++ b/doc/device-tree-bindings/spi/spi-qup.txt @@ -0,0 +1,33 @@ +Qualcomm QUP SPI controller Device Tree Bindings +------------------------------------------- + +Required properties: +- compatible : Should be "qcom,spi-qup-v1.1.1", "qcom,spi-qup-v2.1.1" + or "qcom,spi-qup-v2.2.1" +- reg : Physical base address and size of SPI registers map. +- clock : Clock phandle (see clock bindings for details). +- #address-cells : Number of cells required to define a chip select + address on the SPI bus. Should be set to 1. +- #size-cells : Should be zero. +- pinctrl-names : Must be "default" +- pinctrl-n : At least one pinctrl phandle +- cs-gpios : Should specify GPIOs used for chipselects. + The gpios will be referred to as reg = in the + SPI child nodes. + +Optional properties: +- num-cs : total number of chipselects + +Example: + + blsp1_spi1: spi@78b5000 { + compatible = "qcom,spi-qup-v2.2.1"; + reg = <0x78b5000 0x600>; + clock = <&gcc 23>; + #address-cells = <1>; + #size-cells = <0>; + pinctrl-names = "spi"; + pinctrl-0 = <&blsp_spi0>; + num-cs = <2>; + cs-gpios = <&soc_gpios 54 GPIO_ACTIVE_HIGH>, <&soc_gpios 4 GPIO_ACTIVE_HIGH>; + }; -- cgit v1.2.3 From 7ad1e0bcf3dad761c53b97e94a6860d090f5a352 Mon Sep 17 00:00:00 2001 From: Simon Glass Date: Tue, 13 Oct 2020 19:55:07 -0600 Subject: log: Tidy up documentation Fix up the documentation which was lost in a merge conflict in the conversion to RST. Fixes: 52d3df7fefe ("log: Allow LOG_DEBUG to always enable log output") Signed-off-by: Simon Glass --- doc/develop/logging.rst | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) (limited to 'doc') diff --git a/doc/develop/logging.rst b/doc/develop/logging.rst index 7ce8482ab6d..28340a4aac7 100644 --- a/doc/develop/logging.rst +++ b/doc/develop/logging.rst @@ -83,11 +83,8 @@ Sometimes it is useful to turn on logging just in one file. You can use this #define LOG_DEBUG to enable building in of all logging statements in a single file. Put it at -the top of the file, before any #includes. - -To actually get U-Boot to output this you need to also set the default logging -level - e.g. set CONFIG_LOG_DEFAULT_LEVEL to 7 (LOGL_DEBUG) or more. Otherwise -debug output is suppressed and will not be generated. +the top of the file, before any #includes. This overrides any log-level setting +in U-Boot, including CONFIG_LOG_DEFAULT_LEVEL, but just for that file. Convenience functions @@ -111,6 +108,12 @@ LOG_CATEGORY, which you can only define once per file, above all #includes, e.g. #define LOG_CATEGORY LOGC_ALLOC +or + +.. code-block:: c + + #define LOG_CATEGORY UCLASS_SPI + Remember that all uclasses IDs are log categories too. -- cgit v1.2.3 From 69509fb0a592b8bd9b3d50d58493b22b6359f19a Mon Sep 17 00:00:00 2001 From: "Chance.Yang" Date: Wed, 14 Oct 2020 11:47:33 +0800 Subject: doc: dfu: fix typo in README.dfu Fix "ram" typos for serial flash Signed-off-by: Chance.Yang --- doc/README.dfu | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/README.dfu b/doc/README.dfu index 4b9f8835407..be53b5b393c 100644 --- a/doc/README.dfu +++ b/doc/README.dfu @@ -121,7 +121,7 @@ Commands: "sf" (serial flash : NOR) cmd: dfu 0 sf each element in "dfu_alt_info" = - ram raw access to sf device + raw raw access to sf device part raw acces to partition partubi raw acces to ubi partition -- cgit v1.2.3