New image sensors for 10393

From ElphelWiki
Jump to: navigation, search


This page describes development and testing of any new sensors for 10393 system boards. It covers a driver-less mode where python scripts are used to get the first images and the sensor driver structure.

Application notes

Driverless mode

Developing a driver

Fig.1 Sensor driver
Fig.2 FPGA has a certain 256-line table (for all ports)

Device tree

  • record for sensor, like:
elphel393_mt9f002: elphel393-mt9f002@0 {
    compatible = "elphel,elphel393-mt9f002-1.00";
  • record for sensor i2c address, like:
elphel393_sensor_i2c: elphel393-sensor-i2c@0 {
    compatible = "elphel,elphel393-sensor-i2c-1.00";
    /* Add known devices: name, slave address (7-bit), number of address bytes, number of data bytes, SCL frequency (kHz) */
    elphel393-sensor-i2c,i2c_devices = "mt9f002        0x10 2 2 500",
                                       "mt9p006        0x48 1 2 500",
                                       "el10359        0x08 1 2 500",
                                       "el10359_32     0x08 1 4 500",
                                       "pca9500_eeprom 0x50 1 1 100",
                                       "sensor_eeprom  0x50 1 1 100",
                                       "sensor_temp    0x18 1 2 100",
                                       "cy22393        0x69 1 1 100";
  • edit detected sensors:
elphel393_detect_sensors: elphel393-detect_sensors@0 {
    compatible = "elphel,elphel393-detect_sensors-1.00";
    elphel393-detect_sensors,port-mux = "none none none none"; /* "none", "detect" or "mux10359" */
    elphel393-detect_sensors,sensors =  "mt9f002", // Line per port, may contain up to 4 sensors (3 with 10359)

Add a proper application

  • In autocampars.php
  • Set application through 10389's serial or more preferably through /etc/elphel393/default_10389.xml in a 10389-less setup

Driver code

  • In linux-elphel/src/drivers/elphel/
    • Create mt9f002.h and mt9f002.c
    • Add to Makefile:
obj-$(CONFIG_ELPHEL393) += mt9f002.o
    • Edit pgm_functions.c
    • mt9f002.h - fill with registers addresses (from sensor's datasheet) and other constants
    • mt9f002.c:
mt9f002_par2addr table
mt9f002_pages table
mt9f002_ahead_tab - no need to edit in the beginning
sensor_t structure - some fields are used, some - not
mt9f002_inits - registers that must be initialized
mt9f002_pgm_detectsensor func - remove mrst and read id via i2c, register other functions
mt9f002_pgm_initsensor func - applies init i2c commands, cable phase adjustment, gain table and shadow regs
mt9f002_pgm_sensorin func - this just set MT9F002_VACT_DELAY because of sensor's specifics
mt9f002_pgm_window func   - uses mt9f002_pgm_window_common
mt9f002_pgm_window_safe func - uses mt9f002_pgm_window_common
mt9f002_pgm_window_common func - change window, also sets horizontal blanking
mt9f002_pgm_gains func
mt9f002_pgm_limitfps func
mt9f002_pgm_exposure func
mt9f002_pgm_triggermode func