summaryrefslogtreecommitdiff
path: root/drm/nouveau/nvkm/core/secure_boot.c
blob: 7c6b23cde36572642a8b1ba0ec77bea07b147dfe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
/*
 * Copyright (c) 2015, NVIDIA CORPORATION. All rights reserved.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 * DEALINGS IN THE SOFTWARE.
 */

/*
 * Secure boot is the process by which NVIDIA-signed firmware is loaded into
 * some of the falcons of a GPU. For production devices this is the only way
 * to load firmware into some falcons.
 *
 * A Falcon microprocessor supporting advanced security modes can run in one of
 * three modes. Not all Falcon microprocessors on a GPU support all modes.
 *
 * - Non-secure (NS). In this mode, functionality is similar to Falcon
 *   architectures before security modes were introduced (pre-Maxwell), but
 *   capability is restricted. In particular, certain registers may be
 *   inaccessible for reads and/or writes, and physical memory access may be
 *   disabled (on certain Falcon instances). This is the only possible mode that
 *   can be used if you don’t have microcode cryptographically signed by NVIDIA.
 *
 * - Heavy Secure (HS). In this mode, the microprocessor is a black box — it’s
 *   not possible to read or write any Falcon internal state or Falcon registers
 *   from outside the Falcon (for example, from the host system). The only way
 *   to enable this mode is by loading microcode that has been signed by NVIDIA.
 *   (The loading process involves tagging the IMEM block as secure, writing the
 *   signature into a Falcon register, and starting execution. The hardware will
 *   validate the signature, and if valid, grant HS privileges.)
 *
 * - Light Secure (LS). In this mode, the microprocessor has more privileges
 *   than NS but fewer than HS. Some of the microprocessor state is visible to
 *   host software to ease debugging. The only way to enable this mode is by HS
 *   microcode enabling LS mode. Some privileges available to HS mode are not
 *   available here. LS mode is introduced in GM20x.
 *
 * Secure boot consists in temporarily switchin a HS-capable falcon (typically
 * PMU) into HS mode in order to validate the LS firmware of managed falcons,
 * load it, and switch managed falcons into LS mode. Once secure boot completes,
 * no falcon remains in HS mode.
 *
 * Secure boot requires a write-protected memory region (WPR) which can only be
 * written by the secure falcon. On dGPU, the driver sets up the WPR region in
 * video memory. On Tegra, it is set up by the bootloader and its location and
 * size written into memory controller registers.
 *
 * The secure boot process takes place as follows:
 *
 * 1) A LS blob is constructed that contains all the LS firmwares we want to
 *    load, along with their signatures and bootloaders.
 *
 * 2) A HS blob (also called ACR) is created that contains the signed HS
 *    firmware in charge of loading the LS firmwares into their respective
 *    falcons.
 *
 * 3) The HS blob is loaded (via its own bootloader) and executed on the
 *    HS-capable falcon. It authenticates itself, switches the secure falcon to
 *    HS mode and copies the LS blob into the WPR region.
 *
 * 4) The LS blob now being secure from all external tampering. The HS falcon
 *    checks the signatures of the LS firmwares and, if valid, switches the
 *    managed falcons to LS mode and makes them ready to run the LS firmware.
 *
 * 5) The managed falcons remain in LS mode and can be started.
 *
 */

#include <core/secure_boot.h>
#include <core/gpuobj.h>
#include <subdev/mmu.h>
#include <subdev/timer.h>
#include <subdev/fb.h>

#include <linux/mutex.h>

enum {
	GK20A_PMU_DMAIDX_UCODE		= 0,
	GK20A_PMU_DMAIDX_VIRT		= 1,
	GK20A_PMU_DMAIDX_PHYS_VID	= 2,
	GK20A_PMU_DMAIDX_PHYS_SYS_COH	= 3,
	GK20A_PMU_DMAIDX_PHYS_SYS_NCOH	= 4,
};

/*
 *
 * LS blob structures
 *
 */

/**
 * struct lsf_ucode_desc - LS falcon signatures
 * @prd_keys:		signature to use when the GPU is in production mode
 * @dgb_keys:		signature to use when the GPU is in debug mode
 * @b_prd_present:	whether the production key is present
 * @b_dgb_present:	whether the debug key is present
 * @falcon_id:		ID of the falcon the ucode applies to
 *
 * Directly loaded from a signature file.
 */
struct lsf_ucode_desc {
	u8  prd_keys[2][16];
	u8  dbg_keys[2][16];
	u32 b_prd_present;
	u32 b_dbg_present;
	u32 falcon_id;
};

/**
 * struct lsf_wpr_header - LS blob WPR Header
 * @falcon_id:		LS falcon ID
 * @lsb_offset:		offset of the lsb_lsf_header in the WPR region
 * @bootstrap_owner:	secure falcon reponsible for bootstrapping the LS falcon
 * @lazy_bootstrap:	skip bootstrapping by ACR
 * @status:		bootstrapping status
 *
 * An array of these is written at the beginning of the WPR region, one for
 * each managed falcon. The array is terminated by an instance which falcon_id
 * is LSF_FALCON_ID_INVALID.
 */
struct lsf_wpr_header {
	u32  falcon_id;
	u32  lsb_offset;
	u32  bootstrap_owner;
#define LSF_BOOTSTRAP_OWNER_DEFAULT	LSF_FALCON_ID_PMU
	u32  lazy_bootstrap;
	u32  status;
#define LSF_IMAGE_STATUS_NONE				0
#define LSF_IMAGE_STATUS_COPY				1
#define LSF_IMAGE_STATUS_VALIDATION_CODE_FAILED		2
#define LSF_IMAGE_STATUS_VALIDATION_DATA_FAILED		3
#define LSF_IMAGE_STATUS_VALIDATION_DONE		4
#define LSF_IMAGE_STATUS_VALIDATION_SKIPPED		5
#define LSF_IMAGE_STATUS_BOOTSTRAP_READY		6
};

/**
 * struct lsf_lsb_header - LS firmware header
 * @signature:		signature to verify the firmware against
 * @ucode_off:		offset of the ucode blob in the WPR region. The ucode
 *                      blob contains the bootloader, code and data of the
 *                      LS falcon
 * @ucode_size:		size of the ucode blob, including bootloader
 * @data_size:		size of the ucode blob data
 * @bl_code_size:	size of the bootloader code
 * @bl_imem_off:	offset in imem of the bootloader
 * @bl_data_off:	offset of the bootloader data in WPR region
 * @bl_data_size:	size of the bootloader data
 * @app_code_off:	offset of the app code relative to ucode_off
 * @app_code_size:	size of the app code
 * @app_data_off:	offset of the app data relative to ucode_off
 * @app_data_size:	size of the app data
 * @flags:		flags for the secure bootloader
 *
 * This structure is written into the WPR region for each managed falcon. Each
 * instance is referenced by the lsb_offset member of the corresponding
 * lsf_wpr_header.
 */
