Sections de la documentation

Calculateur d'autonomie de la batterie

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

Slug battery-life. Estimez l'autonomie de la batterie pour l'IoT et les appareils portables en fonction de la consommation de courant moyenne, du rapport cyclique, du taux d'autodécharge et de la limite de profondeur de décharge. Convient aux piles LiPo, alcalines, NiMH et piles à pièces.

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-life
Nom	Unité	Plage	Valeur par défaut	Description
capacitynombre	mAh	1 … 100000	2000	Capacité de la batterie
avgCurrentnombre	mA	0.001 … 10000	100	Courant moyen consommé par l'appareil pendant le fonctionnement actif
dutyCyclenombre	%	0.001 … 100	100	Pourcentage de temps pendant lequel l'appareil est actif et utilise du courant. 100 % = fonctionnement continu.
selfDischargenombre	%/month	0 … 30	2	Taux d'autodécharge mensuel de la batterie. LiPo : ~ 2 %, NiMH : ~ 15 %, alcalin : ~ 1 %
cutoffSocnombre	%	0 … 80	20	État de charge minimal auquel l'appareil cesse de fonctionner. 20 % = l'appareil s'éteint alors qu'il reste 20 % de sa capacité.
numLoadsnombre	aucune	0 … 7	0	Charges alimentées par la batterie en plus de l'appareil, chacune avec son propre courant et son rapport cyclique (0–7)
load1Currentnombre	mA	0 … 10000	10	Courant consommé par la charge supplémentaire 1 lorsqu'elle est active
load1Dutynombre	%	0 … 100	10	Part du temps pendant laquelle la charge supplémentaire 1 est active
load2Currentnombre	mA	0 … 10000	10	Courant consommé par la charge supplémentaire 2 lorsqu'elle est active
load2Dutynombre	%	0 … 100	10	Part du temps pendant laquelle la charge supplémentaire 2 est active
load3Currentnombre	mA	0 … 10000	10	Courant consommé par la charge supplémentaire 3 lorsqu'elle est active
load3Dutynombre	%	0 … 100	10	Part du temps pendant laquelle la charge supplémentaire 3 est active
load4Currentnombre	mA	0 … 10000	10	Courant consommé par la charge supplémentaire 4 lorsqu'elle est active
load4Dutynombre	%	0 … 100	10	Part du temps pendant laquelle la charge supplémentaire 4 est active
load5Currentnombre	mA	0 … 10000	10	Courant consommé par la charge supplémentaire 5 lorsqu'elle est active
load5Dutynombre	%	0 … 100	10	Part du temps pendant laquelle la charge supplémentaire 5 est active
load6Currentnombre	mA	0 … 10000	10	Courant consommé par la charge supplémentaire 6 lorsqu'elle est active
load6Dutynombre	%	0 … 100	10	Part du temps pendant laquelle la charge supplémentaire 6 est active
load7Currentnombre	mA	0 … 10000	10	Courant consommé par la charge supplémentaire 7 lorsqu'elle est active
load7Dutynombre	%	0 … 100	10	Part du temps pendant laquelle la charge supplémentaire 7 est active

Sorties

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

Sorties de battery-life
Champ	Unité	Description
runtimeHoursprincipale	h	Temps d'exécution
runtimeDays	days	Temps d'exécution
effectiveCurrent	mA	Courant effectif
usableCapacityMAh	mAh	Capacité utilisable
selfDischargeCurrent	mA	Courant d'autodécharge

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-life",
    "inputs": {
      "capacity": 2000,
      "avgCurrent": 100,
      "dutyCycle": 100,
      "selfDischarge": 2,
      "cutoffSoc": 20,
      "numLoads": 0,
      "load1Current": 10,
      "load1Duty": 10,
      "load2Current": 10,
      "load2Duty": 10,
      "load3Current": 10,
      "load3Duty": 10,
      "load4Current": 10,
      "load4Duty": 10,
      "load5Current": 10,
      "load5Duty": 10,
      "load6Current": 10,
      "load6Duty": 10,
      "load7Current": 10,
      "load7Duty": 10
    }
  }'

import rftools

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

