forked from raspberrypi/documentation
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request raspberrypi#105 from XECDesign/dualcam
Add dualcam and pin configuration documentation
- Loading branch information
Showing
3 changed files
with
429 additions
and
8 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,313 @@ | ||
| # Changing the default pin configuration | ||
| *This feature is intended for advanced users.* | ||
|
|
||
| As of July 15th 2014, the Raspberry Pi firmware supports custom default pin configurations through a user-provided device tree blob file. In order to ensure that your firmware is recent enough, please run `vcgencmd version`. | ||
| ## Providing a custom device tree blob | ||
| In order to compile a device tree source (*dts*) file into a device tree blob (*dtb*) file, the device tree compiler must be installed by running `sudo apt-get install device-tree-compiler`. | ||
| The `dtc` command can then be used as follows: | ||
| ``` | ||
| sudo dtc -I dts -O dtb -i dt-blob.dts -o /boot/dt-blob.bin | ||
| ``` | ||
| **NOTE:** In the case of NOOBS installs, the dtb file should be placed on the recovery partition instead. | ||
|
|
||
| Similarly, a dtb file can be converted back to a dts file, if required. | ||
| ``` | ||
| dtc -I dtb -O dts -i /boot/dt-blob.bin -o dt-blob.dts | ||
| ``` | ||
| ## Sample device tree source file | ||
| **NOTE:** As this is a new feature, there is no reference dts file which is guaranteed to be supported by future firmware revisions. | ||
|
|
||
| The dts file below is used for the dtb compiled into the August 1st 2014 firmware. | ||
| ``` | ||
| /dts-v1/; | ||
| / { | ||
| videocore { | ||
| pins_rev1 { | ||
| pin_config { | ||
| pin@default { | ||
| polarity = "active_high"; | ||
| termination = "pull_down"; | ||
| startup_state = "inactive"; | ||
| function = "input"; | ||
| }; // pin | ||
| pin@p2 { function = "i2c1"; termination = "pull_up"; }; // I2C 1 SDA | ||
| pin@p3 { function = "i2c1"; termination = "pull_up"; }; // I2C 1 SCL | ||
| pin@p5 { function = "output"; termination = "pull_down"; }; // CAM_LED | ||
| pin@p6 { function = "output"; termination = "pull_down"; }; // LAN NRESET | ||
| pin@p14 { function = "uart0"; termination = "no_pulling"; drive_strength_mA = < 8 >; }; // TX uart0 | ||
| pin@p15 { function = "uart0"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // RX uart0 | ||
| pin@p16 { function = "output"; termination = "pull_up"; polarity="active_low"; }; // activity LED | ||
| pin@p27 { function = "output"; termination = "no_pulling"; }; // Camera shutdown | ||
| pin@p40 { function = "pwm"; termination = "no_pulling"; drive_strength_mA = < 16 >; }; // Left audio | ||
| pin@p45 { function = "pwm"; termination = "no_pulling"; drive_strength_mA = < 16 >; }; // Right audio | ||
| pin@p46 { function = "input"; termination = "no_pulling"; }; // Hotplug | ||
| pin@p47 { function = "input"; termination = "no_pulling"; }; // SD card detect | ||
| pin@p48 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD CLK | ||
| pin@p49 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD CMD | ||
| pin@p50 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D0 | ||
| pin@p51 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D1 | ||
| pin@p52 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D2 | ||
| pin@p53 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D3 | ||
| }; // pin_config | ||
| pin_defines { | ||
| pin_define@HDMI_CONTROL_ATTACHED { | ||
| type = "internal"; | ||
| number = <46>; | ||
| }; | ||
| pin_define@NUM_CAMERAS { | ||
| type = "internal"; | ||
| number = <1>; | ||
| }; | ||
| pin_define@CAMERA_0_UNICAM_PORT { | ||
| type = "internal"; | ||
| number = <1>; | ||
| }; | ||
| pin_define@CAMERA_0_I2C_PORT { | ||
| type = "internal"; | ||
| number = <1>; | ||
| }; | ||
| pin_define@CAMERA_0_SDA_PIN { | ||
| type = "internal"; | ||
| number = <2>; | ||
| }; | ||
| pin_define@CAMERA_0_SCL_PIN { | ||
| type = "internal"; | ||
| number = <3>; | ||
| }; | ||
| pin_define@CAMERA_0_SHUTDOWN { | ||
| type = "internal"; | ||
| number = <27>; | ||
| }; | ||
| pin_define@CAMERA_0_LED { | ||
| type = "internal"; | ||
| number = <5>; | ||
| }; | ||
| pin_define@FLASH_0_ENABLE { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@FLASH_0_INDICATOR { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@FLASH_1_ENABLE { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@FLASH_1_INDICATOR { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@POWER_LOW { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@LEDS_DISK_ACTIVITY { | ||
| type = "internal"; | ||
| number = <16>; | ||
| }; | ||
| pin_define@LAN_RESET { | ||
| type = "internal"; | ||
| number = <6>; | ||
| }; | ||
| }; // pin_defines | ||
| }; // pins_rev1 | ||
| pins_rev2 { | ||
| pin_config { | ||
| pin@default { | ||
| polarity = "active_high"; | ||
| termination = "pull_down"; | ||
| startup_state = "inactive"; | ||
| function = "input"; | ||
| }; // pin | ||
| pin@p0 { function = "i2c0"; termination = "pull_up"; }; // I2C 0 SDA | ||
| pin@p1 { function = "i2c0"; termination = "pull_up"; }; // I2C 0 SCL | ||
| pin@p5 { function = "output"; termination = "pull_down"; }; // CAM_LED | ||
| pin@p6 { function = "output"; termination = "pull_down"; }; // LAN NRESET | ||
| pin@p14 { function = "uart0"; termination = "no_pulling"; drive_strength_mA = < 8 >; }; // TX uart0 | ||
| pin@p15 { function = "uart0"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // RX uart0 | ||
| pin@p16 { function = "output"; termination = "pull_up"; polarity = "active_low"; }; // activity LED | ||
| pin@p21 { function = "output"; termination = "no_pulling"; }; // Camera shutdown | ||
| pin@p40 { function = "pwm"; termination = "no_pulling"; drive_strength_mA = < 16 >; }; // Left audio | ||
| pin@p45 { function = "pwm"; termination = "no_pulling"; drive_strength_mA = < 16 >; }; // Right audio | ||
| pin@p46 { function = "input"; termination = "no_pulling"; }; // Hotplug | ||
| pin@p47 { function = "input"; termination = "no_pulling"; }; // SD card detect | ||
| pin@p48 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD CLK | ||
| pin@p49 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD CMD | ||
| pin@p50 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D0 | ||
| pin@p51 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D1 | ||
| pin@p52 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D2 | ||
| pin@p53 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D3 | ||
| }; // pin_config | ||
| pin_defines { | ||
| pin_define@HDMI_CONTROL_ATTACHED { | ||
| type = "internal"; | ||
| number = <46>; | ||
| }; | ||
| pin_define@NUM_CAMERAS { | ||
| type = "internal"; | ||
| number = <1>; | ||
| }; | ||
| pin_define@CAMERA_0_I2C_PORT { | ||
| type = "internal"; | ||
| number = <0>; | ||
| }; | ||
| pin_define@CAMERA_0_SDA_PIN { | ||
| type = "internal"; | ||
| number = <0>; | ||
| }; | ||
| pin_define@CAMERA_0_SCL_PIN { | ||
| type = "internal"; | ||
| number = <1>; | ||
| }; | ||
| pin_define@CAMERA_0_SHUTDOWN { | ||
| type = "internal"; | ||
| number = <21>; | ||
| }; | ||
| pin_define@CAMERA_0_UNICAM_PORT { | ||
| type = "internal"; | ||
| number = <1>; | ||
| }; | ||
| pin_define@CAMERA_0_LED { | ||
| type = "internal"; | ||
| number = <5>; | ||
| }; | ||
| pin_define@FLASH_0_ENABLE { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@FLASH_0_INDICATOR { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@FLASH_1_ENABLE { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@FLASH_1_INDICATOR { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@POWER_LOW { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@LEDS_DISK_ACTIVITY { | ||
| type = "internal"; | ||
| number = <16>; | ||
| }; | ||
| pin_define@LAN_RESET { | ||
| type = "internal"; | ||
| number = <6>; | ||
| }; | ||
| }; // pin_defines | ||
| }; // pins | ||
| pins_bplus { | ||
| pin_config { | ||
| pin@default { | ||
| polarity = "active_high"; | ||
| termination = "pull_down"; | ||
| startup_state = "inactive"; | ||
| function = "input"; | ||
| }; // pin | ||
| pin@p14 { function = "uart0"; termination = "no_pulling"; drive_strength_mA = < 8 >; }; // TX uart0 | ||
| pin@p15 { function = "uart0"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // RX uart0 | ||
| pin@p28 { function = "i2c0"; termination = "pull_up"; }; // I2C 0 SDA | ||
| pin@p29 { function = "i2c0"; termination = "pull_up"; }; // I2C 0 SCL | ||
| pin@p31 { function = "output"; termination = "pull_down"; }; // LAN NRESET | ||
| pin@p32 { function = "output"; termination = "pull_down"; }; // Camera LED | ||
| pin@p35 { function = "input"; termination = "no_pulling"; polarity = "active_low"; }; // Power low | ||
| pin@p38 { function = "output"; termination = "no_pulling"; }; // USB current limit (0=600mA, 1=1200mA) | ||
| pin@p40 { function = "pwm"; termination = "no_pulling"; drive_strength_mA = < 16 >; }; // Left audio | ||
| pin@p41 { function = "output"; termination = "no_pulling"; }; // Camera enable | ||
| pin@p44 { function = "gp_clk"; termination = "pull_down"; }; // Ethernet 25MHz output | ||
| pin@p45 { function = "pwm"; termination = "no_pulling"; drive_strength_mA = < 16 >; }; // Right audio | ||
| pin@p46 { function = "input"; termination = "no_pulling"; polarity = "active_low"; }; // Hotplug | ||
| pin@p47 { function = "output"; termination = "pull_down"; }; // activity LED | ||
| pin@p48 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD CLK | ||
| pin@p49 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD CMD | ||
| pin@p50 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D0 | ||
| pin@p51 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D1 | ||
| pin@p52 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D2 | ||
| pin@p53 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D3 | ||
| }; // pin_config | ||
| pin_defines { | ||
| pin_define@HDMI_CONTROL_ATTACHED { | ||
| type = "internal"; | ||
| number = <46>; | ||
| }; | ||
| pin_define@NUM_CAMERAS { | ||
| type = "internal"; | ||
| number = <1>; | ||
| }; | ||
| pin_define@CAMERA_0_I2C_PORT { | ||
| type = "internal"; | ||
| number = <0>; | ||
| }; | ||
| pin_define@CAMERA_0_SDA_PIN { | ||
| type = "internal"; | ||
| number = <28>; | ||
| }; | ||
| pin_define@CAMERA_0_SCL_PIN { | ||
| type = "internal"; | ||
| number = <29>; | ||
| }; | ||
| pin_define@CAMERA_0_SHUTDOWN { | ||
| type = "internal"; | ||
| number = <41>; | ||
| }; | ||
| pin_define@CAMERA_0_UNICAM_PORT { | ||
| type = "internal"; | ||
| number = <1>; | ||
| }; | ||
| pin_define@CAMERA_0_LED { | ||
| type = "internal"; | ||
| number = <32>; | ||
| }; | ||
| pin_define@FLASH_0_ENABLE { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@FLASH_0_INDICATOR { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@FLASH_1_ENABLE { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@FLASH_1_INDICATOR { | ||
| type = "absent"; | ||
| }; | ||
| pin_define@POWER_LOW { | ||
| type = "internal"; | ||
| number = <35>; | ||
| }; | ||
| pin_define@LEDS_DISK_ACTIVITY { | ||
| type = "internal"; | ||
| number = <47>; | ||
| }; | ||
| pin_define@LAN_RESET { | ||
| type = "internal"; | ||
| number = <31>; | ||
| }; | ||
| }; // pin_defines | ||
| }; // pins | ||
| pins_cm { | ||
| pin_config { | ||
| pin@default { | ||
| polarity = "active_high"; | ||
| termination = "pull_down"; | ||
| startup_state = "inactive"; | ||
| function = "input"; | ||
| }; // pin | ||
| pin@p14 { function = "uart0"; termination = "no_pulling"; }; // TX uart0 | ||
| pin@p15 { function = "uart0"; termination = "pull_up"; }; // RX uart0 | ||
| pin@p48 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD CLK | ||
| pin@p49 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD CMD | ||
| pin@p50 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D0 | ||
| pin@p51 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D1 | ||
| pin@p52 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D2 | ||
| pin@p53 { function = "sdcard"; termination = "pull_up"; drive_strength_mA = < 8 >; }; // SD D3 | ||
| }; // pin_config | ||
| pin_defines { | ||
| }; // pin_defines | ||
| }; // pins_cm | ||
| }; | ||
| }; | ||
| ``` |
Oops, something went wrong.