struct lsf_lsb_header {
	struct lsf_ucode_desc signature;
	u32 ucode_off;
	u32 ucode_size;
	u32 data_size;
	u32 bl_code_size;
	u32 bl_imem_off;
	u32 bl_data_off;
	u32 bl_data_size;
	u32 app_code_off;
	u32 app_code_size;
	u32 app_data_off;
	u32 app_data_size;
	u32 flags;
#define NV_FLCN_ACR_LSF_FLAG_LOAD_CODE_AT_0_FALSE       0
#define NV_FLCN_ACR_LSF_FLAG_LOAD_CODE_AT_0_TRUE        1
#define NV_FLCN_ACR_LSF_FLAG_DMACTL_REQ_CTX_FALSE       0
#define NV_FLCN_ACR_LSF_FLAG_DMACTL_REQ_CTX_TRUE        4
};

/**
 * struct flcn_bl_dmem_desc - DMEM bootloader descriptor
 * @signature:		16B signature for secure code. 0s if no secure code
 * @ctx_dma:		DMA context to be used by BL while loading code/data
 * @code_dma_base:	256B-aligned Physical FB Address where code is located
 * @non_sec_code_off:	offset from code_dma_base where the non-secure code is
 *                      located. The offset must be multiple of 256 to help perf
 * @non_sec_code_size:	the size of the nonSecure code part.
 * @sec_code_off:	offset from code_dma_base where the secure code is
 *                      located. The offset must be multiple of 256 to help perf
 * @sec_code_size:	offset from code_dma_base where the secure code is
 *                      located. The offset must be multiple of 256 to help perf
 * @code_entry_point:	code entry point which will be invoked by BL after
 *                      code is loaded.
 * @data_dma_base:	256B aligned Physical FB Address where data is located.
 * @data_size:		size of data block. Should be multiple of 256B
 *
 * Structure used by the bootloader to load the rest of the code. This has
 * to be filled by host and copied into DMEM at offset provided in the
 * hsflcn_bl_desc.bl_desc_dmem_load_off.
 */
struct flcn_bl_dmem_desc {
	u32 reserved[4];
	u32 signature[4];
	u32 ctx_dma;
	u32 code_dma_base;
	u32 non_sec_code_off;
	u32 non_sec_code_size;
	u32 sec_code_off;
	u32 sec_code_size;
	u32 code_entry_point;
	u32 data_dma_base;
	u32 data_size;
};

/**
 * struct ls_ucode_desc - descriptor of firmware image
 * @descriptor_size:		size of this descriptor
 * @image_size:			size of the whole image
 * @bootloader_start_offset:	start offset of the bootloader in ucode image
 * @bootloader_size:		size of the bootloader
 * @bootloader_imem_offset:	start off set of the bootloader in IMEM
 * @bootloader_entry_point:	entry point of the bootloader in IMEM
 * @app_start_offset:		start offset of the LS firmware
 * @app_size:			size of the LS firmware's code and data
 * @app_imem_offset:		offset of the app in IMEM
 * @app_imem_entry:		entry point of the app in IMEM
 * @app_dmem_offset:		offset of the data in DMEM
 * @app_resident_code_offset:	offset of app code from app_start_offset
 * @app_resident_code_size:	size of the code
 * @app_resident_data_offset:	offset of data from app_start_offset
 * @app_resident_data_size:	size of data
 *
 * A firmware image contains the code, data, and bootloader of a given LS
 * falcon in a single blob. This structure describes where everything is.
 *
 * This can be generated from a (bootloader, code, data) set if they have
 * been loaded separately, or come directly from a file. For the later case,
 * we need to keep the fields that are unused by the code.
 */
struct ls_ucode_desc {
	u32 descriptor_size;
	u32 image_size;
	u32 tools_version;
	u32 app_version;
	char date[64];
	u32 bootloader_start_offset;
	u32 bootloader_size;
	u32 bootloader_imem_offset;
	u32 bootloader_entry_point;
	u32 app_start_offset;
	u32 app_size;
	u32 app_imem_offset;
	u32 app_imem_entry;
	u32 app_dmem_offset;
	u32 app_resident_code_offset;
	u32 app_resident_code_size;
	u32 app_resident_data_offset;
	u32 app_resident_data_size;
	u32 nb_overlays;
	struct {u32 start; u32 size; } load_ovl[32];
	u32 compressed;
};

/**
 * struct lsf_ucode_img - temporary storage for loaded LS firmwares
 * @node:		to link within lsf_ucode_mgr
 * @falcon_id:		ID of the falcon this LS firmware is for
 * @ucode_desc: 	loaded or generated map of ucode_data
 * @wpr_header:		WPR header to be written to the LS blob
 * @lsb_header:		LSB header to be written to the LS blob
 * @bl_dmem_desc:	DMEM descriptor of the LS bootloader
 * @ucode_header:	header of the firmware
 * @ucode_data:		firmware payload (code and data)
 * @ucode_size:		size in bytes of data in ucode_data
 *
 * Preparing the WPR LS blob requires information about all the LS firmwares
 * (size, etc) to be known. This structure contains all the data of one LS
 * firmware.
 */
struct lsf_ucode_img {
	struct list_head node;
	u32 falcon_id;
	struct ls_ucode_desc ucode_desc;

	/* All members below to be copied into the WPR blob */
	struct lsf_wpr_header wpr_header;
	struct lsf_lsb_header lsb_header;
	struct flcn_bl_dmem_desc bl_dmem_desc;
	u32 *ucode_header;
	u8 *ucode_data;
	u32 ucode_size;
};

/**
 * struct lsf_ucode_mgr - manager for all LS falcon firmwares
 * @count:	number of managed LS falcons
 * @wpr_size:	size of the required WPR region in bytes
 * @img_list:	linked list of lsf_ucode_img
 */
struct lsf_ucode_mgr {
	u16 count;
	u32 wpr_size;
	struct list_head img_list;
};

/*
 *
 * HS blob structures
 *
 */

/**
 * struct hs_bin_hdr - header of HS firmware and bootloader files
 * @bin_magic:		always 0x10de
 * @bin_ver:		version of the bin format
 * @bin_size:		entire image size excluding this header
 * @header_offset:	offset of the firmware/bootloader header in the file
 * @data_offset:	offset of the firmware/bootloader payload in the file
 * @data_size:		size of the payload
 *
 * This header is located at the beginning of the HS firmware and HS bootloader
 * files, to describe where the headers and data can be found.
 */
struct hs_bin_hdr {
	u32 bin_magic;
	u32 bin_ver;
	u32 bin_size;
	u32 header_offset;
	u32 data_offset;
	u32 data_size;
};

/**
 * struct hsflcn_bl_desc - HS firmware bootloader descriptor
 * @bl_start_tag:		starting tag of bootloader
 * @bl_desc_dmem_load_off:	DMEM offset of flcn_bl_dmem_desc  TODO check how this is used??
 * @bl_code_off:		offset of code section
 * @bl_code_size:		size of code section
 * @bl_data_off:		offset of data section
 * @bl_data_size:		size of data section
 *
 * This structure is embedded in the HS bootloader firmware file at
 * hs_bin_hdr.header_offset to describe the IMEM and DMEM layout expected by the
 * HS bootloader.
 */
