pwc-v4l.c 29 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052
  1. /* Linux driver for Philips webcam
  2. USB and Video4Linux interface part.
  3. (C) 1999-2004 Nemosoft Unv.
  4. (C) 2004-2006 Luc Saillard (luc@saillard.org)
  5. (C) 2011 Hans de Goede <hdegoede@redhat.com>
  6. NOTE: this version of pwc is an unofficial (modified) release of pwc & pcwx
  7. driver and thus may have bugs that are not present in the original version.
  8. Please send bug reports and support requests to <luc@saillard.org>.
  9. The decompression routines have been implemented by reverse-engineering the
  10. Nemosoft binary pwcx module. Caveat emptor.
  11. This program is free software; you can redistribute it and/or modify
  12. it under the terms of the GNU General Public License as published by
  13. the Free Software Foundation; either version 2 of the License, or
  14. (at your option) any later version.
  15. This program is distributed in the hope that it will be useful,
  16. but WITHOUT ANY WARRANTY; without even the implied warranty of
  17. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  18. GNU General Public License for more details.
  19. You should have received a copy of the GNU General Public License
  20. along with this program; if not, write to the Free Software
  21. Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  22. */
  23. #include <linux/errno.h>
  24. #include <linux/init.h>
  25. #include <linux/mm.h>
  26. #include <linux/module.h>
  27. #include <linux/poll.h>
  28. #include <linux/vmalloc.h>
  29. #include <linux/jiffies.h>
  30. #include <asm/io.h>
  31. #include "pwc.h"
  32. #define PWC_CID_CUSTOM(ctrl) ((V4L2_CID_USER_BASE | 0xf000) + custom_ ## ctrl)
  33. static int pwc_g_volatile_ctrl(struct v4l2_ctrl *ctrl);
  34. static int pwc_s_ctrl(struct v4l2_ctrl *ctrl);
  35. static const struct v4l2_ctrl_ops pwc_ctrl_ops = {
  36. .g_volatile_ctrl = pwc_g_volatile_ctrl,
  37. .s_ctrl = pwc_s_ctrl,
  38. };
  39. enum { awb_indoor, awb_outdoor, awb_fl, awb_manual, awb_auto };
  40. enum { custom_autocontour, custom_contour, custom_noise_reduction,
  41. custom_awb_speed, custom_awb_delay,
  42. custom_save_user, custom_restore_user, custom_restore_factory };
  43. static const char * const pwc_auto_whitebal_qmenu[] = {
  44. "Indoor (Incandescant Lighting) Mode",
  45. "Outdoor (Sunlight) Mode",
  46. "Indoor (Fluorescent Lighting) Mode",
  47. "Manual Mode",
  48. "Auto Mode",
  49. NULL
  50. };
  51. static const struct v4l2_ctrl_config pwc_auto_white_balance_cfg = {
  52. .ops = &pwc_ctrl_ops,
  53. .id = V4L2_CID_AUTO_WHITE_BALANCE,
  54. .type = V4L2_CTRL_TYPE_MENU,
  55. .max = awb_auto,
  56. .qmenu = pwc_auto_whitebal_qmenu,
  57. };
  58. static const struct v4l2_ctrl_config pwc_autocontour_cfg = {
  59. .ops = &pwc_ctrl_ops,
  60. .id = PWC_CID_CUSTOM(autocontour),
  61. .type = V4L2_CTRL_TYPE_BOOLEAN,
  62. .name = "Auto contour",
  63. .min = 0,
  64. .max = 1,
  65. .step = 1,
  66. };
  67. static const struct v4l2_ctrl_config pwc_contour_cfg = {
  68. .ops = &pwc_ctrl_ops,
  69. .id = PWC_CID_CUSTOM(contour),
  70. .type = V4L2_CTRL_TYPE_INTEGER,
  71. .name = "Contour",
  72. .flags = V4L2_CTRL_FLAG_SLIDER,
  73. .min = 0,
  74. .max = 63,
  75. .step = 1,
  76. };
  77. static const struct v4l2_ctrl_config pwc_backlight_cfg = {
  78. .ops = &pwc_ctrl_ops,
  79. .id = V4L2_CID_BACKLIGHT_COMPENSATION,
  80. .type = V4L2_CTRL_TYPE_BOOLEAN,
  81. .min = 0,
  82. .max = 1,
  83. .step = 1,
  84. };
  85. static const struct v4l2_ctrl_config pwc_flicker_cfg = {
  86. .ops = &pwc_ctrl_ops,
  87. .id = V4L2_CID_BAND_STOP_FILTER,
  88. .type = V4L2_CTRL_TYPE_BOOLEAN,
  89. .min = 0,
  90. .max = 1,
  91. .step = 1,
  92. };
  93. static const struct v4l2_ctrl_config pwc_noise_reduction_cfg = {
  94. .ops = &pwc_ctrl_ops,
  95. .id = PWC_CID_CUSTOM(noise_reduction),
  96. .type = V4L2_CTRL_TYPE_INTEGER,
  97. .name = "Dynamic Noise Reduction",
  98. .min = 0,
  99. .max = 3,
  100. .step = 1,
  101. };
  102. static const struct v4l2_ctrl_config pwc_save_user_cfg = {
  103. .ops = &pwc_ctrl_ops,
  104. .id = PWC_CID_CUSTOM(save_user),
  105. .type = V4L2_CTRL_TYPE_BUTTON,
  106. .name = "Save User Settings",
  107. };
  108. static const struct v4l2_ctrl_config pwc_restore_user_cfg = {
  109. .ops = &pwc_ctrl_ops,
  110. .id = PWC_CID_CUSTOM(restore_user),
  111. .type = V4L2_CTRL_TYPE_BUTTON,
  112. .name = "Restore User Settings",
  113. };
  114. static const struct v4l2_ctrl_config pwc_restore_factory_cfg = {
  115. .ops = &pwc_ctrl_ops,
  116. .id = PWC_CID_CUSTOM(restore_factory),
  117. .type = V4L2_CTRL_TYPE_BUTTON,
  118. .name = "Restore Factory Settings",
  119. };
  120. static const struct v4l2_ctrl_config pwc_awb_speed_cfg = {
  121. .ops = &pwc_ctrl_ops,
  122. .id = PWC_CID_CUSTOM(awb_speed),
  123. .type = V4L2_CTRL_TYPE_INTEGER,
  124. .name = "Auto White Balance Speed",
  125. .min = 1,
  126. .max = 32,
  127. .step = 1,
  128. };
  129. static const struct v4l2_ctrl_config pwc_awb_delay_cfg = {
  130. .ops = &pwc_ctrl_ops,
  131. .id = PWC_CID_CUSTOM(awb_delay),
  132. .type = V4L2_CTRL_TYPE_INTEGER,
  133. .name = "Auto White Balance Delay",
  134. .min = 0,
  135. .max = 63,
  136. .step = 1,
  137. };
  138. int pwc_init_controls(struct pwc_device *pdev)
  139. {
  140. struct v4l2_ctrl_handler *hdl;
  141. struct v4l2_ctrl_config cfg;
  142. int r, def;
  143. hdl = &pdev->ctrl_handler;
  144. r = v4l2_ctrl_handler_init(hdl, 20);
  145. if (r)
  146. return r;
  147. /* Brightness, contrast, saturation, gamma */
  148. r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, BRIGHTNESS_FORMATTER, &def);
  149. if (r || def > 127)
  150. def = 63;
  151. pdev->brightness = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  152. V4L2_CID_BRIGHTNESS, 0, 127, 1, def);
  153. r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, CONTRAST_FORMATTER, &def);
  154. if (r || def > 63)
  155. def = 31;
  156. pdev->contrast = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  157. V4L2_CID_CONTRAST, 0, 63, 1, def);
  158. if (pdev->type >= 675) {
  159. if (pdev->type < 730)
  160. pdev->saturation_fmt = SATURATION_MODE_FORMATTER2;
  161. else
  162. pdev->saturation_fmt = SATURATION_MODE_FORMATTER1;
  163. r = pwc_get_s8_ctrl(pdev, GET_CHROM_CTL, pdev->saturation_fmt,
  164. &def);
  165. if (r || def < -100 || def > 100)
  166. def = 0;
  167. pdev->saturation = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  168. V4L2_CID_SATURATION, -100, 100, 1, def);
  169. }
  170. r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, GAMMA_FORMATTER, &def);
  171. if (r || def > 31)
  172. def = 15;
  173. pdev->gamma = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  174. V4L2_CID_GAMMA, 0, 31, 1, def);
  175. /* auto white balance, red gain, blue gain */
  176. r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL, WB_MODE_FORMATTER, &def);
  177. if (r || def > awb_auto)
  178. def = awb_auto;
  179. cfg = pwc_auto_white_balance_cfg;
  180. cfg.name = v4l2_ctrl_get_name(cfg.id);
  181. cfg.def = def;
  182. pdev->auto_white_balance = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
  183. /* check auto controls to avoid NULL deref in v4l2_ctrl_auto_cluster */
  184. if (!pdev->auto_white_balance)
  185. return hdl->error;
  186. r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL,
  187. PRESET_MANUAL_RED_GAIN_FORMATTER, &def);
  188. if (r)
  189. def = 127;
  190. pdev->red_balance = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  191. V4L2_CID_RED_BALANCE, 0, 255, 1, def);
  192. r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL,
  193. PRESET_MANUAL_BLUE_GAIN_FORMATTER, &def);
  194. if (r)
  195. def = 127;
  196. pdev->blue_balance = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  197. V4L2_CID_BLUE_BALANCE, 0, 255, 1, def);
  198. v4l2_ctrl_auto_cluster(3, &pdev->auto_white_balance, awb_manual, true);
  199. /* autogain, gain */
  200. r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, AGC_MODE_FORMATTER, &def);
  201. if (r || (def != 0 && def != 0xff))
  202. def = 0;
  203. /* Note a register value if 0 means auto gain is on */
  204. pdev->autogain = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  205. V4L2_CID_AUTOGAIN, 0, 1, 1, def == 0);
  206. if (!pdev->autogain)
  207. return hdl->error;
  208. r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, PRESET_AGC_FORMATTER, &def);
  209. if (r || def > 63)
  210. def = 31;
  211. pdev->gain = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  212. V4L2_CID_GAIN, 0, 63, 1, def);
  213. /* auto exposure, exposure */
  214. if (DEVICE_USE_CODEC2(pdev->type)) {
  215. r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, SHUTTER_MODE_FORMATTER,
  216. &def);
  217. if (r || (def != 0 && def != 0xff))
  218. def = 0;
  219. /*
  220. * def = 0 auto, def = ff manual
  221. * menu idx 0 = auto, idx 1 = manual
  222. */
  223. pdev->exposure_auto = v4l2_ctrl_new_std_menu(hdl,
  224. &pwc_ctrl_ops,
  225. V4L2_CID_EXPOSURE_AUTO,
  226. 1, 0, def != 0);
  227. if (!pdev->exposure_auto)
  228. return hdl->error;
  229. /* GET_LUM_CTL, PRESET_SHUTTER_FORMATTER is unreliable */
  230. r = pwc_get_u16_ctrl(pdev, GET_STATUS_CTL,
  231. READ_SHUTTER_FORMATTER, &def);
  232. if (r || def > 655)
  233. def = 655;
  234. pdev->exposure = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  235. V4L2_CID_EXPOSURE, 0, 655, 1, def);
  236. /* CODEC2: separate auto gain & auto exposure */
  237. v4l2_ctrl_auto_cluster(2, &pdev->autogain, 0, true);
  238. v4l2_ctrl_auto_cluster(2, &pdev->exposure_auto,
  239. V4L2_EXPOSURE_MANUAL, true);
  240. } else if (DEVICE_USE_CODEC3(pdev->type)) {
  241. /* GET_LUM_CTL, PRESET_SHUTTER_FORMATTER is unreliable */
  242. r = pwc_get_u16_ctrl(pdev, GET_STATUS_CTL,
  243. READ_SHUTTER_FORMATTER, &def);
  244. if (r || def > 255)
  245. def = 255;
  246. pdev->exposure = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  247. V4L2_CID_EXPOSURE, 0, 255, 1, def);
  248. /* CODEC3: both gain and exposure controlled by autogain */
  249. pdev->autogain_expo_cluster[0] = pdev->autogain;
  250. pdev->autogain_expo_cluster[1] = pdev->gain;
  251. pdev->autogain_expo_cluster[2] = pdev->exposure;
  252. v4l2_ctrl_auto_cluster(3, pdev->autogain_expo_cluster,
  253. 0, true);
  254. }
  255. /* color / bw setting */
  256. r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL, COLOUR_MODE_FORMATTER,
  257. &def);
  258. if (r || (def != 0 && def != 0xff))
  259. def = 0xff;
  260. /* def = 0 bw, def = ff color, menu idx 0 = color, idx 1 = bw */
  261. pdev->colorfx = v4l2_ctrl_new_std_menu(hdl, &pwc_ctrl_ops,
  262. V4L2_CID_COLORFX, 1, 0, def == 0);
  263. /* autocontour, contour */
  264. r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, AUTO_CONTOUR_FORMATTER, &def);
  265. if (r || (def != 0 && def != 0xff))
  266. def = 0;
  267. cfg = pwc_autocontour_cfg;
  268. cfg.def = def == 0;
  269. pdev->autocontour = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
  270. if (!pdev->autocontour)
  271. return hdl->error;
  272. r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, PRESET_CONTOUR_FORMATTER, &def);
  273. if (r || def > 63)
  274. def = 31;
  275. cfg = pwc_contour_cfg;
  276. cfg.def = def;
  277. pdev->contour = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
  278. v4l2_ctrl_auto_cluster(2, &pdev->autocontour, 0, false);
  279. /* backlight */
  280. r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL,
  281. BACK_LIGHT_COMPENSATION_FORMATTER, &def);
  282. if (r || (def != 0 && def != 0xff))
  283. def = 0;
  284. cfg = pwc_backlight_cfg;
  285. cfg.name = v4l2_ctrl_get_name(cfg.id);
  286. cfg.def = def == 0;
  287. pdev->backlight = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
  288. /* flikker rediction */
  289. r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL,
  290. FLICKERLESS_MODE_FORMATTER, &def);
  291. if (r || (def != 0 && def != 0xff))
  292. def = 0;
  293. cfg = pwc_flicker_cfg;
  294. cfg.name = v4l2_ctrl_get_name(cfg.id);
  295. cfg.def = def == 0;
  296. pdev->flicker = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
  297. /* Dynamic noise reduction */
  298. r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL,
  299. DYNAMIC_NOISE_CONTROL_FORMATTER, &def);
  300. if (r || def > 3)
  301. def = 2;
  302. cfg = pwc_noise_reduction_cfg;
  303. cfg.def = def;
  304. pdev->noise_reduction = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
  305. /* Save / Restore User / Factory Settings */
  306. pdev->save_user = v4l2_ctrl_new_custom(hdl, &pwc_save_user_cfg, NULL);
  307. pdev->restore_user = v4l2_ctrl_new_custom(hdl, &pwc_restore_user_cfg,
  308. NULL);
  309. if (pdev->restore_user)
  310. pdev->restore_user->flags |= V4L2_CTRL_FLAG_UPDATE;
  311. pdev->restore_factory = v4l2_ctrl_new_custom(hdl,
  312. &pwc_restore_factory_cfg,
  313. NULL);
  314. if (pdev->restore_factory)
  315. pdev->restore_factory->flags |= V4L2_CTRL_FLAG_UPDATE;
  316. /* Auto White Balance speed & delay */
  317. r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL,
  318. AWB_CONTROL_SPEED_FORMATTER, &def);
  319. if (r || def < 1 || def > 32)
  320. def = 1;
  321. cfg = pwc_awb_speed_cfg;
  322. cfg.def = def;
  323. pdev->awb_speed = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
  324. r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL,
  325. AWB_CONTROL_DELAY_FORMATTER, &def);
  326. if (r || def > 63)
  327. def = 0;
  328. cfg = pwc_awb_delay_cfg;
  329. cfg.def = def;
  330. pdev->awb_delay = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
  331. if (!(pdev->features & FEATURE_MOTOR_PANTILT))
  332. return hdl->error;
  333. /* Motor pan / tilt / reset */
  334. pdev->motor_pan = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  335. V4L2_CID_PAN_RELATIVE, -4480, 4480, 64, 0);
  336. if (!pdev->motor_pan)
  337. return hdl->error;
  338. pdev->motor_tilt = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  339. V4L2_CID_TILT_RELATIVE, -1920, 1920, 64, 0);
  340. pdev->motor_pan_reset = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  341. V4L2_CID_PAN_RESET, 0, 0, 0, 0);
  342. pdev->motor_tilt_reset = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
  343. V4L2_CID_TILT_RESET, 0, 0, 0, 0);
  344. v4l2_ctrl_cluster(4, &pdev->motor_pan);
  345. return hdl->error;
  346. }
  347. static void pwc_vidioc_fill_fmt(struct v4l2_format *f,
  348. int width, int height, u32 pixfmt)
  349. {
  350. memset(&f->fmt.pix, 0, sizeof(struct v4l2_pix_format));
  351. f->fmt.pix.width = width;
  352. f->fmt.pix.height = height;
  353. f->fmt.pix.field = V4L2_FIELD_NONE;
  354. f->fmt.pix.pixelformat = pixfmt;
  355. f->fmt.pix.bytesperline = f->fmt.pix.width;
  356. f->fmt.pix.sizeimage = f->fmt.pix.height * f->fmt.pix.width * 3 / 2;
  357. f->fmt.pix.colorspace = V4L2_COLORSPACE_SRGB;
  358. PWC_DEBUG_IOCTL("pwc_vidioc_fill_fmt() width=%d, height=%d, bytesperline=%d, sizeimage=%d, pixelformat=%c%c%c%c\n",
  359. f->fmt.pix.width,
  360. f->fmt.pix.height,
  361. f->fmt.pix.bytesperline,
  362. f->fmt.pix.sizeimage,
  363. (f->fmt.pix.pixelformat)&255,
  364. (f->fmt.pix.pixelformat>>8)&255,
  365. (f->fmt.pix.pixelformat>>16)&255,
  366. (f->fmt.pix.pixelformat>>24)&255);
  367. }
  368. /* ioctl(VIDIOC_TRY_FMT) */
  369. static int pwc_vidioc_try_fmt(struct pwc_device *pdev, struct v4l2_format *f)
  370. {
  371. int size;
  372. if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE) {
  373. PWC_DEBUG_IOCTL("Bad video type must be V4L2_BUF_TYPE_VIDEO_CAPTURE\n");
  374. return -EINVAL;
  375. }
  376. switch (f->fmt.pix.pixelformat) {
  377. case V4L2_PIX_FMT_YUV420:
  378. break;
  379. case V4L2_PIX_FMT_PWC1:
  380. if (DEVICE_USE_CODEC23(pdev->type)) {
  381. PWC_DEBUG_IOCTL("codec1 is only supported for old pwc webcam\n");
  382. f->fmt.pix.pixelformat = V4L2_PIX_FMT_YUV420;
  383. }
  384. break;
  385. case V4L2_PIX_FMT_PWC2:
  386. if (DEVICE_USE_CODEC1(pdev->type)) {
  387. PWC_DEBUG_IOCTL("codec23 is only supported for new pwc webcam\n");
  388. f->fmt.pix.pixelformat = V4L2_PIX_FMT_YUV420;
  389. }
  390. break;
  391. default:
  392. PWC_DEBUG_IOCTL("Unsupported pixel format\n");
  393. f->fmt.pix.pixelformat = V4L2_PIX_FMT_YUV420;
  394. }
  395. size = pwc_get_size(pdev, f->fmt.pix.width, f->fmt.pix.height);
  396. pwc_vidioc_fill_fmt(f,
  397. pwc_image_sizes[size][0],
  398. pwc_image_sizes[size][1],
  399. f->fmt.pix.pixelformat);
  400. return 0;
  401. }
  402. /* ioctl(VIDIOC_SET_FMT) */
  403. static int pwc_s_fmt_vid_cap(struct file *file, void *fh, struct v4l2_format *f)
  404. {
  405. struct pwc_device *pdev = video_drvdata(file);
  406. int ret, pixelformat, compression = 0;
  407. ret = pwc_vidioc_try_fmt(pdev, f);
  408. if (ret < 0)
  409. return ret;
  410. if (vb2_is_busy(&pdev->vb_queue))
  411. return -EBUSY;
  412. pixelformat = f->fmt.pix.pixelformat;
  413. PWC_DEBUG_IOCTL("Trying to set format to: width=%d height=%d fps=%d format=%c%c%c%c\n",
  414. f->fmt.pix.width, f->fmt.pix.height, pdev->vframes,
  415. (pixelformat)&255,
  416. (pixelformat>>8)&255,
  417. (pixelformat>>16)&255,
  418. (pixelformat>>24)&255);
  419. ret = pwc_set_video_mode(pdev, f->fmt.pix.width, f->fmt.pix.height,
  420. pixelformat, 30, &compression, 0);
  421. PWC_DEBUG_IOCTL("pwc_set_video_mode(), return=%d\n", ret);
  422. pwc_vidioc_fill_fmt(f, pdev->width, pdev->height, pdev->pixfmt);
  423. return ret;
  424. }
  425. static int pwc_querycap(struct file *file, void *fh, struct v4l2_capability *cap)
  426. {
  427. struct pwc_device *pdev = video_drvdata(file);
  428. strcpy(cap->driver, PWC_NAME);
  429. strlcpy(cap->card, pdev->vdev.name, sizeof(cap->card));
  430. usb_make_path(pdev->udev, cap->bus_info, sizeof(cap->bus_info));
  431. cap->device_caps = V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_STREAMING |
  432. V4L2_CAP_READWRITE;
  433. cap->capabilities = cap->device_caps | V4L2_CAP_DEVICE_CAPS;
  434. return 0;
  435. }
  436. static int pwc_enum_input(struct file *file, void *fh, struct v4l2_input *i)
  437. {
  438. if (i->index) /* Only one INPUT is supported */
  439. return -EINVAL;
  440. strlcpy(i->name, "Camera", sizeof(i->name));
  441. i->type = V4L2_INPUT_TYPE_CAMERA;
  442. return 0;
  443. }
  444. static int pwc_g_input(struct file *file, void *fh, unsigned int *i)
  445. {
  446. *i = 0;
  447. return 0;
  448. }
  449. static int pwc_s_input(struct file *file, void *fh, unsigned int i)
  450. {
  451. return i ? -EINVAL : 0;
  452. }
  453. static int pwc_g_volatile_ctrl(struct v4l2_ctrl *ctrl)
  454. {
  455. struct pwc_device *pdev =
  456. container_of(ctrl->handler, struct pwc_device, ctrl_handler);
  457. int ret = 0;
  458. switch (ctrl->id) {
  459. case V4L2_CID_AUTO_WHITE_BALANCE:
  460. if (pdev->color_bal_valid &&
  461. (pdev->auto_white_balance->val != awb_auto ||
  462. time_before(jiffies,
  463. pdev->last_color_bal_update + HZ / 4))) {
  464. pdev->red_balance->val = pdev->last_red_balance;
  465. pdev->blue_balance->val = pdev->last_blue_balance;
  466. break;
  467. }
  468. ret = pwc_get_u8_ctrl(pdev, GET_STATUS_CTL,
  469. READ_RED_GAIN_FORMATTER,
  470. &pdev->red_balance->val);
  471. if (ret)
  472. break;
  473. ret = pwc_get_u8_ctrl(pdev, GET_STATUS_CTL,
  474. READ_BLUE_GAIN_FORMATTER,
  475. &pdev->blue_balance->val);
  476. if (ret)
  477. break;
  478. pdev->last_red_balance = pdev->red_balance->val;
  479. pdev->last_blue_balance = pdev->blue_balance->val;
  480. pdev->last_color_bal_update = jiffies;
  481. pdev->color_bal_valid = true;
  482. break;
  483. case V4L2_CID_AUTOGAIN:
  484. if (pdev->gain_valid && time_before(jiffies,
  485. pdev->last_gain_update + HZ / 4)) {
  486. pdev->gain->val = pdev->last_gain;
  487. break;
  488. }
  489. ret = pwc_get_u8_ctrl(pdev, GET_STATUS_CTL,
  490. READ_AGC_FORMATTER, &pdev->gain->val);
  491. if (ret)
  492. break;
  493. pdev->last_gain = pdev->gain->val;
  494. pdev->last_gain_update = jiffies;
  495. pdev->gain_valid = true;
  496. if (!DEVICE_USE_CODEC3(pdev->type))
  497. break;
  498. /* For CODEC3 where autogain also controls expo */
  499. /* fall through */
  500. case V4L2_CID_EXPOSURE_AUTO:
  501. if (pdev->exposure_valid && time_before(jiffies,
  502. pdev->last_exposure_update + HZ / 4)) {
  503. pdev->exposure->val = pdev->last_exposure;
  504. break;
  505. }
  506. ret = pwc_get_u16_ctrl(pdev, GET_STATUS_CTL,
  507. READ_SHUTTER_FORMATTER,
  508. &pdev->exposure->val);
  509. if (ret)
  510. break;
  511. pdev->last_exposure = pdev->exposure->val;
  512. pdev->last_exposure_update = jiffies;
  513. pdev->exposure_valid = true;
  514. break;
  515. default:
  516. ret = -EINVAL;
  517. }
  518. if (ret)
  519. PWC_ERROR("g_ctrl %s error %d\n", ctrl->name, ret);
  520. return ret;
  521. }
  522. static int pwc_set_awb(struct pwc_device *pdev)
  523. {
  524. int ret;
  525. if (pdev->auto_white_balance->is_new) {
  526. ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
  527. WB_MODE_FORMATTER,
  528. pdev->auto_white_balance->val);
  529. if (ret)
  530. return ret;
  531. if (pdev->auto_white_balance->val != awb_manual)
  532. pdev->color_bal_valid = false; /* Force cache update */
  533. /*
  534. * If this is a preset, update our red / blue balance values
  535. * so that events get generated for the new preset values
  536. */
  537. if (pdev->auto_white_balance->val == awb_indoor ||
  538. pdev->auto_white_balance->val == awb_outdoor ||
  539. pdev->auto_white_balance->val == awb_fl)
  540. pwc_g_volatile_ctrl(pdev->auto_white_balance);
  541. }
  542. if (pdev->auto_white_balance->val != awb_manual)
  543. return 0;
  544. if (pdev->red_balance->is_new) {
  545. ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
  546. PRESET_MANUAL_RED_GAIN_FORMATTER,
  547. pdev->red_balance->val);
  548. if (ret)
  549. return ret;
  550. }
  551. if (pdev->blue_balance->is_new) {
  552. ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
  553. PRESET_MANUAL_BLUE_GAIN_FORMATTER,
  554. pdev->blue_balance->val);
  555. if (ret)
  556. return ret;
  557. }
  558. return 0;
  559. }
  560. /* For CODEC2 models which have separate autogain and auto exposure */
  561. static int pwc_set_autogain(struct pwc_device *pdev)
  562. {
  563. int ret;
  564. if (pdev->autogain->is_new) {
  565. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  566. AGC_MODE_FORMATTER,
  567. pdev->autogain->val ? 0 : 0xff);
  568. if (ret)
  569. return ret;
  570. if (pdev->autogain->val)
  571. pdev->gain_valid = false; /* Force cache update */
  572. }
  573. if (pdev->autogain->val)
  574. return 0;
  575. if (pdev->gain->is_new) {
  576. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  577. PRESET_AGC_FORMATTER,
  578. pdev->gain->val);
  579. if (ret)
  580. return ret;
  581. }
  582. return 0;
  583. }
  584. /* For CODEC2 models which have separate autogain and auto exposure */
  585. static int pwc_set_exposure_auto(struct pwc_device *pdev)
  586. {
  587. int ret;
  588. int is_auto = pdev->exposure_auto->val == V4L2_EXPOSURE_AUTO;
  589. if (pdev->exposure_auto->is_new) {
  590. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  591. SHUTTER_MODE_FORMATTER,
  592. is_auto ? 0 : 0xff);
  593. if (ret)
  594. return ret;
  595. if (is_auto)
  596. pdev->exposure_valid = false; /* Force cache update */
  597. }
  598. if (is_auto)
  599. return 0;
  600. if (pdev->exposure->is_new) {
  601. ret = pwc_set_u16_ctrl(pdev, SET_LUM_CTL,
  602. PRESET_SHUTTER_FORMATTER,
  603. pdev->exposure->val);
  604. if (ret)
  605. return ret;
  606. }
  607. return 0;
  608. }
  609. /* For CODEC3 models which have autogain controlling both gain and exposure */
  610. static int pwc_set_autogain_expo(struct pwc_device *pdev)
  611. {
  612. int ret;
  613. if (pdev->autogain->is_new) {
  614. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  615. AGC_MODE_FORMATTER,
  616. pdev->autogain->val ? 0 : 0xff);
  617. if (ret)
  618. return ret;
  619. if (pdev->autogain->val) {
  620. pdev->gain_valid = false; /* Force cache update */
  621. pdev->exposure_valid = false; /* Force cache update */
  622. }
  623. }
  624. if (pdev->autogain->val)
  625. return 0;
  626. if (pdev->gain->is_new) {
  627. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  628. PRESET_AGC_FORMATTER,
  629. pdev->gain->val);
  630. if (ret)
  631. return ret;
  632. }
  633. if (pdev->exposure->is_new) {
  634. ret = pwc_set_u16_ctrl(pdev, SET_LUM_CTL,
  635. PRESET_SHUTTER_FORMATTER,
  636. pdev->exposure->val);
  637. if (ret)
  638. return ret;
  639. }
  640. return 0;
  641. }
  642. static int pwc_set_motor(struct pwc_device *pdev)
  643. {
  644. int ret;
  645. pdev->ctrl_buf[0] = 0;
  646. if (pdev->motor_pan_reset->is_new)
  647. pdev->ctrl_buf[0] |= 0x01;
  648. if (pdev->motor_tilt_reset->is_new)
  649. pdev->ctrl_buf[0] |= 0x02;
  650. if (pdev->motor_pan_reset->is_new || pdev->motor_tilt_reset->is_new) {
  651. ret = send_control_msg(pdev, SET_MPT_CTL,
  652. PT_RESET_CONTROL_FORMATTER,
  653. pdev->ctrl_buf, 1);
  654. if (ret < 0)
  655. return ret;
  656. }
  657. memset(pdev->ctrl_buf, 0, 4);
  658. if (pdev->motor_pan->is_new) {
  659. pdev->ctrl_buf[0] = pdev->motor_pan->val & 0xFF;
  660. pdev->ctrl_buf[1] = (pdev->motor_pan->val >> 8);
  661. }
  662. if (pdev->motor_tilt->is_new) {
  663. pdev->ctrl_buf[2] = pdev->motor_tilt->val & 0xFF;
  664. pdev->ctrl_buf[3] = (pdev->motor_tilt->val >> 8);
  665. }
  666. if (pdev->motor_pan->is_new || pdev->motor_tilt->is_new) {
  667. ret = send_control_msg(pdev, SET_MPT_CTL,
  668. PT_RELATIVE_CONTROL_FORMATTER,
  669. pdev->ctrl_buf, 4);
  670. if (ret < 0)
  671. return ret;
  672. }
  673. return 0;
  674. }
  675. static int pwc_s_ctrl(struct v4l2_ctrl *ctrl)
  676. {
  677. struct pwc_device *pdev =
  678. container_of(ctrl->handler, struct pwc_device, ctrl_handler);
  679. int ret = 0;
  680. switch (ctrl->id) {
  681. case V4L2_CID_BRIGHTNESS:
  682. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  683. BRIGHTNESS_FORMATTER, ctrl->val);
  684. break;
  685. case V4L2_CID_CONTRAST:
  686. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  687. CONTRAST_FORMATTER, ctrl->val);
  688. break;
  689. case V4L2_CID_SATURATION:
  690. ret = pwc_set_s8_ctrl(pdev, SET_CHROM_CTL,
  691. pdev->saturation_fmt, ctrl->val);
  692. break;
  693. case V4L2_CID_GAMMA:
  694. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  695. GAMMA_FORMATTER, ctrl->val);
  696. break;
  697. case V4L2_CID_AUTO_WHITE_BALANCE:
  698. ret = pwc_set_awb(pdev);
  699. break;
  700. case V4L2_CID_AUTOGAIN:
  701. if (DEVICE_USE_CODEC2(pdev->type))
  702. ret = pwc_set_autogain(pdev);
  703. else if (DEVICE_USE_CODEC3(pdev->type))
  704. ret = pwc_set_autogain_expo(pdev);
  705. else
  706. ret = -EINVAL;
  707. break;
  708. case V4L2_CID_EXPOSURE_AUTO:
  709. if (DEVICE_USE_CODEC2(pdev->type))
  710. ret = pwc_set_exposure_auto(pdev);
  711. else
  712. ret = -EINVAL;
  713. break;
  714. case V4L2_CID_COLORFX:
  715. ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
  716. COLOUR_MODE_FORMATTER,
  717. ctrl->val ? 0 : 0xff);
  718. break;
  719. case PWC_CID_CUSTOM(autocontour):
  720. if (pdev->autocontour->is_new) {
  721. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  722. AUTO_CONTOUR_FORMATTER,
  723. pdev->autocontour->val ? 0 : 0xff);
  724. }
  725. if (ret == 0 && pdev->contour->is_new) {
  726. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  727. PRESET_CONTOUR_FORMATTER,
  728. pdev->contour->val);
  729. }
  730. break;
  731. case V4L2_CID_BACKLIGHT_COMPENSATION:
  732. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  733. BACK_LIGHT_COMPENSATION_FORMATTER,
  734. ctrl->val ? 0 : 0xff);
  735. break;
  736. case V4L2_CID_BAND_STOP_FILTER:
  737. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  738. FLICKERLESS_MODE_FORMATTER,
  739. ctrl->val ? 0 : 0xff);
  740. break;
  741. case PWC_CID_CUSTOM(noise_reduction):
  742. ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
  743. DYNAMIC_NOISE_CONTROL_FORMATTER,
  744. ctrl->val);
  745. break;
  746. case PWC_CID_CUSTOM(save_user):
  747. ret = pwc_button_ctrl(pdev, SAVE_USER_DEFAULTS_FORMATTER);
  748. break;
  749. case PWC_CID_CUSTOM(restore_user):
  750. ret = pwc_button_ctrl(pdev, RESTORE_USER_DEFAULTS_FORMATTER);
  751. break;
  752. case PWC_CID_CUSTOM(restore_factory):
  753. ret = pwc_button_ctrl(pdev,
  754. RESTORE_FACTORY_DEFAULTS_FORMATTER);
  755. break;
  756. case PWC_CID_CUSTOM(awb_speed):
  757. ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
  758. AWB_CONTROL_SPEED_FORMATTER,
  759. ctrl->val);
  760. break;
  761. case PWC_CID_CUSTOM(awb_delay):
  762. ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
  763. AWB_CONTROL_DELAY_FORMATTER,
  764. ctrl->val);
  765. break;
  766. case V4L2_CID_PAN_RELATIVE:
  767. ret = pwc_set_motor(pdev);
  768. break;
  769. default:
  770. ret = -EINVAL;
  771. }
  772. if (ret)
  773. PWC_ERROR("s_ctrl %s error %d\n", ctrl->name, ret);
  774. return ret;
  775. }
  776. static int pwc_enum_fmt_vid_cap(struct file *file, void *fh, struct v4l2_fmtdesc *f)
  777. {
  778. struct pwc_device *pdev = video_drvdata(file);
  779. /* We only support two format: the raw format, and YUV */
  780. switch (f->index) {
  781. case 0:
  782. /* RAW format */
  783. f->pixelformat = pdev->type <= 646 ? V4L2_PIX_FMT_PWC1 : V4L2_PIX_FMT_PWC2;
  784. f->flags = V4L2_FMT_FLAG_COMPRESSED;
  785. strlcpy(f->description, "Raw Philips Webcam", sizeof(f->description));
  786. break;
  787. case 1:
  788. f->pixelformat = V4L2_PIX_FMT_YUV420;
  789. strlcpy(f->description, "4:2:0, planar, Y-Cb-Cr", sizeof(f->description));
  790. break;
  791. default:
  792. return -EINVAL;
  793. }
  794. return 0;
  795. }
  796. static int pwc_g_fmt_vid_cap(struct file *file, void *fh, struct v4l2_format *f)
  797. {
  798. struct pwc_device *pdev = video_drvdata(file);
  799. if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
  800. return -EINVAL;
  801. PWC_DEBUG_IOCTL("ioctl(VIDIOC_G_FMT) return size %dx%d\n",
  802. pdev->width, pdev->height);
  803. pwc_vidioc_fill_fmt(f, pdev->width, pdev->height, pdev->pixfmt);
  804. return 0;
  805. }
  806. static int pwc_try_fmt_vid_cap(struct file *file, void *fh, struct v4l2_format *f)
  807. {
  808. struct pwc_device *pdev = video_drvdata(file);
  809. return pwc_vidioc_try_fmt(pdev, f);
  810. }
  811. static int pwc_enum_framesizes(struct file *file, void *fh,
  812. struct v4l2_frmsizeenum *fsize)
  813. {
  814. struct pwc_device *pdev = video_drvdata(file);
  815. unsigned int i = 0, index = fsize->index;
  816. if (fsize->pixel_format == V4L2_PIX_FMT_YUV420 ||
  817. (fsize->pixel_format == V4L2_PIX_FMT_PWC1 &&
  818. DEVICE_USE_CODEC1(pdev->type)) ||
  819. (fsize->pixel_format == V4L2_PIX_FMT_PWC2 &&
  820. DEVICE_USE_CODEC23(pdev->type))) {
  821. for (i = 0; i < PSZ_MAX; i++) {
  822. if (!(pdev->image_mask & (1UL << i)))
  823. continue;
  824. if (!index--) {
  825. fsize->type = V4L2_FRMSIZE_TYPE_DISCRETE;
  826. fsize->discrete.width = pwc_image_sizes[i][0];
  827. fsize->discrete.height = pwc_image_sizes[i][1];
  828. return 0;
  829. }
  830. }
  831. }
  832. return -EINVAL;
  833. }
  834. static int pwc_enum_frameintervals(struct file *file, void *fh,
  835. struct v4l2_frmivalenum *fival)
  836. {
  837. struct pwc_device *pdev = video_drvdata(file);
  838. int size = -1;
  839. unsigned int i;
  840. for (i = 0; i < PSZ_MAX; i++) {
  841. if (pwc_image_sizes[i][0] == fival->width &&
  842. pwc_image_sizes[i][1] == fival->height) {
  843. size = i;
  844. break;
  845. }
  846. }
  847. /* TODO: Support raw format */
  848. if (size < 0 || fival->pixel_format != V4L2_PIX_FMT_YUV420)
  849. return -EINVAL;
  850. i = pwc_get_fps(pdev, fival->index, size);
  851. if (!i)
  852. return -EINVAL;
  853. fival->type = V4L2_FRMIVAL_TYPE_DISCRETE;
  854. fival->discrete.numerator = 1;
  855. fival->discrete.denominator = i;
  856. return 0;
  857. }
  858. static int pwc_g_parm(struct file *file, void *fh,
  859. struct v4l2_streamparm *parm)
  860. {
  861. struct pwc_device *pdev = video_drvdata(file);
  862. if (parm->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
  863. return -EINVAL;
  864. memset(parm, 0, sizeof(*parm));
  865. parm->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
  866. parm->parm.capture.readbuffers = MIN_FRAMES;
  867. parm->parm.capture.capability |= V4L2_CAP_TIMEPERFRAME;
  868. parm->parm.capture.timeperframe.denominator = pdev->vframes;
  869. parm->parm.capture.timeperframe.numerator = 1;
  870. return 0;
  871. }
  872. static int pwc_s_parm(struct file *file, void *fh,
  873. struct v4l2_streamparm *parm)
  874. {
  875. struct pwc_device *pdev = video_drvdata(file);
  876. int compression = 0;
  877. int ret, fps;
  878. if (parm->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
  879. return -EINVAL;
  880. /* If timeperframe == 0, then reset the framerate to the nominal value.
  881. We pick a high framerate here, and let pwc_set_video_mode() figure
  882. out the best match. */
  883. if (parm->parm.capture.timeperframe.numerator == 0 ||
  884. parm->parm.capture.timeperframe.denominator == 0)
  885. fps = 30;
  886. else
  887. fps = parm->parm.capture.timeperframe.denominator /
  888. parm->parm.capture.timeperframe.numerator;
  889. if (vb2_is_busy(&pdev->vb_queue))
  890. return -EBUSY;
  891. ret = pwc_set_video_mode(pdev, pdev->width, pdev->height, pdev->pixfmt,
  892. fps, &compression, 0);
  893. pwc_g_parm(file, fh, parm);
  894. return ret;
  895. }
  896. const struct v4l2_ioctl_ops pwc_ioctl_ops = {
  897. .vidioc_querycap = pwc_querycap,
  898. .vidioc_enum_input = pwc_enum_input,
  899. .vidioc_g_input = pwc_g_input,
  900. .vidioc_s_input = pwc_s_input,
  901. .vidioc_enum_fmt_vid_cap = pwc_enum_fmt_vid_cap,
  902. .vidioc_g_fmt_vid_cap = pwc_g_fmt_vid_cap,
  903. .vidioc_s_fmt_vid_cap = pwc_s_fmt_vid_cap,
  904. .vidioc_try_fmt_vid_cap = pwc_try_fmt_vid_cap,
  905. .vidioc_reqbufs = vb2_ioctl_reqbufs,
  906. .vidioc_querybuf = vb2_ioctl_querybuf,
  907. .vidioc_qbuf = vb2_ioctl_qbuf,
  908. .vidioc_dqbuf = vb2_ioctl_dqbuf,
  909. .vidioc_streamon = vb2_ioctl_streamon,
  910. .vidioc_streamoff = vb2_ioctl_streamoff,
  911. .vidioc_log_status = v4l2_ctrl_log_status,
  912. .vidioc_enum_framesizes = pwc_enum_framesizes,
  913. .vidioc_enum_frameintervals = pwc_enum_frameintervals,
  914. .vidioc_g_parm = pwc_g_parm,
  915. .vidioc_s_parm = pwc_s_parm,
  916. .vidioc_subscribe_event = v4l2_ctrl_subscribe_event,
  917. .vidioc_unsubscribe_event = v4l2_event_unsubscribe,
  918. };