Модуль соединения ПЕ с управлением из ведущей кабины ( с. м. е. )

[NightWolf3dartist]

Необходимо описание работы и применения этой системы с точки зрения её применения в игре (в библиотеке sdk в некоторых устройствах есть описание работы и применения устройства, в этой пока нет).
На сколько реализована и работоспособна эта система в симуляторе сейчас?
Как связан sme_коннектор из класса собственной ПЕ с модулем sme-joint?

[maisvendoo]

На сколько реализована и работоспособна эта система в симуляторе сейчас?

Она штатно применяется для реализации межвагонных связей на РА-3, собственно на её базе была придумана и разработана Михаилом Арепьевым. Она вполне работоспособна и пригодна для применения при разработке дополнений. Она также применяется в проекте ВЛ80с который сейчас пока заморожен.

Как связан sme_коннектор из класса собственной ПЕ с модулем sme-joint?

Переадресую этот вопрос Михаилу, так как он более компетентен в части этой подсистемы. Когда он будет свободен, обязательно ответит.

Необходимо описание работы и применения этой системы с точки зрения её применения в игре

Да, актуальная документация - наша ахиллесова пята....

P.S.: Попробую в течение дня набросать примерную концепцию применения

[maisvendoo]

Постараюсь в общих чертах изложить концепцию, а Михаил, если я ошибаюсь, меня поправит.

СМЕ, как и все что есть в игре, подчинено общему принципу - симулятор абстрагируется от того, что он симулирует, отдавая конкретику разработчику модуля, с которым взаимодействует через абстрактный интерфейс.

Соотвественно, связь по СМЕ между двумя подвижными единицами (ПЕ) опирается на два класса

1. Коннектор - "розетка" СМЕ, на которую выводятся входящие и исходящие сигналы. Наследуется от класса Device напрямую. Могут присутствовать несколько передних и задних коннекторов, которые храняться в соотвествующих списках базового класса Vehicle, именуемые forward_connectors и backward_connectors соответсвенно.
2. Joint - линия связи, которая описывает, какие входы одного из соединяемых коннекторов, соединяются с выходами другого.

Для каждой серии подвижного состава свой индивидуальный способ огранизации таких связей, поэтому необходима конкретная реализация в виде загружаемого модуля, в котором реализуется класс, наследуемый от Joint. На примере проекта ВЛ80с этот модуль называется joint-vl80-sme.

Этот модуль загружается самим симулятором, а конкретно классом Train при загрузке и инициализации поезда. При этом симулятор в каталоге конфигов каждой ПЕ ищет конфиги вида

joint-<Имя_переднего_коннектора>-<Имя_заднего_коннектора>.xml

Для секции ВЛ80с этот конфиг выглядит так

joint-VL80SME-VL80SME.xml

<?xml version="1.0" encoding="UTF-8"?>
<Config>
	<Joint>
		<ModuleDir>vl80s</ModuleDir>
		<ModuleName>joint-vl80-sme</ModuleName>

		<!-- Начальное состояние шлейфов СМЕ: 0 - разъединены, 1 - соединены -->
		<initConnectionState>1</initConnectionState>
	</Joint>
</Config>

Здесь указаны

• ModuleDir - каталог поиска модуля
• ModuleName - имя DLL модуля
• initConnectionState - состояние, к котором находятся передние и задние коннекторы при инициализации поезда в игре

Такой джоинт создается для каждой пары коннекторов - переднего у одной ПЕ и заднего у другой ПЕ. Внури описывается как соединены "контакты" коннекторов. Пример ВЛ80с

joint-vl80-sme.cpp

