Blame view

include/fsl_avb.h 8.32 KB
64520f3e5   Ye Li   MLK-18591-1 andro...
1
2
3
4
5
6
7
8
  /*
   * Copyright (C) 2016 Freescale Semiconductor, Inc.
   *
   * SPDX-License-Identifier:     GPL-2.0+
   */
  
  #ifndef __FSL_AVB_H__
  #define __FSL_AVB_H__
64520f3e5   Ye Li   MLK-18591-1 andro...
9
  #include "../lib/avb/libavb_atx/libavb_atx.h"
f5cda163c   Ji Luo   MA-17338-1 Enable...
10
  #include "../lib/avb/fsl/fsl_bootctrl.h"
64520f3e5   Ye Li   MLK-18591-1 andro...
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
  /* Reads |num_bytes| from offset |offset| from partition with name
   * |partition| (NUL-terminated UTF-8 string). If |offset| is
   * negative, its absolute value should be interpreted as the number
   * of bytes from the end of the partition.
   *
   * This function returns AVB_IO_RESULT_ERROR_NO_SUCH_PARTITION if
   * there is no partition with the given name,
   * AVB_IO_RESULT_ERROR_RANGE_OUTSIDE_PARTITION if the requested
   * |offset| is outside the partition, and AVB_IO_RESULT_ERROR_IO if
   * there was an I/O error from the underlying I/O subsystem.  If the
   * operation succeeds as requested AVB_IO_RESULT_OK is returned and
   * the data is available in |buffer|.
   *
   * The only time partial I/O may occur is if reading beyond the end
   * of the partition. In this case the value returned in
   * |out_num_read| may be smaller than |num_bytes|.
   */
  AvbIOResult fsl_read_from_partition(AvbOps* ops, const char* partition,
                                      int64_t offset, size_t num_bytes,
                                      void* buffer, size_t* out_num_read);
  
  /* multi block read version
   * */
  AvbIOResult fsl_read_from_partition_multi(AvbOps* ops, const char* partition,
                                            int64_t offset, size_t num_bytes,
                                            void* buffer, size_t* out_num_read);
  
  /* Writes |num_bytes| from |bffer| at offset |offset| to partition
   * with name |partition| (NUL-terminated UTF-8 string). If |offset|
   * is negative, its absolute value should be interpreted as the
   * number of bytes from the end of the partition.
   *
   * This function returns AVB_IO_RESULT_ERROR_NO_SUCH_PARTITION if
   * there is no partition with the given name,
   * AVB_IO_RESULT_ERROR_RANGE_OUTSIDE_PARTITION if the requested
   * byterange goes outside the partition, and AVB_IO_RESULT_ERROR_IO
   * if there was an I/O error from the underlying I/O subsystem.  If
   * the operation succeeds as requested AVB_IO_RESULT_OK is
   * returned.
   *
   * This function never does any partial I/O, it either transfers all
   * of the requested bytes or returns an error.
   */
  AvbIOResult fsl_write_to_partition(AvbOps* ops, const char* partition,
                                     int64_t offset, size_t num_bytes,
                                     const void* buffer);
64520f3e5   Ye Li   MLK-18591-1 andro...
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
  /* Checks if the given public key used to sign the 'vbmeta'
   * partition is trusted. Boot loaders typically compare this with
   * embedded key material generated with 'avbtool
   * extract_public_key'.
   *
   * If AVB_IO_RESULT_OK is returned then |out_is_trusted| is set -
   * true if trusted or false if untrusted.
   */
  AvbIOResult fsl_validate_vbmeta_public_key_rpmb(AvbOps* ops,
                                                  const uint8_t* public_key_data,
                                                  size_t public_key_length,
                                                  const uint8_t* public_key_metadata,
                                                  size_t public_key_metadata_length,
                                                  bool* out_is_trusted);
  
  /* Gets the rollback index corresponding to the slot given by
   * |rollback_index_slot|. The value is returned in
   * |out_rollback_index|. Returns AVB_IO_RESULT_OK if the rollback
   * index was retrieved, otherwise an error code.
   *
   * A device may have a limited amount of rollback index slots (say,
   * one or four) so may error out if |rollback_index_slot| exceeds
   * this number.
   */
  AvbIOResult fsl_read_rollback_index_rpmb(AvbOps* ops, size_t rollback_index_slot,
                                           uint64_t* out_rollback_index);
  
  /* Sets the rollback index corresponding to the slot given by
   * |rollback_index_slot| to |rollback_index|. Returns
   * AVB_IO_RESULT_OK if the rollback index was set, otherwise an
   * error code.
   *
   * A device may have a limited amount of rollback index slots (say,
   * one or four) so may error out if |rollback_index_slot| exceeds
   * this number.
   */
  AvbIOResult fsl_write_rollback_index_rpmb(AvbOps* ops, size_t rollback_index_slot,
                                            uint64_t rollback_index);
  
  /* Gets whether the device is unlocked. The value is returned in
   * |out_is_unlocked| (true if unlocked, false otherwise). Returns
   * AVB_IO_RESULT_OK if the state was retrieved, otherwise an error
   * code.
   */
  AvbIOResult fsl_read_is_device_unlocked(AvbOps* ops, bool* out_is_unlocked);
  
  /* Gets the unique partition GUID for a partition with name in
   * |partition| (NUL-terminated UTF-8 string). The GUID is copied as
   * a string into |guid_buf| of size |guid_buf_size| and will be NUL
   * terminated. The string must be lower-case and properly
   * hyphenated. For example:
   *
   *  527c1c6d-6361-4593-8842-3c78fcd39219
   *
   * Returns AVB_IO_RESULT_OK on success, otherwise an error code.
   */
  AvbIOResult fsl_get_unique_guid_for_partition(AvbOps* ops,
                                                const char* partition,
                                                char* guid_buf,
                                                size_t guid_buf_size);
  
  /* Gets the size of a partition with the name in |partition|
   * (NUL-terminated UTF-8 string). Returns the value in
   * |out_size_num_bytes|.
   * Returns AVB_IO_RESULT_OK on success, otherwise an error code.
   */
  AvbIOResult fsl_get_size_of_partition(AvbOps* ops,
                                        const char* partition,
                                        uint64_t* out_size_num_bytes);
