LXR linux/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
  27struct 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 */
  36struct 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 */
  52struct 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
  61void *nvkm_acr_load_firmware(const struct nvkm_subdev *, const char *, size_t);
  62
  63struct nvkm_acr *acr_r352_new(unsigned long);
  64struct nvkm_acr *acr_r361_new(unsigned long);
  65struct nvkm_acr *acr_r364_new(unsigned long);
  66struct nvkm_acr *acr_r367_new(enum nvkm_secboot_falcon, unsigned long);
  67struct nvkm_acr *acr_r375_new(enum nvkm_secboot_falcon, unsigned long);
  68
  69#endif
  70