aboutsummaryrefslogtreecommitdiffstats
path: root/include/nvgpu/sec2if
diff options
context:
space:
mode:
authorJoshua Bakita <bakitajoshua@gmail.com>2023-06-28 18:24:25 -0400
committerJoshua Bakita <bakitajoshua@gmail.com>2023-06-28 18:24:25 -0400
commit01e6fac4d61fdd7fff5433942ec93fc2ea1e4df1 (patch)
tree4ef34501728a087be24f4ba0af90f91486bf780b /include/nvgpu/sec2if
parent306a03d18b305e4e573be3b2931978fa10679eb9 (diff)
Include nvgpu headers
These are needed to build on NVIDIA's Jetson boards for the time being. Only a couple structs are required, so it should be fairly easy to remove this dependency at some point in the future.
Diffstat (limited to 'include/nvgpu/sec2if')
-rw-r--r--include/nvgpu/sec2if/sec2_cmd_if.h50
-rw-r--r--include/nvgpu/sec2if/sec2_if_acr.h96
-rw-r--r--include/nvgpu/sec2if/sec2_if_cmn.h73
-rw-r--r--include/nvgpu/sec2if/sec2_if_sec2.h75
4 files changed, 294 insertions, 0 deletions
diff --git a/include/nvgpu/sec2if/sec2_cmd_if.h b/include/nvgpu/sec2if/sec2_cmd_if.h
new file mode 100644
index 0000000..839743f
--- /dev/null
+++ b/include/nvgpu/sec2if/sec2_cmd_if.h
@@ -0,0 +1,50 @@
1/*
2 * Copyright (c) 2018, NVIDIA CORPORATION. All rights reserved.
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
19 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20 * DEALINGS IN THE SOFTWARE.
21 */
22
23#ifndef NVGPU_SEC2_CMD_IF_H
24#define NVGPU_SEC2_CMD_IF_H
25
26#include <nvgpu/sec2if/sec2_if_sec2.h>
27#include <nvgpu/sec2if/sec2_if_acr.h>
28
29struct nv_flcn_cmd_sec2 {
30 struct pmu_hdr hdr;
31 union {
32 union nv_sec2_acr_cmd acr;
33 } cmd;
34};
35
36struct nv_flcn_msg_sec2 {
37 struct pmu_hdr hdr;
38
39 union {
40 union nv_flcn_msg_sec2_init init;
41 union nv_sec2_acr_msg acr;
42 } msg;
43};
44
45#define NV_SEC2_UNIT_REWIND NV_FLCN_UNIT_ID_REWIND
46#define NV_SEC2_UNIT_INIT (0x01U)
47#define NV_SEC2_UNIT_ACR (0x07U)
48#define NV_SEC2_UNIT_END (0x0AU)
49
50#endif /* NVGPU_SEC2_CMD_IF_H */
diff --git a/include/nvgpu/sec2if/sec2_if_acr.h b/include/nvgpu/sec2if/sec2_if_acr.h
new file mode 100644
index 0000000..5b41958
--- /dev/null
+++ b/include/nvgpu/sec2if/sec2_if_acr.h
@@ -0,0 +1,96 @@
1/*
2 * Copyright (c) 2018, NVIDIA CORPORATION. All rights reserved.
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
19 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20 * DEALINGS IN THE SOFTWARE.
21 */
22
23#ifndef NVGPU_SEC2_IF_ACR_H
24#define NVGPU_SEC2_IF_ACR_H
25
26#include <nvgpu/types.h>
27
28/*
29 * ACR Command Types
30 * _BOOT_FALCON
31 * NVGPU sends a Falcon ID and LSB offset to SEC2 to boot
32 * the falcon in LS mode.
33 * SEC2 needs to hanlde the case since UCODE of falcons are
34 * stored in secured location on FB.
35 */
36#define NV_SEC2_ACR_CMD_ID_BOOTSTRAP_FALCON 0U
37
38/* nvgpu provides the Falcon ID to bootstrap */
39struct nv_sec2_acr_cmd_bootstrap_falcon {
40 /* Command must be first as this struct is the part of union */
41 u8 cmd_type;
42
43 /* Additional bootstrapping flags */
44 u32 flags;
45
46 /* ID to identify Falcon, ref LSF_FALCON_ID_<XYZ> */
47 u32 falcon_id;
48};
49
50#define NV_SEC2_ACR_CMD_BOOTSTRAP_FALCON_FLAGS_RESET 0U
51#define NV_SEC2_ACR_CMD_BOOTSTRAP_FALCON_FLAGS_RESET_NO 1U
52#define NV_SEC2_ACR_CMD_BOOTSTRAP_FALCON_FLAGS_RESET_YES 0U
53
54/* A union of all ACR Commands */
55union nv_sec2_acr_cmd {
56 /* Command type */
57 u8 cmd_type;
58
59 /* Bootstrap Falcon */
60 struct nv_sec2_acr_cmd_bootstrap_falcon bootstrap_falcon;
61};
62
63/* ACR Message Status */
64
65/* Returns the Bootstrapped falcon ID to RM */
66#define NV_SEC2_ACR_MSG_ID_BOOTSTRAP_FALCON 0U
67
68/* Returns the Error Status for Invalid Command */
69#define NV_SEC2_ACR_MSG_ID_INVALID_COMMAND 2U
70
71/*
72 * SEC2 notifies nvgpu about bootstrap status of falcon
73 */
74struct nv_sec2_acr_msg_bootstrap_falcon {
75 /* Message must be at start */
76 u8 msg_type;
77
78 /* Falcon Error Code returned by message */
79 u32 error_code;
80
81 /* Bootstrapped falcon ID by ACR */
82 u32 falcon_id;
83} ;
84
85/*
86 * A union of all ACR Messages.
87 */
88union nv_sec2_acr_msg {
89 /* Message type */
90 u8 msg_type;
91
92 /* Bootstrap details of falcon and status code */
93 struct nv_sec2_acr_msg_bootstrap_falcon msg_flcn;
94};
95
96#endif /* NVGPU_SEC2_IF_ACR_H */
diff --git a/include/nvgpu/sec2if/sec2_if_cmn.h b/include/nvgpu/sec2if/sec2_if_cmn.h
new file mode 100644
index 0000000..a40f8f9
--- /dev/null
+++ b/include/nvgpu/sec2if/sec2_if_cmn.h
@@ -0,0 +1,73 @@
1/*
2 * Copyright (c) 2018, NVIDIA CORPORATION. All rights reserved.
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
19 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20 * DEALINGS IN THE SOFTWARE.
21 */
22
23#ifndef NVGPU_SEC2_IF_CMN_H
24#define NVGPU_SEC2_IF_CMN_H
25
26/*
27 * Define the maximum number of command sequences that can be in flight at
28 * any given time. This is dictated by the width of the sequence number
29 * id ('seqNumId') stored in each sequence packet (currently 8-bits).
30 */
31#define NV_SEC2_MAX_NUM_SEQUENCES 256U
32
33/*
34 * Compares an unit id against the values in the unit_id enumeration and
35 * verifies that the id is valid. It is expected that the id is specified
36 * as an unsigned integer.
37 */
38#define NV_SEC2_UNITID_IS_VALID(id) (((id) < NV_SEC2_UNIT_END))
39
40/*
41 * Defines the size of the surface/buffer that will be allocated to store
42 * debug spew from the SEC2 ucode application when falcon-trace is enabled.
43 */
44#define NV_SEC2_DEBUG_SURFACE_SIZE (32U*1024U)
45
46/*
47 * SEC2's frame-buffer interface block has several slots/indices which can
48 * be bound to support DMA to various surfaces in memory. This is an
49 * enumeration that gives name to each index based on type of memory-aperture
50 * the index is used to access.
51 *
52 * Pre-Turing, NV_SEC2_DMAIDX_PHYS_VID_FN0 == NV_SEC2_DMAIDX_GUEST_PHYS_VID_BOUND.
53 * From Turing, engine context is stored in GPA, requiring a separate aperture.
54 *
55 * Traditionally, video falcons have used the 6th index for ucode, and we will
56 * continue to use that to allow legacy ucode to work seamlessly.
57