betaflight/src/main/io/vtx.c

/*
 * This file is part of Cleanflight.
 *
 * Cleanflight 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.
 *
 * Cleanflight 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 Cleanflight.  If not, see <http://www.gnu.org/licenses/>.
 */

#include <stdint.h>
#include <string.h>

#include "platform.h"

#if defined(USE_VTX_COMMON)

#include "common/time.h"
#include "common/maths.h"

#include "pg/pg.h"
#include "pg/pg_ids.h"

#include "drivers/vtx_common.h"

#include "fc/config.h"
#include "fc/runtime_config.h"
#include "fc/rc_modes.h"

#include "io/vtx.h"
#include "io/vtx_string.h"
#include "io/vtx_control.h"

#include "interface/cli.h"


PG_REGISTER_WITH_RESET_TEMPLATE(vtxSettingsConfig_t, vtxSettingsConfig, PG_VTX_SETTINGS_CONFIG, 0);

PG_RESET_TEMPLATE(vtxSettingsConfig_t, vtxSettingsConfig,
    .band = VTX_SETTINGS_DEFAULT_BAND,
    .channel = VTX_SETTINGS_DEFAULT_CHANNEL,
    .power = VTX_SETTINGS_DEFAULT_POWER,
    .freq = VTX_SETTINGS_DEFAULT_FREQ,
    .pitModeFreq = VTX_SETTINGS_DEFAULT_PITMODE_FREQ,
    .lowPowerDisarm = VTX_SETTINGS_DEFAULT_LOW_POWER_DISARM,
);

#define VTX_PARAM_CYCLE_TIME_US 100000 // 10Hz

typedef enum {
    VTX_PARAM_POWER = 0,
    VTX_PARAM_BANDCHAN,
    VTX_PARAM_PITMODE,
    VTX_PARAM_CONFIRM,
    VTX_PARAM_COUNT
} vtxScheduleParams_e;

void vtxInit(void)
{
    bool settingsUpdated = false;

    // sync frequency in parameter group when band/channel are specified
    const uint16_t freq = vtx58_Bandchan2Freq(vtxSettingsConfig()->band, vtxSettingsConfig()->channel);
    if (vtxSettingsConfig()->band && freq != vtxSettingsConfig()->freq) {
        vtxSettingsConfigMutable()->freq = freq;
        settingsUpdated = true;
    }

#if defined(VTX_SETTINGS_FREQCMD)
    // constrain pit mode frequency
    if (vtxSettingsConfig()->pitModeFreq) {
        const uint16_t constrainedPitModeFreq = MAX(vtxSettingsConfig()->pitModeFreq, VTX_SETTINGS_MIN_USER_FREQ);
        if (constrainedPitModeFreq != vtxSettingsConfig()->pitModeFreq) {
            vtxSettingsConfigMutable()->pitModeFreq = constrainedPitModeFreq;
            settingsUpdated = true;
        }
    }
#endif

    if (settingsUpdated) {
        saveConfigAndNotify();
    }
}

static vtxSettingsConfig_t vtxGetSettings(void) {
    vtxSettingsConfig_t settings = {
        .band = vtxSettingsConfig()->band,
        .channel = vtxSettingsConfig()->channel,
        .power = vtxSettingsConfig()->power,
        .freq = vtxSettingsConfig()->freq,
        .pitModeFreq = vtxSettingsConfig()->pitModeFreq,
        .lowPowerDisarm = vtxSettingsConfig()->lowPowerDisarm,
    };

#if defined(VTX_SETTINGS_FREQCMD)
    if (IS_RC_MODE_ACTIVE(BOXVTXPITMODE) && isModeActivationConditionPresent(BOXVTXPITMODE) && settings.pitModeFreq) {
        settings.band = 0;
        settings.freq = settings.pitModeFreq;
        settings.power = VTX_SETTINGS_DEFAULT_POWER;
    }
#endif

    if (!ARMING_FLAG(ARMED) && settings.lowPowerDisarm) {
        settings.power = VTX_SETTINGS_DEFAULT_POWER;
    }

    return settings;
}