struct hsflcn_bl_desc {
	u32 bl_start_tag;
	u32 bl_desc_dmem_load_off;
	u32 bl_code_off;
	u32 bl_code_size;
	u32 bl_data_off;
	u32 bl_data_size;
};

/**
 * struct acr_fw_header - HS firmware descriptor
 * @sig_dbg_offset:	offset of the debug signature
 * @sig_dbg_size:	size of the debug signature
 * @sig_prod_offset:	offset of the production signature
 * @sig_prod_size:	size of the production signature
 * @patch_loc:		offset of the offset (sic) of where the signature is
 * @patch_sig:		offset of the offset (sic) to add to sig_*_offset
 * @hdr_offset:		offset of the load header (see struct hs_load_header)
 * @hdr_size:		size of above header
 *
 * This structure is embedded in the HS firmware image at
 * hs_bin_hdr.header_offset.
 */
struct acr_fw_header {
	u32 sig_dbg_offset;
	u32 sig_dbg_size;
	u32 sig_prod_offset;
	u32 sig_prod_size;
	u32 patch_loc;
	u32 patch_sig;
	u32 hdr_offset;
	u32 hdr_size;
};

/**
 * struct acr_load_header - HS firmware loading header
 *
 * Data to be copied as-is into the struct flcn_bl_dmem_desc for the HS firmware
 */
struct acr_load_header {
	u32 non_sec_code_off;
	u32 non_sec_code_size;
	u32 data_dma_base;
	u32 data_size;
	u32 reserved;
	u32 sec_code_off;
	u32 sec_code_size;
};

/**
 * Contains the whole secure boot state, allowing it to be performed as needed
 * @falcon_id:		falcon that will perform secure boot
 * @wpr_addr:		physical address of the WPR region
 * @wpr_size:		size in bytes of the WPR region
 * @ls_blob:		LS blob of all the LS firmwares, signatures, bootloaders
 * @ls_blob_size:	size of the LS blob
 * @ls_blob_nb_regions:	number of LS firmwares that will be loaded
 * @acr_blob:		HS blob
 * @acr_blob_vma:	mapping of the HS blob into the secure falcon's VM
 * @acr_bl_desc:	bootloader descriptor of the HS blob
 * @hsbl_blob:		HS blob bootloader
 * @inst:		instance block for HS falcon
 * @pgd:		page directory for the HS falcon
 * @vm:			address space used by the HS falcon
 */
struct secure_boot {
	u32 falcon_id;
	u64 wpr_addr;
	u32 wpr_size;

	/* LS FWs, to be loaded by the HS ACR */
	struct nvkm_gpuobj *ls_blob;
	u32 ls_blob_size;
	u16 ls_blob_nb_regions;

	/* HS FW */
	struct nvkm_gpuobj *acr_blob;
	struct nvkm_vma acr_blob_vma;
	struct flcn_bl_dmem_desc acr_bl_desc;

	/* HS bootloader */
	void *hsbl_blob;

	/* Instance block & address space */
	struct nvkm_gpuobj *inst;
	struct nvkm_gpuobj *pgd;
	struct nvkm_vm *vm;

};

/* TODO make driver-global? */
static void
nvkm_gpuobj_memcpy(struct nvkm_gpuobj *dest, u32 dstoffset, void *src, u32 length)
{
	int i;

	for (i = 0; i < length; i += 4)
		nvkm_wo32(dest, dstoffset + i, *(u32 *)(src + i));
}

/*
 * TODO share with the GR FW loading routine?
 */
static int
get_firmware(struct nvkm_device *device, const char *fwname, const struct firmware **fw)
{
	char f[64];
	char cname[16];
	int i;

	/* Convert device name to lowercase */
	strncpy(cname, device->chip->name, sizeof(cname));
	cname[sizeof(cname) - 1] = '\0';
	i = strlen(cname);
	while (i) {
		--i;
		cname[i] = tolower(cname[i]);
	}

	snprintf(f, sizeof(f), "nvidia/%s/%s.bin", cname, fwname);
	return request_firmware(fw, f, device->dev);
}

/**
 * Convenience function to duplicate a firmware file in memory and check that
 * it has the required minimum size.
 */
static void *
secure_boot_load_fw(struct nvkm_device *device, const char *name,
		    size_t min_size)
{
	const struct firmware *fw;
	void *ret;
	int err;

	err = get_firmware(device, name, &fw);
	if (err)
		return ERR_PTR(err);
	if (fw->size < min_size) {
		release_firmware(fw);
		return ERR_PTR(-EINVAL);
	}
	ret = kmemdup(fw->data, fw->size, GFP_KERNEL);
	release_firmware(fw);
	if (!ret)
		return ERR_PTR(-ENOMEM);

	return ret;
}

#define BL_DESC_BLK_SIZE 256
/**
 * Build a ucode image and descriptor from provided bootloader, code and data.
 *
 * @bl:		bootloader image, including 16-bytes descriptor
 * @code:	LS firmware code segment
 * @data:	LS firmware data segment
 * @desc:	ucode descriptor to be written
 *
 * Return: allocated ucode image with corresponding descriptor information. desc
 *         is also updated to contain the right offsets within returned image.
 */
static void *
build_ucode_image(const struct firmware *bl, const struct firmware *code,
		  const struct firmware *data, struct ls_ucode_desc *desc)
{
	struct {
		u32 start_offset;
		u32 size;
		u32 imem_offset;
		u32 entry_point;
	} *bl_desc;
	u32 *bl_image;
	u32 pos = 0;
	u8 *image;

	bl_desc = (void *)bl->data;
	bl_image = (void *)(bl_desc + 1);

	desc->bootloader_start_offset = pos;
	desc->bootloader_size = ALIGN(bl_desc->size, sizeof(u32));
	desc->bootloader_imem_offset = bl_desc->imem_offset;
	desc->bootloader_entry_point = bl_desc->entry_point;

	pos = ALIGN(pos + desc->bootloader_size, BL_DESC_BLK_SIZE);
	desc->app_start_offset = pos;
	desc->app_size = ALIGN(code->size, BL_DESC_BLK_SIZE) +
			 ALIGN(data->size, BL_DESC_BLK_SIZE);
	desc->app_imem_offset = 0;
	desc->app_imem_entry = 0;
	desc->app_dmem_offset = 0;
	desc->app_resident_code_offset = 0;
	desc->app_resident_code_size = code->size;

	pos = ALIGN(pos + desc->app_resident_code_size, BL_DESC_BLK_SIZE);
	desc->app_resident_data_offset = pos - desc->app_start_offset;
	desc->app_resident_data_size = data->size;

	desc->image_size = ALIGN(bl_desc->size, BL_DESC_BLK_SIZE) +
			   desc->app_size;

	image = kzalloc(desc->image_size, GFP_KERNEL);
	if (!image)
		return ERR_PTR(-ENOMEM);

	memcpy(image + desc->bootloader_start_offset, bl_image, bl_desc->size);
	memcpy(image + desc->app_start_offset, code->data, code->size);
	memcpy(image + desc->app_start_offset + desc->app_resident_data_offset,
	       data->data, data->size);

	return image;
}