//------------------------------------------------------------------------------
//
//------------------------------------------------------------------------------
void JointVL80sme::step(double t, double dt)
{
    Q_UNUSED(t)
    Q_UNUSED(dt)

    // Управление соединением СМЕ, если не более 4 секций
    if (((devices[FWD]->getOutputSignal(SME_OUTPUT_REF_STATE) == 1.0) ||
        (devices[BWD]->getOutputSignal(SME_OUTPUT_REF_STATE) == 1.0)) &&
        ((devices[FWD]->getOutputSignal(SME_NUM_SECTIONS) +
        (devices[BWD]->getOutputSignal(SME_NUM_SECTIONS))) <= 4.0))
    {
        is_connected = true;
    }

    // Управление разъединением СМЕ, либо обнаружение уже 4 секций
    if ((devices[FWD]->getOutputSignal(SME_OUTPUT_REF_STATE) == -1.0) ||
        (devices[BWD]->getOutputSignal(SME_OUTPUT_REF_STATE) == -1.0) ||
        (devices[FWD]->getOutputSignal(SME_NUM_SECTIONS) >= 4.0) ||
        (devices[BWD]->getOutputSignal(SME_NUM_SECTIONS) >= 4.0))
    {
        is_connected = false;
    }

    if (is_connected)
    {
        devices[FWD]->setInputSignal(SME_INPUT_IS_CONNECTED, 1.0);
        devices[BWD]->setInputSignal(SME_INPUT_IS_CONNECTED, 1.0);

        /*for (size_t i = SME_NUM_SECTIONS; i < NUM_VL80_SME_SIGNALS; ++i)
        {
            devices[FWD]->setInputSignal(i, devices[BWD]->getOutputSignal(i));
            devices[BWD]->setInputSignal(i, devices[FWD]->getOutputSignal(i));
        }*/

        // Цепи управления токоприемниками
        devices[FWD]->setInputSignal(SME_E15_IN, devices[BWD]->getOutputSignal(SME_E15_OUT));
        devices[BWD]->setInputSignal(SME_E15_IN, devices[FWD]->getOutputSignal(SME_E15_OUT));

        devices[FWD]->setInputSignal(SME_E16_IN, devices[BWD]->getOutputSignal(SME_E17_OUT));
        devices[BWD]->setInputSignal(SME_E16_IN, devices[FWD]->getOutputSignal(SME_E17_OUT));

        devices[FWD]->setInputSignal(SME_E17_IN, devices[BWD]->getOutputSignal(SME_E16_OUT));
        devices[BWD]->setInputSignal(SME_E17_IN, devices[FWD]->getOutputSignal(SME_E16_OUT));

        devices[FWD]->setInputSignal(SME_E35_IN, devices[BWD]->getOutputSignal(SME_E35_OUT));
        devices[BWD]->setInputSignal(SME_E35_IN, devices[FWD]->getOutputSignal(SME_E35_OUT));

        devices[FWD]->setInputSignal(SME_E27_IN, devices[BWD]->getOutputSignal(SME_E28_OUT));
        devices[BWD]->setInputSignal(SME_E27_IN, devices[FWD]->getOutputSignal(SME_E28_OUT));

        devices[FWD]->setInputSignal(SME_E28_IN, devices[BWD]->getOutputSignal(SME_E27_OUT));
        devices[BWD]->setInputSignal(SME_E28_IN, devices[FWD]->getOutputSignal(SME_E27_OUT));

        devices[FWD]->setInputSignal(SME_E37_IN, devices[BWD]->getOutputSignal(SME_E37_OUT));
        devices[BWD]->setInputSignal(SME_E37_IN, devices[FWD]->getOutputSignal(SME_E37_OUT));

        devices[FWD]->setInputSignal(SME_E30_IN, devices[BWD]->getOutputSignal(SME_E30_OUT));
        devices[BWD]->setInputSignal(SME_E30_IN, devices[FWD]->getOutputSignal(SME_E30_OUT));
    }
    else
    {
        devices[FWD]->setInputSignal(SME_INPUT_IS_CONNECTED, 0.0);
        devices[BWD]->setInputSignal(SME_INPUT_IS_CONNECTED, 0.0);

        // Несоединённые контакты СМЕ
        for (size_t i = SME_NUM_SECTIONS; i < NUM_VL80_SME_SIGNALS; ++i)
        {
            devices[FWD]->setInputSignal(i, 0.0);
            devices[BWD]->setInputSignal(i, 0.0);
        }
    }
}

Метод step() вызывается на каждом шаге симуляции и обеспечивает верное соединение коннекторов двух ПЕ. Коннекторы содержаться в массиве devices.

Соотвественно, каждая ПЕ должна иметь эти коннекторы. У секции ВЛ80с класс коннектора описан в vl80-sme-connector.h. Он содержит массивы входный input_signals и выходных output_signals сигналов, на который выводятся провода межсекционных соединений. При инициализации необходимо определить размер этих массивов, и обязательно дать коннетору имя

vl80-sme-connector.cpp

