1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
/*-
* Copyright (c) 2008 Nathan Whitehorn
* All rights reserved
*
* 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 AUTHOR 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 AUTHOR 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.
*
* $FreeBSD$
*/
#ifndef _MACHINE_DBDMA_H_
#define _MACHINE_DBDMA_H_
#include <sys/param.h>
#include <machine/bus.h>
/*
* Apple's DBDMA (Descriptor-based DMA) interface is a common DMA engine
* used by a variety of custom Apple ASICs. It is described in the CHRP
* specification and in the book Macintosh Technology in the Common
* Hardware Reference Platform, copyright 1995 Apple Computer.
*/
/* DBDMA Command Values */
enum {
DBDMA_OUTPUT_MORE = 0,
DBDMA_OUTPUT_LAST = 1,
DBDMA_INPUT_MORE = 2,
DBDMA_INPUT_LAST = 3,
DBDMA_STORE_QUAD = 4,
DBDMA_LOAD_QUAD = 5,
DBDMA_NOP = 6,
DBDMA_STOP = 7
};
/* These codes are for the interrupt, branch, and wait flags */
enum {
DBDMA_NEVER = 0,
DBDMA_COND_TRUE = 1,
DBDMA_COND_FALSE = 2,
DBDMA_ALWAYS = 3
};
/* Channel status bits */
#define DBDMA_STATUS_RUN (0x01 << 15)
#define DBDMA_STATUS_PAUSE (0x01 << 14)
#define DBDMA_STATUS_FLUSH (0x01 << 13)
#define DBDMA_STATUS_WAKE (0x01 << 12)
#define DBDMA_STATUS_DEAD (0x01 << 11)
#define DBDMA_STATUS_ACTIVE (0x01 << 10)
/* Set by hardware if a branch was taken */
#define DBDMA_STATUS_BRANCH 8
struct dbdma_command;
typedef struct dbdma_command dbdma_command_t;
struct dbdma_channel;
typedef struct dbdma_channel dbdma_channel_t;
int dbdma_allocate_channel(struct resource *dbdma_regs,
bus_dma_tag_t parent_dma, int slots, dbdma_channel_t **chan);
int dbdma_resize_channel(dbdma_channel_t *chan, int newslots);
int dbdma_free_channel(dbdma_channel_t *chan);
uint16_t dbdma_get_cmd_status(dbdma_channel_t *chan, int slot);
uint16_t dbdma_get_residuals(dbdma_channel_t *chan, int slot);
void dbdma_run(dbdma_channel_t *chan);
void dbdma_stop(dbdma_channel_t *chan);
void dbdma_reset(dbdma_channel_t *chan);
void dbdma_set_current_cmd(dbdma_channel_t *chan, int slot);
void dbdma_pause(dbdma_channel_t *chan);
void dbdma_wake(dbdma_channel_t *chan);
uint16_t dbdma_get_chan_status(dbdma_channel_t *chan);
uint8_t dbdma_get_chan_device_status(dbdma_channel_t *chan);
void dbdma_set_interrupt_selector(dbdma_channel_t *chan, uint8_t mask,
uint8_t value);
void dbdma_set_branch_selector(dbdma_channel_t *chan, uint8_t mask,
uint8_t value);
void dbdma_set_wait_selector(dbdma_channel_t *chan, uint8_t mask,
uint8_t value);
void dbdma_insert_command(dbdma_channel_t *chan, int slot, int command,
int stream, bus_addr_t data, size_t count, uint8_t interrupt,
uint8_t branch, uint8_t wait, uint32_t branch_slot);
void dbdma_insert_stop(dbdma_channel_t *chan, int slot);
void dbdma_insert_nop(dbdma_channel_t *chan, int slot);
void dbdma_insert_branch(dbdma_channel_t *chan, int slot, int to_slot);
void dbdma_sync_commands(dbdma_channel_t *chan, bus_dmasync_op_t op);
#endif /* _MACHINE_DBDMA_H_ */
|