static int
load_fecs_ucode(struct nvkm_device *device, struct lsf_ucode_img *img)
{
	const struct firmware *fecs_bl, *fecs_code, *fecs_data;
	struct lsf_ucode_desc *lsf_desc;
	int err;

	img->ucode_header = NULL;

	err = get_firmware(device, "fecs", &fecs_bl);
	if (err)
		goto error;

	err = get_firmware(device, "fecs_inst", &fecs_code);
	if (err)
		goto free_bl;

	err = get_firmware(device, "fecs_data", &fecs_data);
	if (err)
		goto free_inst;

	img->ucode_data = build_ucode_image(fecs_bl, fecs_code, fecs_data,
					&img->ucode_desc);
	if (IS_ERR(img->ucode_data)) {
		err = PTR_ERR(img->ucode_data);
		goto free_data;
	}
	img->ucode_size = img->ucode_desc.image_size;

	lsf_desc = secure_boot_load_fw(device, "fecs_sig", sizeof(*lsf_desc));
	if (IS_ERR(lsf_desc)) {
		err = PTR_ERR(lsf_desc);
		goto free_image;
	}
	/* not needed? the signature should already have the right value */
	lsf_desc->falcon_id = LSF_FALCON_ID_FECS;
	memcpy(&img->lsb_header.signature, lsf_desc, sizeof(*lsf_desc));
	img->falcon_id = lsf_desc->falcon_id;
	kfree(lsf_desc);

	/* success path - only free requested firmware files */
	goto free_data;

free_image:
	kfree(img->ucode_data);
free_data:
	release_firmware(fecs_data);
free_inst:
	release_firmware(fecs_code);
free_bl:
	release_firmware(fecs_bl);
error:
	return err;
}

/**
 * lsf_mgr_add_img - add a LS image to the manager
 */
static void
lsf_mgr_add_img(struct lsf_ucode_mgr *mgr, struct lsf_ucode_img *img)
{
	mgr->count++;
	list_add(&img->node, &mgr->img_list);
}

#define LSF_LSB_HEADER_ALIGN 256
#define LSF_BL_DATA_ALIGN 256
#define LSF_BL_DATA_SIZE_ALIGN 256
#define LSF_BL_CODE_SIZE_ALIGN 256
#define LSF_UCODE_DATA_ALIGN 4096
/**
 * lsf_ucode_img_fill_headers - fill the WPR and LSB headers of an image
 * @img:	image to generate for
 * @offset:	offset in the WPR region where this image starts
 *
 * Allocate space in the WPR area from offset and write the WPR and LSB headers
 * accordingly.
 *
 * Return: offset at the end of this image.
 */
static u32
lsf_ucode_img_fill_headers(struct lsf_ucode_img *img, u32 offset,
			   u32 falcon_id)
{
	struct lsf_wpr_header *whdr = &img->wpr_header;
	struct lsf_lsb_header *lhdr = &img->lsb_header;
	struct ls_ucode_desc *desc = &img->ucode_desc;

	/* Fill WPR header */
	whdr->falcon_id = img->falcon_id;
	whdr->bootstrap_owner = LSF_BOOTSTRAP_OWNER_DEFAULT;
	whdr->status = LSF_IMAGE_STATUS_COPY;

	/* Align, save off, and include an LSB header size */
	offset = ALIGN(offset, LSF_LSB_HEADER_ALIGN);
	whdr->lsb_offset = offset;
	offset += sizeof(struct lsf_lsb_header);

	/*
	 * Align, save off, and include the original (static) ucode
	 * image size
	 */
	offset = ALIGN(offset, LSF_UCODE_DATA_ALIGN);
	lhdr->ucode_off = offset;
	offset += img->ucode_size;

	/*
	 * For falcons that use a boot loader (BL), we append a loader
	 * desc structure on the end of the ucode image and consider
	 * this the boot loader data. The host will then copy the loader
	 * desc args to this space within the WPR region (before locking
	 * down) and the HS bin will then copy them to DMEM 0 for the
	 * loader.
	 */
	if (!img->ucode_header) {
		/* Use a loader */
		lhdr->bl_code_size = ALIGN(desc->bootloader_size,
					   LSF_BL_CODE_SIZE_ALIGN);
		lhdr->ucode_size = ALIGN(desc->app_resident_data_offset,
					 LSF_BL_CODE_SIZE_ALIGN) +
					lhdr->bl_code_size;
		lhdr->data_size = ALIGN(desc->app_size,
					LSF_BL_CODE_SIZE_ALIGN) +
					lhdr->bl_code_size -
					lhdr->ucode_size;
		/*
		* Though the BL is located at 0th offset of the image, the VA
		* is different to make sure that it doesnt collide the actual
		* OS VA range
		*/
		lhdr->bl_imem_off = desc->bootloader_imem_offset;
		lhdr->app_code_off = desc->app_start_offset +
			desc->app_resident_code_offset;
		lhdr->app_code_size = desc->app_resident_code_size;
		lhdr->app_data_off = desc->app_start_offset +
					desc->app_resident_data_offset;
		lhdr->app_data_size = desc->app_resident_data_size;

		lhdr->flags = 0;
		if (img->falcon_id == falcon_id)
			lhdr->flags = NV_FLCN_ACR_LSF_FLAG_DMACTL_REQ_CTX_TRUE;

		/* Align (size bloat) and save off BL descriptor size */
		lhdr->bl_data_size = ALIGN(sizeof(img->bl_dmem_desc),
					   LSF_BL_DATA_SIZE_ALIGN);
		/*
		 * Align, save off, and include the additional BL data
		 */
		offset = ALIGN(offset, LSF_BL_DATA_ALIGN);
		lhdr->bl_data_off = offset;
		offset += lhdr->bl_data_size;
	} else {
		/* TODO never applies to Tegra! */
		/* Do not use a loader */
		lhdr->ucode_size = img->ucode_size;
		lhdr->data_size = 0;
		lhdr->bl_code_size = 0;
		lhdr->bl_data_off = 0;
		lhdr->bl_data_size = 0;

		/* TODO Complete using lsfm_add_ucode_img */
		/*
		 * bl_data_off is already assigned in static
		 * information. But that is from start of the image
		 */
		      img->lsb_header.bl_data_off += (offset - img->ucode_size);
	}

	return offset;
}

/**
 * lsf_mgr_fill_headers - fill the WPR and LSB headers of all managed images
 */
static void
lsf_mgr_fill_headers(struct secure_boot *sb, struct lsf_ucode_mgr *mgr)
{
	struct lsf_ucode_img *img;
	u32 offset;

	/*
	 * Start with an array of WPR headers at the base of the WPR.
	 * The expectation here is that the secure falcon will do a single DMA
	 * read of this array and cache it internally so it's OK to pack these.
	 * Also, we add 1 to the falcon count to indicate the end of the array.
	 */
	offset = sizeof(struct lsf_wpr_header) * (mgr->count + 1);

	/*
	 * Walk the managed falcons, accounting for the LSB structs
	 * as well as the ucode images.
	 */
	list_for_each_entry(img, &mgr->img_list, node) {
		offset = lsf_ucode_img_fill_headers(img, offset,
						    sb->falcon_id);
	}

	mgr->wpr_size = offset;
}

