Sections de la documentation

Durée de vie de la batterie (charge du moteur)

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

Slug battery-runtime-motor. Calculez l'autonomie de la batterie pour les systèmes motorisés en tenant compte de la consommation de courant du moteur, de son efficacité et de la profondeur de décharge.

Entrées

Envoyez chacune de ces entrées dans inputs, dans les unités indiquées. La plupart sont obligatoires : un appel auquel il en manque une est refusé (400) et ne coûte rien ; une entrée dont le calculateur peut se passer prend la valeur par défaut indiquée. Une entrée hors de sa plage est tout de même calculée et signalée dans la provenance.

Entrées de battery-runtime-motor
Nom	Unité	Plage	Valeur par défaut	Description
batteryCapacityMahnombre	mAh	au moins 1	2000	Capacité de la batterie
batteryVoltagenombre	V	au moins 0.5	3.7	Tension de la batterie
motorCurrentAnombre	A	au moins 0.001	0.5	Courant du moteur (moyen)
efficiencynombre	%	10 … 100	85	Efficacité combinée du moteur et du moteur
depthOfDischargenombre	%	1 … 100	80	Profondeur de décharge
motorDutynombre	%	1 … 100	100	Part du temps pendant lequel le moteur tourne à son courant moyen. 100 % = continu.
numLoadsnombre	aucune	0 … 5	0	Charges alimentées par la batterie en plus du moteur : autres moteurs, servos, carte de commande (0–5)
load1Currentnombre	A	0 … 100	0.5	Courant moyen consommé par la charge supplémentaire 1 lorsqu'elle est active, ramené à la tension de la batterie
load1Dutynombre	%	0 … 100	100	Part du temps pendant laquelle la charge supplémentaire 1 est active
load1Efficiencynombre	%	10 … 100	85	Rendement du variateur ou du convertisseur entre la batterie et la charge supplémentaire 1
load2Currentnombre	A	0 … 100	0.5	Courant moyen consommé par la charge supplémentaire 2 lorsqu'elle est active, ramené à la tension de la batterie
load2Dutynombre	%	0 … 100	100	Part du temps pendant laquelle la charge supplémentaire 2 est active
load2Efficiencynombre	%	10 … 100	85	Rendement du variateur ou du convertisseur entre la batterie et la charge supplémentaire 2
load3Currentnombre	A	0 … 100	0.5	Courant moyen consommé par la charge supplémentaire 3 lorsqu'elle est active, ramené à la tension de la batterie
load3Dutynombre	%	0 … 100	100	Part du temps pendant laquelle la charge supplémentaire 3 est active
load3Efficiencynombre	%	10 … 100	85	Rendement du variateur ou du convertisseur entre la batterie et la charge supplémentaire 3
load4Currentnombre	A	0 … 100	0.5	Courant moyen consommé par la charge supplémentaire 4 lorsqu'elle est active, ramené à la tension de la batterie
load4Dutynombre	%	0 … 100	100	Part du temps pendant laquelle la charge supplémentaire 4 est active
load4Efficiencynombre	%	10 … 100	85	Rendement du variateur ou du convertisseur entre la batterie et la charge supplémentaire 4
load5Currentnombre	A	0 … 100	0.5	Courant moyen consommé par la charge supplémentaire 5 lorsqu'elle est active, ramené à la tension de la batterie
load5Dutynombre	%	0 … 100	100	Part du temps pendant laquelle la charge supplémentaire 5 est active
load5Efficiencynombre	%	10 … 100	85	Rendement du variateur ou du convertisseur entre la batterie et la charge supplémentaire 5

Sorties

Renvoyées dans values, par nom. Une valeur non bornée ou non définie vaut null.

Sorties de battery-runtime-motor
Champ	Unité	Description
runtimeHoursprincipale	h	Temps d'exécution
runtimeMinutes	min	Temps d'exécution
usableCapacityMah	mAh	Capacité utilisable
energyWh	Wh	Énergie de la batterie (est.)
batteryCurrent	A	Courant de la batterie

Comment l'appeler

Calculer : un appel, la requête et la réponse complètes, et ses erreurs.
Calcul par lots : ce calculateur avec d'autres, ou un balayage, en une seule requête.
Résoudre pour une valeur cible : la valeur d'une entrée qui amène une sortie à une cible.

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"
    }
  ]
}

Une entrée envoyée sous forme de texte. Rien n'a été décompté.

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

Trop de requêtes en une minute, avec Retry-After.

Les mêmes entrées sur la page du calculateurDurée de vie de la batterie (charge du moteur), avec ces valeurs