Abschnitte der Dokumentation

Akkulaufzeit (Motorlast)

POSThttps://rftools.io/api/py/v1/calculate

Slug battery-runtime-motor. Berechnen Sie die Akkulaufzeit für motorbetriebene Systeme unter Berücksichtigung der Motorstromaufnahme, des Wirkungsgrads und der Entladungstiefe.

Eingaben

Senden Sie jede dieser Eingaben in inputs, in den gezeigten Einheiten. Die meisten sind erforderlich: Ein Aufruf, dem eine davon fehlt, wird abgelehnt (400) und kostet nichts; eine, auf die der Rechner verzichten kann, erhält den gezeigten Standardwert. Eine Eingabe außerhalb ihres Bereichs wird trotzdem berechnet und in der Provenienz markiert.

Eingaben von battery-runtime-motor
Name	Einheit	Bereich	Standardwert	Beschreibung
batteryCapacityMahZahl	mAh	mindestens 1	2000	Akkukapazität
batteryVoltageZahl	V	mindestens 0.5	3.7	Akkuspannung
motorCurrentAZahl	A	mindestens 0.001	0.5	Motorstrom (avg)
efficiencyZahl	%	10 … 100	85	Kombinierter Wirkungsgrad von Motortreiber und Motor
depthOfDischargeZahl	%	1 … 100	80	Tiefe der Entladung
motorDutyZahl	%	1 … 100	100	Anteil der Zeit, in dem der Motor mit seinem mittleren Strom läuft. 100 % = Dauerbetrieb.
numLoadsZahl	keine	0 … 5	0	Lasten an der Batterie neben dem Motor: weitere Motoren, Servos, eine Steuerplatine (0–5)
load1CurrentZahl	A	0 … 100	0.5	Mittlerer Strom, den die zusätzliche Last 1 im eingeschalteten Zustand aufnimmt, bezogen auf die Batteriespannung
load1DutyZahl	%	0 … 100	100	Anteil der Zeit, in dem die zusätzliche Last 1 eingeschaltet ist
load1EfficiencyZahl	%	10 … 100	85	Wirkungsgrad des Antriebs oder Wandlers zwischen Batterie und zusätzlicher Last 1
load2CurrentZahl	A	0 … 100	0.5	Mittlerer Strom, den die zusätzliche Last 2 im eingeschalteten Zustand aufnimmt, bezogen auf die Batteriespannung
load2DutyZahl	%	0 … 100	100	Anteil der Zeit, in dem die zusätzliche Last 2 eingeschaltet ist
load2EfficiencyZahl	%	10 … 100	85	Wirkungsgrad des Antriebs oder Wandlers zwischen Batterie und zusätzlicher Last 2
load3CurrentZahl	A	0 … 100	0.5	Mittlerer Strom, den die zusätzliche Last 3 im eingeschalteten Zustand aufnimmt, bezogen auf die Batteriespannung
load3DutyZahl	%	0 … 100	100	Anteil der Zeit, in dem die zusätzliche Last 3 eingeschaltet ist
load3EfficiencyZahl	%	10 … 100	85	Wirkungsgrad des Antriebs oder Wandlers zwischen Batterie und zusätzlicher Last 3
load4CurrentZahl	A	0 … 100	0.5	Mittlerer Strom, den die zusätzliche Last 4 im eingeschalteten Zustand aufnimmt, bezogen auf die Batteriespannung
load4DutyZahl	%	0 … 100	100	Anteil der Zeit, in dem die zusätzliche Last 4 eingeschaltet ist
load4EfficiencyZahl	%	10 … 100	85	Wirkungsgrad des Antriebs oder Wandlers zwischen Batterie und zusätzlicher Last 4
load5CurrentZahl	A	0 … 100	0.5	Mittlerer Strom, den die zusätzliche Last 5 im eingeschalteten Zustand aufnimmt, bezogen auf die Batteriespannung
load5DutyZahl	%	0 … 100	100	Anteil der Zeit, in dem die zusätzliche Last 5 eingeschaltet ist
load5EfficiencyZahl	%	10 … 100	85	Wirkungsgrad des Antriebs oder Wandlers zwischen Batterie und zusätzlicher Last 5

