iverilog/vvp/ufunc.h

94 lines
3.1 KiB
C++

#ifndef __ufunc_H
#define __ufunc_H
/*
* Copyright (c) 2002-2008 Stephen Williams (steve@icarus.com)
*
* This source code is free software; you can redistribute it
* and/or modify it in source code form under the terms of the GNU
* General Public License as published by the Free Software
* Foundation; either version 2 of the License, or (at your option)
* any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
*/
# include "pointers.h"
/*
* The .ufunc statement creates functors to represent user defined
* functions within the netlist (as opposed to within behavioral
* code.) The function device itself is implemented as a thread with a
* bunch of functors to receive input and a functor to deliver the
* output. (Functions have exactly one output.) The input functors
* detect that a change has occurred, and invoke the thread to process
* the new values. The thread then uses the output functor to deliver
* the result. The relationships look like this:
*
* ufunc_input_functor --+--> ufunc_core --> ...
* |
* ufunc_input_functor --+
* |
* ufunc_input_functor --+
*
* There are enough input functors to take all the function inputs, 4
* per functor. These inputs deliver the changed input value to the
* ufunc_core, which carries the infrastructure for the thread. The
* ufunc_core is also a functor whose output is connected to the rest
* of the netlist. This is where the result is delivered back to the
* netlist.
*
* This class relies to the vvp_wide_fun_* classes in vvp_net.h.
*/
class ufunc_core : public vvp_wide_fun_core {
public:
ufunc_core(unsigned ow, vvp_net_t*ptr,
unsigned nports, vvp_net_t**ports,
vvp_code_t start_address,
struct __vpiScope*call_scope,
char*result_label,
char*scope_label);
~ufunc_core();
struct __vpiScope*call_scope() { return call_scope_; }
struct __vpiScope*func_scope() { return func_scope_; }
void assign_bits_to_ports(vvp_context_t context);
void finish_thread(vthread_t thr);
private:
void recv_vec4_from_inputs(unsigned port);
void recv_real_from_inputs(unsigned port);
void invoke_thread_(void);
private:
// output width of the function node.
unsigned owid_;
// The vvp_net_t* objects for the function input ports. We use
// these to write the input values to the reg input variable
// functors for the thread.
vvp_net_t**ports_;
// This is a thread to execute the behavioral portion of the
// function.
vthread_t thread_;
struct __vpiScope*call_scope_;
struct __vpiScope*func_scope_;
vvp_code_t code_;
// Where the result will be.
vvp_net_t*result_;
};
#endif