[linux.git] / drivers / ps3 / ps3stor_lib.c

/*
 * PS3 Storage Library
 *
 * Copyright (C) 2007 Sony Computer Entertainment Inc.
 * Copyright 2007 Sony Corp.
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published
 * by the Free Software Foundation; version 2 of the License.
 *
 * 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.
 */

#include <linux/dma-mapping.h>

#include <asm/lv1call.h>
#include <asm/ps3stor.h>


static int ps3stor_probe_access(struct ps3_storage_device *dev)
{
	int res, error;
	unsigned int i;
	unsigned long n;

	if (dev->sbd.match_id == PS3_MATCH_ID_STOR_ROM) {
		/* special case: CD-ROM is assumed always accessible */
		dev->accessible_regions = 1;
		return 0;
	}

	error = -EPERM;
	for (i = 0; i < dev->num_regions; i++) {
		dev_dbg(&dev->sbd.core,
			"%s:%u: checking accessibility of region %u\n",
			__func__, __LINE__, i);

		dev->region_idx = i;
		res = ps3stor_read_write_sectors(dev, dev->bounce_lpar, 0, 1,
						 0);
		if (res) {
			dev_dbg(&dev->sbd.core, "%s:%u: read failed, "
				"region %u is not accessible\n", __func__,
				__LINE__, i);
			continue;
		}

		dev_dbg(&dev->sbd.core, "%s:%u: region %u is accessible\n",
			__func__, __LINE__, i);
		set_bit(i, &dev->accessible_regions);

		/* We can access at least one region */
		error = 0;
	}
	if (error)
		return error;

	n = hweight_long(dev->accessible_regions);
	if (n > 1)
		dev_info(&dev->sbd.core,
			 "%s:%u: %lu accessible regions found. Only the first "
			 "one will be used\n",
			 __func__, __LINE__, n);
	dev->region_idx = __ffs(dev->accessible_regions);
	dev_info(&dev->sbd.core,
		 "First accessible region has index %u start %lu size %lu\n",
		 dev->region_idx, dev->regions[dev->region_idx].start,
		 dev->regions[dev->region_idx].size);

	return 0;
}


/**
 *	ps3stor_setup - Setup a storage device before use
 *	@dev: Pointer to a struct ps3_storage_device
 *	@handler: Pointer to an interrupt handler
 *
 *	Returns 0 for success, or an error code
 */
int ps3stor_setup(struct ps3_storage_device *dev, irq_handler_t handler)
{
	int error, res, alignment;
	enum ps3_dma_page_size page_size;

	error = ps3_open_hv_device(&dev->sbd);
	if (error) {
		dev_err(&dev->sbd.core,
			"%s:%u: ps3_open_hv_device failed %d\n", __func__,
			__LINE__, error);
		goto fail;
	}

	error = ps3_sb_event_receive_port_setup(&dev->sbd, PS3_BINDING_CPU_ANY,
						&dev->irq);
	if (error) {
		dev_err(&dev->sbd.core,
			"%s:%u: ps3_sb_event_receive_port_setup failed %d\n",
		       __func__, __LINE__, error);
		goto fail_close_device;
	}

	error = request_irq(dev->irq, handler, IRQF_DISABLED,
			    dev->sbd.core.driver->name, dev);
	if (error) {
		dev_err(&dev->sbd.core, "%s:%u: request_irq failed %d\n",
			__func__, __LINE__, error);
		goto fail_sb_event_receive_port_destroy;
	}

	alignment = min(__ffs(dev->bounce_size),
			__ffs((unsigned long)dev->bounce_buf));
	if (alignment < 12) {
		dev_err(&dev->sbd.core,
			"%s:%u: bounce buffer not aligned (%lx at 0x%p)\n",
			__func__, __LINE__, dev->bounce_size, dev->bounce_buf);
		error = -EINVAL;
		goto fail_free_irq;
	} else if (alignment < 16)
		page_size = PS3_DMA_4K;
	else
		page_size = PS3_DMA_64K;
	dev->sbd.d_region = &dev->dma_region;
	ps3_dma_region_init(&dev->sbd, &dev->dma_region, page_size,
			    PS3_DMA_OTHER, dev->bounce_buf, dev->bounce_size);
	res = ps3_dma_region_create(&dev->dma_region);
	if (res) {
		dev_err(&dev->sbd.core, "%s:%u: cannot create DMA region\n",
			__func__, __LINE__);
		error = -ENOMEM;
		goto fail_free_irq;
	}

	dev->bounce_lpar = ps3_mm_phys_to_lpar(__pa(dev->bounce_buf));
	dev->bounce_dma = dma_map_single(&dev->sbd.core, dev->bounce_buf,
					 dev->bounce_size, DMA_BIDIRECTIONAL);
	if (!dev->bounce_dma) {
		dev_err(&dev->sbd.core, "%s:%u: map DMA region failed\n",
			__func__, __LINE__);
		error = -ENODEV;
		goto fail_free_dma;
	}

	error = ps3stor_probe_access(dev);
	if (error) {
		dev_err(&dev->sbd.core, "%s:%u: No accessible regions found\n",
			__func__, __LINE__);
		goto fail_unmap_dma;
	}
	return 0;

fail_unmap_dma:
	dma_unmap_single(&dev->sbd.core, dev->bounce_dma, dev->bounce_size,
			 DMA_BIDIRECTIONAL);
fail_free_dma:
	ps3_dma_region_free(&dev->dma_region);
fail_free_irq:
	free_irq(dev->irq, dev);
fail_sb_event_receive_port_destroy:
	ps3_sb_event_receive_port_destroy(&dev->sbd, dev->irq);
fail_close_device:
	ps3_close_hv_device(&dev->sbd);
fail:
	return error;
}
EXPORT_SYMBOL_GPL(ps3stor_setup);


