xref: /xnu-11215.61.5/EXTERNAL_HEADERS/img4/chip_ap_software.h (revision 4f1223e81cd707a65cc109d0b8ad6653699da3c4)
1*4f1223e8SApple OSS Distributions /*!
2*4f1223e8SApple OSS Distributions  * @header
3*4f1223e8SApple OSS Distributions  * Software AP chip environments.
4*4f1223e8SApple OSS Distributions  */
5*4f1223e8SApple OSS Distributions #ifndef __IMG4_CHIP_AP_SOFTWARE_H
6*4f1223e8SApple OSS Distributions #define __IMG4_CHIP_AP_SOFTWARE_H
7*4f1223e8SApple OSS Distributions 
8*4f1223e8SApple OSS Distributions #ifndef __IMG4_INDIRECT
9*4f1223e8SApple OSS Distributions #error "Please #include <img4/firmware.h> instead of this file directly"
10*4f1223e8SApple OSS Distributions #endif // __IMG4_INDIRECT
11*4f1223e8SApple OSS Distributions 
12*4f1223e8SApple OSS Distributions __BEGIN_DECLS
13*4f1223e8SApple OSS Distributions OS_ASSUME_NONNULL_BEGIN
14*4f1223e8SApple OSS Distributions OS_ASSUME_PTR_ABI_SINGLE_BEGIN
15*4f1223e8SApple OSS Distributions 
16*4f1223e8SApple OSS Distributions /*!
17*4f1223e8SApple OSS Distributions  * @const IMG4_CHIP_AP_SOFTWARE_FF00
18*4f1223e8SApple OSS Distributions  * A software-defined chip environment whose firmwares are executed on any
19*4f1223e8SApple OSS Distributions  * Application Processor on an Apple ARM SoC. The firmwares are loadable trust
20*4f1223e8SApple OSS Distributions  * caches shipped with OTA update brains.
21*4f1223e8SApple OSS Distributions  *
22*4f1223e8SApple OSS Distributions  * This chip cannot be uniquely identified.
23*4f1223e8SApple OSS Distributions  */
24*4f1223e8SApple OSS Distributions #if !XNU_KERNEL_PRIVATE
25*4f1223e8SApple OSS Distributions IMG4_API_AVAILABLE_20200508
26*4f1223e8SApple OSS Distributions OS_EXPORT
27*4f1223e8SApple OSS Distributions const img4_chip_t _img4_chip_ap_software_ff00;
28*4f1223e8SApple OSS Distributions #define IMG4_CHIP_AP_SOFTWARE_FF00 (&_img4_chip_ap_software_ff00)
29*4f1223e8SApple OSS Distributions #else
30*4f1223e8SApple OSS Distributions #define IMG4_CHIP_AP_SOFTWARE_FF00 (img4if->i4if_v7.chip_ap_software_ff00)
31*4f1223e8SApple OSS Distributions #endif
32*4f1223e8SApple OSS Distributions 
33*4f1223e8SApple OSS Distributions /*!
34*4f1223e8SApple OSS Distributions  * @const IMG4_CHIP_AP_SOFTWARE_FF01
35*4f1223e8SApple OSS Distributions  * A software-defined chip environment whose firmwares are executed on any
36*4f1223e8SApple OSS Distributions  * Application Processor on an Apple ARM SoC. The firmwares are loadable trust
37*4f1223e8SApple OSS Distributions  * caches which are shipped in the Install Assistant and loaded by an
38*4f1223e8SApple OSS Distributions  * unprivileged trampoline.
39*4f1223e8SApple OSS Distributions  *
40*4f1223e8SApple OSS Distributions  * This chip cannot be uniquely identified.
41*4f1223e8SApple OSS Distributions  */
42*4f1223e8SApple OSS Distributions #if !XNU_KERNEL_PRIVATE
43*4f1223e8SApple OSS Distributions IMG4_API_AVAILABLE_20200508
44*4f1223e8SApple OSS Distributions OS_EXPORT
45*4f1223e8SApple OSS Distributions const img4_chip_t _img4_chip_ap_software_ff01;
46*4f1223e8SApple OSS Distributions #define IMG4_CHIP_AP_SOFTWARE_FF01 (&_img4_chip_ap_software_ff01)
47*4f1223e8SApple OSS Distributions #else
48*4f1223e8SApple OSS Distributions #define IMG4_CHIP_AP_SOFTWARE_FF01 (img4if->i4if_v7.chip_ap_software_ff01)
49*4f1223e8SApple OSS Distributions #endif
50*4f1223e8SApple OSS Distributions 
51*4f1223e8SApple OSS Distributions /*!
52*4f1223e8SApple OSS Distributions  * @const IMG4_CHIP_AP_SOFTWARE_FF06
53*4f1223e8SApple OSS Distributions  * A software-defined chip environment whose firmwares are executed on any
54*4f1223e8SApple OSS Distributions  * Application Processor on an Apple ARM SoC. The firmwares are loadable trust
55*4f1223e8SApple OSS Distributions  * caches which are shipped in the preboot volume.
56*4f1223e8SApple OSS Distributions  *
57*4f1223e8SApple OSS Distributions  * This chip cannot be uniquely identified.
58*4f1223e8SApple OSS Distributions  */
59*4f1223e8SApple OSS Distributions #if !XNU_KERNEL_PRIVATE
60*4f1223e8SApple OSS Distributions IMG4_API_AVAILABLE_20210113
61*4f1223e8SApple OSS Distributions OS_EXPORT
62*4f1223e8SApple OSS Distributions const img4_chip_t _img4_chip_ap_software_ff06;
63*4f1223e8SApple OSS Distributions #define IMG4_CHIP_AP_SOFTWARE_FF06 (&_img4_chip_ap_software_ff06)
64*4f1223e8SApple OSS Distributions #else
65*4f1223e8SApple OSS Distributions #define IMG4_CHIP_AP_SOFTWARE_FF06 (img4if->i4if_v11.chip_ap_software_ff06)
66*4f1223e8SApple OSS Distributions #endif
67*4f1223e8SApple OSS Distributions 
68*4f1223e8SApple OSS Distributions OS_ASSUME_PTR_ABI_SINGLE_END
69*4f1223e8SApple OSS Distributions OS_ASSUME_NONNULL_END
70*4f1223e8SApple OSS Distributions __END_DECLS
71*4f1223e8SApple OSS Distributions 
72*4f1223e8SApple OSS Distributions #endif // __IMG4_CHIP_AP_SOFTWARE_H
73