[linux-2.6-block.git] / drivers / uwb / scan.c

/*
 * Ultra Wide Band
 * Scanning management
 *
 * Copyright (C) 2005-2006 Intel Corporation
 * Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License version
 * 2 as published by the Free Software Foundation.
 *
 * This program 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301, USA.
 *
 *
 *
 * FIXME: docs
 * FIXME: there are issues here on how BEACON and SCAN on USB RCI deal
 *        with each other. Currently seems that START_BEACON while
 *        SCAN_ONLY will cancel the scan, so we need to update the
 *        state here. Clarification request sent by email on
 *        10/05/2005.
 *        10/28/2005 No clear answer heard--maybe we'll hack the API
 *                   so that when we start beaconing, if the HC is
 *                   scanning in a mode not compatible with beaconing
 *                   we just fail.
 */

#include <linux/device.h>
#include <linux/err.h>
#include <linux/slab.h>
#include "uwb-internal.h"


/**
 * Start/stop scanning in a radio controller
 *
 * @rc:      UWB Radio Controlller
 * @channel: Channel to scan; encodings in WUSB1.0[Table 5.12]
 * @type:    Type of scanning to do.
 * @bpst_offset: value at which to start scanning (if type ==
 *                UWB_SCAN_ONLY_STARTTIME)
 * @returns: 0 if ok, < 0 errno code on error
 *
 * We put the command on kmalloc'ed memory as some arches cannot do
 * USB from the stack. The reply event is copied from an stage buffer,
 * so it can be in the stack. See WUSB1.0[8.6.2.4] for more details.
 */
int uwb_rc_scan(struct uwb_rc *rc,
		unsigned channel, enum uwb_scan_type type,
		unsigned bpst_offset)
{
	int result;
	struct uwb_rc_cmd_scan *cmd;
	struct uwb_rc_evt_confirm reply;

	result = -ENOMEM;
	cmd = kzalloc(sizeof(*cmd), GFP_KERNEL);
	if (cmd == NULL)
		goto error_kzalloc;
	mutex_lock(&rc->uwb_dev.mutex);
	cmd->rccb.bCommandType = UWB_RC_CET_GENERAL;
	cmd->rccb.wCommand = cpu_to_le16(UWB_RC_CMD_SCAN);
	cmd->bChannelNumber = channel;
	cmd->bScanState = type;
	cmd->wStartTime = cpu_to_le16(bpst_offset);
	reply.rceb.bEventType = UWB_RC_CET_GENERAL;
	reply.rceb.wEvent = UWB_RC_CMD_SCAN;
	result = uwb_rc_cmd(rc, "SCAN", &cmd->rccb, sizeof(*cmd),
			    &reply.rceb, sizeof(reply));
	if (result < 0)
		goto error_cmd;
	if (reply.bResultCode != UWB_RC_RES_SUCCESS) {
		dev_err(&rc->uwb_dev.dev,
			"SCAN: command execution failed: %s (%d)\n",
			uwb_rc_strerror(reply.bResultCode), reply.bResultCode);
		result = -EIO;
		goto error_cmd;
	}
	rc->scanning = channel;
	rc->scan_type = type;
error_cmd:
	mutex_unlock(&rc->uwb_dev.mutex);
	kfree(cmd);
error_kzalloc:
	return result;
}

/*
 * Print scanning state
 */
static ssize_t uwb_rc_scan_show(struct device *dev,
				struct device_attribute *attr, char *buf)
{
	struct uwb_dev *uwb_dev = to_uwb_dev(dev);
	struct uwb_rc *rc = uwb_dev->rc;
	ssize_t result;

	mutex_lock(&rc->uwb_dev.mutex);
	result = sprintf(buf, "%d %d\n", rc->scanning, rc->scan_type);
	mutex_unlock(&rc->uwb_dev.mutex);
	return result;
}

/*
 *
 */
static ssize_t uwb_rc_scan_store(struct device *dev,
				 struct device_attribute *attr,
				 const char *buf, size_t size)
{
	struct uwb_dev *uwb_dev = to_uwb_dev(dev);
	struct uwb_rc *rc = uwb_dev->rc;
	unsigned channel;
	unsigned type;
	unsigned bpst_offset = 0;
	ssize_t result = -EINVAL;

	result = sscanf(buf, "%u %u %u\n", &channel, &type, &bpst_offset);
	if (result >= 2 && type < UWB_SCAN_TOP)
		result = uwb_rc_scan(rc, channel, type, bpst_offset);

	return result < 0 ? result : size;
}

