Changes to the SDK 2.1 APIs for this release

The following table describes which APIs:
  • Have been updated for this release
  • Are new for this release
  • Have been replaced for this release
  • Were available in the previous release but have been removed for this release
Table 1. API changes
API Name API has been updated for this release Y/N New API for this release Changes from SDK 2.1 API removed for this release
Framework APIs        
alf_handle_t N      
ALF_ERR_POLICY_T N      
alf_init Y includes functionality of alf_configure      
alf_query_system_info Y      
alf_num_instances_set   X    
alf_exit N      
alf_error_handler_register N      
alf_configure       Y
Compute APIs        
alf_task_handle_t N      
alf_task_desc_handle_t   X    
alf_task_desc_create   X The task descriptor concept replaces the task_info structure in SDK 2.1  
alf_task_desc_destroy   X The task descriptor concept replaces the task_info structure in SDK 2.1  
alf_task_desc_ctx_entry_add   X The task descriptor concept replaces the task_info structure in SDK 2.1  
alf_task_desc_set_int32 Y      
alf_task_desc_set_int64   X    
alf_task_create   X The alf_task_create function in this new API is very different from the alf_task_create function in SDK 2.1. The differences are:
  • Task is created based on a task descriptor, not task_info
  • You can specify the number of instances of a task in this function.
  • Users can specify work block distribution
  • Task context data is provided through this function.
 
alf_task_finalize   X    
alf_task_wait Y   In SDK 2.1, alf_task_wait also signifies that you cannot add work blocks into a task. In this API, alf_task_wait is divided into two separate functions, alf_task_finalize and alf_task_wait.  
alf_task_query N      
alf_task_destroy N   It is no longer required to call this API to release the resources that a task uses.  
alf_task_depends_on   X    
alf_task_event_handler_register   X    
alf_task_info_t     API replaced by alf_desc_task_handle_t Y
alf_task_context_create     alf_task_create Y
alf_task_context_add_entry     alf_task_desc_ctx_entry_add Y
alf_task_context_register     alf_task_create Y
Work block APIs        
alf_wb_handle_t N      
alf_wb_create Y      
alf_wb_enqueue N      
alf_wb_dtl_begin   X    
alf_wb_parm_add N      
alf_wb_dtl_entry_add   X    
alf_wb_dtl_end   X    
alf_wb_add_io_buffer    

alf_wb_dtl_set_begin
alf_wb_dtl_entry_add
alf_wb_dtl_set_ end

 Y
alf_wb_sync       Y
sync_callback_func       Y
alf_wb_sync_wait       Y
alf_wb_sync_handle_t       Y
Data set APIs        
alf_dataset_handle_t   X    
alf_dataset_create   X    
alf_dataset_buffer_add   X    
alf_dataset_destroy   X    
alf_task_dataset_associate   X    
Accelerator APIs        
ALF_ACCEL_EXPORT_API_

LIST_BEGIN

   X    
ALF_ACCEL_EXPORT_API   X    
ALF_ACCEL_EXPORT_API_

LIST_END

   X    
Computational kernel APIs        
alf_accel_comp_kernel   X    
alf_accel_input_dtl_prepare   X    
alf_accel_output_dtl_prepare   X    
alf_accel_task_context_setup   X    
alf_accel_task_context_merge   X    
Runtime APIs        
alf_accel_num_instances   X    
alf_accel_instance_id   X    
ALF_ACCEL_DTL_BEGIN   X    
ALF_ACCEL_DTL_ENTRY_ADD   X    
ALF_ACCEL_DTL_END   X    
alf_comp_kernel     alf_accel_comp_kernel  
alf_prepare_input_list     alf_accel_input_dtl_prepare  
alf_prepare_output_list     alf_accel_output_dtl_prepare  
ALF_DT_LIST_CREATE    

ALF_ACCEL_DTL_BEGIN
ALF_ACCEL_DTL_END

  
Cell BE platform specific APIs        
ALF_ACCEL_DTL_CBEA_

DMA_LIST_BUFFER_UPDATE

   X    
ALF_ACCEL_DTL_CBEA_

DMA_LIST_BUFFER_GET

   X    
ALF_TASK_INFO_T_CBEA       Y