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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
// SPDX-License-Identifier: MIT
use crate::*;
/// Trait containing the rest of [`struct@FwIsoIrSingle`] methods.
///
/// # Implementors
///
/// [`FwIsoIrSingle`][struct@crate::FwIsoIrSingle]
pub trait FwIsoIrSingleExtManual {
/// Start IR context.
/// ## `cycle_match`
/// The isochronous cycle
/// to start packet processing. The first element should be the second part of
/// isochronous cycle, up to 3. The second element should be the cycle part of
/// isochronous cycle, up to 7999.
/// ## `sync_code`
/// The value of sy field in isochronous packet header for packet processing, up to 15.
/// ## `tags`
/// The value of tag field in isochronous header for packet processing.
///
/// # Returns
///
/// TRUE if the overall operation finishes successfully, otherwise FALSE.
#[doc(alias = "hinoko_fw_iso_ir_single_start")]
fn start(
&self,
cycle_match: Option<&[u16; 2]>,
sync: u32,
tags: FwIsoCtxMatchFlag,
) -> Result<(), Error>;
/// Retrieve payload of IR context for a handled packet corresponding to index at the event of
/// interrupt.
/// ## `index`
/// the index inner available packets at the event of interrupt.
///
/// # Returns
///
///
/// ## `payload`
/// The array with data
/// frame for payload of IR context.
#[doc(alias = "hinoko_fw_iso_ir_single_get_payload")]
fn payload(&self, index: u32) -> &[u8];
/// Emitted when Linux FireWire subsystem generates interrupt event. There are three cases
/// for Linux FireWire subsystem to generate the event:
///
/// - When 1394 OHCI hardware generates hardware interrupt as a result to process the
/// isochronous packet for the buffer chunk marked to generate hardware interrupt.
/// - When the size of accumulated context header for packets since the last event reaches
/// the size of memory page (usually 4,096 bytes).
/// - When application calls [`FwIsoCtxExt::flush_completions()`][crate::prelude::FwIsoCtxExt::flush_completions()] explicitly.
///
/// The handler of signal can retrieve context payload of received packet by call of
/// [`FwIsoIrSingleExtManual::payload()`][crate::prelude::FwIsoIrSingleExtManual::payload()].
/// ## `sec`
/// sec part of isochronous cycle when interrupt occurs, up to 7.
/// ## `cycle`
/// cycle part of of isochronous cycle when interrupt occurs, up to 7999.
/// ## `header`
/// The headers of IR context
/// for packets handled in the event of interrupt. The content is different
/// depending on header_size parameter of [`FwIsoIrSingleExt::allocate()`][crate::prelude::FwIsoIrSingleExt::allocate()].
/// ## `count`
/// the number of packets to handle.
#[doc(alias = "interrupted")]
fn connect_interrupted<F: Fn(&Self, u32, u32, &[u8], u32) + 'static>(
&self,
f: F,
) -> SignalHandlerId;
}
impl<O: IsA<FwIsoIrSingle>> FwIsoIrSingleExtManual for O {
fn start(
&self,
cycle_match: Option<&[u16; 2]>,
sync: u32,
tags: FwIsoCtxMatchFlag,
) -> Result<(), Error> {
unsafe {
let ptr: *const [u16; 2] = match cycle_match {
Some(data) => data,
None => std::ptr::null_mut(),
};
let mut error = std::ptr::null_mut();
let is_ok = ffi::hinoko_fw_iso_ir_single_start(
self.as_ref().to_glib_none().0,
ptr,
sync,
tags.into_glib(),
&mut error,
);
debug_assert_eq!(is_ok == glib::ffi::GFALSE, !error.is_null());
if error.is_null() {
Ok(())
} else {
Err(from_glib_full(error))
}
}
}
fn payload(&self, index: u32) -> &[u8] {
unsafe {
let mut data = std::ptr::null_mut() as *const u8;
let mut size = std::mem::MaybeUninit::uninit();
ffi::hinoko_fw_iso_ir_single_get_payload(
self.as_ref().to_glib_none().0,
index,
&mut data,
size.as_mut_ptr(),
);
std::slice::from_raw_parts(data, size.assume_init() as usize)
}
}
fn connect_interrupted<F>(&self, f: F) -> SignalHandlerId
where
F: Fn(&Self, u32, u32, &[u8], u32) + 'static,
{
unsafe extern "C" fn interrupted_trampoline<P, F>(
this: *mut ffi::HinokoFwIsoIrSingle,
sec: std::ffi::c_uint,
cycle: std::ffi::c_uint,
header: *const u8,
header_length: std::ffi::c_uint,
count: std::ffi::c_uint,
f: glib::ffi::gpointer,
) where
P: IsA<FwIsoIrSingle>,
F: Fn(&P, u32, u32, &[u8], u32) + 'static,
{
let f: &F = &*(f as *const F);
f(
&FwIsoIrSingle::from_glib_borrow(this).unsafe_cast_ref(),
sec,
cycle,
std::slice::from_raw_parts(header, header_length as usize),
count,
)
}
unsafe {
let f: std::boxed::Box<F> = std::boxed::Box::new(f);
connect_raw(
self.as_ptr() as *mut _,
c"interrupted".as_ptr() as *const _,
Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
interrupted_trampoline::<Self, F> as *const (),
)),
std::boxed::Box::into_raw(f),
)
}
}
}