/**
 *	ps3stor_teardown - Tear down a storage device after use
 *	@dev: Pointer to a struct ps3_storage_device
 */
void ps3stor_teardown(struct ps3_storage_device *dev)
{
	int error;

	dma_unmap_single(&dev->sbd.core, dev->bounce_dma, dev->bounce_size,
			 DMA_BIDIRECTIONAL);
	ps3_dma_region_free(&dev->dma_region);

	free_irq(dev->irq, dev);

	error = ps3_sb_event_receive_port_destroy(&dev->sbd, dev->irq);
	if (error)
		dev_err(&dev->sbd.core,
			"%s:%u: destroy event receive port failed %d\n",
			__func__, __LINE__, error);

	error = ps3_close_hv_device(&dev->sbd);
	if (error)
		dev_err(&dev->sbd.core,
			"%s:%u: ps3_close_hv_device failed %d\n", __func__,
			__LINE__, error);
}
EXPORT_SYMBOL_GPL(ps3stor_teardown);


/**
 *	ps3stor_read_write_sectors - read/write from/to a storage device
 *	@dev: Pointer to a struct ps3_storage_device
 *	@lpar: HV logical partition address
 *	@start_sector: First sector to read/write
 *	@sectors: Number of sectors to read/write
 *	@write: Flag indicating write (non-zero) or read (zero)
 *
 *	Returns 0 for success, -1 in case of failure to submit the command, or
 *	an LV1 status value in case of other errors
 */
u64 ps3stor_read_write_sectors(struct ps3_storage_device *dev, u64 lpar,
			       u64 start_sector, u64 sectors, int write)
{
	unsigned int region_id = dev->regions[dev->region_idx].id;
	const char *op = write ? "write" : "read";
	int res;

	dev_dbg(&dev->sbd.core, "%s:%u: %s %lu sectors starting at %lu\n",
		__func__, __LINE__, op, sectors, start_sector);

	init_completion(&dev->done);
	res = write ? lv1_storage_write(dev->sbd.dev_id, region_id,
					start_sector, sectors, 0, lpar,
					&dev->tag)
		    : lv1_storage_read(dev->sbd.dev_id, region_id,
				       start_sector, sectors, 0, lpar,
				       &dev->tag);
	if (res) {
		dev_dbg(&dev->sbd.core, "%s:%u: %s failed %d\n", __func__,
			__LINE__, op, res);
		return -1;
	}

	wait_for_completion(&dev->done);
	if (dev->lv1_status) {
		dev_dbg(&dev->sbd.core, "%s:%u: %s failed 0x%lx\n", __func__,
			__LINE__, op, dev->lv1_status);
		return dev->lv1_status;
	}

	dev_dbg(&dev->sbd.core, "%s:%u: %s completed\n", __func__, __LINE__,
		op);

	return 0;
}
EXPORT_SYMBOL_GPL(ps3stor_read_write_sectors);


/**
 *	ps3stor_send_command - send a device command to a storage device
 *	@dev: Pointer to a struct ps3_storage_device
 *	@cmd: Command number
 *	@arg1: First command argument
 *	@arg2: Second command argument
 *	@arg3: Third command argument
 *	@arg4: Fourth command argument
 *
 *	Returns 0 for success, -1 in case of failure to submit the command, or
 *	an LV1 status value in case of other errors
 */