64520f3e5   Ye Li   MLK-18591-1 andro...
126
127
128
129
130
131
132
133
134
135
136
137
  
  /* reset rollback_index part in avbkey partition
   * used in the switch from LOCK to UNLOCK
   * return 0 if success, non 0 if fail.
   * */
  int rbkidx_erase(void);
  
  /* init the avbkey in rpmb partition, include the header/public key/rollback index
   * for public key/rollback index part, use caam to do encrypt
   * return 0 if success, non 0 if fail.
   * */
  int avbkey_init(uint8_t *plainkey, uint32_t keylen);
64520f3e5   Ye Li   MLK-18591-1 andro...
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
  /* Reads permanent |attributes| data. There are no restrictions on where this
   * data is stored. On success, returns AVB_IO_RESULT_OK and populates
   * |attributes|.
   */
  AvbIOResult fsl_read_permanent_attributes(
      AvbAtxOps* atx_ops, AvbAtxPermanentAttributes* attributes);
  
  /* Reads a |hash| of permanent attributes. This hash MUST be retrieved from a
   * permanently read-only location (e.g. fuses) when a device is LOCKED. On
   * success, returned AVB_IO_RESULT_OK and populates |hash|.
   */
  AvbIOResult fsl_read_permanent_attributes_hash(AvbAtxOps* atx_ops,
                                                 uint8_t hash[AVB_SHA256_DIGEST_SIZE]);
  
  /* Provides the key version of a key used during verification. This may be
   * useful for managing the minimum key version.
   */
  void fsl_set_key_version(AvbAtxOps* atx_ops,
                           size_t rollback_index_location,
                           uint64_t key_version);
64520f3e5   Ye Li   MLK-18591-1 andro...
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
  /* Generates |num_bytes| random bytes and stores them in |output|,
   * which must point to a buffer large enough to store the bytes.
   *
   * Returns AVB_IO_RESULT_OK on success, otherwise an error code.
   */
  AvbIOResult fsl_get_random(AvbAtxOps* atx_ops,
  				size_t num_bytes,
  				uint8_t* output);
  
  /* Program ATX perm_attr into RPMB partition */
  int avb_atx_fuse_perm_attr(uint8_t *staged_buffer, uint32_t size);
  
  /* Initialize rpmb key with the staged key */
  int fastboot_set_rpmb_key(uint8_t *staged_buf, uint32_t key_size);
  
  /* Initialize rpmb key with random key which is generated by caam rng */
  int fastboot_set_rpmb_random_key(void);
  
  /* Generate ATX unlock challenge */
  int avb_atx_get_unlock_challenge(struct AvbAtxOps* atx_ops,
  				uint8_t *upload_buffer, uint32_t *size);
  /* Verify ATX unlock credential */
  int avb_atx_verify_unlock_credential(struct AvbAtxOps* atx_ops,
  					uint8_t *staged_buffer);
  /* Check if the perm-attr have been fused. */
  bool perm_attr_are_fused(void);
  
  /* Check if the unlock vboot is already disabled */
  bool at_unlock_vboot_is_disabled(void);
  
  /* disable at unlock vboot */
  int at_disable_vboot_unlock(void);
  
  /* Set vbmeta public key */
  int avb_set_public_key(uint8_t *staged_buffer, uint32_t size);
6bdc7d05c   Ji Luo   MA-15019-1 Suppor...
193
194
195
  
  /* Get manufacture protection  public key */
  int fastboot_get_mppubk(uint8_t *staged_buffer, uint32_t *size);
063d358ab   Ji Luo   MA-15321-3 Suppor...
196
197
  /* Check if hab is closed. */
  bool hab_is_enabled(void);
49bccf924   Ji Luo   MA-15158 Set spl ...
198
199
  /* Return if device is in spl recovery mode. */
  bool is_spl_recovery(void);
64520f3e5   Ye Li   MLK-18591-1 andro...
200
  #endif /* __FSL_AVB_H__ */