-------------------------------------------------------------------------------
-- Copyright (c) 2003 Mentor Graphics Corporation
--
-- This model is a component of the Mentor Graphics VHDL-AMS educational open 
-- source model library, and is covered by this license agreement. This model,
-- including any updates, modifications, revisions, copies, and documentation 
-- are copyrighted works of Mentor Graphics. USE OF THIS MODEL INDICATES YOUR 
-- COMPLETE AND UNCONDITIONAL ACCEPTANCE OF THE TERMS AND CONDITIONS SET FORTH
-- IN THIS LICENSE AGREEMENT.  Mentor Graphics grants you a non-exclusive 
-- license to use, reproduce, modify and distribute this model, provided that:
-- (a) no fee or other consideration is charged for any distribution except 
-- compilations distributed in accordance with Section (d) of this license 
-- agreement; (b) the comment text embedded in this model is included verbatim
-- in each copy of this model made or distributed by you, whether or not such 
-- version is modified; (c) any modified version must include a conspicuous 
-- notice that this model has been modified and the date of modification; and 
-- (d) any compilations sold by you that include this model must include a 
-- conspicuous notice that this model is available from Mentor Graphics in its
-- original form at no charge.
--
-- THIS MODEL IS LICENSED TO YOU "AS IS" AND WITH NO WARRANTIES, EXPRESS OR 
-- IMPLIED.  MENTOR GRAPHICS SPECIFICALLY DISCLAIMS ALL IMPLIED WARRANTIES OF 
-- MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  MENTOR GRAPHICS SHALL
-- HAVE NO RESPONSIBILITY FOR ANY DAMAGES WHATSOEVER.
-------------------------------------------------------------------------------
-- File       : connector_roundwire_hhm.vhd
-- Author     : Mentor Graphics
-- Created    : 2003-05-30
-- Last update: 
-------------------------------------------------------------------------------
-- Description: Connector model based on physical dimensions. Electrical characteristic 
-- formulas from "High Speed Digital System Design", by Hall, Hall and McCall, (pg. 104-106)
-- Uses formulas for round wire inductance and coupling. Assumes wire length >> wire radius.
-- Circuit topology:
--
--    "p1" --------L------- "n1"
--                 |     
--                 | LM
--                 |
--    "p2" --------L------- "n2" 
--
--  ... where L and LM values are computed from physical dimensions of the wire and spacing 
-------------------------------------------------------------------------------
-- Revisions  :
-- Date        Version     Author              Description
-- 2003-05-30  1.0         Mentor Graphics     Created
-------------------------------------------------------------------------------

Library IEEE;
USE IEEE.math_real.ALL;
USE IEEE.ELECTRICAL_SYSTEMS.ALL;

ENTITY connector_roundwire_hhm IS 
  GENERIC (
    len : real;		      -- Effective wire length (inches)
  	rad : real;           -- Effective wire radius (inches)
	s : real              -- Effective separation between wires (inches)
	);
  PORT (
    TERMINAL p1, p2, n1, n2 : electrical
	);
END ENTITY connector_roundwire_hhm;

ARCHITECTURE hhm OF connector_roundwire_hhm IS
constant mu_0 : real := 4.0e-7*math_pi;
constant L  : real := (mu_0/math_2_pi)*len*(log(2.0*len/rad) - 0.75);   -- Wire self-inductance
constant LM : real := (mu_0/math_2_pi)*len*(log(len/s + SQRT(1.0 + (len/s)**2.0)) - 
                       SQRT(1.0 + (s/len)**2.0) + s/len);               -- Mutual inductance
quantity v1 across i1 through p1 to n1;
quantity v2 across i2 through p2 to n2;

BEGIN

    v1 == L*i1'dot + LM*i2'dot;
    v2 == L*i2'dot + LM*i1'dot;

END ARCHITECTURE hhm;

-------------------------------------------------------------------------------
-- Copyright (c) 2003 Mentor Graphics Corporation
-------------------------------------------------------------------------------