cndrv 0.1.2

Safe Cambricon driver API.
Documentation 
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

#![doc = include_str!("../README.md")]
#![cfg(detected_neuware)]
#![deny(warnings)]

#[macro_use]
#[allow(unused, non_upper_case_globals, non_camel_case_types, non_snake_case)]
pub mod bindings {
    include!(concat!(env!("OUT_DIR"), "/bindings.rs"));

    #[macro_export]
    macro_rules! cndrv {
        ($f:expr) => {{
            #[allow(unused_imports)]
            use $crate::bindings::*;
            #[allow(unused_unsafe)]
            let err = unsafe { $f };
            assert_eq!(err, CNresult::CN_SUCCESS);
        }};
    }

    #[macro_export]
    macro_rules! cnrtc {
        ($f:expr) => {{
            #[allow(unused_imports)]
            use $crate::bindings::*;
            #[allow(unused_unsafe)]
            let err = unsafe { $f };
            assert_eq!(err, cnrtcStatus::CNRTC_SUCCESS);
        }};
    }
}

mod spore;

/// §4.3 Version Management
mod version;

/// §4.4 Device Management
mod device;

/// §4.5 Context Management
mod context;

/// §4.6 Memory Management
mod memory;

/// §4.7 Queue Management
mod queue;

/// §4.8 Notifier Management
mod notifier;

/// §4.9 Atomic Operation Management
// mod atomic;

/// §4.10 Module Management
// mod module;

/// §4.11 Execution Control Management
// mod execution;

/// §4.12 Virtual Memory Management
// mod vmem;

/// §4.13 Task Topo Management
// mod task_topo;

/// CNRTC
mod cnrtc;

pub trait AsRaw {
    type Raw;
    /// # Safety
    ///
    /// The caller must ensure that the returned item is dropped before the original item.
    unsafe fn as_raw(&self) -> Self::Raw;
}

#[inline(always)]
pub fn init() {
    cndrv!(cnInit(0));
}

pub use cnrtc::CnrtcBinary;
pub use context::{Context, CurrentCtx};
pub use device::Device;
pub use memory::{
    memcpy_d2d, memcpy_d2h, memcpy_h2d, DevByte, DevMem, DevMemSpore, HostMem, HostMemSpore,
};
pub use notifier::{Notifier, NotifierSpore};
pub use queue::{Queue, QueueSpore};
pub use spore::{ContextResource, ContextSpore, RawContainer};
pub use version::{driver_version, library_version, Version};

struct Blob<P> {
    ptr: P,
    len: usize,
}