UndercarriageCtrlGeom.h

Go to the documentation of this file.

/*
 * Copyright 2017 Fraunhofer Institute for Manufacturing Engineering and Automation (IPA)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
 
#ifndef UndercarriageCtrlGeom_INCLUDEDEF_H
#define UndercarriageCtrlGeom_INCLUDEDEF_H
 
//#include <time.h>
 
#include <cob_utilities/IniFile.h>
#include <cob_utilities/MathSup.h>
#include <cob_utilities/TimeStamp.h>
 
class UndercarriageCtrlGeom
{
private:
 
        bool m_bEMStopActive;
 
        int m_iNumberOfDrives;
 
        std::string m_sIniDirectory;
 
        /*// Logging for debugging
        // create Filepointers
        FILE * m_pfileDesVel, * m_pfileMeasVel;
        FILE * m_pfileSteerAngTarget1, * m_pfileSteerAngTarget2;
        FILE * m_pfileSteerAngTarget, * m_pfileDriveVelTarget;
        FILE * m_pfileSteerAngCmd, * m_pfileSteerVelCmd, * m_pfileDriveVelCmd;
        // create TimeStamp
        TimeStamp m_RawTime, m_StartTime;
        double m_dNowTime;*/
 
 
        // Actual Values for PltfMovement (calculated from Actual Wheelspeeds)
        double m_dVelLongMMS;
        double m_dVelLatMMS;
        double m_dRotRobRadS;
        double m_dRotVelRadS;
 
        // Actual Wheelspeed (read from Motor-Ctrls)
        std::vector<double> m_vdVelGearDriveRadS;
        std::vector<double> m_vdVelGearSteerRadS;
        std::vector<double> m_vdDltAngGearDriveRad;
        std::vector<double> m_vdAngGearSteerRad;
 
        // Desired Pltf-Movement (set from PltfHwItf)
        double m_dCmdVelLongMMS;
        double m_dCmdVelLatMMS;
        double m_dCmdRotRobRadS;
        double m_dCmdRotVelRadS;
 
        /*// Interpolated Wheelspeeds (calculated from desired and current Pltf-Config)
        std::vector<double> m_vdVelGearDriveIntpRadS;
        std::vector<double> m_vdVelGearSteerIntpRadS;
        std::vector<double> m_vdAngGearSteerIntpRad;
 
        // Delta values for interpolating between two commands
        std::vector<double> m_vdDeltaAngIntpRad;
        std::vector<double> m_vdDeltaDriveIntpRadS;*/
 
        // Desired Wheelspeeds set to ELMO-Ctrl's (calculated from desired Pltf-Movement)
        std::vector<double> m_vdVelGearDriveCmdRadS;
        std::vector<double> m_vdVelGearSteerCmdRadS;
        std::vector<double> m_vdAngGearSteerCmdRad;
 
        // Target Wheelspeed and -angle (calculated from desired Pltf-Movement with Inverse without controle!)
        // This Values might not be valid (to high step response in steering rate, ...) for commanding the drives
        std::vector<double> m_vdAngGearSteerTarget1Rad; // alternativ 1 for steering angle
        std::vector<double> m_vdVelGearDriveTarget1RadS;
        std::vector<double> m_vdAngGearSteerTarget2Rad; // alternativ 2 for steering angle (+/- PI)
        std::vector<double> m_vdVelGearDriveTarget2RadS;
        std::vector<double> m_vdAngGearSteerTargetRad; // choosen alternativ for steering angle
        std::vector<double> m_vdVelGearDriveTargetRadS;
 
        std::vector<double> m_vdWheelXPosMM;
        std::vector<double> m_vdWheelYPosMM;
        std::vector<double> m_vdWheelDistMM;
        std::vector<double> m_vdWheelAngRad;
 
        std::vector<double> m_vdExWheelXPosMM;
        std::vector<double> m_vdExWheelYPosMM;
        std::vector<double> m_vdExWheelDistMM;
        std::vector<double> m_vdExWheelAngRad;
 
        struct ParamType
        {
                int iDistWheels;
                int iRadiusWheelMM;
 
                int iDistSteerAxisToDriveWheelMM;
 
                double dMaxDriveRateRadpS;
                double dMaxSteerRateRadpS;
                double dCmdRateS;
                std::vector<double> WheelNeutralPos;
                std::vector<double> vdSteerDriveCoupling;
                std::vector<double> vdFactorVel;
        };
 
        ParamType m_UnderCarriagePrms;
 
        double m_dSpring, m_dDamp, m_dVirtM, m_dDPhiMax, m_dDDPhiMax;
        std::vector< std::vector<double> > m_vdCtrlVal;
 
        // Factor for thread cycle time of ThreadMotionPltfCtrl and ThreadUnderCarriageCtrl
        //double m_dThreadCycleMultiplier;
 
        // calculate inverse kinematics
        void CalcInverse(void);
 
        // calculate direct kinematics
        void CalcDirect(void);
 
        // calculate Exact Wheel Position in robot coordinates
        void CalcExWheelPos(void);
 
        // perform one discrete Controle Step
        void CalcControlStep(void);
 
public:
 
        // Constructor
        UndercarriageCtrlGeom(std::string sIniDirectory);
 
        // Destructor
        ~UndercarriageCtrlGeom(void);
 
        // Initialize Parameters for Controller and Kinematics
        void InitUndercarriageCtrl(void);
 
        // Set desired value for Plattform Velocity to UndercarriageCtrl (Sollwertvorgabe)
        void SetDesiredPltfVelocity(double dCmdVelLongMMS, double dCmdVelLatMMS, double dCmdRotRobRadS, double dCmdRotVelRadS);
 
        // Set actual values of wheels (steer/drive velocity/position) (Istwerte)
        void SetActualWheelValues(std::vector<double> vdVelGearDriveRadS, std::vector<double> vdVelGearSteerRadS, std::vector<double> vdDltAngGearDriveRad, std::vector<double> vdAngGearSteerRad);
 
        // Get result of inverse kinematics (without controller)
        void GetSteerDriveSetValues(std::vector<double> & vdVelGearDriveRadS, std::vector<double> & vdAngGearSteerRad);
 
        // Get set point values for the Wheels (including controller) from UndercarriangeCtrl
        void GetNewCtrlStateSteerDriveSetValues(std::vector<double> & vdVelGearDriveRadS, std::vector<double> & vdVelGearSteerRadS, std::vector<double> & vdAngGearSteerRad,
                                                double & dVelLongMMS, double & dVelLatMMS, double & dRotRobRadS, double & dRotVelRadS);
 
        // Get result of direct kinematics
        void GetActualPltfVelocity(double & dDeltaLongMM, double & dDeltaLatMM, double & dDeltaRotRobRad, double & dDeltaRotVelRad,
                                        double & dVelLongMMS, double & dVelLatMMS, double & dRotRobRadS, double & dRotVelRadS);
 
        // Set EM flag and stop Ctrlr
        void setEMStopActive(bool bEMStopActive);
 
        // operator overloading
        void operator=(const UndercarriageCtrlGeom & GeomCtrl);
};
#endif