Difference between revisions of "Mv mipi i2c.sh user guide"
Line 3: | Line 3: | ||
=== Overview === | === Overview === | ||
The mv_mipi_i2c.sh script is a tool set for configuring MV MIPI series cameras through the I2C. | The mv_mipi_i2c.sh script is a tool set for configuring MV MIPI series cameras through the I2C. | ||
+ | |||
+ | This script is essentially an access to registers. For registers, please refer to [[MV Series MIPI Camera Register Map]]. | ||
=== Raspberry Pi Only, Set IO config === | === Raspberry Pi Only, Set IO config === | ||
Line 45: | Line 47: | ||
[[I2c bus number and video node|i2c bus number on different boards]] | [[I2c bus number and video node|i2c bus number on different boards]] | ||
===Functions list=== | ===Functions list=== | ||
+ | The camera has two states, '''standby''' and '''running''', after the start of image acquisition into the '''running''' state. | ||
+ | |||
+ | There are some registers that are write-protected in the running state, which will be marked with an asterisk. For example: '''''trgsrc*''''' ''.'' | ||
+ | |||
+ | There are some parameters that have strict range restrictions, and it's a good idea to try reading them when you're in doubt. | ||
==== Basic Parameters ==== | ==== Basic Parameters ==== | ||
− | <br /> | + | |
+ | ===== manufacturer ===== | ||
+ | <code>./mv_mipi_i2c.sh -r -f manufacturer</code> | ||
+ | |||
+ | Get the manufacturer name, which is '''VEYE'''. | ||
+ | |||
+ | ===== model ===== | ||
+ | <code>./mv_mipi_i2c.sh -r -f model</code> | ||
+ | |||
+ | Get the product model, such as MV-MIPI-IMX178. | ||
+ | |||
+ | ===== version ===== | ||
+ | <code>./mv_mipi_i2c.sh -r -f version</code> | ||
+ | |||
+ | Get the Controller version number and Logical version number. | ||
+ | |||
+ | The system has two main control chips that serve the control and logic functions respectively. | ||
+ | |||
+ | ===== timestamp ===== | ||
+ | <code>./mv_mipi_i2c.sh -r -f timestamp</code> | ||
+ | |||
+ | Time after system startup in Milliseconds. | ||
+ | |||
+ | This value starts counting again if you call the reboot command, or if the camera reboots unexpectedly. | ||
+ | |||
+ | ===== errcode ===== | ||
+ | <code>./mv_mipi_i2c.sh -r -f errcode</code> | ||
+ | |||
+ | System error code, each bit represents an error type. | ||
+ | |||
+ | bit0: sensor error. | ||
+ | |||
+ | bit1: Logic module startup error. | ||
+ | |||
+ | bit2: Logic module communication error. | ||
+ | |||
+ | bit5: AA(AE&AG) regulation cannot reach the target brightness. | ||
+ | |||
+ | bit6: Authorization failure. | ||
+ | |||
+ | ===== factoryparam ===== | ||
+ | <code>./mv_mipi_i2c.sh -w -f factoryparam</code> | ||
+ | |||
+ | All parameters restored to factory default values. | ||
+ | |||
+ | ===== paramsave ===== | ||
+ | <code>./mv_mipi_i2c.sh -w -f paramsave</code> | ||
+ | |||
+ | Save all parameters to flash, and they will not be lost when power off. | ||
+ | |||
+ | ===== reboot ===== | ||
+ | <code>./mv_mipi_i2c.sh -w -f reboot</code> | ||
+ | |||
+ | Reboot the camera. | ||
+ | |||
+ | ===== i2caddr ===== | ||
+ | <code>./mv_mipi_i2c.sh -w -f i2caddr -p1 [new]</code> | ||
+ | |||
+ | <code>./mv_mipi_i2c.sh -r -f i2caddr</code> <br />This module support i2c address changed by software, i2c address range[0x3,0x77]. | ||
+ | |||
+ | Only after paramsave and reboot will it really take effect. | ||
==== Image Acquisition ==== | ==== Image Acquisition ==== |
Revision as of 18:12, 7 March 2022
mv_mipi_i2c.sh Shell scripts usage
1 Overview
The mv_mipi_i2c.sh script is a tool set for configuring MV MIPI series cameras through the I2C.
This script is essentially an access to registers. For registers, please refer to MV Series MIPI Camera Register Map.
2 Raspberry Pi Only, Set IO config
Running
./enable_i2c_vc.sh
./camera_i2c_config
first,it will config IO pin. Then you can run mv_mipi_i2c.sh.
3 mv_mipi_i2c.sh USAGE
./mv_mipi_i2c.sh
Usage: ./mv_mipi_i2c.sh [-r/w] [-f] function name -p1 param1 -p2 param2 -b bus
options:
-r read
-w write
-f [function name] function name
-p1 [param1] param1 of each function
-p2 [param1] param2 of each function
-p3 [param3] param3 of each function
-p4 [param4] param4 of each function
-b [i2c bus num] i2c bus number
-d [i2c addr] i2c addr if not default 0x3b
Please open this srcipt and read the COMMENT on top for support functions and samples
4 i2c bus number on different board
Please refer to the following article to determine which -b parameter you need to use.
i2c bus number on different boards
5 Functions list
The camera has two states, standby and running, after the start of image acquisition into the running state.
There are some registers that are write-protected in the running state, which will be marked with an asterisk. For example: trgsrc* .
There are some parameters that have strict range restrictions, and it's a good idea to try reading them when you're in doubt.
5.1 Basic Parameters
5.1.1 manufacturer
./mv_mipi_i2c.sh -r -f manufacturer
Get the manufacturer name, which is VEYE.
5.1.2 model
./mv_mipi_i2c.sh -r -f model
Get the product model, such as MV-MIPI-IMX178.
5.1.3 version
./mv_mipi_i2c.sh -r -f version
Get the Controller version number and Logical version number.
The system has two main control chips that serve the control and logic functions respectively.
5.1.4 timestamp
./mv_mipi_i2c.sh -r -f timestamp
Time after system startup in Milliseconds.
This value starts counting again if you call the reboot command, or if the camera reboots unexpectedly.
5.1.5 errcode
./mv_mipi_i2c.sh -r -f errcode
System error code, each bit represents an error type.
bit0: sensor error.
bit1: Logic module startup error.
bit2: Logic module communication error.
bit5: AA(AE&AG) regulation cannot reach the target brightness.
bit6: Authorization failure.
5.1.6 factoryparam
./mv_mipi_i2c.sh -w -f factoryparam
All parameters restored to factory default values.
5.1.7 paramsave
./mv_mipi_i2c.sh -w -f paramsave
Save all parameters to flash, and they will not be lost when power off.
5.1.8 reboot
./mv_mipi_i2c.sh -w -f reboot
Reboot the camera.
5.1.9 i2caddr
./mv_mipi_i2c.sh -w -f i2caddr -p1 [new]
./mv_mipi_i2c.sh -r -f i2caddr
This module support i2c address changed by software, i2c address range[0x3,0x77].
Only after paramsave and reboot will it really take effect.
5.2 Image Acquisition
5.3 Image Features
5.4 ISP
5.5 IO Control
5.6 Special Functions