2 * Copyright (c) 2016, NVIDIA CORPORATION. All rights reserved.
4 * This program is free software; you can redistribute it and/or modify it
5 * under the terms and conditions of the GNU General Public License,
6 * version 2, as published by the Free Software Foundation.
8 * This program is distributed in the hope it will be useful, but WITHOUT
9 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16 #include <linux/device.h>
17 #include <linux/dma-mapping.h>
18 #include <linux/types.h>
20 struct tegra_ivc_header
;
26 struct tegra_ivc_header
*channel
;
27 unsigned int position
;
31 void (*notify
)(struct tegra_ivc
*ivc
, void *data
);
34 unsigned int num_frames
;
39 * tegra_ivc_read_get_next_frame - Peek at the next frame to receive
40 * @ivc pointer of the IVC channel
42 * Peek at the next frame to be received, without removing it from
45 * Returns a pointer to the frame, or an error encoded pointer.
47 void *tegra_ivc_read_get_next_frame(struct tegra_ivc
*ivc
);
50 * tegra_ivc_read_advance - Advance the read queue
51 * @ivc pointer of the IVC channel
53 * Advance the read queue
55 * Returns 0, or a negative error value if failed.
57 int tegra_ivc_read_advance(struct tegra_ivc
*ivc
);
60 * tegra_ivc_write_get_next_frame - Poke at the next frame to transmit
61 * @ivc pointer of the IVC channel
63 * Get access to the next frame.
65 * Returns a pointer to the frame, or an error encoded pointer.
67 void *tegra_ivc_write_get_next_frame(struct tegra_ivc
*ivc
);
70 * tegra_ivc_write_advance - Advance the write queue
71 * @ivc pointer of the IVC channel
73 * Advance the write queue
75 * Returns 0, or a negative error value if failed.
77 int tegra_ivc_write_advance(struct tegra_ivc
*ivc
);
80 * tegra_ivc_notified - handle internal messages
81 * @ivc pointer of the IVC channel
83 * This function must be called following every notification.
85 * Returns 0 if the channel is ready for communication, or -EAGAIN if a channel
86 * reset is in progress.
88 int tegra_ivc_notified(struct tegra_ivc
*ivc
);
91 * tegra_ivc_reset - initiates a reset of the shared memory state
92 * @ivc pointer of the IVC channel
94 * This function must be called after a channel is reserved before it is used
95 * for communication. The channel will be ready for use when a subsequent call
96 * to notify the remote of the channel reset.
98 void tegra_ivc_reset(struct tegra_ivc
*ivc
);
100 size_t tegra_ivc_align(size_t size
);
101 unsigned tegra_ivc_total_queue_size(unsigned queue_size
);
102 int tegra_ivc_init(struct tegra_ivc
*ivc
, struct device
*peer
, void *rx
,
103 dma_addr_t rx_phys
, void *tx
, dma_addr_t tx_phys
,
104 unsigned int num_frames
, size_t frame_size
,
105 void (*notify
)(struct tegra_ivc
*ivc
, void *data
),
107 void tegra_ivc_cleanup(struct tegra_ivc
*ivc
);
109 #endif /* __TEGRA_IVC_H */