All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH v4 1/3] docs/zh_CN: add iio iio_configfs.rst translation
@ 2021-01-21  3:33 Yanteng Si
  2021-01-21  3:33 ` [PATCH v4 2/3] docs/zh_CN: add iio ep93xx_adc.rst translation Yanteng Si
                   ` (3 more replies)
  0 siblings, 4 replies; 7+ messages in thread
From: Yanteng Si @ 2021-01-21  3:33 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: Alex Shi, Harry Wei, Yanteng Si, linux-doc, realpuyuwang,
	Huacai Chen, Jiaxun Yang, Yanteng Si

This patch translates Documentation/iio/iio_configfs.rst into Chinese.

Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
---
 .../translations/zh_CN/iio/iio_configfs.rst   | 102 ++++++++++++++++++
 1 file changed, 102 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/iio/iio_configfs.rst

diff --git a/Documentation/translations/zh_CN/iio/iio_configfs.rst b/Documentation/translations/zh_CN/iio/iio_configfs.rst
new file mode 100644
index 000000000000..223bc732ce66
--- /dev/null
+++ b/Documentation/translations/zh_CN/iio/iio_configfs.rst
@@ -0,0 +1,102 @@
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :doc:`../../../iio/iio_configfs`
+:Translator: Yanteng Si <siyanteng@loongson.cn>
+
+.. _cn_iio_configfs:
+
+
+=====================
+工业 IIO configfs支持
+=====================
+
+1. 概述
+=======
+
+Configfs是一种内核对象的基于文件系统的管理系统,IIO使用一些可以通过
+configfs轻松配置的对象(例如:设备,触发器)。
+
+关于configfs是如何运行的,请查阅Documentation/filesystems/configfs.rst
+了解更多信息。
+
+2. 用法
+=======
+为了使configfs支持IIO,我们需要在编译时选中config的CONFIG_IIO_CONFIGFS
+选项。
+
+然后,挂载configfs文件系统(通常在 /config directory目录下)::
+
+  $ mkdir/config
+  $ mount -t configfs none/config
+
+此时,将创建所有默认IIO组,并可以在/ config / iio下对其进行访问。 下一章
+将介绍可用的IIO配置对象。
+
+3. 软件触发器
+=============
+
+IIO默认configfs组之一是“触发器”组。 挂载configfs后可以自动访问它,并且可
+以在/config/iio/triggers下找到。
+
+IIO软件触发器为创建多种触发器类型提供了支持。 通常在include/linux/iio
+/sw_trigger.h:中的接口下将新的触发器类型实现为单独的内核模块:
+::
+
+  /*
+   * drivers/iio/trigger/iio-trig-sample.c
+   * 一种新触发器类型的内核模块实例
+   */
+  #include <linux/iio/sw_trigger.h>
+
+
+  static struct iio_sw_trigger *iio_trig_sample_probe(const char *name)
+  {
+	/*
+	 * 这将分配并注册一个IIO触发器以及其他触发器类型特性的初始化。
+	 */
+  }
+
+  static int iio_trig_sample_remove(struct iio_sw_trigger *swt)
+  {
+	/*
+	 * 这会废弃iio_trig_sample_probe中的操作
+	 */
+  }
+
+  static const struct iio_sw_trigger_ops iio_trig_sample_ops = {
+	.probe		= iio_trig_sample_probe,
+	.remove		= iio_trig_sample_remove,
+  };
+
+  static struct iio_sw_trigger_type iio_trig_sample = {
+	.name = "trig-sample",
+	.owner = THIS_MODULE,
+	.ops = &iio_trig_sample_ops,
+  };
+
+module_iio_sw_trigger_driver(iio_trig_sample);
+
+每种触发器类型在/config/iio/triggers下都有其自己的目录。 加载iio-trig-sample
+模块将创建“ trig-sample”触发器类型目录/config/iio/triggers/trig-sample.
+
+我们支持以下中断源(触发器类型)
+
+	* hrtimer,使用高分辨率定时器作为中断源
+
+3.1 Hrtimer触发器创建与销毁
+---------------------------
+
+加载iio-trig-hrtimer模块将注册hrtimer触发器类型,从而允许用户在
+/config/iio/triggers/hrtimer下创建hrtimer触发器。
+
+例如::
+
+  $ mkdir /config/iio/triggers/hrtimer/instance1
+  $ rmdir /config/iio/triggers/hrtimer/instance1
+
+每个触发器可以具有一个或多个独特的触发器类型的属性。
+
+3.2 "hrtimer" 触发器类型属性
+----------------------------
+
+"hrtimer”触发器类型没有来自/config dir的任何可配置属性。
+但它确实将采样频率属性引入了触发目录。
-- 
2.27.0


