116 lines · c
1/* SPDX-License-Identifier: GPL-2.0-only */2/*3 * Copyright (c) 2015, NVIDIA Corporation.4 */5 6#ifndef _FALCON_H_7#define _FALCON_H_8 9#include <linux/types.h>10 11#define FALCON_UCLASS_METHOD_OFFSET 0x0000004012 13#define FALCON_UCLASS_METHOD_DATA 0x0000004414 15#define FALCON_IRQMSET 0x0000101016#define FALCON_IRQMSET_WDTMR (1 << 1)17#define FALCON_IRQMSET_HALT (1 << 4)18#define FALCON_IRQMSET_EXTERR (1 << 5)19#define FALCON_IRQMSET_SWGEN0 (1 << 6)20#define FALCON_IRQMSET_SWGEN1 (1 << 7)21#define FALCON_IRQMSET_EXT(v) (((v) & 0xff) << 8)22 23#define FALCON_IRQDEST 0x0000101c24#define FALCON_IRQDEST_HALT (1 << 4)25#define FALCON_IRQDEST_EXTERR (1 << 5)26#define FALCON_IRQDEST_SWGEN0 (1 << 6)27#define FALCON_IRQDEST_SWGEN1 (1 << 7)28#define FALCON_IRQDEST_EXT(v) (((v) & 0xff) << 8)29 30#define FALCON_ITFEN 0x0000104831#define FALCON_ITFEN_CTXEN (1 << 0)32#define FALCON_ITFEN_MTHDEN (1 << 1)33 34#define FALCON_IDLESTATE 0x0000104c35 36#define FALCON_CPUCTL 0x0000110037#define FALCON_CPUCTL_STARTCPU (1 << 1)38 39#define FALCON_BOOTVEC 0x0000110440 41#define FALCON_DMACTL 0x0000110c42#define FALCON_DMACTL_DMEM_SCRUBBING (1 << 1)43#define FALCON_DMACTL_IMEM_SCRUBBING (1 << 2)44 45#define FALCON_DMATRFBASE 0x0000111046 47#define FALCON_DMATRFMOFFS 0x0000111448 49#define FALCON_DMATRFCMD 0x0000111850#define FALCON_DMATRFCMD_IDLE (1 << 1)51#define FALCON_DMATRFCMD_IMEM (1 << 4)52#define FALCON_DMATRFCMD_SIZE_256B (6 << 8)53#define FALCON_DMATRFCMD_DMACTX(v) (((v) & 0x7) << 12)54 55#define FALCON_DMATRFFBOFFS 0x0000111c56 57struct falcon_fw_bin_header_v1 {58 u32 magic; /* 0x10de */59 u32 version; /* version of bin format (1) */60 u32 size; /* entire image size including this header */61 u32 os_header_offset;62 u32 os_data_offset;63 u32 os_size;64};65 66struct falcon_fw_os_app_v1 {67 u32 offset;68 u32 size;69};70 71struct falcon_fw_os_header_v1 {72 u32 code_offset;73 u32 code_size;74 u32 data_offset;75 u32 data_size;76};77 78struct falcon_firmware_section {79 unsigned long offset;80 size_t size;81};82 83struct falcon_firmware {84 /* Firmware after it is read but not loaded */85 const struct firmware *firmware;86 87 /* Raw firmware data */88 dma_addr_t iova;89 dma_addr_t phys;90 void *virt;91 size_t size;92 93 /* Parsed firmware information */94 struct falcon_firmware_section bin_data;95 struct falcon_firmware_section data;96 struct falcon_firmware_section code;97};98 99struct falcon {100 /* Set by falcon client */101 struct device *dev;102 void __iomem *regs;103 104 struct falcon_firmware firmware;105};106 107int falcon_init(struct falcon *falcon);108void falcon_exit(struct falcon *falcon);109int falcon_read_firmware(struct falcon *falcon, const char *firmware_name);110int falcon_load_firmware(struct falcon *falcon);111int falcon_boot(struct falcon *falcon);112void falcon_execute_method(struct falcon *falcon, u32 method, u32 data);113int falcon_wait_idle(struct falcon *falcon);114 115#endif /* _FALCON_H_ */116