/** Radio Control sysfs interface (declaration) */
DEVICE_ATTR(scan, S_IRUGO | S_IWUSR, uwb_rc_scan_show, uwb_rc_scan_store);
Commit	Line	Data
22d203ec IPG	1	/*
	2	* Ultra Wide Band
	3	* Scanning management
	4	*
	5	* Copyright (C) 2005-2006 Intel Corporation
	6	* Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
	7	*
	8	* This program is free software; you can redistribute it and/or
	9	* modify it under the terms of the GNU General Public License version
	10	* 2 as published by the Free Software Foundation.
	11	*
	12	* This program is distributed in the hope that it will be useful,
	13	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	14	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	15	* GNU General Public License for more details.
	16	*
	17	* You should have received a copy of the GNU General Public License
	18	* along with this program; if not, write to the Free Software
	19	* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
	20	* 02110-1301, USA.
	21	*
	22	*
	23	*
	24	* FIXME: docs
	25	* FIXME: there are issues here on how BEACON and SCAN on USB RCI deal
	26	* with each other. Currently seems that START_BEACON while
	27	* SCAN_ONLY will cancel the scan, so we need to update the
	28	* state here. Clarification request sent by email on
	29	* 10/05/2005.
	30	* 10/28/2005 No clear answer heard--maybe we'll hack the API
	31	* so that when we start beaconing, if the HC is
	32	* scanning in a mode not compatible with beaconing
	33	* we just fail.
	34	*/
	35
	36	#include <linux/device.h>
	37	#include <linux/err.h>
5a0e3ad6	38	#include <linux/slab.h>
22d203ec IPG	39	#include "uwb-internal.h"
	40
	41
	42	/**
	43	* Start/stop scanning in a radio controller
	44	*
	45	* @rc: UWB Radio Controlller
	46	* @channel: Channel to scan; encodings in WUSB1.0[Table 5.12]
	47	* @type: Type of scanning to do.
	48	* @bpst_offset: value at which to start scanning (if type ==
	49	* UWB_SCAN_ONLY_STARTTIME)
	50	* @returns: 0 if ok, < 0 errno code on error
	51	*
	52	* We put the command on kmalloc'ed memory as some arches cannot do
	53	* USB from the stack. The reply event is copied from an stage buffer,
	54	* so it can be in the stack. See WUSB1.0[8.6.2.4] for more details.
	55	*/
	56	int uwb_rc_scan(struct uwb_rc *rc,
	57	unsigned channel, enum uwb_scan_type type,
	58	unsigned bpst_offset)
	59	{
	60	int result;
	61	struct uwb_rc_cmd_scan *cmd;
	62	struct uwb_rc_evt_confirm reply;
	63
	64	result = -ENOMEM;
	65	cmd = kzalloc(sizeof(*cmd), GFP_KERNEL);
	66	if (cmd == NULL)
	67	goto error_kzalloc;
	68	mutex_lock(&rc->uwb_dev.mutex);
	69	cmd->rccb.bCommandType = UWB_RC_CET_GENERAL;
	70	cmd->rccb.wCommand = cpu_to_le16(UWB_RC_CMD_SCAN);
	71	cmd->bChannelNumber = channel;
	72	cmd->bScanState = type;
	73	cmd->wStartTime = cpu_to_le16(bpst_offset);
	74	reply.rceb.bEventType = UWB_RC_CET_GENERAL;
	75	reply.rceb.wEvent = UWB_RC_CMD_SCAN;
	76	result = uwb_rc_cmd(rc, "SCAN", &cmd->rccb, sizeof(*cmd),
	77	&reply.rceb, sizeof(reply));
	78	if (result < 0)
	79	goto error_cmd;
	80	if (reply.bResultCode != UWB_RC_RES_SUCCESS) {
	81	dev_err(&rc->uwb_dev.dev,
	82	"SCAN: command execution failed: %s (%d)\n",
	83	uwb_rc_strerror(reply.bResultCode), reply.bResultCode);
	84	result = -EIO;
	85	goto error_cmd;
	86	}
	87	rc->scanning = channel;
	88	rc->scan_type = type;
	89	error_cmd:
	90	mutex_unlock(&rc->uwb_dev.mutex);
	91	kfree(cmd);
	92	error_kzalloc:
	93	return result;
	94	}
	95
	96	/*
	97	* Print scanning state
	98	*/
	99	static ssize_t uwb_rc_scan_show(struct device *dev,
	100	struct device_attribute attr, char buf)
	101	{
	102	struct uwb_dev *uwb_dev = to_uwb_dev(dev);
103	struct uwb_rc *rc = uwb_dev->rc;
104	ssize_t result;
105
106	mutex_lock(&rc->uwb_dev.mutex);
107	result = sprintf(buf, "%d %d\n", rc->scanning, rc->scan_type);
108	mutex_unlock(&rc->uwb_dev.mutex);
109	return result;
110	}
111
112	/*
113	*
114	*/
115	static ssize_t uwb_rc_scan_store(struct device *dev,
116	struct device_attribute *attr,
117	const char *buf, size_t size)
118	{
119	struct uwb_dev *uwb_dev = to_uwb_dev(dev);
120	struct uwb_rc *rc = uwb_dev->rc;
121	unsigned channel;
122	unsigned type;
123	unsigned bpst_offset = 0;
124	ssize_t result = -EINVAL;
125
126	result = sscanf(buf, "%u %u %u\n", &channel, &type, &bpst_offset);
127	if (result >= 2 && type < UWB_SCAN_TOP)
128	result = uwb_rc_scan(rc, channel, type, bpst_offset);
129
130	return result < 0 ? result : size;
131	}
132
133	/** Radio Control sysfs interface (declaration) */
134	DEVICE_ATTR(scan, S_IRUGO \| S_IWUSR, uwb_rc_scan_show, uwb_rc_scan_store);