You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

acl_base.h 21 kB

4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611
  1. /**
  2. * Copyright 2019-2020 Huawei Technologies Co., Ltd
  3. *
  4. * Licensed under the Apache License, Version 2.0 (the "License");
  5. * you may not use this file except in compliance with the License.
  6. * You may obtain a copy of the License at
  7. *
  8. * http://www.apache.org/licenses/LICENSE-2.0
  9. *
  10. * Unless required by applicable law or agreed to in writing, software
  11. * distributed under the License is distributed on an "AS IS" BASIS,
  12. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. * See the License for the specific language governing permissions and
  14. * limitations under the License.
  15. */
  16. #ifndef INC_EXTERNAL_ACL_ACL_BASE_H_
  17. #define INC_EXTERNAL_ACL_ACL_BASE_H_
  18. #include <stdint.h>
  19. #include <stddef.h>
  20. #include "error_codes/rt_error_codes.h"
  21. #include "error_codes/ge_error_codes.h"
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25. #if defined(_MSC_VER)
  26. #ifdef FUNC_VISIBILITY
  27. #define ACL_FUNC_VISIBILITY _declspec(dllexport)
  28. #else
  29. #define ACL_FUNC_VISIBILITY
  30. #endif
  31. #else
  32. #ifdef FUNC_VISIBILITY
  33. #define ACL_FUNC_VISIBILITY __attribute__((visibility("default")))
  34. #else
  35. #define ACL_FUNC_VISIBILITY
  36. #endif
  37. #endif
  38. #ifdef __GNUC__
  39. #define ACL_DEPRECATED __attribute__((deprecated))
  40. #define ACL_DEPRECATED_MESSAGE(message) __attribute__((deprecated(message)))
  41. #elif defined(_MSC_VER)
  42. #define ACL_DEPRECATED __declspec(deprecated)
  43. #define ACL_DEPRECATED_MESSAGE(message) __declspec(deprecated(message))
  44. #else
  45. #define ACL_DEPRECATED
  46. #define ACL_DEPRECATED_MESSAGE(message)
  47. #endif
  48. typedef void *aclrtStream;
  49. typedef void *aclrtEvent;
  50. typedef void *aclrtContext;
  51. typedef int aclError;
  52. typedef uint16_t aclFloat16;
  53. typedef struct aclDataBuffer aclDataBuffer;
  54. typedef struct aclTensorDesc aclTensorDesc;
  55. static const int ACL_ERROR_NONE = 0;
  56. static const int ACL_SUCCESS = 0;
  57. static const int ACL_ERROR_INVALID_PARAM = 100000;
  58. static const int ACL_ERROR_UNINITIALIZE = 100001;
  59. static const int ACL_ERROR_REPEAT_INITIALIZE = 100002;
  60. static const int ACL_ERROR_INVALID_FILE = 100003;
  61. static const int ACL_ERROR_WRITE_FILE = 100004;
  62. static const int ACL_ERROR_INVALID_FILE_SIZE = 100005;
  63. static const int ACL_ERROR_PARSE_FILE = 100006;
  64. static const int ACL_ERROR_FILE_MISSING_ATTR = 100007;
  65. static const int ACL_ERROR_FILE_ATTR_INVALID = 100008;
  66. static const int ACL_ERROR_INVALID_DUMP_CONFIG = 100009;
  67. static const int ACL_ERROR_INVALID_PROFILING_CONFIG = 100010;
  68. static const int ACL_ERROR_INVALID_MODEL_ID = 100011;
  69. static const int ACL_ERROR_DESERIALIZE_MODEL = 100012;
  70. static const int ACL_ERROR_PARSE_MODEL = 100013;
  71. static const int ACL_ERROR_READ_MODEL_FAILURE = 100014;
  72. static const int ACL_ERROR_MODEL_SIZE_INVALID = 100015;
  73. static const int ACL_ERROR_MODEL_MISSING_ATTR = 100016;
  74. static const int ACL_ERROR_MODEL_INPUT_NOT_MATCH = 100017;
  75. static const int ACL_ERROR_MODEL_OUTPUT_NOT_MATCH = 100018;
  76. static const int ACL_ERROR_MODEL_NOT_DYNAMIC = 100019;
  77. static const int ACL_ERROR_OP_TYPE_NOT_MATCH = 100020;
  78. static const int ACL_ERROR_OP_INPUT_NOT_MATCH = 100021;
  79. static const int ACL_ERROR_OP_OUTPUT_NOT_MATCH = 100022;
  80. static const int ACL_ERROR_OP_ATTR_NOT_MATCH = 100023;
  81. static const int ACL_ERROR_OP_NOT_FOUND = 100024;
  82. static const int ACL_ERROR_OP_LOAD_FAILED = 100025;
  83. static const int ACL_ERROR_UNSUPPORTED_DATA_TYPE = 100026;
  84. static const int ACL_ERROR_FORMAT_NOT_MATCH = 100027;
  85. static const int ACL_ERROR_BIN_SELECTOR_NOT_REGISTERED = 100028;
  86. static const int ACL_ERROR_KERNEL_NOT_FOUND = 100029;
  87. static const int ACL_ERROR_BIN_SELECTOR_ALREADY_REGISTERED = 100030;
  88. static const int ACL_ERROR_KERNEL_ALREADY_REGISTERED = 100031;
  89. static const int ACL_ERROR_INVALID_QUEUE_ID = 100032;
  90. static const int ACL_ERROR_REPEAT_SUBSCRIBE = 100033;
  91. static const int ACL_ERROR_STREAM_NOT_SUBSCRIBE = 100034;
  92. static const int ACL_ERROR_THREAD_NOT_SUBSCRIBE = 100035;
  93. static const int ACL_ERROR_WAIT_CALLBACK_TIMEOUT = 100036;
  94. static const int ACL_ERROR_REPEAT_FINALIZE = 100037;
  95. static const int ACL_ERROR_NOT_STATIC_AIPP = 100038;
  96. static const int ACL_ERROR_COMPILING_STUB_MODE = 100039;
  97. static const int ACL_ERROR_GROUP_NOT_SET = 100040;
  98. static const int ACL_ERROR_GROUP_NOT_CREATE = 100041;
  99. static const int ACL_ERROR_PROF_ALREADY_RUN = 100042;
  100. static const int ACL_ERROR_PROF_NOT_RUN = 100043;
  101. static const int ACL_ERROR_DUMP_ALREADY_RUN = 100044;
  102. static const int ACL_ERROR_DUMP_NOT_RUN = 100045;
  103. static const int ACL_ERROR_PROF_REPEAT_SUBSCRIBE = 148046;
  104. static const int ACL_ERROR_PROF_API_CONFLICT = 148047;
  105. static const int ACL_ERROR_INVALID_MAX_OPQUEUE_NUM_CONFIG = 148048;
  106. static const int ACL_ERROR_INVALID_OPP_PATH = 148049;
  107. static const int ACL_ERROR_BAD_ALLOC = 200000;
  108. static const int ACL_ERROR_API_NOT_SUPPORT = 200001;
  109. static const int ACL_ERROR_INVALID_DEVICE = 200002;
  110. static const int ACL_ERROR_MEMORY_ADDRESS_UNALIGNED = 200003;
  111. static const int ACL_ERROR_RESOURCE_NOT_MATCH = 200004;
  112. static const int ACL_ERROR_INVALID_RESOURCE_HANDLE = 200005;
  113. static const int ACL_ERROR_FEATURE_UNSUPPORTED = 200006;
  114. static const int ACL_ERROR_PROF_MODULES_UNSUPPORTED = 200007;
  115. static const int ACL_ERROR_STORAGE_OVER_LIMIT = 300000;
  116. static const int ACL_ERROR_INTERNAL_ERROR = 500000;
  117. static const int ACL_ERROR_FAILURE = 500001;
  118. static const int ACL_ERROR_GE_FAILURE = 500002;
  119. static const int ACL_ERROR_RT_FAILURE = 500003;
  120. static const int ACL_ERROR_DRV_FAILURE = 500004;
  121. static const int ACL_ERROR_PROFILING_FAILURE = 500005;
  122. #define ACL_TENSOR_SHAPE_RANGE_NUM 2
  123. #define ACL_UNKNOWN_RANK 0xFFFFFFFFFFFFFFFE
  124. typedef enum {
  125. ACL_DT_UNDEFINED = -1,
  126. ACL_FLOAT = 0,
  127. ACL_FLOAT16 = 1,
  128. ACL_INT8 = 2,
  129. ACL_INT32 = 3,
  130. ACL_UINT8 = 4,
  131. ACL_INT16 = 6,
  132. ACL_UINT16 = 7,
  133. ACL_UINT32 = 8,
  134. ACL_INT64 = 9,
  135. ACL_UINT64 = 10,
  136. ACL_DOUBLE = 11,
  137. ACL_BOOL = 12,
  138. ACL_STRING = 13,
  139. } aclDataType;
  140. typedef enum {
  141. ACL_FORMAT_UNDEFINED = -1,
  142. ACL_FORMAT_NCHW = 0,
  143. ACL_FORMAT_NHWC = 1,
  144. ACL_FORMAT_ND = 2,
  145. ACL_FORMAT_NC1HWC0 = 3,
  146. ACL_FORMAT_FRACTAL_Z = 4,
  147. ACL_FORMAT_NC1HWC0_C04 = 12,
  148. ACL_FORMAT_NDHWC = 27,
  149. ACL_FORMAT_FRACTAL_NZ = 29,
  150. ACL_FORMAT_NCDHW = 30,
  151. ACL_FORMAT_NDC1HWC0 = 32,
  152. ACL_FRACTAL_Z_3D = 33
  153. } aclFormat;
  154. typedef enum {
  155. ACL_DEBUG = 0,
  156. ACL_INFO = 1,
  157. ACL_WARNING = 2,
  158. ACL_ERROR = 3,
  159. } aclLogLevel;
  160. /**
  161. * @ingroup AscendCL
  162. * @brief Converts data of type aclFloat16 to data of type float
  163. *
  164. * @param value [IN] Data to be converted
  165. *
  166. * @retval Transformed data
  167. */
  168. ACL_FUNC_VISIBILITY float aclFloat16ToFloat(aclFloat16 value);
  169. /**
  170. * @ingroup AscendCL
  171. * @brief Converts data of type float to data of type aclFloat16
  172. *
  173. * @param value [IN] Data to be converted
  174. *
  175. * @retval Transformed data
  176. */
  177. ACL_FUNC_VISIBILITY aclFloat16 aclFloatToFloat16(float value);
  178. /**
  179. * @ingroup AscendCL
  180. * @brief create data of aclDataBuffer
  181. *
  182. * @param data [IN] pointer to data
  183. * @li Need to be managed by the user,
  184. * call aclrtMalloc interface to apply for memory,
  185. * call aclrtFree interface to release memory
  186. *
  187. * @param size [IN] size of data in bytes
  188. *
  189. * @retval pointer to created instance. nullptr if run out of memory
  190. *
  191. * @see aclrtMalloc | aclrtFree
  192. */
  193. ACL_FUNC_VISIBILITY aclDataBuffer *aclCreateDataBuffer(void *data, size_t size);
  194. /**
  195. * @ingroup AscendCL
  196. * @brief destroy data of aclDataBuffer
  197. *
  198. * @par Function
  199. * Only the aclDataBuffer type data is destroyed here.
  200. * The memory of the data passed in when the aclDataDataBuffer interface
  201. * is called to create aclDataBuffer type data must be released by the user
  202. *
  203. * @param dataBuffer [IN] pointer to the aclDataBuffer
  204. *
  205. * @retval ACL_SUCCESS The function is successfully executed.
  206. * @retval OtherValues Failure
  207. *
  208. * @see aclCreateDataBuffer
  209. */
  210. ACL_FUNC_VISIBILITY aclError aclDestroyDataBuffer(const aclDataBuffer *dataBuffer);
  211. /**
  212. * @ingroup AscendCL
  213. * @brief update new data of aclDataBuffer
  214. *
  215. * @param dataBuffer [OUT] pointer to aclDataBuffer
  216. * @li The old data need to be released by the user, otherwise it may occur memory leak leakage
  217. * call aclGetDataBufferAddr interface to get old data address
  218. * call aclrtFree interface to release memory
  219. *
  220. * @param data [IN] pointer to new data
  221. * @li Need to be managed by the user,
  222. * call aclrtMalloc interface to apply for memory,
  223. * call aclrtFree interface to release memory
  224. *
  225. * @param size [IN] size of data in bytes
  226. *
  227. * @retval ACL_SUCCESS The function is successfully executed.
  228. * @retval OtherValues Failure
  229. *
  230. * @see aclrtMalloc | aclrtFree | aclGetDataBufferAddr
  231. */
  232. ACL_FUNC_VISIBILITY aclError aclUpdateDataBuffer(aclDataBuffer *dataBuffer, void *data, size_t size);
  233. /**
  234. * @ingroup AscendCL
  235. * @brief get data address from aclDataBuffer
  236. *
  237. * @param dataBuffer [IN] pointer to the data of aclDataBuffer
  238. *
  239. * @retval data address
  240. */
  241. ACL_FUNC_VISIBILITY void *aclGetDataBufferAddr(const aclDataBuffer *dataBuffer);
  242. /**
  243. * @ingroup AscendCL
  244. * @brief get data size of aclDataBuffer
  245. *
  246. * @param dataBuffer [IN] pointer to the data of aclDataBuffer
  247. *
  248. * @retval data size
  249. */
  250. ACL_DEPRECATED_MESSAGE("aclGetDataBufferSize is deprecated, use aclGetDataBufferSizeV2 instead")
  251. ACL_FUNC_VISIBILITY uint32_t aclGetDataBufferSize(const aclDataBuffer *dataBuffer);
  252. /**
  253. * @ingroup AscendCL
  254. * @brief get data size of aclDataBuffer to replace aclGetDataBufferSize
  255. *
  256. * @param dataBuffer [IN] pointer to the data of aclDataBuffer
  257. *
  258. * @retval data size
  259. */
  260. ACL_FUNC_VISIBILITY size_t aclGetDataBufferSizeV2(const aclDataBuffer *dataBuffer);
  261. /**
  262. * @ingroup AscendCL
  263. * @brief get size of aclDataType
  264. *
  265. * @param dataType [IN] aclDataType data the size to get
  266. *
  267. * @retval size of the aclDataType
  268. */
  269. ACL_FUNC_VISIBILITY size_t aclDataTypeSize(aclDataType dataType);
  270. // interfaces of tensor desc
  271. /**
  272. * @ingroup AscendCL
  273. * @brief create data aclTensorDesc
  274. *
  275. * @param dataType [IN] Data types described by tensor
  276. * @param numDims [IN] the number of dimensions of the shape
  277. * @param dims [IN] the size of the specified dimension
  278. * @param format [IN] tensor format
  279. *
  280. * @retval aclTensorDesc pointer.
  281. * @retval nullptr if param is invalid or run out of memory
  282. */
  283. ACL_FUNC_VISIBILITY aclTensorDesc *aclCreateTensorDesc(aclDataType dataType, int numDims, const int64_t *dims,
  284. aclFormat format);
  285. /**
  286. * @ingroup AscendCL
  287. * @brief destroy data aclTensorDesc
  288. *
  289. * @param desc [IN] pointer to the data of aclTensorDesc to destroy
  290. */
  291. ACL_FUNC_VISIBILITY void aclDestroyTensorDesc(const aclTensorDesc *desc);
  292. /**
  293. * @ingroup AscendCL
  294. * @brief set tensor shape range for aclTensorDesc
  295. *
  296. * @param desc [OUT] pointer to the data of aclTensorDesc
  297. * @param dimsCount [IN] the number of dimensions of the shape
  298. * @param dimsRange [IN] the range of dimensions of the shape
  299. *
  300. * @retval ACL_SUCCESS The function is successfully executed.
  301. * @retval OtherValues Failure
  302. */
  303. ACL_FUNC_VISIBILITY aclError aclSetTensorShapeRange(aclTensorDesc *desc, size_t dimsCount,
  304. int64_t dimsRange[][ACL_TENSOR_SHAPE_RANGE_NUM]);
  305. /**
  306. * @ingroup AscendCL
  307. * @brief get data type specified by the tensor description
  308. *
  309. * @param desc [IN] pointer to the instance of aclTensorDesc
  310. *
  311. * @retval data type specified by the tensor description.
  312. * @retval ACL_DT_UNDEFINED if description is null
  313. */
  314. ACL_FUNC_VISIBILITY aclDataType aclGetTensorDescType(const aclTensorDesc *desc);
  315. /**
  316. * @ingroup AscendCL
  317. * @brief get data format specified by the tensor description
  318. *
  319. * @param desc [IN] pointer to the instance of aclTensorDesc
  320. *
  321. * @retval data format specified by the tensor description.
  322. * @retval ACL_FORMAT_UNDEFINED if description is null
  323. */
  324. ACL_FUNC_VISIBILITY aclFormat aclGetTensorDescFormat(const aclTensorDesc *desc);
  325. /**
  326. * @ingroup AscendCL
  327. * @brief get tensor size specified by the tensor description
  328. *
  329. * @param desc [IN] pointer to the instance of aclTensorDesc
  330. *
  331. * @retval data size specified by the tensor description.
  332. * @retval 0 if description is null
  333. */
  334. ACL_FUNC_VISIBILITY size_t aclGetTensorDescSize(const aclTensorDesc *desc);
  335. /**
  336. * @ingroup AscendCL
  337. * @brief get element count specified by the tensor description
  338. *
  339. * @param desc [IN] pointer to the instance of aclTensorDesc
  340. *
  341. * @retval element count specified by the tensor description.
  342. * @retval 0 if description is null
  343. */
  344. ACL_FUNC_VISIBILITY size_t aclGetTensorDescElementCount(const aclTensorDesc *desc);
  345. /**
  346. * @ingroup AscendCL
  347. * @brief get number of dims specified by the tensor description
  348. *
  349. * @param desc [IN] pointer to the instance of aclTensorDesc
  350. *
  351. * @retval number of dims specified by the tensor description.
  352. * @retval 0 if description is null
  353. * @retval ACL_UNKNOWN_RANK if the tensor dim is -2
  354. */
  355. ACL_FUNC_VISIBILITY size_t aclGetTensorDescNumDims(const aclTensorDesc *desc);
  356. /**
  357. * @ingroup AscendCL
  358. * @brief Get the size of the specified dim in the tensor description
  359. *
  360. * @param desc [IN] pointer to the instance of aclTensorDesc
  361. * @param index [IN] index of dims, start from 0.
  362. *
  363. * @retval dim specified by the tensor description and index.
  364. * @retval -1 if description or index is invalid
  365. */
  366. ACL_DEPRECATED_MESSAGE("aclGetTensorDescDim is deprecated, use aclGetTensorDescDimV2 instead")
  367. ACL_FUNC_VISIBILITY int64_t aclGetTensorDescDim(const aclTensorDesc *desc, size_t index);
  368. /**
  369. * @ingroup AscendCL
  370. * @brief Get the size of the specified dim in the tensor description
  371. *
  372. * @param desc [IN] pointer to the instance of aclTensorDesc
  373. * @param index [IN] index of dims, start from 0.
  374. * @param dimSize [OUT] size of the specified dim.
  375. *
  376. * @retval ACL_SUCCESS The function is successfully executed.
  377. * @retval OtherValues Failure
  378. */
  379. ACL_FUNC_VISIBILITY aclError aclGetTensorDescDimV2(const aclTensorDesc *desc, size_t index, int64_t *dimSize);
  380. /**
  381. * @ingroup AscendCL
  382. * @brief Get the range of the specified dim in the tensor description
  383. *
  384. * @param desc [IN] pointer to the instance of aclTensorDesc
  385. * @param index [IN] index of dims, start from 0.
  386. * @param dimRangeNum [IN] number of dimRange.
  387. * @param dimRange [OUT] range of the specified dim.
  388. *
  389. * @retval ACL_SUCCESS The function is successfully executed.
  390. * @retval OtherValues Failure
  391. */
  392. ACL_FUNC_VISIBILITY aclError aclGetTensorDescDimRange(const aclTensorDesc *desc, size_t index, size_t dimRangeNum,
  393. int64_t *dimRange);
  394. /**
  395. * @ingroup AscendCL
  396. * @brief set tensor description name
  397. *
  398. * @param desc [OUT] pointer to the instance of aclTensorDesc
  399. * @param name [IN] tensor description name
  400. */
  401. ACL_FUNC_VISIBILITY void aclSetTensorDescName(aclTensorDesc *desc, const char *name);
  402. /**
  403. * @ingroup AscendCL
  404. * @brief get tensor description name
  405. *
  406. * @param desc [IN] pointer to the instance of aclTensorDesc
  407. *
  408. * @retval tensor description name.
  409. * @retval empty string if description is null
  410. */
  411. ACL_FUNC_VISIBILITY const char *aclGetTensorDescName(aclTensorDesc *desc);
  412. /**
  413. * @ingroup AscendCL
  414. * @brief Convert the format in the source aclTensorDesc according to
  415. * the specified dstFormat to generate a new target aclTensorDesc.
  416. * The format in the source aclTensorDesc remains unchanged.
  417. *
  418. * @param srcDesc [IN] pointer to the source tensor desc
  419. * @param dstFormat [IN] destination format
  420. * @param dstDesc [OUT] pointer to the pointer to the destination tensor desc
  421. *
  422. * @retval ACL_SUCCESS The function is successfully executed.
  423. * @retval OtherValues Failure
  424. */
  425. ACL_FUNC_VISIBILITY aclError aclTransTensorDescFormat(const aclTensorDesc *srcDesc, aclFormat dstFormat,
  426. aclTensorDesc **dstDesc);
  427. /**
  428. * @ingroup AscendCL
  429. * @brief Set the storage format specified by the tensor description
  430. *
  431. * @param desc [OUT] pointer to the instance of aclTensorDesc
  432. * @param format [IN] the storage format
  433. *
  434. * @retval ACL_SUCCESS The function is successfully executed.
  435. * @retval OtherValues Failure
  436. */
  437. ACL_DEPRECATED_MESSAGE("aclSetTensorStorageFormat is deprecated, use aclSetTensorFormat instead")
  438. ACL_FUNC_VISIBILITY aclError aclSetTensorStorageFormat(aclTensorDesc *desc, aclFormat format);
  439. /**
  440. * @ingroup AscendCL
  441. * @brief Set the storage shape specified by the tensor description
  442. *
  443. * @param desc [OUT] pointer to the instance of aclTensorDesc
  444. * @param numDims [IN] the number of dimensions of the shape
  445. * @param dims [IN] the size of the specified dimension
  446. *
  447. * @retval ACL_SUCCESS The function is successfully executed.
  448. * @retval OtherValues Failure
  449. */
  450. ACL_DEPRECATED_MESSAGE("aclSetTensorStorageShape is deprecated, use aclSetTensorShape instead")
  451. ACL_FUNC_VISIBILITY aclError aclSetTensorStorageShape(aclTensorDesc *desc, int numDims, const int64_t *dims);
  452. /**
  453. * @ingroup AscendCL
  454. * @brief Set the format specified by the tensor description
  455. *
  456. * @param desc [OUT] pointer to the instance of aclTensorDesc
  457. * @param format [IN] the storage format
  458. *
  459. * @retval ACL_SUCCESS The function is successfully executed.
  460. * @retval OtherValues Failure
  461. */
  462. ACL_FUNC_VISIBILITY aclError aclSetTensorFormat(aclTensorDesc *desc, aclFormat format);
  463. /**
  464. * @ingroup AscendCL
  465. * @brief Set the shape specified by the tensor description
  466. *
  467. * @param desc [OUT] pointer to the instance of aclTensorDesc
  468. * @param numDims [IN] the number of dimensions of the shape
  469. * @param dims [IN] the size of the specified dimension
  470. *
  471. * @retval ACL_SUCCESS The function is successfully executed.
  472. * @retval OtherValues Failure
  473. */
  474. ACL_FUNC_VISIBILITY aclError aclSetTensorShape(aclTensorDesc *desc, int numDims, const int64_t *dims);
  475. /**
  476. * @ingroup AscendCL
  477. * @brief Set the original format specified by the tensor description
  478. *
  479. * @param desc [OUT] pointer to the instance of aclTensorDesc
  480. * @param format [IN] the storage format
  481. *
  482. * @retval ACL_SUCCESS The function is successfully executed.
  483. * @retval OtherValues Failure
  484. */
  485. ACL_FUNC_VISIBILITY aclError aclSetTensorOriginFormat(aclTensorDesc *desc, aclFormat format);
  486. /**
  487. * @ingroup AscendCL
  488. * @brief Set the original shape specified by the tensor description
  489. *
  490. * @param desc [OUT] pointer to the instance of aclTensorDesc
  491. * @param numDims [IN] the number of dimensions of the shape
  492. * @param dims [IN] the size of the specified dimension
  493. *
  494. * @retval ACL_SUCCESS The function is successfully executed.
  495. * @retval OtherValues Failure
  496. */
  497. ACL_FUNC_VISIBILITY aclError aclSetTensorOriginShape(aclTensorDesc *desc, int numDims, const int64_t *dims);
  498. /**
  499. * @ingroup AscendCL
  500. * @brief get op description info
  501. *
  502. * @param desc [IN] pointer to tensor description
  503. * @param index [IN] index of tensor
  504. *
  505. * @retval null for failed.
  506. * @retval OtherValues success.
  507. */
  508. ACL_FUNC_VISIBILITY aclTensorDesc *aclGetTensorDescByIndex(aclTensorDesc *desc, size_t index);
  509. /**
  510. * @ingroup AscendCL
  511. * @brief get address of tensor
  512. *
  513. * @param desc [IN] pointer to tensor description
  514. *
  515. * @retval null for failed
  516. * @retval OtherValues success
  517. */
  518. ACL_FUNC_VISIBILITY void *aclGetTensorDescAddress(const aclTensorDesc *desc);
  519. /**
  520. * @ingroup AscendCL
  521. * @brief Set the dynamic input name specified by the tensor description
  522. *
  523. * @param desc [OUT] pointer to the instance of aclTensorDesc
  524. * @param dynamicInputName [IN] pointer to the dynamic input name
  525. *
  526. * @retval ACL_SUCCESS The function is successfully executed.
  527. * @retval OtherValues Failure
  528. */
  529. ACL_FUNC_VISIBILITY aclError aclSetTensorDynamicInput(aclTensorDesc *desc, const char *dynamicInputName);
  530. /**
  531. * @ingroup AscendCL
  532. * @brief Set const data specified by the tensor description
  533. *
  534. * @param desc [OUT] pointer to the instance of aclTensorDesc
  535. * @param dataBuffer [IN] pointer to the const databuffer
  536. * @param length [IN] the length of const databuffer
  537. *
  538. * @retval ACL_SUCCESS The function is successfully executed.
  539. * @retval OtherValues Failure
  540. */
  541. ACL_FUNC_VISIBILITY aclError aclSetTensorConst(aclTensorDesc *desc, void *dataBuffer, size_t length);
  542. /**
  543. * @ingroup AscendCL
  544. * @brief an interface for users to output APP logs
  545. *
  546. * @param logLevel [IN] the level of current log
  547. * @param func [IN] the function where the log is located
  548. * @param file [IN] the file where the log is located
  549. * @param line [IN] Number of source lines where the log is located
  550. * @param fmt [IN] the format of current log
  551. * @param ... [IN] the value of current log
  552. */
  553. ACL_FUNC_VISIBILITY void aclAppLog(aclLogLevel logLevel, const char *func, const char *file, uint32_t line,
  554. const char *fmt, ...);
  555. #define ACL_APP_LOG(level, fmt, ...) aclAppLog(level, __FUNCTION__, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
  556. #ifdef __cplusplus
  557. }
  558. #endif
  559. #endif // INC_EXTERNAL_ACL_ACL_BASE_H_

图引擎模块(GE)是MindSpore的一个子模块,其代码由C++实现,位于前端模块ME和底层硬件之间,起到承接作用。图引擎模块以ME下发的图作为输入,然后进行一系列的深度图优化操作,最后输出一张可以在底层硬件上高效运行的图。GE针对昇腾AI处理器的硬件结构特点,做了特定的优化工作,以此来充分发挥出昇腾AI处理器的强大算力。在进行模型训练/推理时,GE会被自动调用而用户并不感知。GE主要由GE API和GE Core两部分组成,详细的架构图如下所示