Ausgaben

Zurückgegeben in values, nach Namen. Ein Wert, der unbegrenzt oder nicht definiert ist, ist null.

Ausgaben von battery-runtime-motor
Feld	Einheit	Beschreibung
runtimeHoursHauptwert	h	Laufzeit
runtimeMinutes	min	Laufzeit
usableCapacityMah	mAh	Nutzbare Kapazität
energyWh	Wh	Batterieenergie (geschätzt)
batteryCurrent	A	Batteriestrom

Aufruf

Berechnen: ein Aufruf, Anfrage und Antwort vollständig, und seine Fehler.
Batch: dieser Rechner zusammen mit anderen oder ein Sweep, in einer Anfrage.
Nach einem Zielwert auflösen: der Wert einer Eingabe, der eine Ausgabe auf einen Zielwert bringt.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "battery-runtime-motor",
    "inputs": {
      "batteryCapacityMah": 2000,
      "batteryVoltage": 3.7,
      "motorCurrentA": 0.5,
      "efficiency": 85,
      "depthOfDischarge": 80,
      "motorDuty": 100,
      "numLoads": 0,
      "load1Current": 0.5,
      "load1Duty": 100,
      "load1Efficiency": 85,
      "load2Current": 0.5,
      "load2Duty": 100,
      "load2Efficiency": 85,
      "load3Current": 0.5,
      "load3Duty": 100,
      "load3Efficiency": 85,
      "load4Current": 0.5,
      "load4Duty": 100,
      "load4Efficiency": 85,
      "load5Current": 0.5,
      "load5Duty": 100,
      "load5Efficiency": 85
    }
  }'

import rftools

client = rftools.Client()  # reads RFTOOLS_API_KEY, or the key `rftools login` saved

result = client.calculate("battery-runtime-motor", {
    "batteryCapacityMah": 2000,
    "batteryVoltage": 3.7,
    "motorCurrentA": 0.5,
    "efficiency": 85,
    "depthOfDischarge": 80,
    "motorDuty": 100,
    "numLoads": 0,
    "load1Current": 0.5,
    "load1Duty": 100,
    "load1Efficiency": 85,
    "load2Current": 0.5,
    "load2Duty": 100,
    "load2Efficiency": 85,
    "load3Current": 0.5,
    "load3Duty": 100,
    "load3Efficiency": 85,
    "load4Current": 0.5,
    "load4Duty": 100,
    "load4Efficiency": 85,
    "load5Current": 0.5,
    "load5Duty": 100,
    "load5Efficiency": 85,
})
print(result.values)
print(result.warnings, result.provenance.formula_ref)

