Sections de la documentation

Calculateur de capteur à effet Hall

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

Slug hall-effect-sensor. Calculez la tension Hall V_H = R_H·i·B/t, la densité des porteurs et la sensibilité des capteurs à effet Hall. Couvre les applications de mesure du champ magnétique, de détection de courant et de détection de position.

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 hall-effect-sensor
Nom	Unité	Plage	Valeur par défaut	Description
currentnombre	mA	0.001 … 1000	100	Courant de commande traversant l'élément Hall
Bfieldnombre	mT	au moins 0.001	100	Champ magnétique appliqué perpendiculairement au courant
thicknessnombre	mm	au moins 0.001	0.5	Épaisseur de l'élément Hall dans la direction du champ magnétique
carrierDensitynombre	×10²³/m³	au moins 0.001	8.5	Densité de porteurs de charge en unités de 10²³ par m³ : cuivre 8,5×10⁵ (8,5×10²⁸/m³), InSb environ 0,2 (2×10²²/m³ à température ambiante), silicium intrinsèque 1,5×10⁻⁷ (1,5×10¹⁶/m³)
frontGainnombre	V/V	0.01 … 1000000	4000	Le gain entre l'élément Hall et l'ADC. Un gain de 4000 porte les 0,73 mV de l'élément par défaut à 500 mT à environ 2,9 V.
adcRefnombre	V	0.1 … 50	3.3	La pleine échelle de l'ADC
adcBitsnombre	bit	1 … 24	12	Résolution ADC en bits

Sorties

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

Sorties de hall-effect-sensor
Champ	Unité	Description
hallVoltageprincipale	mV	Tension de Hall
hallCoefficient	m³/C	Coefficient de Hall
sensitivity	mV/mT	Sensibilité
amplifiedVoltage	V	Sortie de l'amplificateur
adcCode	aucune	Code ADC
resolution	mT/LSB	Résolution

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": "hall-effect-sensor",
    "inputs": {
      "current": 100,
      "Bfield": 100,
      "thickness": 0.5,
      "carrierDensity": 8.5,
      "frontGain": 4000,
      "adcRef": 3.3,
      "adcBits": 12
    }
  }'

import rftools

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

result = client.calculate("hall-effect-sensor", {
    "current": 100,
    "Bfield": 100,
    "thickness": 0.5,
    "carrierDensity": 8.5,
    "frontGain": 4000,
    "adcRef": 3.3,
    "adcBits": 12,
})
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": "hall-effect-sensor",
    "inputs": {
      "current": 100,
      "Bfield": 100,
      "thickness": 0.5,
      "carrierDensity": 8.5,
      "frontGain": 4000,
      "adcRef": 3.3,
      "adcBits": 12
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "hall-effect-sensor",
	  "inputs": {
	    "current": 100,
	    "Bfield": 100,
	    "thickness": 0.5,
	    "carrierDensity": 8.5,
	    "frontGain": 4000,
	    "adcRef": 3.3,
	    "adcBits": 12
	  }
	}`)
	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": "hall-effect-sensor",
  "values": {
    "hallVoltage": 0.14685903704613562,
    "hallCoefficient": 0.000007342951852306781,
    "sensitivity": 0.0014685903704613561,
    "amplifiedVoltage": 0.5874361481845425,
    "adcCode": 729,
    "resolution": 0.13714921442779537
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:hall-effect-sensor",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "current": {
          "min": 0.001,
          "max": 1000,
          "unit": "mA"
        },
        "Bfield": {
          "min": 0.001,
          "max": null,
          "unit": "mT"
        },
        "thickness": {
          "min": 0.001,
          "max": null,
          "unit": "mm"
        },
        "carrierDensity": {
          "min": 0.001,
          "max": null,
          "unit": "×10²³/m³"
        },
        "frontGain": {
          "min": 0.01,
          "max": 1000000,
          "unit": "V/V"
        },
        "adcRef": {
          "min": 0.1,
          "max": 50,
          "unit": "V"
        },
        "adcBits": {
          "min": 1,
          "max": 24,
          "unit": "bit"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "current": 100,
      "Bfield": 100,
      "thickness": 0.5,
      "carrierDensity": 8.5,
      "frontGain": 4000,
      "adcRef": 3.3,
      "adcBits": 12
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "current"
      ],
      "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 de capteur à effet Hall, avec ces valeurs