{
	"ver": "0.01",
	"module": "visible_lens",
	"title": "可见光镜头模块", 
	"description": "描述了可见光镜头模块的RPC接口和参数，以及状态上报的主题和数据", 
	"author":"基础平台室 王全全",
	"date":"2022-10-12",
	"copyright":"高德红外",	
	"RPC": [
		{
			"func": "lens_init",
			"title": "镜头初始化",
			"examples": [
				{
					"ver": "0.01",
					"func": "lens_init",
					"id": 0
				}
			]
		},
		{
			"func": "zoom_set",
			"title": "变倍设置",
			"description": "光学变倍设置",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "倍数比",
					"description": "变倍值, 通过百分比表示",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0.1
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "zoom_set",
					"id": 0,
					"params": {
						"value": 20
					}
				}
			]
		},
		{
			"func": "zoom_inc",
			"title": "变倍+",
			"description": "变倍长焦增加",
			"params": {
				"step": {
					"$id": "#root/step",
					"title": "步长",
					"description": "变倍步长, 通过百分比表示, 如果不设置, 则由各个模块自定义的默认速度增加，如果为100, 则表示直接调整到最大值",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0.1
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "zoom_inc",
					"id": 0,
					"params": {
						"step": 20
					}
				}
			]
		},
		{
			"func": "zoom_dec",
			"title": "变倍-",
			"description": "变倍广角增加",
			"params": {
				"step": {
					"$id": "#root/step",
					"title": "步长",
					"description": "变倍步长, 通过百分比表示, 如果不设置, 则由各个模块自定义的默认速度增加，如果为100, 则表示直接调整到最大值",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0.1
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "zoom_wide_angle",
					"id": 0,
					"params": {
						"step": 20
					}
				}
			]
		},
		{
			"func": "zoom_stop",
			"title": "变倍停止",
			"description": "停止变倍, 针对所有变倍的操作, 都可以停止",
			"examples": [
				{
					"ver": "0.01",
					"func": "zoom_stop",
					"id": 0
				}
			]
		},
		{
			"func": "zoom_digital_on",
			"title": "数字变倍开",			
			"description": "打开数字变倍, 目前很多镜头不支持数字变倍",
			"examples": [
				{
					"ver": "0.01",
					"func": "zoom_digital_on",
					"id": 0
				}
			]
		},
		{
			"func": "zoom_digital_off",
			"title": "数字变倍关",			
			"description": "关闭数字变倍, 目前很多镜头不支持数字变倍",
			"examples": [
				{
					"ver": "0.01",
					"func": "zoom_digital_on",
					"id": 0
				}
			]
		},
		{
			"func": "zoom_digital_set",
			"title": "数字变倍设置",			
			"description": "数字变倍设置, 默认是依赖于zoom_digital_on, 目前很多镜头不支持数字变倍",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "倍数比",
					"description": "变倍值, 通过百分比表示",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0.1
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "zoom_digital_set",
					"id": 0,
					"params": {
						"value": 20
					}
				}
			]
		},
		{
			"func": "focus_mode_set",
			"title": "调焦模式设置",
			"description": "调焦模式设置, 默认有很多场景是依赖于手动调焦模式的",
			"params": {
				"type": {
					"$id": "#root/type",
					"title": "模式",
					"description": "变焦模式",
					"isMust": true,
					"type": "string",
					"enum": [
						"MF",
						"AF",
						"AF_S",
						"AF_C"
					],
					"enum_zh": [
						"手动对焦",
						"自动对焦",
						"单次自动对焦",
						"连续自动对焦"
					]
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "focus_mode",
					"id": 0,
					"params": {
						"type": "AF"
					}
				}
			]
		},
		{
			"func": "focus_mode_get",
			"title": "调焦模式获取",
			"description": "调焦模式获取, 默认有很多场景是依赖于手动调焦模式的",
			"examples": [
				{
					"ver": "0.01",
					"func": "focus_mode_get",
					"id": 0
				}
			]
		},
		{
			"func": "focus_inc",
			"title": "变焦+",
			"description": "远焦增加, 默认在手动对焦模式下使用",
			"examples": [
				{
					"ver": "0.01",
					"func": "focus_far",
					"id": 0
				}
			]
		},
		{
			"func": "focus_dec",
			"title": "变焦-",
			"description": "近焦增加, 默认在手动对焦模式下使用",
			"examples": [
				{
					"ver": "0.01",
					"func": "focus_near",
					"id": 0
				}
			]
		},
		{
			"func": "focus_set",
			"title": "聚焦设置",
			"description": "聚焦设置, 默认在手动对焦模式下使用",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "聚焦值",
					"description": "聚焦值, 通过百分比表示",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0.1
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "focus_set",
					"id": 0,
					"params": {
						"value": 20
					}
				}
			]
		},
		{
			"func": "focus_stop",
			"title": "聚焦停止",
			"description": "聚焦停止, 针对所有聚焦的操作, 都可以停止",
			"examples": [
				{
					"ver": "0.01",
					"func": "focus_stop",
					"id": 0
				}
			]
		},
		{
			"func": "focus_af_sensitivity",
			"title": "自动聚焦灵敏度",
			"description": "自动聚焦灵敏度, 默认在自动对焦模式下使用",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "水平",
					"description": "灵敏度水平",
					"isMust": true,
					"type": "string",
					"enum": [
						"noraml",
						"low"
					],
					"enum_zh": [
						"普通",
						"低"
					]
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "focus_af_sensitivity",
					"id": 0,
					"params": {
						"value": "noraml"
					}
				}
			]
		},
		{
			"func": "wb_mode",
			"title": "白平衡模式",
			"description": "白平衡模式设置",
			"params": {
				"type": {
					"$id": "#root/type",
					"title": "类型",
					"description": "类型",
					"isMust": true,
					"type": "string",
					"enum": [
						"awb_1",
						"wb_indoor",
						"wb_outdoor",
						"awb_2",
						"mwb",
						"wb_sodium_lamp",
						"wb_fluorescent_lamp"
					],
					"enum_zh": [
						"自动白平衡模式1",
						"室内白平衡模式",
						"室外白平衡模式",
						"自动白平衡模式2",
						"手动白平衡模式",
						"钠灯白平衡模式",
						"日光灯白平衡模式"
					]
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "wb_mode",
					"id": 0,
					"params": {
						"type": "awb_1"
					}
				}
			]
		},
		{
			"func": "exposure_mode",
			"title": "曝光模式",
			"description": "曝光模式设置",
			"params": {
				"type": {
					"$id": "#root/type",
					"title": "类型",
					"description": "类型",
					"isMust": true,
					"type": "string",
					"enum": [
						"P",
						"M",
						"TV",
						"AV"
					],
					"enum_zh": [
						"自动曝光",
						"手动曝光",
						"快门优先",
						"光圈优先"
					]
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "exposure_mode",
					"id": 0,
					"params": {
						"type": "P"
					}
				}
			]
		},
		{
			"func": "shutter_mode",
			"title": "快门模式设置",
			"description": "快门模式设置, 可见光模块通常是不需要设置的，红外可能需要设置",
			"params": {
				"type": {
					"$id": "#root/type",
					"title": "类型",
					"description": "类型",
					"isMust": true,
					"type": "string",
					"enum": [
						"A",
						"M"
					],
					"enum_zh": [
						"自动快门",
						"手动快门"
					]
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "shutter_mode",
					"id": 0,
					"params": {
						"type": "A"
					}
				}
			]
		},
		{
			"func": "shutter_reset",
			"title": "快门速度默认",
			"description": "快门速度默认",
			"examples": [
				{
					"ver": "0.01",
					"func": "shutter_reset",
					"id": 0
				}
			]
		},
		{
			"func": "shutter_inc",
			"title": "快门速度增加",
			"description": "快门速度增加",
			"examples": [
				{
					"ver": "0.01",
					"func": "shutter_inc",
					"id": 0
				}
			]
		},
		{
			"func": "shutter_dec",
			"title": "快门速度减少",
			"description": "快门速度减少",
			"examples": [
				{
					"ver": "0.01",
					"func": "shutter_dec",
					"id": 0
				}
			]
		},
		{
			"func": "shutter_set",
			"title": "快门速度设置",
			"description": "快门速度设置, 在exposure_mode设置快门优先下和手动曝光模式下起效",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "速度",
					"description": "快门速度",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0.1
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "shutter_set",
					"id": 0,
					"params": {
						"value": 20
					}
				}
			]
		},
		{
			"func": "shutter_slow_mode",
			"title": "慢快门模式设置",
			"description": "慢快门模式设置",
			"params": {
				"type": {
					"$id": "#root/value",
					"title": "速度",
					"description": "快门速度",
					"isMust": true,
					"type": "string",
					"enum": [
						"ON",
						"OFF",
						"ON_25_3",
						"ON_25_4",
						"ON_25_5",
						"ON_25_6"
					],
					"enum_zh": [
						"慢快门开",
						"慢快门关",
						"慢快门1/25*3",
						"慢快门1/25*4",
						"慢快门1/25*5",
						"慢快门1/25*6"
					]
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "shutter_slow_mode",
					"id": 0,
					"params": {
						"type": "ON"
					}
				}
			]
		},		
		{
			"func": "backlight_compensation_on",
			"title": "背光补偿打开",
			"description": "背光补偿打开",
			"examples": [
				{
					"ver": "0.01",
					"func": "backlight_compensation_on",
					"id": 0
				}
			]
		},
		{
			"func": "backlight_compensation_off",
			"title": "背光补偿关闭",
			"description": "背光补偿关闭",
			"examples": [
				{
					"ver": "0.01",
					"func": "backlight_compensation_off",
					"id": 0
				}
			]
		},
		{
			"func": "backlight_compensation_move",
			"title": "背光补偿区域移动",
			"description": "背光补偿区域移动",
			"params": {
				"type": {
					"$id": "#root/type",
					"title": "方位",
					"description": "方位",
					"isMust": true,
					"type": "string",
					"enum": [						
						"TOP",
						"DOWN",
						"LEFT",
						"RIGHT"
						
					],
					"enum_zh": [
						"上",
						"下",
						"左",
						"右"
					]
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "backlight_compensation_move",
					"id": 0,
					"params": {
						"type": "TOP"
					}
				}
			]
		},
		{
			"func": "aperture_reset",
			"title": "光圈大小复位",
			"description": "光圈大小复位",
			"examples": [
				{
					"ver": "0.01",
					"func": "aperture_reset",
					"id": 0
				}
			]
		},
		{
			"func": "aperture_inc",
			"title": "光圈+",
			"description": "光圈大小增加",
			"examples": [
				{
					"ver": "0.01",
					"func": "aperture_inc",
					"id": 0
				}
			]
		},
		{
			"func": "aperture_dec",
			"title": "光圈-",
			"description": "光圈大小减少",
			"examples": [
				{
					"ver": "0.01",
					"func": "aperture_dec",
					"id": 0
				}
			]
		},
		{
			"func": "aperture_set",
			"title": "光圈大小设置",
			"description": "光圈大小设置",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "速度",
					"description": "快门速度",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0.1
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "aperture_set",
					"id": 0,
					"params": {
						"value": 20
					}
				}
			]
		},
		{
			"func": "sharpness_reset",
			"title": "清晰度复位",
			"description": "清晰度复位",
			"examples": [
				{
					"ver": "0.01",
					"func": "sharpness_reset",
					"id": 0
				}
			]
		},		
		{
			"func": "sharpness_inc",
			"title": "清晰度增加",
			"description": "清晰度增加",
			"examples": [
				{
					"ver": "0.01",
					"func": "sharpness_inc",
					"id": 0
				}
			]
		},
		{
			"func": "sharpness_dec",
			"title": "清晰度减少",
			"description": "清晰度减少",
			"examples": [
				{
					"ver": "0.01",
					"func": "sharpness_dec",
					"id": 0
				}
			]
		},
		{
			"func": "sharpness_set",
			"title": "清晰度设置",
			"description": "清晰度设置",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "清晰度",
					"description": "清晰度",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0.1
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "sharpness_set",
					"id": 0,
					"params": {
						"value": 20
					}
				}
			]
		},
		{
			"func": "foggy_on",
			"title": "透雾打开",
			"description": "透雾打开",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "水平",
					"description": "水平",
					"isMust": true,
					"type": "string",
					"enum": [
						"low",
						"middle",
						"high"
					],
					"enum_zh": [
						"低",
						"中",
						"高"
					]
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "foggy_on",
					"id": 0,
					"params": {
						"value": "low"
					}
				}
			]
		},
		{
			"func": "foggy_off",
			"title": "透雾关闭",
			"description": "透雾关闭",
			"examples": [
				{
					"ver": "0.01",
					"func": "foggy_off",
					"id": 0
				}
			]
		},
		{
			"func": "wdr_on",
			"title": "宽动态开",
			"description": "宽动态开",
			"examples": [
				{
					"ver": "0.01",
					"func": "wdr_on",
					"id": 0
				}
			]
		},
		{
			"func": "wdr_off",
			"title": "宽动态关",
			"description": "宽动态关",
			"examples": [
				{
					"ver": "0.01",
					"func": "wdr_off",
					"id": 0
				}
			]
		},
		{
			"func": "hor_mirror_on",
			"title": "水平镜像开",
			"description": "水平镜像开",
			"examples": [
				{
					"ver": "0.01",
					"func": "wdr_on",
					"id": 0
				}
			]
		},
		{
			"func": "hor_mirror_off",
			"title": "水平镜像关",
			"description": "水平镜像关",
			"examples": [
				{
					"ver": "0.01",
					"func": "wdr_off",
					"id": 0
				}
			]
		},
		{
			"func": "ver_mirror_on",
			"title": "垂直镜像开",
			"description": "垂直镜像开",
			"examples": [
				{
					"ver": "0.01",
					"func": "wdr_on",
					"id": 0
				}
			]
		},
		{
			"func": "ver_mirror_off",
			"title": "垂直镜像关",
			"description": "垂直镜像关",
			"examples": [
				{
					"ver": "0.01",
					"func": "wdr_off",
					"id": 0
				}
			]
		},
		{
			"func": "icr_filter_mode",
			"title": "ICR滤光片模式",
			"description": "ICR滤光片模式",
			"params": {
				"type": {
					"$id": "#root/type",
					"title": "类型",
					"description": "类型",
					"isMust": true,
					"type": "string",
					"enum": [
						"night",
						"daytime"
					],
					"enum_zh": [
						"黑夜",
						"白天"
					]
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "icr_filter_mode",
					"id": 0,
					"params": {
						"type": "night"
					}
				}
			]
		},
	
		{
			"func": "icr_auto_mode",
			"title": "自动ICR模式",
			"description": "自动ICR模式",
			"params": {
				"type": {
					"$id": "#root/type",
					"title": "类型",
					"description": "类型",
					"isMust": true,
					"type": "string",
					"enum": [
						"on",
						"off"
					],
					"enum_zh": [
						"打开",
						"关闭"
					]
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "icr_auto_mode",
					"id": 0,
					"params": {
						"type": "on"
					}
				}
			]
		},
		{
			"func": "icr_auto_sensitivity",
			"title": "自动ICR灵敏度",
			"description": "自动ICR灵敏度, 曝光模式为自动、光圈优先、快门优先是自动 ICR 有效",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "水平",
					"description": "灵敏度水平",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0.1
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "icr_auto_sensitivity",
					"id": 0,
					"params": {
						"value": 20
					}
				}
			]
		},
		{
			"func": "luma_set",
			"title": "亮度设置",
			"description": "亮度设置",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "亮度",
					"description": "亮度",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "luma_set",
					"id": 0,
					"params": {
						"value": 20
					}
				}
			]
		},
		{
			"func": "contrast_set",
			"title": "对比度设置",
			"description": "对比度设置",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "对比度",
					"description": "对比度",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "contrast_set",
					"id": 0,
					"params": {
						"value": 20
					}
				}
			]
		},	
		{
			"func": "hue_set",
			"title": "色调设置",
			"description": "色调设置",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "色调",
					"description": "色调",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "hue_set",
					"id": 0,
					"params": {
						"value": 20
					}
				}
			]
		},
		{
			"func": "satuature_set",
			"title": "饱和度设置",
			"description": "饱和度设置",
			"params": {
				"value": {
					"$id": "#root/value",
					"title": "饱和度",
					"description": "饱和度",
					"isMust": true,
					"type": "number",
					"max": 100,
					"min": 0
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"func": "satuature_set",
					"id": 0,
					"params": {
						"value": 20
					}
				}
			]
		}
	],
	"Report": [
		{
			"topic": "lens",
			"title": "镜头状态",
			"state": {
				"temp": {
					"$id": "#root/temp",
					"title": "温度",
					"type": "number"
				},
				"focus": {
					"$id": "#root/focus",
					"title": "焦距",
					"type": "number"
				},
				"fov": {
					"$id": "#root/fov",
					"title": "视场角",
					"type": "number"
				},
				"sharpness": {
					"$id": "#root/sharpness",
					"title": "清晰度",
					"type": "number"
				}
			},
			"examples": [
				{
					"ver": "0.01",
					"temp": 9,
					"focus": 9,
					"fov": 9,
					"sharpness": 2
				}
			]
		}
	]
}