Abschnitte der Dokumentation

BLDC-Effizienzanalysator

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

Slug bldc-efficiency. Analysieren Sie die Effizienz des BLDC-Motors an jedem Betriebspunkt. Baut Kupfer, Eisen und mechanische Verluste ab. Findet den optimalen Strom und die optimale Drehzahl für Spitzeneffizienz.

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 bldc-efficiency
Name	Einheit	Bereich	Standardwert	Beschreibung
kvRatingZahl	RPM/V	1 … 10000	920	Kv-Wert
phaseResistanceZahl	mΩ	mindestens 0.1	45	Wicklungswiderstand zwischen zwei Motoranschlüssen, wie ihn Datenblätter angeben; bei Blockkommutierung fließt der Versorgungsstrom durch ihn
noLoadCurrentZahl	A	mindestens 0.001	1.5	Stromaufnahme ohne mechanische Belastung (Eisen + Reibungsverluste)
supplyVoltageZahl	V	mindestens 1	22.2	Versorgungsspannung
operatingCurrentZahl	A	mindestens 0.01	10	Tatsächlicher Laststrom zur Analyse
targetEfficiencyZahl	%	0 … 100	85	Der Wirkungsgrad, den der Motor beim Betriebsstrom erreichen muss. Der Status fällt unter 50% aus.

Ausgemustert, weiterhin angenommen und mit einer Warnung ignoriert: polePairs (Pole Pairs, 12. Oktober 2026).

Ausgaben

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

Ausgaben von bldc-efficiency
Feld	Einheit	Beschreibung
copperLoss	W	Kupferverlust
ironLoss	W	Eisenverlust
mechanicalLoss	W	Mechanischer Verlust
totalLoss	W	Totaler Verlust
outputPower	W	Ausgangsleistung
efficiencyHauptwert	%	Effizienz
optimalCurrent	A	Optimaler Strom
optimalRpm	RPM	Optimale Drehzahl
copperPct	%	Kupfer-Verlustanteil
ironPct	%	Anteil an Eisenverlust
mechPct	%	Mechanischer Verlustanteil

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": "bldc-efficiency",
    "inputs": {
      "kvRating": 920,
      "phaseResistance": 45,
      "noLoadCurrent": 1.5,
      "supplyVoltage": 22.2,
      "operatingCurrent": 10,
      "targetEfficiency": 85
    }
  }'

import rftools

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

result = client.calculate("bldc-efficiency", {
    "kvRating": 920,
    "phaseResistance": 45,
    "noLoadCurrent": 1.5,
    "supplyVoltage": 22.2,
    "operatingCurrent": 10,
    "targetEfficiency": 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": "bldc-efficiency",
    "inputs": {
      "kvRating": 920,
      "phaseResistance": 45,
      "noLoadCurrent": 1.5,
      "supplyVoltage": 22.2,
      "operatingCurrent": 10,
      "targetEfficiency": 85
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "bldc-efficiency",
	  "inputs": {
	    "kvRating": 920,
	    "phaseResistance": 45,
	    "noLoadCurrent": 1.5,
	    "supplyVoltage": 22.2,
	    "operatingCurrent": 10,
	    "targetEfficiency": 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": "bldc-efficiency",
  "values": {
    "copperLoss": 4.5,
    "ironLoss": 32.19446127288026,
    "mechanicalLoss": 0.10124999999999999,
    "totalLoss": 36.79571127288026,
    "outputPower": 185.20428872711975,
    "efficiency": 83.42535528248636,
    "optimalCurrent": 27.202941017470888,
    "optimalRpm": 19297.798241876706,
    "copperPct": 12.229686135505306,
    "ironPct": 87.49514592644583,
    "mechPct": 0.27516793804886935
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:bldc-efficiency",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Drela, First-Order DC Electric Motor Model (MIT, 2007), eqs. 3, 7 and 9; maxon, Formulae Handbook (J. Braun, maxon academy, 2012), p. 37; Hanselman, D. — Brushless Permanent Magnet Motor Design",
    "assumptions": [
      {
        "code": "block-commutation-terminal-resistance",
        "text": "The motor is driven by block (six-step) commutation, so the supply current flows through the terminal resistance measured between two leads and the copper loss is I²·R (Drela 2007; maxon Formulae Handbook 2012, p. 37). A sinusoidal drive with I the phase rms current would give 1.5·I²·R for the same resistance."
      },
      {
        "code": "no-load-loss-split",
        "text": "The no-load input power V·I₀ less the no-load copper loss I₀²·R is iron loss, scaled with speed to the power 1.5; the mechanical loss is taken equal to the no-load copper loss."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "kvRating": {
          "min": 1,
          "max": 10000,
          "unit": "RPM/V"
        },
        "phaseResistance": {
          "min": 0.1,
          "max": null,
          "unit": "mΩ"
        },
        "noLoadCurrent": {
          "min": 0.001,
          "max": null,
          "unit": "A"
        },
        "supplyVoltage": {
          "min": 1,
          "max": null,
          "unit": "V"
        },
        "operatingCurrent": {
          "min": 0.01,
          "max": null,
          "unit": "A"
        },
        "targetEfficiency": {
          "min": 0,
          "max": 100,
          "unit": "%"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "kvRating": 920,
      "phaseResistance": 45,
      "noLoadCurrent": 1.5,
      "supplyVoltage": 22.2,
      "operatingCurrent": 10,
      "targetEfficiency": 85
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "kvRating"
      ],
      "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 RechnerseiteBLDC-Effizienzanalysator, mit diesen Werten