digital_cam_i2c module

Digital Photo Camera Triggering (using a I2C channel)

This module controls triggering of an attached device via an I2C command. Typically a remote microcontroller (atmega/arduino) will then use the triggering/zoom/power commands. Using the PAYLOAD_COMMAND, all functions of the camera can be controlled.

Example for airframe file

Add to your firmware section: This example contains all possible configuration options, not all of them are mandatory!

<module name="digital_cam_i2c">
  b'<configure name="ATMEGA_I2C_DEV" value="i2cX" />\n    '
</module>

Module configuration options

Configure Options

• name: ATMEGA_I2C_DEV value: i2cX
  Description: select which i2c peripheral to use (default i2c0)

Airframe file section

• section name: DIGITAL_CAM prefix: DC_
  • name SHOOT_ON_BUTTON_RELEASE value: None

Module functions

Init Functions

These initialization functions are called once on startup.

• atmega_i2c_cam_ctrl_init()

Event Functions

These event functions are called in each cycle of the module event loop.

• atmega_i2c_cam_ctrl_event()

Periodic Functions

These functions are called periodically at the specified frequency from the module periodic loop.

• atmega_i2c_cam_ctrl_periodic()
  • Frequency in Hz: 10
  • Autorun: TRUE
    Periodic function automatically starts after init.

Datalink Functions

Whenever the specified datalink message is received, the corresponing handler function is called.

• on message PAYLOAD_COMMAND call ParseCameraCommand(buf)

Files

Header Files

The following headers are automatically included in modules.h

• atmega_i2c_cam_ctrl.h

Source Files

• modules/digital_cam/atmega_i2c_cam_ctrl.c
• modules/digital_cam/sim_i2c_cam_ctrl.c

Raw digital_cam_i2c.xml file:

<!DOCTYPE module SYSTEM "module.dtd">
 
<module name="digital_cam_i2c" dir="digital_cam">
  <doc>
    <description>
      Digital Photo Camera Triggering (using a I2C channel)
 
      This module controls triggering of an attached device via an I2C command.
      Typically a remote microcontroller (atmega/arduino) will then use the triggering/zoom/power commands.
      Using the PAYLOAD_COMMAND, all functions of the camera can be controlled.
    </description>
    <configure name="ATMEGA_I2C_DEV" value="i2cX" description="select which i2c peripheral to use (default i2c0)"/>
    <section name="DIGITAL_CAM" prefix="DC_">
      <define name="SHOOT_ON_BUTTON_RELEASE" />
    </section>
  </doc>
  <dep>
    <depends>digital_cam_common</depends>
    <conflicts>digital_cam_gpio,digital_cam_servo,digital_cam_uart,digital_cam_video,digital_cam_pprzlink</conflicts>
  </dep>
  <header>
    <file name="atmega_i2c_cam_ctrl.h"/>
  </header>
  <init fun="atmega_i2c_cam_ctrl_init()"/>
  <periodic fun="atmega_i2c_cam_ctrl_periodic()"  autorun="TRUE" freq="10"/>
  <event fun="atmega_i2c_cam_ctrl_event()"/>
  <datalink message="PAYLOAD_COMMAND" fun="ParseCameraCommand(buf)"/>
 
  <makefile target="ap">
    <configure name="ATMEGA_I2C_DEV" default="i2c0" case="upper|lower"/>
    <define name="USE_$(ATMEGA_I2C_DEV_UPPER)"/>
    <define name="ATMEGA_I2C_DEV" value="$(ATMEGA_I2C_DEV_LOWER)"/>
    <file name="atmega_i2c_cam_ctrl.c"/>
    <test firmware="rotorcraft">
      <define name="DOWNLINK_TRANSPORT" value="pprz_tp"/>
      <define name="DOWNLINK_DEVICE" value="uart0"/>
      <define name="USE_UART0"/>
      <define name="USE_I2C0"/>
    </test>
  </makefile>
 
  <makefile target="sim">
    <file name="sim_i2c_cam_ctrl.c"/>
    <test firmware="rotorcraft">
      <define name="DOWNLINK_TRANSPORT" value="pprz_tp"/>
      <define name="DOWNLINK_DEVICE" value="uart0"/>
      <define name="USE_UART0"/>
    </test>
  </makefile>
 
</module>