result = client.calculate("battery-life", {
    "capacity": 2000,
    "avgCurrent": 100,
    "dutyCycle": 100,
    "selfDischarge": 2,
    "cutoffSoc": 20,
    "numLoads": 0,
    "load1Current": 10,
    "load1Duty": 10,
    "load2Current": 10,
    "load2Duty": 10,
    "load3Current": 10,
    "load3Duty": 10,
    "load4Current": 10,
    "load4Duty": 10,
    "load5Current": 10,
    "load5Duty": 10,
    "load6Current": 10,
    "load6Duty": 10,
    "load7Current": 10,
    "load7Duty": 10,
})
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-life",
    "inputs": {
      "capacity": 2000,
      "avgCurrent": 100,
      "dutyCycle": 100,
      "selfDischarge": 2,
      "cutoffSoc": 20,
      "numLoads": 0,
      "load1Current": 10,
      "load1Duty": 10,
      "load2Current": 10,
      "load2Duty": 10,
      "load3Current": 10,
      "load3Duty": 10,
      "load4Current": 10,
      "load4Duty": 10,
      "load5Current": 10,
      "load5Duty": 10,
      "load6Current": 10,
      "load6Duty": 10,
      "load7Current": 10,
      "load7Duty": 10
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "battery-life",
	  "inputs": {
	    "capacity": 2000,
	    "avgCurrent": 100,
	    "dutyCycle": 100,
	    "selfDischarge": 2,
	    "cutoffSoc": 20,
	    "numLoads": 0,
	    "load1Current": 10,
	    "load1Duty": 10,
	    "load2Current": 10,
	    "load2Duty": 10,
	    "load3Current": 10,
	    "load3Duty": 10,
	    "load4Current": 10,
	    "load4Duty": 10,
	    "load5Current": 10,
	    "load5Duty": 10,
	    "load6Current": 10,
	    "load6Duty": 10,
	    "load7Current": 10,
	    "load7Duty": 10
	  }
	}`)
	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-life",
  "values": {
    "runtimeHours": 15.991116046640755,
    "runtimeDays": 0.6662965019433648,
    "effectiveCurrent": 100,
    "usableCapacityMAh": 1600,
    "selfDischargeCurrent": 0.05555555555555555
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:battery-life",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Nordic Semiconductor PWR Profiler methodology; Texas Instruments SLUA364",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "capacity": {
          "min": 1,
          "max": 100000,
          "unit": "mAh"
        },
        "avgCurrent": {
          "min": 0.001,
          "max": 10000,
          "unit": "mA"
        },
        "dutyCycle": {
          "min": 0.001,
          "max": 100,
          "unit": "%"
        },
        "selfDischarge": {
          "min": 0,
          "max": 30,
          "unit": "%/month"
        },
        "cutoffSoc": {
          "min": 0,
          "max": 80,
          "unit": "%"
        },
        "numLoads": {
          "min": 0,
          "max": 7,
          "unit": ""
        },
        "load1Current": {
          "min": 0,
          "max": 10000,
          "unit": "mA"
        },
        "load1Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        },
        "load2Current": {
          "min": 0,
          "max": 10000,
          "unit": "mA"
        },
        "load2Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        },
        "load3Current": {
          "min": 0,
          "max": 10000,
          "unit": "mA"
        },
        "load3Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        },
        "load4Current": {
          "min": 0,
          "max": 10000,
          "unit": "mA"
        },
        "load4Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        },
        "load5Current": {
          "min": 0,
          "max": 10000,
          "unit": "mA"
        },
        "load5Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        },
        "load6Current": {
          "min": 0,
          "max": 10000,
          "unit": "mA"
        },
        "load6Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        },
        "load7Current": {
          "min": 0,
          "max": 10000,
          "unit": "mA"
        },
        "load7Duty": {
          "min": 0,
          "max": 100,
          "unit": "%"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "capacity": 2000,
      "avgCurrent": 100,
      "dutyCycle": 100,
      "selfDischarge": 2,
      "cutoffSoc": 20,
      "numLoads": 0,
      "load1Current": 10,
      "load1Duty": 10,
      "load2Current": 10,
      "load2Duty": 10,
      "load3Current": 10,
      "load3Duty": 10,
      "load4Current": 10,
      "load4Duty": 10,
      "load5Current": 10,
      "load5Duty": 10,
      "load6Current": 10,
      "load6Duty": 10,
      "load7Current": 10,
      "load7Duty": 10
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "capacity"
      ],
      "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 calculateurCalculateur d'autonomie de la batterie, avec ces valeurs