^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH v4 2/3] docs/zh_CN: add iio ep93xx_adc.rst translation
  2021-01-21  3:33 [PATCH v4 1/3] docs/zh_CN: add iio iio_configfs.rst translation Yanteng Si
@ 2021-01-21  3:33 ` Yanteng Si
  2021-01-21  9:27   ` Huacai Chen
  2021-01-21  3:33 ` [PATCH v4 3/3] docs: zh_CN: add iio index.rst translation Yanteng Si
                   ` (2 subsequent siblings)
  3 siblings, 1 reply; 7+ messages in thread
From: Yanteng Si @ 2021-01-21  3:33 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: Alex Shi, Harry Wei, Yanteng Si, linux-doc, realpuyuwang,
	Huacai Chen, Jiaxun Yang, Yanteng Si

This patch translates Documentation/iio/ep93xx_adc.rst into Chinese.

Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
---
 .../translations/zh_CN/iio/ep93xx_adc.rst     | 46 +++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/iio/ep93xx_adc.rst

diff --git a/Documentation/translations/zh_CN/iio/ep93xx_adc.rst b/Documentation/translations/zh_CN/iio/ep93xx_adc.rst
new file mode 100644
index 000000000000..727a48d09090
--- /dev/null
+++ b/Documentation/translations/zh_CN/iio/ep93xx_adc.rst
@@ -0,0 +1,46 @@
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :doc:`../../../iio/ep93xx_adc`
+:Translator: Yanteng Si <siyanteng@loongson.cn>
+
+.. _cn_iio_ep93xx_adc:
+
+
+==================================
+思睿逻辑 EP93xx 模拟数字转换器驱动
+==================================
+
+1. 概述
+=======
+
+该驱动同时适用于具有5通道模拟数字转换器的低端 (EP9301, Ep9302) 设备和10通道
+触摸屏/模拟数字转换器的高端设备(EP9307, EP9312, EP9315)。
+
+2. 通道编号
+===========
+
+EP9301和EP9302数据表定义了通道0..4的编号方案。虽然EP9307, EP9312和EP9315多
+了3个通道(一共8个),但是编号并没有定义。所以说最后三个通道是随机编号的。
+
+如果ep93xx_adc是IIO设备0,您将在以下位置找到条目
+/sys/bus/iio/devices/iio:device0/:
+
+  +-----------------+---------------+
+  | sysfs 入口      | ball/pin 名称 |
+  +=================+===============+
+  | in_voltage0_raw | YM            |
+  +-----------------+---------------+
+  | in_voltage1_raw | SXP           |
+  +-----------------+---------------+
+  | in_voltage2_raw | SXM           |
+  +-----------------+---------------+
+  | in_voltage3_raw | SYP           |
+  +-----------------+---------------+
+  | in_voltage4_raw | SYM           |
+  +-----------------+---------------+
+  | in_voltage5_raw | XP            |
+  +-----------------+---------------+
+  | in_voltage6_raw | XM            |
+  +-----------------+---------------+
+  | in_voltage7_raw | YP            |
+  +-----------------+---------------+
-- 
2.27.0