/*
 * Calculates PHY and VIRT addresses for various portions of the ucode image.
 * like: application code, application data, and bootloader code.
 * Return if ucode image is header based.
 * BL desc will be used by HS bin to boot corresponding LS(Low secure) falcon.
 */
static void
falcon_populate_bl_dmem_desc(struct secure_boot *sb, struct lsf_ucode_img *img,
			     struct flcn_bl_dmem_desc *desc)
{
	struct ls_ucode_desc *pdesc = &img->ucode_desc;
	u64 addr_base;

	addr_base = sb->wpr_addr + img->lsb_header.ucode_off +
		pdesc->app_start_offset;

	memset(desc, 0, sizeof(*desc));
	desc->ctx_dma = GK20A_PMU_DMAIDX_UCODE;
	desc->code_dma_base = lower_32_bits(
		(addr_base + pdesc->app_resident_code_offset) >> 8);
	desc->non_sec_code_size = pdesc->app_resident_code_size;
	desc->data_dma_base = lower_32_bits(
		(addr_base + pdesc->app_resident_data_offset) >> 8);
	desc->data_size = pdesc->app_resident_data_size;
	desc->code_entry_point = pdesc->app_imem_entry;
}

typedef int (*lsf_load_func)(struct nvkm_device *, struct lsf_ucode_img *);

static struct lsf_ucode_img *
lsf_ucode_img_load(struct nvkm_device *device,
		   lsf_load_func load_func)
{
	struct lsf_ucode_img *img;
	int err;

	img = kzalloc(sizeof(*img), GFP_KERNEL);
	if (!img)
		return ERR_PTR(-ENOMEM);

	err = load_func(device, img);
	if (err) {
		kfree(img);
		return ERR_PTR(err);
	}

	return img;
}

static void
lsf_mgr_init(struct lsf_ucode_mgr *mgr)
{
	memset(mgr, 0, sizeof(*mgr));
	INIT_LIST_HEAD(&mgr->img_list);
}

static void
lsf_mgr_cleanup(struct lsf_ucode_mgr *mgr)
{
	struct lsf_ucode_img *img, *t;

	list_for_each_entry_safe(img, t, &mgr->img_list, node) {
		kfree(img->ucode_data);
		kfree(img->ucode_header);
		kfree(img);
	}
}


/**
 * Write the WPR object contents.
 */
static void
lsf_mgr_write_wpr(struct nvkm_device *device, struct secure_boot *sb,
		  struct lsf_ucode_mgr *mgr, struct nvkm_gpuobj *ucodebuf)
{
	struct lsf_ucode_img *img;
	u32 pos = 0;

	nvkm_kmap(ucodebuf);

	list_for_each_entry(img, &mgr->img_list, node) {
		nvkm_gpuobj_memcpy(ucodebuf, pos, &img->wpr_header,
				   sizeof(img->wpr_header));

		nvkm_gpuobj_memcpy(ucodebuf, img->wpr_header.lsb_offset,
				   &img->lsb_header, sizeof(img->lsb_header));

		if (!img->ucode_header) {
			falcon_populate_bl_dmem_desc(sb, img,
						     &img->bl_dmem_desc);
			nvkm_gpuobj_memcpy(ucodebuf,
					   img->lsb_header.bl_data_off,
					   &img->bl_dmem_desc,
					   sizeof(img->bl_dmem_desc));
		}

		/* Copy ucode */
		nvkm_gpuobj_memcpy(ucodebuf, img->lsb_header.ucode_off,
				                       img->ucode_data, img->ucode_size);

		pos += sizeof(img->wpr_header);
	}

	nvkm_wo32(ucodebuf, pos, LSF_FALCON_ID_INVALID);

	nvkm_done(ucodebuf);
}

static const lsf_load_func lsf_load_funcs[] = {
	[LSF_FALCON_ID_END] = NULL, /* reserve enough space */
	[LSF_FALCON_ID_FECS] = load_fecs_ucode,
};

static int
prepare_ucode_blob(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;
	struct lsf_ucode_mgr mgr;
	int falcon_id;
	int err;

	lsf_mgr_init(&mgr);

	sb->falcon_id = device->chip->secure_boot.boot_falcon;

	/* Load all LS blobs */
	for_each_set_bit(falcon_id, &device->chip->secure_boot.managed_falcons,
			 LSF_FALCON_ID_END) {
		struct lsf_ucode_img *img;

		img = lsf_ucode_img_load(device, lsf_load_funcs[falcon_id]);

		if (IS_ERR(img)) {
			err = PTR_ERR(img);
			goto cleanup;
		}
		lsf_mgr_add_img(&mgr, img);
	}

	/*
	 * Fill the WPR and LSF headers with the right offsets and compute
	 * required WPR size
	 */
	lsf_mgr_fill_headers(sb, &mgr);

	if (mgr.wpr_size > sb->wpr_size) {
		nvdev_error(device, "WPR region too small to host FW blob!\n");
		nvdev_error(device, "required: %d bytes\n", sb->ls_blob_size);
		nvdev_error(device, "WPR size: %d bytes\n", sb->wpr_size);
		err = -ENOMEM;
		goto cleanup;
	}

	/* TODO change zero to false */
	err = nvkm_gpuobj_new(device, mgr.wpr_size, 0x1000, true, NULL,
			      &sb->ls_blob);
	if (err)
		goto cleanup;

	nvdev_info(device, "managed LS falcon %d, WPR size %d bytes.\n",
		  mgr.count, mgr.wpr_size);

	/* Write FW blob */
	lsf_mgr_write_wpr(device, sb, &mgr, sb->ls_blob);

	sb->ls_blob_size = mgr.wpr_size;
	sb->ls_blob_nb_regions = mgr.count;

cleanup:
	lsf_mgr_cleanup(&mgr);

	return err;
}

static void
del_ucode_blob(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;

	nvkm_gpuobj_del(&sb->ls_blob);
}


/*
 * Wait for PMU halt interrupt status to be cleared
 */
static int
pmu_wait_clear_halt_interrupt(struct nvkm_device *device, unsigned int usecs)
{
	int err;

	nvkm_mask(device, 0x10a004, 0x10, 0x10);
	err = nvkm_wait_msec(device, usecs, 0x10a008, 0x10, 0x0);
	if (err < 0)
		return err;

	return 0;
}

/*
 * Wait for PMU to halt
 */
static int
pmu_wait_for_halt(struct nvkm_device *device, unsigned int usecs)
{
	u32 data;
	int err;

	err = nvkm_wait_usec(device, usecs, 0x10a100, 0x10, 0x10);
	if (err < 0)
		return err;

	data = nvkm_rd32(device, 0x10a040);
	if (data) {
		nvdev_error(device, "ACR boot failed, err %x", data);
		return -EAGAIN;
	}

	return 0;
}