//------------------------------------------------------------------------------
//
//------------------------------------------------------------------------------
VL80SME::VL80SME(QObject *parent) : Device(parent)
  , is_ref_state_command(false)
{
    name = QString("VL80SME");

    input_signals.resize(NUM_VL80_SME_SIGNALS);
    output_signals.resize(NUM_VL80_SME_SIGNALS);

    std::fill(input_signals.begin(), input_signals.end(), 0.0);
    std::fill(output_signals.begin(), output_signals.end(), 0.0);
}

Обратите внимание на то, что имя коннектора (VL80SME) в точности совпадает с тем именем которое указано в имени конфига джоинта! Имя конфига указывает какой коннекто с каким коннектором должен быть соединен. При инициализации поезда в классе Train происходит создание джоинта из модуля и добавление в него данных коннектров.

В коде модуля локомотива необходимо создать коннекторы и добавить их в соотвествующие списки передних и задних коннекторов

vl80s/src/vl80s-init-sme.cpp

//------------------------------------------------------------------------------
//
//------------------------------------------------------------------------------
void VL80s::initSME(const QString &modules_dir, const QString &custom_cfg_dir)
{
    (void) modules_dir;
    (void) custom_cfg_dir;

    // Инициализация связей системы многих единиц (СМЕ)
    sme_fwd = new VL80SME();
    sme_fwd->setKeyCode(KEY_Minus);
    sme_fwd->setCustomConfigDir(config_dir);
    forward_connectors.push_back(sme_fwd);

    sme_bwd = new VL80SME();
    sme_bwd->setKeyCode(KEY_Equals);
    sme_bwd->setCustomConfigDir(config_dir);
    backward_connectors.push_back(sme_bwd);
}

Далее, в секции происходит запись сигналов в выходы и чтение их из входов

vl80s/src/vl80s-step-sme.cpp

//------------------------------------------------------------------------------
//
//------------------------------------------------------------------------------
void VL80s::stepSME(double t, double dt)
{
    // Опрос количества секций в СМЕ
    sme_fwd->setSignal(SME_NUM_SECTIONS, sme_bwd->getSignal(SME_NUM_SECTIONS) + 1.0);
    sme_bwd->setSignal(SME_NUM_SECTIONS, sme_fwd->getSignal(SME_NUM_SECTIONS) + 1.0);

    if (km->isReversHandle())
    {
        // Запрет на включение реверсивки в других кабинах
        sme_fwd->setSignal(SME_NO_REVERS_HANDLE, 1.0);
        sme_bwd->setSignal(SME_NO_REVERS_HANDLE, 1.0);
    }
    else
    {
        // Пропускаем дальше запрет на включение реверсивки в других кабинах
        sme_fwd->setSignal(SME_NO_REVERS_HANDLE, sme_bwd->getSignal(SME_NO_REVERS_HANDLE));
        sme_bwd->setSignal(SME_NO_REVERS_HANDLE, sme_fwd->getSignal(SME_NO_REVERS_HANDLE));
    }

    // TODO // Добавить в движке возможность вставить / снять рукоятку УБТ
    // TODO // и сделать аналогичный запрет включать УБТ в других кабинах

    // TODO // всё остальное взаимодействие секций вл80

    // Цепи управления токоприемниками
    sme_bwd->setSignal(SME_E15_OUT, shield_223->getOutputVoltage(Shield_223::E15));
    sme_bwd->setSignal(SME_E16_OUT, shield_223->getOutputVoltage(Shield_223::E16));
    sme_bwd->setSignal(SME_E17_OUT, shield_223->getOutputVoltage(Shield_223::E17));
    sme_bwd->setSignal(SME_E35_OUT, panel_1->getOutputVoltage(Panel_1::E35_OUT));
    sme_bwd->setSignal(SME_E37_OUT, panel_1->getOutputVoltage(Panel_1::E28_OUT));

    double U_E30 = max(shield_223->getOutputVoltage(Shield_223::E16),
                       shield_223->getOutputSignal(Shield_223::E17));
    sme_bwd->setSignal(SME_E30_OUT, U_E30);

    // Управление
    sme_fwd->setControl(keys);
    sme_fwd->step(t, dt);
    sme_bwd->setControl(keys);
    sme_bwd->step(t, dt);
}

а класс поезда, посредством joint-vl80-sme.dll обеспечивает корректное соединение этих "розеток".

Ограничусь пока таким общим описанием, будут вопросы - задавайте, ответим.