const response = await fetch("https://rftools.io/api/py/v1/calculate", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.RFTOOLS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "slug": "battery-runtime-motor",
    "inputs": {
      "batteryCapacityMah": 2000,
      "batteryVoltage": 3.7,
      "motorCurrentA": 0.5,
      "efficiency": 85,
      "depthOfDischarge": 80,
      "motorDuty": 100,
      "numLoads": 0,
      "load1Current": 0.5,
      "load1Duty": 100,
      "load1Efficiency": 85,
      "load2Current": 0.5,
      "load2Duty": 100,
      "load2Efficiency": 85,
      "load3Current": 0.5,
      "load3Duty": 100,
      "load3Efficiency": 85,
      "load4Current": 0.5,
      "load4Duty": 100,
      "load4Efficiency": 85,
      "load5Current": 0.5,
      "load5Duty": 100,
      "load5Efficiency": 85
    }
  }),
});
console.log(response.status, await response.json());

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{
	  "slug": "battery-runtime-motor",
	  "inputs": {
	    "batteryCapacityMah": 2000,
	    "batteryVoltage": 3.7,
	    "motorCurrentA": 0.5,
	    "efficiency": 85,
	    "depthOfDischarge": 80,
	    "motorDuty": 100,
	    "numLoads": 0,
	    "load1Current": 0.5,
	    "load1Duty": 100,
	    "load1Efficiency": 85,
	    "load2Current": 0.5,
	    "load2Duty": 100,
	    "load2Efficiency": 85,
	    "load3Current": 0.5,
	    "load3Duty": 100,
	    "load3Efficiency": 85,
	    "load4Current": 0.5,
	    "load4Duty": 100,
	    "load4Efficiency": 85,
	    "load5Current": 0.5,
	    "load5Duty": 100,
	    "load5Efficiency": 85
	  }
	}`)
	req, err := http.NewRequest("POST", "https://rftools.io/api/py/v1/calculate", bytes.NewReader(body))
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("RFTOOLS_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

application/json

{
  "slug": "battery-runtime-motor",
  "values": {
    "usableCapacityMah": 1600,
    "runtimeHours": 2.7199999999999998,
    "runtimeMinutes": 163.2,
    "energyWh": 7.4,
    "batteryCurrent": 0.5882352941176471
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:battery-runtime-motor",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "batteryCapacityMah": {
          "min": 1,
          "max": null,
          "unit": "mAh"
        },
        "batteryVoltage": {
          "min": 0.5,
          "max": null,
          "unit": "V"
        },
        "motorCurrentA": {
          "min": 0.001,
          "max": null,
          "unit": "A"
        },
        "efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        },
        "depthOfDischarge": {
          "min": 1,
          "max": 100,
          "unit": "%"
        },
        "motorDuty": {
          "min": 1,
          "max": 100,
          "unit": "%"
        },
        "numLoads": {
          "min": 0,
          "max": 5,
          "unit": ""
        },
        "load1Current": {
          "min": 0,
          "max": 100,
          "unit": "A"
        },
        "load1Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        },
        "load1Efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        },
        "load2Current": {
          "min": 0,
          "max": 100,
          "unit": "A"
        },
        "load2Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        },
        "load2Efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        },
        "load3Current": {
          "min": 0,
          "max": 100,
          "unit": "A"
        },
        "load3Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        },
        "load3Efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        },
        "load4Current": {
          "min": 0,
          "max": 100,
          "unit": "A"
        },
        "load4Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        },
        "load4Efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        },
        "load5Current": {
          "min": 0,
          "max": 100,
          "unit": "A"
        },
        "load5Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        },
        "load5Efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "batteryCapacityMah": 2000,
      "batteryVoltage": 3.7,
      "motorCurrentA": 0.5,
      "efficiency": 85,
      "depthOfDischarge": 80,
      "motorDuty": 100,
      "numLoads": 0,
      "load1Current": 0.5,
      "load1Duty": 100,
      "load1Efficiency": 85,
      "load2Current": 0.5,
      "load2Duty": 100,
      "load2Efficiency": 85,
      "load3Current": 0.5,
      "load3Duty": 100,
      "load3Efficiency": 85,
      "load4Current": 0.5,
      "load4Duty": 100,
      "load4Efficiency": 85,
      "load5Current": 0.5,
      "load5Duty": 100,
      "load5Efficiency": 85
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "batteryCapacityMah"
      ],
      "msg": "Input should be a valid number, unable to parse string as a number",
      "input": "abc"
    }
  ]
}

Eine als Text gesendete Eingabe. Es wurde nichts gezählt.

{
  "detail": "More than 120 requests in 60 seconds from this address.",
  "errorKind": "rate_limited",
  "limit": 120,
  "windowSeconds": 60,
  "upgradeUrl": "https://rftools.io/pricing/"
}

Zu viele Anfragen in einer Minute, mit Retry-After.

Dieselben Eingaben auf der RechnerseiteAkkulaufzeit (Motorlast), mit diesen Werten