static int
pmu_wait_idle(struct nvkm_device *device)
{
	int err;

	err = nvkm_wait_msec(device, 10, 0x10a04c, 0xffff, 0x0);
	if (err < 0)
		return err;

	return 0;
}

static void
pmu_enable_irq(struct nvkm_device *device)
{
	nvkm_wr32(device, 0x10a010, 0xff);
	nvkm_mask(device, 0x640, 0x1000000, 0x1000000);
	nvkm_mask(device, 0x644, 0x1000000, 0x1000000);
}

static void
pmu_disable_irq(struct nvkm_device *device)
{
	nvkm_mask(device, 0x644, 0x1000000, 0x0);
	nvkm_mask(device, 0x640, 0x1000000, 0x0);
	nvkm_wr32(device, 0x10a014, 0xff);
}


static int
pmu_enable(struct nvkm_device *device)
{
	int err;

	nvkm_mask(device, 0x200, 0x2000, 0x2000);
	nvkm_rd32(device, 0x200);
	err = nvkm_wait_msec(device, 10, 0x10a10c, 0x6, 0x0);
	if (err < 0) {
		nvkm_mask(device, 0x200, 0x2000, 0x0);
		nvdev_error(device, "Falcon mem scrubbing timeout\n");
		return err;
	}

	err = pmu_wait_idle(device);
	if (err)
		return err;

	pmu_enable_irq(device);

	return 0;
}

static void
pmu_disable(struct nvkm_device *device)
{
	if ((nvkm_rd32(device, 0x200) & 0x2000) != 0) {
		pmu_disable_irq(device);
		nvkm_mask(device, 0x200, 0x2000, 0x0);
	}
}

static int
pmu_reset(struct nvkm_device *device)
{
	int err;

	err = pmu_wait_idle(device);
	if (err)
		return err;

	pmu_disable(device);

	return pmu_enable(device);
}

#define PMU_DMEM_ADDR_MASK	0xfffc
static int
pmu_copy_to_dmem(struct nvkm_device *device, u32 dst, void *src, u32 size,
		 u8 port)
{
	/* Number of full words */
	u32 w_size = size / sizeof(u32);
	/* Number of extra bytes */
	u32 b_size = size % sizeof(u32);
	int i;

	if (size == 0)
		return 0;

	if (dst & 0x3) {
		nvdev_error(device, "destination offset not aligned\n");
		return -EINVAL;
	}

	dst &= PMU_DMEM_ADDR_MASK;

	mutex_lock(&device->mutex);

	nvkm_wr32(device, (0x10a1c0 + (port * 8)), (dst | (0x1 << 24)));

	for (i = 0; i < w_size; i++)
		nvkm_wr32(device, (0x10a1c4 + (port * 8)), ((u32 *)src)[i]);

	if (b_size != 0) {
		u32 data = 0;
		memcpy(&data, ((u32 *)src) + w_size, b_size);
		nvkm_wr32(device, (0x10a1c4 + (port * 8)), data);
	}

	mutex_unlock(&device->mutex);

	return 0;
}


static void
pmu_load_hs_bl(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;
	struct hs_bin_hdr *hdr = sb->hsbl_blob;
	struct hsflcn_bl_desc *hsbl_desc = sb->hsbl_blob + hdr->header_offset;
	u32 acr_blob_vma_base = lower_32_bits(sb->acr_blob_vma.offset >> 8);
	void *hsbl_code = sb->hsbl_blob + hdr->data_offset;
	u32 code_size = ALIGN(hsbl_desc->bl_code_size, 256);
	u32 dst_blk;
	u32 tag;
	int i;

	/*
	 * Copy HS bootloader interface structure where the HS descriptor
	 * expects it to be, after updating virtual address of DMA bases
	 */
	sb->acr_bl_desc.code_dma_base += acr_blob_vma_base;
	sb->acr_bl_desc.data_dma_base += acr_blob_vma_base;
	pmu_copy_to_dmem(device, hsbl_desc->bl_desc_dmem_load_off,
			 &sb->acr_bl_desc, sizeof(sb->acr_bl_desc), 0);
	sb->acr_bl_desc.code_dma_base -= acr_blob_vma_base;
	sb->acr_bl_desc.data_dma_base -= acr_blob_vma_base;

	/* Copy HS bootloader code to IMEM */
	dst_blk = (nvkm_rd32(device, 0x10a108) & 0x1ff) - (code_size >> 8);
	tag = hsbl_desc->bl_start_tag;
	/* Set Auto-Increment on write */
	nvkm_wr32(device, 0x10a180, ((dst_blk & 0xff) << 8) | (0x1 << 24));
	for (i = 0; i < code_size; i += 4) {
		/* write new tag every 256B */
		if ((i % 0x100) == 0) {
			nvkm_wr32(device, 0x10a188, tag & 0xffff);
			tag++;
		}
		nvkm_wr32(device, 0x10a184, *(u32 *)(hsbl_code + i));
	}
	nvkm_wr32(device, 0x10a188, 0);
}

static int
pmu_bl_bootstrap(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;
	struct hs_bin_hdr *hdr = sb->hsbl_blob;
	struct hsflcn_bl_desc *hsbl_desc = sb->hsbl_blob + hdr->header_offset;
	/* virtual start address for boot vector */
	u32 virt_addr = hsbl_desc->bl_start_tag << 8;

	pmu_load_hs_bl(device);

	/* Set context */
	nvkm_mask(device, 0x10a048, 0x1, 0x1);
	nvkm_wr32(device, 0x10a480, ((sb->inst->addr >> 12) & 0xfffffff) |
				    (1 << 29) | (1 << 30));

	/* Set boot vector to code's starting virtual address */
	nvkm_wr32(device, 0x10a104, virt_addr);
	/* Start PMU */
	nvkm_wr32(device, 0x10a100, 0x2);

	return 0;
}

static int
pmu_setup(struct nvkm_device *device)
{
	int err;

	err = pmu_wait_clear_halt_interrupt(device, 10000);
	if (err)
		return err;

	err = pmu_reset(device);
	if (err)
		return err;
	/* setup apertures - virtual */
	nvkm_wr32(device, 0x10ae00 + 4 * (GK20A_PMU_DMAIDX_UCODE), 0x4 | 0x0);
	nvkm_wr32(device, 0x10ae00 + 4 * (GK20A_PMU_DMAIDX_VIRT), 0x0);
	/* setup apertures - physical */
	nvkm_wr32(device, 0x10ae00 + 4 * (GK20A_PMU_DMAIDX_PHYS_VID), 0x4);
	nvkm_wr32(device, 0x10ae00 + 4 * (GK20A_PMU_DMAIDX_PHYS_SYS_COH),
		  0x4 | 0x1);
	nvkm_wr32(device, 0x10ae00 + 4 * (GK20A_PMU_DMAIDX_PHYS_SYS_NCOH),
		  0x4 | 0x2);
	/* disable irqs for hs falcon booting as we will poll for halt */
	pmu_disable_irq(device);

	return 0;
}

