drivers/gpu/drm/nouveau/nvkm/subdev/secboot/acr.h

   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_r375_new(enum nvkm_secboot_falcon, unsigned long);
  68
  69 #endif