Kommandoradsargument

SIMRIG Kontrollcenter använder kommandoradsargument för att förstärka sitt beteende och startprocedur. De är en avancerad funktion som bara är användbar för ett fåtal.

Följande kommandoradsargument igenkänns:

Argument	Beskrivning
/Version	Skriver ut programversionen och avslutar sedan
/SingleCore	Begränsar programmet till att använda en enda processorkärna
/ReloadDrivers	Tvingar omladdning av alla drivrutiner vid start
/ReloadDriver	Se /ReloadDrivers
/ForceEnable	Aktiverar automatiskt rörelse vid start
/TelemetrySource	Visar en lista över alla tillgängliga telemetri-ID
/TelemetrySource=<id>	Åsidosätter automatisk telemetrikällval med det angivna telemetri-IDet
/Minimized	Startar med huvudfönstret minimerat
/Simple	Visar ett förenklat användargränssnitt med färre inställningar och mer automation
/EnableRemoteControl	Lyssnar på och följer fjärrstyrningskommandon

Följande kommandoradsargument används för interna ändamål. Lita inte på dessa:

Argument	Beskrivning
/AutoStart	Indikerar att programmet startades av Windows vid systemstart. Aktuell katalog ställs in för att inkludera SIMRIG Kontrollcenter exekverbara fil.
/Restart	Indikerar att programmet startade om sig självt. Väntar på att föregående instans ska avslutas innan det fortsätter.
/Updated	Indikerar att programmet uppdaterades

Fjärrstyrningskommandon

Fjärrstyrningskommandon används för att automatisera SIMRIG Kontrollcenter. De tillåter externa program och skript begränsad kontroll över systemet. Denna kontroll utförs genom att köra SimrigRemoteControl.exe med specifika kommandoradsargument och genom att tolka de returnerade avslutningskoderna och JSON.

Observera

SimrigRemoteControl.exe är en del av det valfria Management Tools-paketet. Installera detta paket med SIMRIG Kontrollcenter-installationsprogrammet.

Proceduren är som följer:

Starta en långvarig instans av SIMRIG Kontrollcenter med hjälp av /EnableRemoteControl-kommandoradsargumentet. Denna instans kontrollerar rörelsesystemet, läser telemetri från spelet och interagerar med användaren. Den är känd som servern [1]. För att aktivera rörelse, kör sedan SimrigRemoteControl.exe EnableMotion. Denna kortvariga instans av SimrigRemoteControl.exe är känd som klienten [2]. Klienten skickar ett EnableMotion-kommando till servern. Servern aktiverar sedan rörelsen och svarar med antingen framgång eller misslyckande. Klientprocessen avslutas sedan och rapporterar resultatet med en avslutningskod och JSON över standardutmatning.

Sagt på ett annat sätt, användaren startar SIMRIG Kontrollcenter med fjärrstyrning aktiverad. Skriptet startar sedan SimrigRemoteControl.exe om och om igen varje gång det vill skicka ett kommando.

Följande avslutningskoder returneras:

Avslutningskod	Beskrivning
0	Framgång
1	Allmänt serverfel. Se standardutmatning för detaljer.
2	Allmänt klientfel. Se standardutmatning för detaljer.
3	Okänt kommando. Klienten känner inte igen det givna kommandot.
4	Felformaterade eller saknade argument. Kommandot förväntar sig mer eller annan information från kommandoradsargumenten.
5	Timeout. Ingen server körs.

Följande kommandon finns tillgängliga:

Kommando	Beskrivning
EnableMotion	Aktiverar rörelsesystemet. Rörelse startar när telemetri blir tillgänglig.
DisableMotion	Inaktiverar rörelsesystemet. Rörelsesystemet återgår till sitt neutrala läge och strömmen kopplas därefter från motorerna.
ResetAllDevices	Återställer alla anslutna enheter
SystemStatus	Returnerar system- och enhetsstatus

Detaljerade resultat returneras som JSON-objekt över standardutmatning.

