ViennaCL - The Vienna Computing Library  1.7.0
Free open-source GPU-accelerated linear algebra and solver library.
opencl.hpp
Go to the documentation of this file.
1 #ifndef VIENNACL_BACKEND_OPENCL_HPP_
2 #define VIENNACL_BACKEND_OPENCL_HPP_
3 
4 /* =========================================================================
5  Copyright (c) 2010-2015, Institute for Microelectronics,
6  Institute for Analysis and Scientific Computing,
7  TU Wien.
8  Portions of this software are copyright by UChicago Argonne, LLC.
9 
10  -----------------
11  ViennaCL - The Vienna Computing Library
12  -----------------
13 
14  Project Head: Karl Rupp rupp@iue.tuwien.ac.at
15 
16  (A list of authors and contributors can be found in the manual)
17 
18  License: MIT (X11), see file LICENSE in the base directory
19 ============================================================================= */
20 
26 #include <vector>
27 #include "viennacl/ocl/handle.hpp"
28 #include "viennacl/ocl/backend.hpp"
29 
30 namespace viennacl
31 {
32 namespace backend
33 {
34 namespace opencl
35 {
36 
37 // Requirements for backend:
38 
39 // * memory_create(size, host_ptr)
40 // * memory_copy(src, dest, offset_src, offset_dest, size)
41 // * memory_write_from_main_memory(src, offset, size,
42 // dest, offset, size)
43 // * memory_read_to_main_memory(src, offset, size
44 // dest, offset, size)
45 // *
46 //
47 
55 inline cl_mem memory_create(viennacl::ocl::context const & ctx, vcl_size_t size_in_bytes, const void * host_ptr = NULL)
56 {
57  //std::cout << "Creating buffer (" << size_in_bytes << " bytes) host buffer " << host_ptr << " in context " << &ctx << std::endl;
58  return ctx.create_memory_without_smart_handle(CL_MEM_READ_WRITE, static_cast<unsigned int>(size_in_bytes), const_cast<void *>(host_ptr));
59 }
60 
69 inline void memory_copy(viennacl::ocl::handle<cl_mem> const & src_buffer,
70  viennacl::ocl::handle<cl_mem> & dst_buffer,
71  vcl_size_t src_offset,
72  vcl_size_t dst_offset,
73  vcl_size_t bytes_to_copy)
74 {
75  assert( &src_buffer.context() == &dst_buffer.context() && bool("Transfer between memory buffers in different contexts not supported yet!"));
76 
77  viennacl::ocl::context & memory_context = const_cast<viennacl::ocl::context &>(src_buffer.context());
78  cl_int err = clEnqueueCopyBuffer(memory_context.get_queue().handle().get(),
79  src_buffer.get(),
80  dst_buffer.get(),
81  src_offset,
82  dst_offset,
83  bytes_to_copy,
84  0, NULL, NULL); //events
85  VIENNACL_ERR_CHECK(err);
86 }
87 
88 
98  vcl_size_t dst_offset,
99  vcl_size_t bytes_to_copy,
100  const void * ptr,
101  bool async = false)
102 {
103 
104  viennacl::ocl::context & memory_context = const_cast<viennacl::ocl::context &>(dst_buffer.context());
105 
106 #if defined(VIENNACL_DEBUG_ALL) || defined(VIENNACL_DEBUG_DEVICE)
107  std::cout << "Writing data (" << bytes_to_copy << " bytes, offset " << dst_offset << ") to OpenCL buffer " << dst_buffer.get() << " with queue " << memory_context.get_queue().handle().get() << " from " << ptr << std::endl;
108 #endif
109 
110  cl_int err = clEnqueueWriteBuffer(memory_context.get_queue().handle().get(),
111  dst_buffer.get(),
112  async ? CL_FALSE : CL_TRUE, //blocking
113  dst_offset,
114  bytes_to_copy,
115  ptr,
116  0, NULL, NULL); //events
117  VIENNACL_ERR_CHECK(err);
118 }
119 
120 
129 inline void memory_read(viennacl::ocl::handle<cl_mem> const & src_buffer,
130  vcl_size_t src_offset,
131  vcl_size_t bytes_to_copy,
132  void * ptr,
133  bool async = false)
134 {
135  //std::cout << "Reading data (" << bytes_to_copy << " bytes, offset " << src_offset << ") from OpenCL buffer " << src_buffer.get() << " to " << ptr << std::endl;
136  viennacl::ocl::context & memory_context = const_cast<viennacl::ocl::context &>(src_buffer.context());
137  cl_int err = clEnqueueReadBuffer(memory_context.get_queue().handle().get(),
138  src_buffer.get(),
139  async ? CL_FALSE : CL_TRUE, //blocking
140  src_offset,
141  bytes_to_copy,
142  ptr,
143  0, NULL, NULL); //events
144  VIENNACL_ERR_CHECK(err);
145 }
146 
147 
148 }
149 } //backend
150 } //viennacl
151 #endif
cl_mem memory_create(viennacl::ocl::context const &ctx, vcl_size_t size_in_bytes, const void *host_ptr=NULL)
Creates an array of the specified size in the current OpenCL context. If the second argument is provi...
Definition: opencl.hpp:55
cl_mem create_memory_without_smart_handle(cl_mem_flags flags, unsigned int size, void *ptr=NULL) const
Creates a memory buffer within the context. Does not wrap the OpenCL handle into the smart-pointer-li...
Definition: context.hpp:196
viennacl::ocl::command_queue & get_queue()
Definition: context.hpp:266
Manages an OpenCL context and provides the respective convenience functions for creating buffers...
Definition: context.hpp:55
void memory_write(viennacl::ocl::handle< cl_mem > &dst_buffer, vcl_size_t dst_offset, vcl_size_t bytes_to_copy, const void *ptr, bool async=false)
Writes data from main RAM identified by 'ptr' to the OpenCL buffer identified by 'dst_buffer'.
Definition: opencl.hpp:97
void memory_read(viennacl::ocl::handle< cl_mem > const &src_buffer, vcl_size_t src_offset, vcl_size_t bytes_to_copy, void *ptr, bool async=false)
Reads data from an OpenCL buffer back to main RAM.
Definition: opencl.hpp:129
viennacl::ocl::context const & context() const
Definition: handle.hpp:191
viennacl::ocl::handle< cl_command_queue > const & handle() const
#define VIENNACL_ERR_CHECK(err)
Definition: error.hpp:681
Main namespace in ViennaCL. Holds all the basic types such as vector, matrix, etc. and defines operations upon them.
Definition: cpu_ram.hpp:34
const OCL_TYPE & get() const
Definition: handle.hpp:189
void memory_copy(viennacl::ocl::handle< cl_mem > const &src_buffer, viennacl::ocl::handle< cl_mem > &dst_buffer, vcl_size_t src_offset, vcl_size_t dst_offset, vcl_size_t bytes_to_copy)
Copies 'bytes_to_copy' bytes from address 'src_buffer + src_offset' in the OpenCL context to memory s...
Definition: opencl.hpp:69
Implementation of a smart-pointer-like class for handling OpenCL handles.
std::size_t vcl_size_t
Definition: forwards.h:75
Implementations of the OpenCL backend, where all contexts are stored in.