NetBSD/sys/arch/arm/s3c2xx0/s3c2440_i2s.h

113 lines
3.8 KiB
C

/*-
* Copyright (c) 2012 The NetBSD Foundation, Inc.
* All rights reserved.
*
* This code is derived from software contributed to The NetBSD Foundation
* by Paul Fleischer <paul@xpg.dk>
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef _S3C2440_I2S_H_
#define _S3C2440_I2S_H_
struct s3c2440_i2s_attach_args {
void *i2sa_handle; /* Handle of the S3C2440 I2S Controller */
};
/* It should be possible to allocate most buffer sizes within
2 segments.
However, worst case actually is PHYSMEM / PAGE_SIZE, which seems to
be 65535/4096 = 16 as default for most architectures.
This does seem like a too pesimistic number.
*/
#define S3C2440_I2S_BUF_MAX_SEGS 2
struct s3c2440_i2s_buf {
void *i2b_parent; /* I2S handle */
/* Size of the buffer */
int i2b_size;
/* Kernelspace virtual address of the buffer */
void *i2b_addr;
/* Physical segments holding the buffer */
bus_dma_segment_t i2b_segs[S3C2440_I2S_BUF_MAX_SEGS];
/* Number of segments in use */
int i2b_nsegs;
/* Map used for transfers DMA transfers */
bus_dmamap_t i2b_dmamap;
/* DMA transfer structure */
dmac_xfer_t i2b_xfer;
/* Callback */
void (*i2b_cb)(void*);
void *i2b_cb_cookie;
};
typedef struct s3c2440_i2s_buf* s3c2440_i2s_buf_t;
void s3c2440_i2s_set_intr_lock(void *handle, kmutex_t *sc_intr_lock);
#define S3C2440_I2S_NONE (0)
#define S3C2440_I2S_TRANSMIT (1<<0)
#define S3C2440_I2S_RECEIVE (1<<1)
#define S3C2440_I2S_BOTH (S3C2440_I2S_TRANSMIT | S3C2440_I2S_RECEIVE)
/* Set transfer direction of the I2S bus */
void s3c2440_i2s_set_direction(void *handle, int direction);
/* Set the I2S clocks (master and serial) from the given sample rate */
void s3c2440_i2s_set_sample_rate(void *handle, int sample_rate);
void s3c2440_i2s_set_sample_width(void *handle, int width);
#define S3C2440_I2S_BUS_MSB 1
#define S3C2440_I2S_BUS_I2S 2
void s3c2440_i2s_set_bus_format(void *handle, int format);
/* Enable the I2S bus */
int s3c2440_i2s_commit(void *handle);
/* Disable the I2S bus */
int s3c2440_i2s_disable(void *handle);
int s3c2440_i2s_get_master_clock(void *handle);
int s3c2440_i2s_get_serial_clock(void *handle);
/* Allocate a I2S buffer. */
int s3c2440_i2s_alloc(void *, int, size_t, int, s3c2440_i2s_buf_t *);
/* Free an I2S buffer. */
void s3c2440_i2s_free(s3c2440_i2s_buf_t);
/* Write data (from the I2S buffer) onto the I2S bus */
int s3c2440_i2s_output(s3c2440_i2s_buf_t, void *, int, void (*)(void*), void*);
int s3c2440_i2s_input(s3c2440_i2s_buf_t, void *, int, void (*)(void*), void*);
int s3c2440_i2s_halt_output(s3c2440_i2s_buf_t);
#endif