^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH v4 3/3] docs: zh_CN: add iio index.rst translation
  2021-01-21  3:33 [PATCH v4 1/3] docs/zh_CN: add iio iio_configfs.rst translation Yanteng Si
  2021-01-21  3:33 ` [PATCH v4 2/3] docs/zh_CN: add iio ep93xx_adc.rst translation Yanteng Si
@ 2021-01-21  3:33 ` Yanteng Si
  2021-01-21  9:28   ` Huacai Chen
  2021-01-21  9:27 ` [PATCH v4 1/3] docs/zh_CN: add iio iio_configfs.rst translation Huacai Chen
  2021-01-28 22:41 ` Jonathan Corbet
  3 siblings, 1 reply; 7+ messages in thread
From: Yanteng Si @ 2021-01-21  3:33 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: Alex Shi, Harry Wei, Yanteng Si, linux-doc, realpuyuwang,
	Huacai Chen, Jiaxun Yang, Yanteng Si

This patch translates Documentation/iio/index.rst into Chinese.

Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
---
 .../translations/zh_CN/iio/index.rst          | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/iio/index.rst

diff --git a/Documentation/translations/zh_CN/iio/index.rst b/Documentation/translations/zh_CN/iio/index.rst
new file mode 100644
index 000000000000..88b6ba5f233b
--- /dev/null
+++ b/Documentation/translations/zh_CN/iio/index.rst
@@ -0,0 +1,20 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :doc:`../../../iio/index`
+:Translator: Yanteng Si <siyanteng@loongson.cn>
+
+.. _cn_iio_index:
+
+
+========
+工业 I/O
+========
+
+.. toctree::
+   :maxdepth: 1
+
+   iio_configfs
+
+   ep93xx_adc
-- 
2.27.0


^ permalink raw reply related	[flat|nested] 7+ messages in thread

* Re: [PATCH v4 1/3] docs/zh_CN: add iio iio_configfs.rst translation
  2021-01-21  3:33 [PATCH v4 1/3] docs/zh_CN: add iio iio_configfs.rst translation Yanteng Si
  2021-01-21  3:33 ` [PATCH v4 2/3] docs/zh_CN: add iio ep93xx_adc.rst translation Yanteng Si
  2021-01-21  3:33 ` [PATCH v4 3/3] docs: zh_CN: add iio index.rst translation Yanteng Si
@ 2021-01-21  9:27 ` Huacai Chen
  2021-01-28 22:41 ` Jonathan Corbet
  3 siblings, 0 replies; 7+ messages in thread
From: Huacai Chen @ 2021-01-21  9:27 UTC (permalink / raw)
  To: Yanteng Si
  Cc: Jonathan Corbet, Alex Shi, Harry Wei, Yanteng Si, linux-doc,
	realpuyuwang, Jiaxun Yang

Reviewed-by: Huacai Chen <chenhuacai@kernel.org>

On Thu, Jan 21, 2021 at 11:32 AM Yanteng Si <siyanteng@loongson.cn> wrote:
>
> This patch translates Documentation/iio/iio_configfs.rst into Chinese.
>
> Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
> Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
> ---
>  .../translations/zh_CN/iio/iio_configfs.rst   | 102 ++++++++++++++++++
>  1 file changed, 102 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/iio/iio_configfs.rst
>
> diff --git a/Documentation/translations/zh_CN/iio/iio_configfs.rst b/Documentation/translations/zh_CN/iio/iio_configfs.rst
> new file mode 100644
> index 000000000000..223bc732ce66
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/iio/iio_configfs.rst
> @@ -0,0 +1,102 @@
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :doc:`../../../iio/iio_configfs`
> +:Translator: Yanteng Si <siyanteng@loongson.cn>
> +
> +.. _cn_iio_configfs:
> +
> +
> +=====================
> +工业 IIO configfs支持
> +=====================
> +
> +1. 概述
> +=======
> +
> +Configfs是一种内核对象的基于文件系统的管理系统,IIO使用一些可以通过
> +configfs轻松配置的对象(例如:设备,触发器)。
> +
> +关于configfs是如何运行的,请查阅Documentation/filesystems/configfs.rst
> +了解更多信息。
> +
> +2. 用法
> +=======
> +为了使configfs支持IIO,我们需要在编译时选中config的CONFIG_IIO_CONFIGFS
> +选项。
> +
> +然后,挂载configfs文件系统(通常在 /config directory目录下)::
> +
> +  $ mkdir/config
> +  $ mount -t configfs none/config
> +
> +此时,将创建所有默认IIO组,并可以在/ config / iio下对其进行访问。 下一章
> +将介绍可用的IIO配置对象。
> +
> +3. 软件触发器
> +=============
> +
> +IIO默认configfs组之一是“触发器”组。 挂载configfs后可以自动访问它,并且可
> +以在/config/iio/triggers下找到。
> +
> +IIO软件触发器为创建多种触发器类型提供了支持。 通常在include/linux/iio
> +/sw_trigger.h:中的接口下将新的触发器类型实现为单独的内核模块:
> +::
> +
> +  /*
> +   * drivers/iio/trigger/iio-trig-sample.c
> +   * 一种新触发器类型的内核模块实例
> +   */
> +  #include <linux/iio/sw_trigger.h>
> +
> +
> +  static struct iio_sw_trigger *iio_trig_sample_probe(const char *name)
> +  {
> +       /*
> +        * 这将分配并注册一个IIO触发器以及其他触发器类型特性的初始化。
> +        */
> +  }
> +
> +  static int iio_trig_sample_remove(struct iio_sw_trigger *swt)
> +  {
> +       /*
> +        * 这会废弃iio_trig_sample_probe中的操作
> +        */
> +  }
> +
> +  static const struct iio_sw_trigger_ops iio_trig_sample_ops = {
> +       .probe          = iio_trig_sample_probe,
> +       .remove         = iio_trig_sample_remove,
> +  };
> +
> +  static struct iio_sw_trigger_type iio_trig_sample = {
> +       .name = "trig-sample",
> +       .owner = THIS_MODULE,
> +       .ops = &iio_trig_sample_ops,
> +  };
> +
> +module_iio_sw_trigger_driver(iio_trig_sample);
> +
> +每种触发器类型在/config/iio/triggers下都有其自己的目录。 加载iio-trig-sample
> +模块将创建“ trig-sample”触发器类型目录/config/iio/triggers/trig-sample.
> +
> +我们支持以下中断源(触发器类型)
> +
> +       * hrtimer,使用高分辨率定时器作为中断源
> +
> +3.1 Hrtimer触发器创建与销毁
> +---------------------------
> +
> +加载iio-trig-hrtimer模块将注册hrtimer触发器类型,从而允许用户在
> +/config/iio/triggers/hrtimer下创建hrtimer触发器。
> +
> +例如::
> +
> +  $ mkdir /config/iio/triggers/hrtimer/instance1
> +  $ rmdir /config/iio/triggers/hrtimer/instance1
> +
> +每个触发器可以具有一个或多个独特的触发器类型的属性。
> +
> +3.2 "hrtimer" 触发器类型属性
> +----------------------------
> +
> +"hrtimer”触发器类型没有来自/config dir的任何可配置属性。
> +但它确实将采样频率属性引入了触发目录。
> --
> 2.27.0
>

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH v4 2/3] docs/zh_CN: add iio ep93xx_adc.rst translation
  2021-01-21  3:33 ` [PATCH v4 2/3] docs/zh_CN: add iio ep93xx_adc.rst translation Yanteng Si