static int
prepare_hs_bootloader(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;

	if (!sb->hsbl_blob) {
		sb->hsbl_blob = secure_boot_load_fw(device, "pmu_bl", 0);
		if (IS_ERR(sb->hsbl_blob)) {
			int err = PTR_ERR(sb->hsbl_blob);
			sb->hsbl_blob = NULL;
			return err;
		}
	}

	return 0;
}

static void
del_hs_bootloader(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;

	kfree(sb->hsbl_blob);
	sb->hsbl_blob = NULL;
}

/*
 * Executes a generic bootloader and wait for PMU to halt.
 * This BL will be used for those binaries that are loaded
 * and executed at times other than RM PMU Binary execution.
 *
 * @param[in] g			gk20a pointer
 * @param[in] desc		Bootloader descriptor
 * @param[in] dma_idx		DMA Index
 * @param[in] b_wait_for_halt	Wait for PMU to HALT
 */
static int
pmu_exec_gen_bl(struct nvkm_device *device)
{
	int err;

	nvdev_info(device, "Executing Generic Bootloader\n");

	err = pmu_setup(device);
	if (err)
		return err;
	err = pmu_bl_bootstrap(device);
	if (err)
		return err;

	/* Poll for HALT */
	err = pmu_wait_for_halt(device, 100000);
	if (err)
		return err;

	/* Clear the HALT interrupt */
	err = pmu_wait_clear_halt_interrupt(device, 10000);
	if (err)
		return err;

	return 0;
}

/**
 * hsf_img_patch_signature() - patch the HS blob with the correct signature
 */
static void
hsf_img_patch_signature(struct nvkm_device *device, void *acr_image)
{
	struct hs_bin_hdr *hsbin_hdr = acr_image;
	struct acr_fw_header *fw_hdr = acr_image + hsbin_hdr->header_offset;
	void *hs_data = acr_image + hsbin_hdr->data_offset;
	u32 patch_loc;
	u32 patch_sig;
	void *sig;
	u32 sig_size;

	patch_loc = *(u32 *)(acr_image + fw_hdr->patch_loc);
	patch_sig = *(u32 *)(acr_image + fw_hdr->patch_sig);

	/* Falcon in debug or production mode? */
	if ((nvkm_rd32(device, 0x10ac08) >> 20) & 0x1) {
		sig = acr_image + fw_hdr->sig_dbg_offset;
		sig_size = fw_hdr->sig_dbg_size;
	} else {
		sig = acr_image + fw_hdr->sig_prod_offset;
		sig_size = fw_hdr->sig_prod_size;
	}

	/* Patch signature */
	memcpy(hs_data + patch_loc, sig + patch_sig, sig_size);
}

/**
 * struct hsflcn_acr_desc - data section of the HS firmware
 * @signature:		signature of ACR ucode
 * @wpr_region_id:	region ID holding the WPR header and its details
 * @wpr_offset:		offset from the WPR region holding the wpr header
 * @regions:		region descriptors
 * @nonwpr_ucode_blob_size:	size of LS blob
 * @nonwpr_ucode_blob_start:	FB location of LS blob is
 */
struct hsflcn_acr_desc {
	union {
		u8 reserved_dmem[0x200];
		u32 signatures[4];
	} ucode_reserved_space;
	u32 wpr_region_id;
	u32 wpr_offset;
	u32 mmu_mem_range;
#define FLCN_ACR_MAX_REGIONS 2
	struct {
		u32 no_regions;
		struct {
			u32 start_addr;
			u32 end_addr;
			u32 region_id;
			u32 read_mask;
			u32 write_mask;
			u32 client_mask;
		} region_props[FLCN_ACR_MAX_REGIONS];
	} regions;
	u32 nonwpr_ucode_blob_size;
	u64 nonwpr_ucode_blob_start;
};

/**
 * hsf_img_patch_desc() - patch the HS firmware with location of the LS blob
 */
static void
hsf_img_patch_desc(struct secure_boot *sb, void *acr_image)
{
	struct hs_bin_hdr *hsbin_hdr = acr_image;
	struct acr_fw_header *fw_hdr = acr_image + hsbin_hdr->header_offset;
	struct acr_load_header *load_hdr = acr_image + fw_hdr->hdr_offset;
	void *hs_data = acr_image + hsbin_hdr->data_offset;
	struct hsflcn_acr_desc *desc = hs_data + load_hdr->data_dma_base;

	desc->nonwpr_ucode_blob_start = sb->ls_blob->addr;
	desc->nonwpr_ucode_blob_size = sb->ls_blob_size;
	desc->regions.no_regions = sb->ls_blob_nb_regions;
	desc->wpr_offset = 0;
}

static void
hsf_write_bl_desc(void *acr_image, struct flcn_bl_dmem_desc *bl_desc)
{
	struct hs_bin_hdr *hsbin_hdr = acr_image;
	struct acr_fw_header *fw_hdr = acr_image + hsbin_hdr->header_offset;
	struct acr_load_header *load_hdr = acr_image + fw_hdr->hdr_offset;

	/*
	 * Descriptor for the bootloader that will load the ACR image into
	 * IMEM/DMEM memory.
	 */
	fw_hdr = acr_image + hsbin_hdr->header_offset;
	load_hdr = acr_image + fw_hdr->hdr_offset;
	memset(bl_desc, 0, sizeof(*bl_desc));
	bl_desc->ctx_dma = GK20A_PMU_DMAIDX_VIRT;
	bl_desc->non_sec_code_off = load_hdr->non_sec_code_off;
	bl_desc->non_sec_code_size = load_hdr->non_sec_code_size;
	bl_desc->sec_code_off = load_hdr->sec_code_off;
	bl_desc->sec_code_size = load_hdr->sec_code_size;
	bl_desc->code_entry_point = 0;
	/*
	 * We need to set code_dma_base to the virtual address of the acr_blob,
	 * and add this address to data_dma_base before writing it into DMEM
	 */
	bl_desc->code_dma_base = 0;
	bl_desc->data_dma_base = load_hdr->data_dma_base >> 8;
	bl_desc->data_size = load_hdr->data_size;
}

static int
hsf_create_blob(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;
	void *acr_image;
	struct hs_bin_hdr *hsbin_hdr;
	u32 img_size;
	int err;

	acr_image = secure_boot_load_fw(device, "acr_ucode", 0);
	if (IS_ERR(acr_image))
		return PTR_ERR(acr_image);

	/* Patch image */
	hsf_img_patch_signature(device, acr_image);
	hsf_img_patch_desc(sb, acr_image);

	/* Generate HS BL descriptor */
	hsf_write_bl_desc(acr_image, &sb->acr_bl_desc);

	/* Create ACR blob and copy HS data to it */
	hsbin_hdr = acr_image;
	img_size = ALIGN(hsbin_hdr->data_size, 256);
	err = nvkm_gpuobj_new(device, img_size, 0x1000, true, NULL,
			      &sb->acr_blob);
	if (err)
		goto cleanup;

	nvkm_kmap(sb->acr_blob);
	nvkm_gpuobj_memcpy(sb->acr_blob, 0, acr_image + hsbin_hdr->data_offset,
			   img_size);
	nvkm_done(sb->acr_blob);

cleanup:
	kfree(acr_image);

	return err;
}

