camera.c

/**
 * @file camera.c
 * Camera module -- this handles the camera LED-indicator for MCE
 * <p>
 * Copyright © 2007-2011 Nokia Corporation and/or its subsidiary(-ies).
 * Copyright (C) 2013-2019 Jolla Ltd.
 * <p>
 * @author David Weinehall <david.weinehall@nokia.com>
 * @author Santtu Lakkala <ext-santtu.1.lakkala@nokia.com>
 * @author Simo Piiroinen <simo.piiroinen@jollamobile.com>
 *
 * mce is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License
 * version 2.1 as published by the Free Software Foundation.
 *
 * mce is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with mce.  If not, see <http://www.gnu.org/licenses/>.
 */

#include "camera.h"

#include "../mce-log.h"
#include "../mce-io.h"
#include "../mce-conf.h"
#include "../tklock.h"

#include <string.h>

#include <gmodule.h>

/** Unlock the tklock if the camera is popped out? */
static gboolean popout_unlock = DEFAULT_CAMERA_POPOUT_UNLOCK;

/** Module name */
#define MODULE_NAME		"camera"

/** Functionality provided by this module */
static const gchar *const provides[] = { MODULE_NAME, NULL };

/** Functionality that this module depends on */
static const gchar *const depends[] = { "tklock", NULL };

/** Functionality that this module recommends */
static const gchar *const recommends[] = { "led", NULL };

/** Module information */
G_MODULE_EXPORT module_info_struct module_info = {
	/** Name of the module */
	.name = MODULE_NAME,
	/** Module dependencies */
	.depends = depends,
	/** Module recommends */
	.recommends = recommends,
	/** Module provides */
	.provides = provides,
	/** Module priority */
	.priority = 250
};

/** ID for the camera active state I/O monitor */
static mce_io_mon_t *camera_active_state_iomon_id = NULL;

/** ID for the camera pop-out state I/O monitor */
static mce_io_mon_t *camera_popout_state_iomon_id = NULL;

/** Camera pop-out state I/O monitor deleted callback
 *
 * @param iomon io monitor that is about to get deleted
 */
static void camera_popout_state_iomon_delete_cb(mce_io_mon_t *iomon)
{
	if( iomon == camera_popout_state_iomon_id )
		camera_popout_state_iomon_id = 0;
}

/** Camera active state I/O monitor deleted callback
 *
 * @param iomon io monitor that is about to get deleted
 */
static void camera_active_state_iomon_delete_cb(mce_io_mon_t *iomon)
{
	if( iomon == camera_active_state_iomon_id )
		camera_active_state_iomon_id = 0;
}

/**
 * I/O monitor callback for the camera active state
 *
 * @param data The new data
 * @param bytes_read Unused
 * @return Always returns FALSE to return remaining chunks (if any)
 */
static gboolean camera_active_state_iomon_input_cb(mce_io_mon_t *iomon, gpointer data, gsize bytes_read)
{
	(void)iomon;
	(void)bytes_read;

	if (!strncmp(data, MCE_CAMERA_ACTIVE, strlen(MCE_CAMERA_ACTIVE))) {
		datapipe_exec_full(&led_pattern_activate_pipe,
				   MCE_LED_PATTERN_CAMERA);
	} else {
		datapipe_exec_full(&led_pattern_deactivate_pipe,
				   MCE_LED_PATTERN_CAMERA);
	}

	return FALSE;
}

/**
 * I/O monitor callback for the camera pop-out state
 *
 * @param data The new data
 * @param bytes_read Unused
 * @return Always returns FALSE to return remaining chunks (if any)
 */
static gboolean camera_popout_state_iomon_input_cb(mce_io_mon_t *iomon, gpointer data, gsize bytes_read)
{
	(void)iomon;
	(void)bytes_read;

	/* Generate activity */
	mce_datapipe_generate_activity();

	if (popout_unlock == FALSE)
		goto EXIT;

	/* Unlock tklock if camera is popped out */
	if (!strncmp(data, MCE_CAMERA_POPPED_OUT,
		     strlen(MCE_CAMERA_POPPED_OUT))) {
		/* Request delayed unlock of touchscreen/keypad lock */
		mce_datapipe_request_tklock(TKLOCK_REQUEST_OFF_DELAYED);
	}

EXIT:
	return FALSE;
}

/**
 * Init function for the camera module
 *
 * @todo XXX status needs to be set on error!
 *
 * @param module Unused
 * @return NULL on success, a string with an error message on failure
 */
G_MODULE_EXPORT const gchar *g_module_check_init(GModule *module);
const gchar *g_module_check_init(GModule *module)
{
	(void)module;

	/* Get configuration options */
	popout_unlock = mce_conf_get_bool(MCE_CONF_TKLOCK_GROUP,
					  MCE_CONF_CAMERA_POPOUT_UNLOCK,
					  DEFAULT_CAMERA_POPOUT_UNLOCK);

	/* Register I/O monitors */
	camera_active_state_iomon_id =
		mce_io_mon_register_string(-1, CAMERA_ACTIVE_STATE_PATH,
					   MCE_IO_ERROR_POLICY_IGNORE,
					   TRUE,
					   camera_active_state_iomon_input_cb,
					   camera_active_state_iomon_delete_cb);

	camera_popout_state_iomon_id =
		mce_io_mon_register_string(-1, CAMERA_POPOUT_STATE_PATH,
					   MCE_IO_ERROR_POLICY_IGNORE,
					   TRUE,
					   camera_popout_state_iomon_input_cb,
					   camera_popout_state_iomon_delete_cb);
	return NULL;
}

/**
 * Exit function for the camera module
 *
 * @param module Unused
 */
G_MODULE_EXPORT void g_module_unload(GModule *module);
void g_module_unload(GModule *module)
{
	(void)module;

	/* Unregister I/O monitors */
	mce_io_mon_unregister(camera_popout_state_iomon_id);
	mce_io_mon_unregister(camera_active_state_iomon_id);

	return;
}