@ 2021-01-21  9:27   ` Huacai Chen
  0 siblings, 0 replies; 7+ messages in thread
From: Huacai Chen @ 2021-01-21  9:27 UTC (permalink / raw)
  To: Yanteng Si
  Cc: Jonathan Corbet, Alex Shi, Harry Wei, Yanteng Si, linux-doc,
	realpuyuwang, Jiaxun Yang

Reviewed-by: Huacai Chen <chenhuacai@kernel.org>

On Thu, Jan 21, 2021 at 11:32 AM Yanteng Si <siyanteng@loongson.cn> wrote:
>
> This patch translates Documentation/iio/ep93xx_adc.rst into Chinese.
>
> Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
> Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
> ---
>  .../translations/zh_CN/iio/ep93xx_adc.rst     | 46 +++++++++++++++++++
>  1 file changed, 46 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/iio/ep93xx_adc.rst
>
> diff --git a/Documentation/translations/zh_CN/iio/ep93xx_adc.rst b/Documentation/translations/zh_CN/iio/ep93xx_adc.rst
> new file mode 100644
> index 000000000000..727a48d09090
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/iio/ep93xx_adc.rst
> @@ -0,0 +1,46 @@
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :doc:`../../../iio/ep93xx_adc`
> +:Translator: Yanteng Si <siyanteng@loongson.cn>
> +
> +.. _cn_iio_ep93xx_adc:
> +
> +
> +==================================
> +思睿逻辑 EP93xx 模拟数字转换器驱动
> +==================================
> +
> +1. 概述
> +=======
> +
> +该驱动同时适用于具有5通道模拟数字转换器的低端 (EP9301, Ep9302) 设备和10通道
> +触摸屏/模拟数字转换器的高端设备(EP9307, EP9312, EP9315)。
> +
> +2. 通道编号
> +===========
> +
> +EP9301和EP9302数据表定义了通道0..4的编号方案。虽然EP9307, EP9312和EP9315多
> +了3个通道(一共8个),但是编号并没有定义。所以说最后三个通道是随机编号的。
> +
> +如果ep93xx_adc是IIO设备0,您将在以下位置找到条目
> +/sys/bus/iio/devices/iio:device0/:
> +
> +  +-----------------+---------------+
> +  | sysfs 入口      | ball/pin 名称 |
> +  +=================+===============+
> +  | in_voltage0_raw | YM            |
> +  +-----------------+---------------+
> +  | in_voltage1_raw | SXP           |
> +  +-----------------+---------------+
> +  | in_voltage2_raw | SXM           |
> +  +-----------------+---------------+
> +  | in_voltage3_raw | SYP           |
> +  +-----------------+---------------+
> +  | in_voltage4_raw | SYM           |
> +  +-----------------+---------------+
> +  | in_voltage5_raw | XP            |
> +  +-----------------+---------------+
> +  | in_voltage6_raw | XM            |
> +  +-----------------+---------------+
> +  | in_voltage7_raw | YP            |
> +  +-----------------+---------------+
> --
> 2.27.0
>

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH v4 3/3] docs: zh_CN: add iio index.rst translation
  2021-01-21  3:33 ` [PATCH v4 3/3] docs: zh_CN: add iio index.rst translation Yanteng Si