Felmeddelanden har följande format:

{
        "type": "error",
        "error": "En beskrivning av felet går här.",
        "other_fields": "kan också finnas"
}

Framgångsmeddelanden har följande format:

{
        "type": "success",
        "other_fields": "kan också finnas"
}

EnableMotion

Aktiverar rörelsesystemet. Detta har samma effekt som att trycka på Aktivera-knappen i huvudgränssnittet. Rörelse startar när telemetri är tillgänglig. Systemet återgår till sitt viloläge när telemetri slutar och strömmen stängs av.

utdata:: Ett tomt framgångsmeddelande returneras vid framgång: {"type": "success"}.

DisableMotion

Inaktiverar rörelsesystemet. Detta har samma effekt som att trycka på Inaktivera-knappen i huvudgränssnittet. Systemet återgår till sitt viloläge och sedan stängs strömmen av.

utdata:: Ett tomt framgångsmeddelande returneras vid framgång: {"type": "success"}.

ResetAllDevices

Varning

Felkoder ställs endast in när ett hårdvaruproblem uppstår. De bör inte tas lättvindigt. Undersök alltid orsaken till felkoden innan du återställer. Underlåtenhet att göra detta kan leda till permanent skada.

Återställer alla anslutna enheter. Detta rensar alla felkoder.

utdata:: Ett tomt framgångsmeddelande returneras vid framgång: {"type": "success"}.

SystemStatus

Hämta systemstatus; såsom om rörelse är aktiverad eller inte. Detta inkluderar information om alla anslutna enheter.

utdata:

Systemstatus returneras vid framgång:

{
        "system_status":
        {
                "devices":
                [
                        {
                                "nominal": false,
                                "error_codes": [18, 18, 18, 18],
                                "estopped": false,
                                "firmware_update_available": false,
                                "device_status": ""
                        }
                ],
                "motion_enabled": false,
                "telemetry_source": 0,
                "telemetry_status": ""
        },
        "type": "success"
}

system_status

devices

Detta är en lista över alla enheter som är anslutna till systemet. Det kan vara null om inga enheter hittas.

nominal: Denna flagga är true om enhetens status är nominel. Om flaggan är false kan det indikera att enheten är frånkopplad, eller att en felkod är inställd.

error_codes: Om ej null, innehåller denna lista alla felkoder som ställts in av enheten. Återställ enheten för att rensa felkoderna. Se varning.

estopped: En bekvämlighetsflagga som är true när nödstoppet är aktivt. Detta är en tolkning av felkoderna.

firmware_update_available: Denna flagga är true om en firmwareuppdatering är tillgänglig för denna enhet.

device_status: En lättförståelig förklaring av enhetens status. Det kan indikera att enheten körs och allt fungerar som förväntat. Det kan också indikera att ett hårdvarufel har inträffat etc.

motion_enabled: Denna flagga är true när rörelse är aktiverad. Använd kommandona EnableMotion/DisableMotion för att kontrollera denna flagga.

telemetry_source: ID för den aktuella telemetrikällan.

telemetry_status: En lättförståelig förklaring av den aktuella statusen för telemetrikällan. Det kan indikera att spelet körs och allt fungerar som förväntat. Det kan också indikera att inget spel körs etc.

Ändringslogg

2023-08-28:

Använd SimrigRemoteControl.exe för att skicka kommandon istället för SimrigControlCenter.exe

2023-08-01:

Bytte namn på enheters ok till nominal
Lägger till device_status

Genvägsinställning

För att starta SIMRIG Kontrollcenter med ett eller flera kommandoradsargument, skapa en ny genväg på ditt skrivbord eller startmeny. Använd ett minnesvärt namn. Högerklicka sedan på genvägen för att öppna dess Egenskaper.

Lägg till dina kommandoradsargument i slutet av textfältet Mål. Spara ändringarna.

SIMRIG Kontrollcenter startar med de tillagda kommandoradsargumenten varje gång denna genväg används i framtiden.