static bool vtxProcessBandAndChannel(void) {
    if(!ARMING_FLAG(ARMED)) {
        uint8_t vtxBand;
        uint8_t vtxChan;
        if (vtxCommonGetBandAndChannel(&vtxBand, &vtxChan)) {
            const vtxSettingsConfig_t settings = vtxGetSettings();
            if (vtxBand != settings.band || vtxChan != settings.channel) {
                vtxCommonSetBandAndChannel(settings.band, settings.channel);
                return true;
            }
        }
    }
    return false;
}

#if defined(VTX_SETTINGS_FREQCMD)
static bool vtxProcessFrequency(void) {
    if(!ARMING_FLAG(ARMED)) {
        uint16_t vtxFreq;
        if (vtxCommonGetFrequency(&vtxFreq)) {
            const vtxSettingsConfig_t settings = vtxGetSettings();
            if (vtxFreq != settings.freq) {
                vtxCommonSetFrequency(settings.freq);
                return true;
            }
        }
    }
    return false;
}
#endif

static bool vtxProcessPower(void) {
    uint8_t vtxPower;
    if (vtxCommonGetPowerIndex(&vtxPower)) {
        const vtxSettingsConfig_t settings = vtxGetSettings();
        if (vtxPower != settings.power) {
            vtxCommonSetPowerByIndex(settings.power);
            return true;
        }
    }
    return false;
}

static bool vtxProcessPitMode(void) {
    uint8_t pitOnOff;
    if (!ARMING_FLAG(ARMED) && vtxCommonGetPitMode(&pitOnOff)) {
        if (IS_RC_MODE_ACTIVE(BOXVTXPITMODE)) {
#if defined(VTX_SETTINGS_FREQCMD)
            if (vtxSettingsConfig()->pitModeFreq) {
                return false;
            }
#endif
            if (isModeActivationConditionPresent(BOXVTXPITMODE)) {
                if (!pitOnOff) {
                    vtxCommonSetPitMode(true);
                    return true;
                }
            } else {
                if (pitOnOff) {
                    vtxCommonSetPitMode(false);
                    return true;
                }
            }
        }
    }
    return false;
}

static bool vtxProcessStateUpdate(void)
{
    const vtxSettingsConfig_t vtxSettingsState = vtxGetSettings();
    vtxSettingsConfig_t vtxState = vtxSettingsState;

    if (vtxSettingsState.band) {
        vtxCommonGetBandAndChannel(&vtxState.band, &vtxState.channel);
#if defined(VTX_SETTINGS_FREQCMD)
    } else {
        vtxCommonGetFrequency(&vtxState.freq);
#endif
    }

    vtxCommonGetPowerIndex(&vtxState.power);

    return (bool) memcmp(&vtxSettingsState, &vtxState, sizeof(vtxSettingsConfig_t));
}

void vtxUpdate(timeUs_t currentTimeUs)
{
    static timeUs_t lastCycleTimeUs;
    static uint8_t currentSchedule = 0;

    if (cliMode) {
        return;
    }

    // Check input sources for config updates
    vtxControlInputPoll();

    if (vtxCommonDeviceRegistered()) {
        bool vtxUpdatePending = false;
        const vtxSettingsConfig_t settings = vtxGetSettings();
        // Process VTX changes from the parameter group at 10Hz
        if (currentTimeUs > lastCycleTimeUs + VTX_PARAM_CYCLE_TIME_US) {
            switch (currentSchedule) {
            case VTX_PARAM_POWER:
                vtxUpdatePending = vtxProcessPower();
                break;
            case VTX_PARAM_BANDCHAN:
                if (settings.band) {
                    vtxUpdatePending = vtxProcessBandAndChannel();
#if defined(VTX_SETTINGS_FREQCMD)
                } else {
                    vtxUpdatePending = vtxProcessFrequency();
#endif
                }
                break;
            case VTX_PARAM_PITMODE:
                vtxUpdatePending = vtxProcessPitMode();
                break;
            case VTX_PARAM_CONFIRM:
                 vtxUpdatePending = vtxProcessStateUpdate();
                 break;
            default:
                break;
            }
            lastCycleTimeUs = currentTimeUs;
            currentSchedule = (currentSchedule + 1) % VTX_PARAM_COUNT;
        }
        if (!ARMING_FLAG(ARMED) || vtxUpdatePending) {
            vtxCommonProcess(currentTimeUs);
        }
    }
}

#endif