panel_electrical_spacing_iec60664.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KICAD, a free EDA CAD application.
 *
 * Copyright (C) 2023 Kicad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 3
 * 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, see <http://www.gnu.org/licenses/>.
 */
 
/* see
 * http://www.desmith.net/NMdS/Electronics/TraceWidth.html
 * http://www.ultracad.com/articles/pcbtemp.pdf
 * for more info
 */
#include <calculator_panels/panel_electrical_spacing.h>
#include <pcb_calculator_settings.h>
#include <string_utils.h>
#include "iec60664.h"
#include <wx/string.h>
#include <widgets/html_window.h>
#include <bitmaps.h>
 
 
#include <i18n_utility.h> // For _HKI definition in iec60664_help.h
wxString iec60664help =
#include "iec60664_help.h"
 
extern double DoubleFromString( const wxString& TextValue );
 
PANEL_ELECTRICAL_SPACING_IEC60664::PANEL_ELECTRICAL_SPACING_IEC60664( wxWindow* parent,
 wxWindowID id,
 const wxPoint& pos,
 const wxSize& size,
 long style,
 const wxString& name ) :
 PANEL_ELECTRICAL_SPACING_IEC60664_BASE( parent, id, pos, size, style, name )
{
 m_OVCchoice->SetSelection( 0 );
 m_insulationType->SetSelection( 0 );
 m_pollutionDegree->SetSelection( 0 );
 m_materialGroup->SetSelection( 0 );
 
 wxString msg;
 ConvertMarkdown2Html( wxGetTranslation( iec60664help ), msg );
 m_panelHelp->SetPage( msg );
 
 m_creepageclearanceBitmap->SetBitmap( KiBitmapBundle( BITMAPS::creepage_clearance ) );
 
 Layout();
}
 
 
PANEL_ELECTRICAL_SPACING_IEC60664::~PANEL_ELECTRICAL_SPACING_IEC60664()
{
}
 
 
void PANEL_ELECTRICAL_SPACING_IEC60664::ThemeChanged()
{
 m_creepageclearanceBitmap->SetBitmap( KiBitmapBundle( BITMAPS::creepage_clearance ) );
}
 
 
void PANEL_ELECTRICAL_SPACING_IEC60664::SaveSettings( PCB_CALCULATOR_SETTINGS* aCfg )
{
 if( !aCfg )
 return;
 
 aCfg->m_Electrical.iec60664_ratedVoltage = DoubleFromString( m_ratedVoltage->GetValue() );
 aCfg->m_Electrical.iec60664_RMSvoltage = DoubleFromString( m_RMSVoltage->GetValue() );
 aCfg->m_Electrical.iec60664_transientOV = DoubleFromString( m_transientOvervoltage->GetValue() );
 aCfg->m_Electrical.iec60664_peakOV = DoubleFromString( m_peakVoltage->GetValue() );
 aCfg->m_Electrical.iec60664_altitude = DoubleFromString( m_altitude->GetValue() );
 
 aCfg->m_Electrical.iec60664_OVC = m_OVCchoice->GetSelection();
 aCfg->m_Electrical.iec60664_insulationType = m_insulationType->GetSelection();
 aCfg->m_Electrical.iec60664_pollutionDegree = m_pollutionDegree->GetSelection();
 aCfg->m_Electrical.iec60664_materialGroup = m_materialGroup->GetSelection();
 
 aCfg->m_Electrical.iec60664_pcbMaterial = m_pcbMaterial->GetValue() ? 1 : 0;
}
 
 
void PANEL_ELECTRICAL_SPACING_IEC60664::LoadSettings( PCB_CALCULATOR_SETTINGS* aCfg )
{
 if( !aCfg )
 return;
 
 m_ratedVoltage->SetValue( wxString( "" ) << aCfg->m_Electrical.iec60664_ratedVoltage );
 m_RMSVoltage->SetValue( wxString( "" ) << aCfg->m_Electrical.iec60664_RMSvoltage );
 m_transientOvervoltage->SetValue( wxString( "" ) << aCfg->m_Electrical.iec60664_transientOV );
 m_peakVoltage->SetValue( wxString( "" ) << aCfg->m_Electrical.iec60664_peakOV );
 m_altitude->SetValue( wxString( "" ) << aCfg->m_Electrical.iec60664_altitude );
 
 m_OVCchoice->SetSelection( aCfg->m_Electrical.iec60664_OVC );
 m_insulationType->SetSelection( aCfg->m_Electrical.iec60664_insulationType );
 m_pollutionDegree->SetSelection( aCfg->m_Electrical.iec60664_pollutionDegree );
 m_materialGroup->SetSelection( aCfg->m_Electrical.iec60664_materialGroup );
 
 m_pcbMaterial->SetValue( aCfg->m_Electrical.iec60664_pcbMaterial ? true : false );
 
 CalculateTransientImpulse();
 CalculateClearanceCreepage();
}
 
 
void PANEL_ELECTRICAL_SPACING_IEC60664::CalculateTransientImpulse()
{
 IEC60664::OV_CATEGORY ovc;
 
 switch( m_OVCchoice->GetSelection() )
 {
 case 0: ovc = IEC60664::OV_CATEGORY::OV_I; break;
 case 1: ovc = IEC60664::OV_CATEGORY::OV_II; break;
 case 2: ovc = IEC60664::OV_CATEGORY::OV_III; break;
 default: ovc = IEC60664::OV_CATEGORY::OV_IV; break;
 }
 
 wxString string = m_ratedVoltage->GetValue();
 double value = 0;
 
 if( string.ToDouble( &value ) )
 {
 IEC60664 cal;
 cal.SetOvervoltageCategory( ovc );
 cal.SetRatedVoltage( value );
 string = "";
 double result = cal.GetRatedImpulseWithstandVoltage();
 
 if( result >= 0 )
 string << result / 1000;
 else
 string << _( "Error" );
 
 m_impulseVotlage1TxtCtrl->SetValue( string );
 }
}
 
 
void PANEL_ELECTRICAL_SPACING_IEC60664::UpdateTransientImpulse( wxCommandEvent& event )
{
 CalculateTransientImpulse();
}
 
 
void PANEL_ELECTRICAL_SPACING_IEC60664::CalculateClearanceCreepage()
{
 IEC60664::INSULATION_TYPE insul;
 IEC60664::POLLUTION_DEGREE pd;
 IEC60664::MATERIAL_GROUP mg;
 
 switch( m_insulationType->GetSelection() )
 {
 case 0: insul = IEC60664::INSULATION_TYPE::FUNCTIONAL; break;
 case 1: insul = IEC60664::INSULATION_TYPE::BASIC; break;
 default: insul = IEC60664::INSULATION_TYPE::REINFORCED; break;
 }
 
 switch( m_pollutionDegree->GetSelection() )
 {
 case 0: pd = IEC60664::POLLUTION_DEGREE::PD1; break;
 case 1: pd = IEC60664::POLLUTION_DEGREE::PD2; break;
 case 2: pd = IEC60664::POLLUTION_DEGREE::PD3; break;
 default: pd = IEC60664::POLLUTION_DEGREE::PD4; break;
 }
 
 switch( m_materialGroup->GetSelection() )
 {
 case 0: mg = IEC60664::MATERIAL_GROUP::MG_I; break;
 case 1: mg = IEC60664::MATERIAL_GROUP::MG_II; break;
 case 2: mg = IEC60664::MATERIAL_GROUP::MG_IIIa; break;
 default: mg = IEC60664::MATERIAL_GROUP::MG_IIIb; break;
 }
 
 double altitude = 0;
 double transientV = 0;
 double RMSV = 0;
 double peakV = 0;
 
 if( m_altitude->GetValue().ToDouble( &altitude )
 && m_transientOvervoltage->GetValue().ToDouble( &transientV )
 && m_peakVoltage->GetValue().ToDouble( &peakV )
 && m_RMSVoltage->GetValue().ToDouble( &RMSV ) )
 {
 IEC60664 cal;
 cal.SetPollutionDegree( pd );
 cal.SetMaterialGroup( mg );
 cal.SetInsulationType( insul );
 cal.SetAltitude( altitude );
 cal.SetTransientVoltage( transientV );
 cal.SetPeakVoltage( peakV );
 cal.SetRMSVoltage( RMSV );
 cal.SetPCBMaterial( m_pcbMaterial->GetValue() );
 
 cal.Compute();
 
 double groove = cal.GetMinGrooveWidth();
 double creepage = cal.GetCreepageDistance();
 double clearange = cal.GetClearanceDistance();
 
 wxString string;
 
 if( groove >= 0 )
 string << groove;
 else
 string << _( "Error" );
 
 m_minGrooveWidth->SetValue( string );
 
 string.Clear();
 
 if( creepage >= 0 )
 string << creepage;
 else
 string << _( "Error" );
 
 m_creepage->SetValue( string );
 
 string.Clear();
 
 if( clearange >= 0 )
 string << clearange;
 else
 string << _( "Error" );
 
 m_clearance->SetValue( string );
 }
 else
 {
 m_minGrooveWidth->SetValue( _( "Error" ) );
 m_creepage->SetValue( _( "Error" ) );
 m_clearance->SetValue( _( "Error" ) );
 }
}
 
 
void PANEL_ELECTRICAL_SPACING_IEC60664::UpdateClearanceCreepage( wxCommandEvent& event )
{
 CalculateClearanceCreepage();
}