P.S.: Вообще говоря, на модулях-joint-ах построены все связи между ПЕ, например

• Пневматические рукава simulator/joint-pneumo-hose и simulator/joint-pneumo-hose-epb. В качестве коннектора тут выступает конкретный рукав simulator/hose369a
• Сцепные устройства simulator/joint-coupling и simulator/joint-coupling-sa3. В качестве коннектора используется автосцепка СА-3 simulator/sa3

[NightWolf3dartist]

Хорошо развёрнутый ответ вы дали.

Класс SME_Connektor в классе подвижной единицы создаёт экземпляры для fwd-розетки и для bwd-розетки, в которые там заправляются по каналам в массив (который предоставляет интерфейс класса Device) значения, которые должны будут быть переданы на следующий за ним вагон .

А Joint определяет эти розетки и соединяет в правильной последовательности.

Там должен работать только bwd-коннектор или оба одновременно ??????????
У меня только bwd-коннектор работает.
Я просматриваю по информации с консоли через метод isConnected из класса коннектора, bwd-коннектор возвращает "1", fwd-коннектор не работает.
А если выразить по-другому, сцепку розеток определяет только класс Joint, (но почему тогда метод isConnected (из SME_Connector) возвращает состояние с одного экземпляра класса, а с другого - нет)??????.

[maisvendoo]

Так это выглядит физически

Сигнал с выхода (output_signal) bwd ПЕ0 посылается на вход (input_signal) fwd у ПЕ1, и наоборот - выход от fwd ПЕ1 - на вход bwd ПЕ0.

Так что работают оба коннектора, но они находятся на разных ПЕ.

Вообще было бы неплохо посмотреть на конкретный код, чтобы предметно разобраться что не работает

[NightWolf3dartist]

Если исходить из такого понимания, то на одной ПЕ только один коннектор и возвращает на уровне кода состояние "on", а другой конечно на соседней ПЕ. Так и есть.

Я просто экспериментирую с кодами.

[maisvendoo]

Может быть и такая ситуация, если у вас две одинаковых секции, а задняя развернута на 180 градусов через параметр конфига IsOrientationForward (1 - не развернуто, 0 - развернуто)

Тогда оба коннектора - задние. Какие соединять - зависит от ориентации ПЕ в момент соединения и решается на уровне класса Train

[ArepMM]

Ок, тут уже много ответили, но всё же подключусь к дискуссии.
Небольшое уточнение - в любом Device можно проверить, связан ли он с каким-либо Joint, методом isLinked(). Обсуждаемый здесь метод isConnected() - это реализация конкретных СМЕ-розеток и joint-а для них. Если речь про этот метод в СМЕ на ра-3 или вл80с, то это мы подготовили возможность отключить взаимодействие сцепленных секций: Train в любом случае создаёт все возможные joint между ПЕ, но в жизни мы не обязательно соединяем все возможные рукава, шлейфы СМЕ и прочее. Впрочем, до управления этой возможностью в СМЕ у нас дело пока не дошло, так что isConnected() будет совпадать с isLinked(). А вот в рукавах и сцепках аналогичная логика не только присутствует, но и кое-как управляется, см. инструкцию RRS/docs/Coupling-Uncoupling_manual.pdf (правда, у нас так и не доходят руки сделать ко всему этому наглядные анимации в 3d-моделях).

И тоже хотел нарисовать наглядную картинку, но Дмитрий уже успел нарисовать такую. Для некоторого разнообразия приведу пример, как будут выглядеть связи у двухсекционного локомотива, прицепленного в хвост поезда

[NightWolf3dartist]

Заправил сигнал в Idx в крайней секции, в joint-sme модуле передал из Output массива в Input массив, в модуле управляемой от с.м.е. единицы изъял сигнал и передал в исполняющую действие функцию (или другой массив вывода сигналов анимации).
Смотрю по консоли, состояние соединённости по составу идёт, а посланый из управляющей секции сигнал действует только в ближайшем к ней вагоне, на остальные копии вагона сигнал не распространяется (то есть коннекторы соединены - показывает консольный вывод, а управляющий сигнал дальше первой копии не идёт).
Управление анимацией происходит только в одном вагоне, в последующих - нет.?

[maisvendoo]

Ответить на данный вопрос будет легче, если мы посмотрим код

[maisvendoo]

на остальные копии вагона сигнал не распространяется

проброс сигнала сквозь вагон остается на совести разработчика