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