@ 2021-01-21  9:28   ` Huacai Chen
  0 siblings, 0 replies; 7+ messages in thread
From: Huacai Chen @ 2021-01-21  9:28 UTC (permalink / raw)
  To: Yanteng Si
  Cc: Jonathan Corbet, Alex Shi, Harry Wei, Yanteng Si, linux-doc,
	realpuyuwang, Jiaxun Yang

Reviewed-by: Huacai Chen <chenhuacai@kernel.org>

On Thu, Jan 21, 2021 at 11:32 AM Yanteng Si <siyanteng@loongson.cn> wrote:
>
> This patch translates Documentation/iio/index.rst into Chinese.
>
> Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
> Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
> ---
>  .../translations/zh_CN/iio/index.rst          | 20 +++++++++++++++++++
>  1 file changed, 20 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/iio/index.rst
>
> diff --git a/Documentation/translations/zh_CN/iio/index.rst b/Documentation/translations/zh_CN/iio/index.rst
> new file mode 100644
> index 000000000000..88b6ba5f233b
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/iio/index.rst
> @@ -0,0 +1,20 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :doc:`../../../iio/index`
> +:Translator: Yanteng Si <siyanteng@loongson.cn>
> +
> +.. _cn_iio_index:
> +
> +
> +========
> +工业 I/O
> +========
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   iio_configfs
> +
> +   ep93xx_adc
> --
> 2.27.0
>

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH v4 1/3] docs/zh_CN: add iio iio_configfs.rst translation
  2021-01-21  3:33 [PATCH v4 1/3] docs/zh_CN: add iio iio_configfs.rst translation Yanteng Si
                   ` (2 preceding siblings ...)
  2021-01-21  9:27 ` [PATCH v4 1/3] docs/zh_CN: add iio iio_configfs.rst translation Huacai Chen
@ 2021-01-28 22:41 ` Jonathan Corbet
  3 siblings, 0 replies; 7+ messages in thread
From: Jonathan Corbet @ 2021-01-28 22:41 UTC (permalink / raw)
  To: Yanteng Si
  Cc: Alex Shi, Harry Wei, Yanteng Si, linux-doc, realpuyuwang,
	Huacai Chen, Jiaxun Yang

On Thu, 21 Jan 2021 11:33:00 +0800
Yanteng Si <siyanteng@loongson.cn> wrote:

> This patch translates Documentation/iio/iio_configfs.rst into Chinese.
> 
> Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
> Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
> ---
>  .../translations/zh_CN/iio/iio_configfs.rst   | 102 ++++++++++++++++++
>  1 file changed, 102 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/iio/iio_configfs.rst

All three patches applied, thanks.

In the future, please consider providing a cover letter with a multi-part
series like this.

Thanks,

jon

^ permalink raw reply	[flat|nested] 7+ messages in thread

end of thread, other threads:[~2021-01-28 22:43 UTC | newest]

Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-01-21  3:33 [PATCH v4 1/3] docs/zh_CN: add iio iio_configfs.rst translation Yanteng Si
2021-01-21  3:33 ` [PATCH v4 2/3] docs/zh_CN: add iio ep93xx_adc.rst translation Yanteng Si
2021-01-21  9:27   ` Huacai Chen
2021-01-21  3:33 ` [PATCH v4 3/3] docs: zh_CN: add iio index.rst translation Yanteng Si
2021-01-21  9:28   ` Huacai Chen
2021-01-21  9:27 ` [PATCH v4 1/3] docs/zh_CN: add iio iio_configfs.rst translation Huacai Chen
2021-01-28 22:41 ` Jonathan Corbet

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.