凯视佳产品文档 产品文档与技术支持

KSJAPI SDK · IO 与闪光灯

版本 1.0 · 更新于 2026-10-21 · 阅读 0

GPIO 方向与状态、闪光灯控制、输入输出模式切换、输入滤波、DAC。

本组接口来自 KSJApiIo.h。

GPIO0 引脚只能定义为外触发信号线或普通输入；GPIO1 引脚与闪光灯控制线共用。
KSJ_GpioInMode* / KSJ_GpioOutMode* 系列仅适用于 YYO 型号相机（帧存带光耦），
使用前应通过 KSJ_QueryFunction(KSJ_SUPPORT_GPIO_NORMAL) 确认支持。

函数一览

函数 说明
KSJ_GpioSetDirection 设置 IO 为输入或输出（按位：bit0 = GPIO0，bit1 = GPIO1）。
KSJ_GpioGetDirection 获取 IO 方向设置。
KSJ_GpioSetStatus 对输出引脚设置输出状态。
KSJ_GpioGetStatus 读取输入 IO 引脚状态。
KSJ_FlashControlSet 设置闪光灯（使能、信号翻转、模式）。
KSJ_FlashControlGet 获取闪光灯使能、翻转与模式。
KSJ_FlashEnableSet 设置闪光灯使能。
KSJ_FlashEnableGet 获取闪光灯使能状态。
KSJ_FlashInvertSet 设置闪光灯信号翻转。
KSJ_FlashInvertGet 获取闪光灯信号翻转状态。
KSJ_GpioInModeSet 设置外触发输入引脚工作模式（仅 YYO 型号）。
KSJ_GpioInModeGet 读取外触发输入引脚工作模式。
KSJ_GpioInStatusGet 当输入引脚为普通输入模式时，读取输入状态（BIT0 为该引脚电平）。
KSJ_GpioOutModeSet 设置闪光灯输出引脚工作模式。
KSJ_GpioOutModeGet 读取闪光灯输出引脚工作模式。
KSJ_GpioOutStatusSet 输出引脚为普通模式时，控制其状态（BIT1 为该引脚电平）。
KSJ_GpioFilterSet 设置外触发输入的滤波时长（微秒）。
KSJ_GpioFilterGet 读取外触发输入滤波时长（0 表示默认 200ns 滤波）。
KSJ_DACSet 设置 DAC 的数字量。
KSJ_DACGet 读取 DAC 的数字量。

关键函数详解

KSJ_FlashControlSet

int __stdcall KSJ_FlashControlSet(int nIndex, bool bEnable, bool bInvert, int nMode);

设置闪光灯（使能、信号翻转、模式）。

返回：成功返回 RET_SUCCESS(1)

说明

  • 闪光灯控制线与 GPIO1 是同一引脚：使能闪光灯后 GPIO1 不能再作普通 IO。
  • 不翻转（bInvert = false）时闪光灯信号为 TTL 高电平，翻转时为 TTL 低电平。

KSJ_GpioInModeSet

int __stdcall KSJ_GpioInModeSet(int nIndex, KSJ_GPIOIN_MODE GpioInMode);

设置外触发输入引脚工作模式（仅 YYO 型号）。

返回：成功返回 RET_SUCCESS(1)

说明

  • 外触发模式下不可设为 KSJ_GPIOIN_NORMAL，须先切换到非外触发模式再设置。
  • 用户设为外触发模式时，相机自动置为 KSJ_GPIOIN_EXTERNALTRIGGER。