1 /*
2 * Copyright (c) 2016, 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 #ifndef __NVKM_SECBOOT_ACR_H__
23 #define __NVKM_SECBOOT_ACR_H__
24
25 #include "priv.h"
26
27 struct nvkm_acr;
28
29 /**
30 * struct nvkm_acr_func - properties and functions specific to an ACR
31 *
32 * @load: make the ACR ready to run on the given secboot device
33 * @reset: reset the specified falcon
34 * @start: start the specified falcon (assumed to have been reset)
35 */
36 struct nvkm_acr_func {
37 void (*dtor)(struct nvkm_acr *);
38 int (*oneinit)(struct nvkm_acr *, struct nvkm_secboot *);
39 int (*fini)(struct nvkm_acr *, struct nvkm_secboot *, bool);
40 int (*load)(struct nvkm_acr *, struct nvkm_falcon *,
41 struct nvkm_gpuobj *, u64);
42 int (*reset)(struct nvkm_acr *, struct nvkm_secboot *, unsigned long);
43 };
44
45 /**
46 * struct nvkm_acr - instance of an ACR
47 *
48 * @boot_falcon: ID of the falcon that will perform secure boot
49 * @managed_falcons: bitfield of falcons managed by this ACR
50 * @optional_falcons: bitfield of falcons we can live without
51 */
52 struct nvkm_acr {
53 const struct nvkm_acr_func *func;
54 const struct nvkm_subdev *subdev;
55
56 enum nvkm_secboot_falcon boot_falcon;
57 unsigned long managed_falcons;
58 unsigned long optional_falcons;
59 };
60
61 void *nvkm_acr_load_firmware(const struct nvkm_subdev *, const char *, size_t);
62
63 struct nvkm_acr *acr_r352_new(unsigned long);
64 struct nvkm_acr *acr_r361_new(unsigned long);
65 struct nvkm_acr *acr_r364_new(unsigned long);
66 struct nvkm_acr *acr_r367_new(enum nvkm_secboot_falcon, unsigned long);
67 struct nvkm_acr *acr_r370_new(enum nvkm_secboot_falcon, unsigned long);
68 struct nvkm_acr *acr_r375_new(enum nvkm_secboot_falcon, unsigned long);
69
70 #endif