u64 ps3stor_send_command(struct ps3_storage_device *dev, u64 cmd, u64 arg1,
			 u64 arg2, u64 arg3, u64 arg4)
{
	int res;

	dev_dbg(&dev->sbd.core, "%s:%u: send device command 0x%lx\n", __func__,
		__LINE__, cmd);

	init_completion(&dev->done);

	res = lv1_storage_send_device_command(dev->sbd.dev_id, cmd, arg1,
					      arg2, arg3, arg4, &dev->tag);
	if (res) {
		dev_err(&dev->sbd.core,
			"%s:%u: send_device_command 0x%lx failed %d\n",
			__func__, __LINE__, cmd, res);
		return -1;
	}

	wait_for_completion(&dev->done);
	if (dev->lv1_status) {
		dev_dbg(&dev->sbd.core, "%s:%u: command 0x%lx failed 0x%lx\n",
			__func__, __LINE__, cmd, dev->lv1_status);
		return dev->lv1_status;
	}

	dev_dbg(&dev->sbd.core, "%s:%u: command 0x%lx completed\n", __func__,
		__LINE__, cmd);

	return 0;
}
EXPORT_SYMBOL_GPL(ps3stor_send_command);


MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("PS3 Storage Bus Library");
MODULE_AUTHOR("Sony Corporation");
Commit	Line	Data
80071802 GU	1	/*
	2	* PS3 Storage Library
	3	*
	4	* Copyright (C) 2007 Sony Computer Entertainment Inc.
	5	* Copyright 2007 Sony Corp.
	6	*
	7	* This program is free software; you can redistribute it and/or modify it
	8	* under the terms of the GNU General Public License as published
	9	* by the Free Software Foundation; version 2 of the License.
	10	*
	11	* This program is distributed in the hope that it will be useful, but
	12	* WITHOUT ANY WARRANTY; without even the implied warranty of
	13	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	14	* General Public License for more details.
	15	*
	16	* You should have received a copy of the GNU General Public License along
	17	* with this program; if not, write to the Free Software Foundation, Inc.,
	18	* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
	19	*/
	20
	21	#include <linux/dma-mapping.h>
	22
	23	#include <asm/lv1call.h>
	24	#include <asm/ps3stor.h>
	25
	26
	27	static int ps3stor_probe_access(struct ps3_storage_device *dev)
	28	{
	29	int res, error;
	30	unsigned int i;
	31	unsigned long n;
	32
	33	if (dev->sbd.match_id == PS3_MATCH_ID_STOR_ROM) {
	34	/* special case: CD-ROM is assumed always accessible */
	35	dev->accessible_regions = 1;
	36	return 0;
	37	}
	38
	39	error = -EPERM;
	40	for (i = 0; i < dev->num_regions; i++) {
	41	dev_dbg(&dev->sbd.core,
	42	"%s:%u: checking accessibility of region %u\n",
	43	__func__, __LINE__, i);
	44
	45	dev->region_idx = i;
	46	res = ps3stor_read_write_sectors(dev, dev->bounce_lpar, 0, 1,
	47	0);
	48	if (res) {
	49	dev_dbg(&dev->sbd.core, "%s:%u: read failed, "
	50	"region %u is not accessible\n", __func__,
	51	__LINE__, i);
	52	continue;
	53	}
	54
	55	dev_dbg(&dev->sbd.core, "%s:%u: region %u is accessible\n",
	56	__func__, __LINE__, i);
	57	set_bit(i, &dev->accessible_regions);
	58
	59	/* We can access at least one region */
	60	error = 0;
	61	}
	62	if (error)
	63	return error;
	64
65	n = hweight_long(dev->accessible_regions);
66	if (n > 1)
67	dev_info(&dev->sbd.core,
68	"%s:%u: %lu accessible regions found. Only the first "
898eb71c	69	"one will be used\n",
80071802 GU	70	__func__, __LINE__, n);
	71	dev->region_idx = __ffs(dev->accessible_regions);
	72	dev_info(&dev->sbd.core,
	73	"First accessible region has index %u start %lu size %lu\n",
	74	dev->region_idx, dev->regions[dev->region_idx].start,
	75	dev->regions[dev->region_idx].size);
	76
	77	return 0;
	78	}
	79
	80
	81	/**
	82	* ps3stor_setup - Setup a storage device before use
	83	* @dev: Pointer to a struct ps3_storage_device
	84	* @handler: Pointer to an interrupt handler
	85	*
	86	* Returns 0 for success, or an error code
	87	*/
	88	int ps3stor_setup(struct ps3_storage_device *dev, irq_handler_t handler)
	89	{
	90	int error, res, alignment;
	91	enum ps3_dma_page_size page_size;
	92
	93	error = ps3_open_hv_device(&dev->sbd);
	94	if (error) {
	95	dev_err(&dev->sbd.core,
	96	"%s:%u: ps3_open_hv_device failed %d\n", __func__,
	97	__LINE__, error);
	98	goto fail;
	99	}
	100
	101	error = ps3_sb_event_receive_port_setup(&dev->sbd, PS3_BINDING_CPU_ANY,
	102	&dev->irq);
	103	if (error) {
	104	dev_err(&dev->sbd.core,
	105	"%s:%u: ps3_sb_event_receive_port_setup failed %d\n",
	106	__func__, __LINE__, error);
	107	goto fail_close_device;
	108	}
	109
	110	error = request_irq(dev->irq, handler, IRQF_DISABLED,
	111	dev->sbd.core.driver->name, dev);
	112	if (error) {
	113	dev_err(&dev->sbd.core, "%s:%u: request_irq failed %d\n",
	114	__func__, __LINE__, error);
	115	goto fail_sb_event_receive_port_destroy;
	116	}
	117
	118	alignment = min(__ffs(dev->bounce_size),
	119	__ffs((unsigned long)dev->bounce_buf));
	120	if (alignment < 12) {
	121	dev_err(&dev->sbd.core,
	122	"%s:%u: bounce buffer not aligned (%lx at 0x%p)\n",
	123	__func__, __LINE__, dev->bounce_size, dev->bounce_buf);
	124	error = -EINVAL;
	125	goto fail_free_irq;
	126	} else if (alignment < 16)
	127	page_size = PS3_DMA_4K;
	128	else
	129	page_size = PS3_DMA_64K;
	130	dev->sbd.d_region = &dev->dma_region;
	131	ps3_dma_region_init(&dev->sbd, &dev->dma_region, page_size,
	132	PS3_DMA_OTHER, dev->bounce_buf, dev->bounce_size);
	133	res = ps3_dma_region_create(&dev->dma_region);
134	if (res) {
135	dev_err(&dev->sbd.core, "%s:%u: cannot create DMA region\n",
136	__func__, __LINE__);
137	error = -ENOMEM;
138	goto fail_free_irq;
139	}
140
141	dev->bounce_lpar = ps3_mm_phys_to_lpar(__pa(dev->bounce_buf));
142	dev->bounce_dma = dma_map_single(&dev->sbd.core, dev->bounce_buf,
143	dev->bounce_size, DMA_BIDIRECTIONAL);
144	if (!dev->bounce_dma) {
145	dev_err(&dev->sbd.core, "%s:%u: map DMA region failed\n",
146	__func__, __LINE__);
147	error = -ENODEV;
148	goto fail_free_dma;
149	}
150
151	error = ps3stor_probe_access(dev);
152	if (error) {
153	dev_err(&dev->sbd.core, "%s:%u: No accessible regions found\n",
154	__func__, __LINE__);
155	goto fail_unmap_dma;
156	}
157	return 0;
158
159	fail_unmap_dma:
160	dma_unmap_single(&dev->sbd.core, dev->bounce_dma, dev->bounce_size,
161	DMA_BIDIRECTIONAL);
162	fail_free_dma:
163	ps3_dma_region_free(&dev->dma_region);
164	fail_free_irq:
165	free_irq(dev->irq, dev);
166	fail_sb_event_receive_port_destroy:
167	ps3_sb_event_receive_port_destroy(&dev->sbd, dev->irq);
168	fail_close_device:
169	ps3_close_hv_device(&dev->sbd);
170	fail:
171	return error;
172	}
173	EXPORT_SYMBOL_GPL(ps3stor_setup);
174
175
176	/**
177	* ps3stor_teardown - Tear down a storage device after use
178	* @dev: Pointer to a struct ps3_storage_device
179	*/
180	void ps3stor_teardown(struct ps3_storage_device *dev)
181	{
182	int error;
183
184	dma_unmap_single(&dev->sbd.core, dev->bounce_dma, dev->bounce_size,
185	DMA_BIDIRECTIONAL);
186	ps3_dma_region_free(&dev->dma_region);
187
188	free_irq(dev->irq, dev);
189
190	error = ps3_sb_event_receive_port_destroy(&dev->sbd, dev->irq);
191	if (error)
192	dev_err(&dev->sbd.core,
193	"%s:%u: destroy event receive port failed %d\n",
194	__func__, __LINE__, error);
195
196	error = ps3_close_hv_device(&dev->sbd);
197	if (error)
198	dev_err(&dev->sbd.core,
199	"%s:%u: ps3_close_hv_device failed %d\n", __func__,
200	__LINE__, error);
201	}
202	EXPORT_SYMBOL_GPL(ps3stor_teardown);
203
204
205	/**
206	* ps3stor_read_write_sectors - read/write from/to a storage device
207	* @dev: Pointer to a struct ps3_storage_device
208	* @lpar: HV logical partition address
209	* @start_sector: First sector to read/write
210	* @sectors: Number of sectors to read/write
211	* @write: Flag indicating write (non-zero) or read (zero)
212	*
213	* Returns 0 for success, -1 in case of failure to submit the command, or
214	* an LV1 status value in case of other errors
215	*/
216	u64 ps3stor_read_write_sectors(struct ps3_storage_device *dev, u64 lpar,
217	u64 start_sector, u64 sectors, int write)
218	{
219	unsigned int region_id = dev->regions[dev->region_idx].id;
220	const char *op = write ? "write" : "read";
221	int res;
222
223	dev_dbg(&dev->sbd.core, "%s:%u: %s %lu sectors starting at %lu\n",
224	__func__, __LINE__, op, sectors, start_sector);
225
226	init_completion(&dev->done);
227	res = write ? lv1_storage_write(dev->sbd.dev_id, region_id,
228	start_sector, sectors, 0, lpar,
229	&dev->tag)
230	: lv1_storage_read(dev->sbd.dev_id, region_id,
231	start_sector, sectors, 0, lpar,
232	&dev->tag);
233	if (res) {
234	dev_dbg(&dev->sbd.core, "%s:%u: %s failed %d\n", __func__,
235	__LINE__, op, res);
236	return -1;
237	}
238
239	wait_for_completion(&dev->done);
240	if (dev->lv1_status) {
241	dev_dbg(&dev->sbd.core, "%s:%u: %s failed 0x%lx\n", __func__,
242	__LINE__, op, dev->lv1_status);
243	return dev->lv1_status;
244	}
245
246	dev_dbg(&dev->sbd.core, "%s:%u: %s completed\n", __func__, __LINE__,
247	op);
248
249	return 0;
250	}
251	EXPORT_SYMBOL_GPL(ps3stor_read_write_sectors);
252
253
254	/**
255	* ps3stor_send_command - send a device command to a storage device
256	* @dev: Pointer to a struct ps3_storage_device
257	* @cmd: Command number
258	* @arg1: First command argument
259	* @arg2: Second command argument
260	* @arg3: Third command argument
261	* @arg4: Fourth command argument
262	*
263	* Returns 0 for success, -1 in case of failure to submit the command, or
264	* an LV1 status value in case of other errors
265	*/
266	u64 ps3stor_send_command(struct ps3_storage_device *dev, u64 cmd, u64 arg1,
267	u64 arg2, u64 arg3, u64 arg4)
268	{
269	int res;
270
271	dev_dbg(&dev->sbd.core, "%s:%u: send device command 0x%lx\n", __func__,
272	__LINE__, cmd);
273
274	init_completion(&dev->done);
275
276	res = lv1_storage_send_device_command(dev->sbd.dev_id, cmd, arg1,
277	arg2, arg3, arg4, &dev->tag);
278	if (res) {
279	dev_err(&dev->sbd.core,
280	"%s:%u: send_device_command 0x%lx failed %d\n",
281	__func__, __LINE__, cmd, res);
282	return -1;
283	}
284
285	wait_for_completion(&dev->done);
286	if (dev->lv1_status) {
287	dev_dbg(&dev->sbd.core, "%s:%u: command 0x%lx failed 0x%lx\n",
288	__func__, __LINE__, cmd, dev->lv1_status);
289	return dev->lv1_status;
290	}
291
292	dev_dbg(&dev->sbd.core, "%s:%u: command 0x%lx completed\n", __func__,
293	__LINE__, cmd);
294
295	return 0;
296	}
297	EXPORT_SYMBOL_GPL(ps3stor_send_command);
298
299
300	MODULE_LICENSE("GPL");
301	MODULE_DESCRIPTION("PS3 Storage Bus Library");
302	MODULE_AUTHOR("Sony Corporation");