static void
hsf_del_blob(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;

	nvkm_gpuobj_del(&sb->acr_blob);
}

static int
secure_boot_init_vm(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;
	struct nvkm_vm *vm;
	int err;

	const u64 pmu_area_len = 600 * 1024;

	err = nvkm_gpuobj_new(device, 0x1000, 0, true, NULL, &sb->inst);
	if (err)
		return err;

	err = nvkm_gpuobj_new(device, 0x8000, 0, true, NULL, &sb->pgd);
	if (err)
		return err;

	err = nvkm_vm_new(device, 0, pmu_area_len, 0, NULL, &vm);
	if (err)
		return err;

	atomic_inc(&vm->engref[NVKM_SUBDEV_PMU]);

	err = nvkm_vm_ref(vm, &sb->vm, sb->pgd);
	nvkm_vm_ref(NULL, &vm, NULL);
	if (err)
		return err;

	nvkm_kmap(sb->inst);
	nvkm_wo32(sb->inst, 0x200, lower_32_bits(sb->pgd->addr));
	nvkm_wo32(sb->inst, 0x204, upper_32_bits(sb->pgd->addr));
	nvkm_wo32(sb->inst, 0x208, lower_32_bits(pmu_area_len - 1));
	nvkm_wo32(sb->inst, 0x20c, upper_32_bits(pmu_area_len - 1));
	nvkm_done(sb->inst);

	return 0;
}

static void
secure_boot_cleanup_vm(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;

	nvkm_vm_ref(NULL, &sb->vm, sb->pgd);
	nvkm_gpuobj_del(&sb->pgd);
	nvkm_gpuobj_del(&sb->inst);
}

const char *managed_falcons_names[] = {
	[LSF_FALCON_ID_PMU] = "PMU",
	[LSF_FALCON_ID_RESERVED] = "<invalid>",
	[LSF_FALCON_ID_FECS] = "FECS",
	[LSF_FALCON_ID_GPCCS] = "GPCCS",
	[LSF_FALCON_ID_END] = "<invalid>",
};

#ifdef CONFIG_ARCH_TEGRA
/* TODO Should this be handled by the Tegra MC driver? */
#define TEGRA_MC_BASE				0x70019000
#define MC_SECURITY_CARVEOUT2_CFG0		0xc58
#define MC_SECURITY_CARVEOUT2_BOM_0		0xc5c
#define MC_SECURITY_CARVEOUT2_BOM_HI_0		0xc60
#define MC_SECURITY_CARVEOUT2_SIZE_128K		0xc64
#define TEGRA_MC_SECURITY_CARVEOUT_CFG_LOCKED	(1 << 1)
static int
/* Temporarily map the MC registers so we can peek the WPR location */
secure_boot_tegra_read_wpr(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;
	void __iomem *mc;
	u32 cfg;

	mc = ioremap(TEGRA_MC_BASE, 0xd00);
	if (!mc) {
		nvdev_error(device, "Cannot map Tegra MC registers\n");
		return PTR_ERR(mc);
	}
	sb->wpr_addr = ioread32_native(mc + MC_SECURITY_CARVEOUT2_BOM_0) |
	      ((u64)ioread32_native(mc + MC_SECURITY_CARVEOUT2_BOM_HI_0) << 32);
	sb->wpr_size = ioread32_native(mc + MC_SECURITY_CARVEOUT2_SIZE_128K)
		<< 17;
	cfg = ioread32_native(mc + MC_SECURITY_CARVEOUT2_CFG0);
	iounmap(mc);

	/* Check that WPR settings are valid */
	if (sb->wpr_size == 0) {
		nvdev_error(device, "WPR region is empty\n");
		return -EINVAL;
	}

	if (!(cfg & TEGRA_MC_SECURITY_CARVEOUT_CFG_LOCKED)) {
		nvdev_error(device, "WPR region not locked\n");
		return -EINVAL;
	}

	return 0;
}
#else
static int
secure_boot_tegra_read_wpr(struct nvkm_device *device)
{
	nvdev_error(device, "Tegra support not compiled in\n");
	return -EINVAL;
}
#endif

int
nvkm_secure_boot_init(struct nvkm_device *device)
{
	struct secure_boot *sb;
	int err;

	sb = kzalloc(sizeof(*sb), GFP_KERNEL);
	if (!sb) {
		err = -ENOMEM;
		goto error;
	}
	device->secure_boot_state = sb;

	if (device->type == NVKM_DEVICE_TEGRA) {
		err = secure_boot_tegra_read_wpr(device);
		if (err)
			goto error;
	}

	err = secure_boot_init_vm(device);
	if (err) {
		kfree(sb);
		device->secure_boot_state = NULL;
		goto error;
	}

	return 0;

error:
	nvdev_error(device, "Secure Boot initialization failed: %d\n", err);
	return err;
}

void
nvkm_secure_boot_fini(struct nvkm_device *device)
{
	struct secure_boot *sb = device->secure_boot_state;

	if (!sb)
		return;

	if (sb->hsbl_blob)
		del_hs_bootloader(device);

	if (sb->acr_blob)
		hsf_del_blob(device);

	if (sb->ls_blob)
		del_ucode_blob(device);

	secure_boot_cleanup_vm(device);

	kfree(sb);
	device->secure_boot_state = NULL;
}

int
nvkm_secure_boot(struct nvkm_device *device)
{
	struct secure_boot *sb;
	unsigned long falcon_id;
	int err;

	sb = device->secure_boot_state;

	nvdev_info(device, "performing secure boot of:\n");
	for_each_set_bit(falcon_id, &device->chip->secure_boot.managed_falcons,
			 LSF_FALCON_ID_END) {
		char buf[32];
		snprintf(buf, sizeof(buf), "- %s\n",
			 managed_falcons_names[falcon_id]);
		nvdev_info(device, buf);
	}

	/* Load all the LS firmwares and prepare the blob */
	if (!sb->ls_blob) {
		err = prepare_ucode_blob(device);
		if (err)
			return err;
	}

	/* Load the HS firmware for the performing falcon */
	if (!sb->acr_blob) {
		err = hsf_create_blob(device);
		if (err)
			return err;
	}

	/* Load the HS firmware bootloader */
	if (!sb->hsbl_blob) {
		err = prepare_hs_bootloader(device);
		if (err)
			return err;
	}

	/* Map the HS firmware so the HS bootloader can see it */
	err = nvkm_gpuobj_map(sb->acr_blob, sb->vm, NV_MEM_ACCESS_RW,
			      &sb->acr_blob_vma);

	/*
	 * Run the HS bootloader. It will load the HS firmware and then run it.
	 * Once this returns, the LS firmwares will be loaded into the managed
	 * falcons.
	 */
	err = pmu_exec_gen_bl(device);
	if (err)
		return err;

	/* We don't need the ACR firmware anymore */
	nvkm_gpuobj_unmap(&sb->acr_blob_vma);

	return err;
}