Commit 43310e27 authored by Luca Ceresoli's avatar Luca Ceresoli Committed by Wolfram Sang

docs: i2c: instantiating-devices: add syntax coloring to dts and C blocks

These blocks can be nicely coloured via Sphinx.
Signed-off-by: default avatarLuca Ceresoli <luca.ceresoli@bootlin.com>
Signed-off-by: default avatarWolfram Sang <wsa@kernel.org>
parent 6c12ec27
...@@ -31,7 +31,9 @@ Declare the I2C devices via devicetree ...@@ -31,7 +31,9 @@ Declare the I2C devices via devicetree
On platforms using devicetree, the declaration of I2C devices is done in On platforms using devicetree, the declaration of I2C devices is done in
subnodes of the master controller. subnodes of the master controller.
Example:: Example:
.. code-block:: dts
i2c1: i2c@400a0000 { i2c1: i2c@400a0000 {
/* ... master properties skipped ... */ /* ... master properties skipped ... */
...@@ -71,7 +73,9 @@ code. Instantiating I2C devices via board files is done with an array of ...@@ -71,7 +73,9 @@ code. Instantiating I2C devices via board files is done with an array of
struct i2c_board_info which is registered by calling struct i2c_board_info which is registered by calling
i2c_register_board_info(). i2c_register_board_info().
Example (from omap2 h4):: Example (from omap2 h4):
.. code-block:: c
static struct i2c_board_info h4_i2c_board_info[] __initdata = { static struct i2c_board_info h4_i2c_board_info[] __initdata = {
{ {
...@@ -111,7 +115,9 @@ bus in advance, so the method 1 described above can't be used. Instead, ...@@ -111,7 +115,9 @@ bus in advance, so the method 1 described above can't be used. Instead,
you can instantiate your I2C devices explicitly. This is done by filling you can instantiate your I2C devices explicitly. This is done by filling
a struct i2c_board_info and calling i2c_new_client_device(). a struct i2c_board_info and calling i2c_new_client_device().
Example (from the sfe4001 network driver):: Example (from the sfe4001 network driver):
.. code-block:: c
static struct i2c_board_info sfe4001_hwmon_info = { static struct i2c_board_info sfe4001_hwmon_info = {
I2C_BOARD_INFO("max6647", 0x4e), I2C_BOARD_INFO("max6647", 0x4e),
...@@ -136,7 +142,9 @@ it may have different addresses from one board to the next (manufacturer ...@@ -136,7 +142,9 @@ it may have different addresses from one board to the next (manufacturer
changing its design without notice). In this case, you can call changing its design without notice). In this case, you can call
i2c_new_scanned_device() instead of i2c_new_client_device(). i2c_new_scanned_device() instead of i2c_new_client_device().
Example (from the nxp OHCI driver):: Example (from the nxp OHCI driver):
.. code-block:: c
static const unsigned short normal_i2c[] = { 0x2c, 0x2d, I2C_CLIENT_END }; static const unsigned short normal_i2c[] = { 0x2c, 0x2d, I2C_CLIENT_END };
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment