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
// Copyright 2022 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
use crate::*;
pub(crate) fn new() -> Item {
let docs = docs! {
/// Debugging operations.
};
let name = "debug".into();
let items = vec![
item! {
/// Prints a message to the debug output.
///
/// If debug output is disabled then this is a no-op.
fn println "dp" {
/// The message to print.
///
/// Traps if the message is not valid UTF-8.
ptr: *const u8,
/// The length of the message in bytes.
len: usize,
} -> ()
},
item! {
/// Returns the time spent since some initial event.
///
/// The time is in micro-seconds and may wrap before using all 64 bits.
fn time "dt" {
/// Pointer to the 64-bits time (may be null).
///
/// The least significant 31 bits are always returned, regardless of whether the
/// pointer is null.
ptr: *mut u64,
} -> usize
},
item! {
/// Time in micro-seconds since the scheduler started.
///
/// Values may not be accurate for a few reasons:
/// - Interrupts are accounted to the component they interrupt. Ideally it should be
/// accounted to the platform only.
/// - Allocation in the applet by the platform is accounted to the platform instead of
/// the applet.
/// - The board time is assumed to have a longer wrap period than any continuous
/// component run time.
struct Perf {
/// Time spent in the platform.
platform: u64,
/// Time spent in applets.
applets: u64,
/// Time spent waiting for events.
waiting: u64,
}
},
item! {
/// Returns the time spent since some initial event, split by component.
fn perf "dq" {
/// Pointer to the output [`super::Perf`] struct.
ptr: *mut u8,
} -> ()
},
];
Item::Mod(Mod { docs, name, items })
}