Seções da documentação

Calculadora de sensor de efeito Hall

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

Slug hall-effect-sensor. Calcule a tensão Hall V_H = R_h·i·b/t, densidade portadora e sensibilidade para sensores de efeito Hall. Abrange aplicações de medição de campo magnético, detecção de corrente e detecção de posição.

Entradas

Envie cada uma destas em inputs, nas unidades mostradas. A maioria é obrigatória: uma chamada sem alguma delas é recusada (400) e não custa nada; uma entrada que a calculadora dispensa assume o padrão mostrado. Uma entrada fora da sua faixa ainda é calculada e sinalizada na procedência.

Entradas de hall-effect-sensor
Nome	Unidade	Faixa	Padrão	Descrição
currentnúmero	mA	0.001 … 1000	100	Corrente de controle que flui pelo elemento Hall
Bfieldnúmero	mT	no mínimo 0.001	100	Campo magnético aplicado perpendicular ao fluxo de corrente
thicknessnúmero	mm	no mínimo 0.001	0.5	Espessura do elemento Hall na direção do campo magnético
carrierDensitynúmero	×10²³/m³	no mínimo 0.001	8.5	Densidade de portadores de carga em unidades de 10²³ por m³: cobre 8,5×10⁵ (8,5×10²⁸/m³), InSb cerca de 0,2 (2×10²²/m³ à temperatura ambiente), silício intrínseco 1,5×10⁻⁷ (1,5×10¹⁶/m³)
frontGainnúmero	V/V	0.01 … 1000000	4000	O ganho entre o elemento Hall e o ADC. Um ganho de 4000 leva os 0,73 mV que o elemento padrão gera em 500 mT a cerca de 2,9 V.
adcRefnúmero	V	0.1 … 50	3.3	O fundo de escala do ADC
adcBitsnúmero	bit	1 … 24	12	Resolução do ADC em bits

Saídas

Devolvidas em values, pelo nome. Um valor ilimitado ou indefinido é null.

Saídas de hall-effect-sensor
Campo	Unidade	Descrição
hallVoltageprincipal	mV	Tensão Hall
hallCoefficient	m³/C	Coeficiente Hall
sensitivity	mV/mT	Sensibilidade
amplifiedVoltage	V	Saída do amplificador
adcCode	nenhuma	Código do ADC
resolution	mT/LSB	Resolução

Como chamar

Calcular: uma chamada, a requisição e a resposta completas, e os seus erros.
Lote: esta calculadora com outras, ou uma varredura, em uma requisição.
Resolver para um valor-alvo: o valor de uma entrada que leva uma saída a um alvo.

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

Uma entrada enviada como texto. Nada foi contabilizado.

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

Requisições demais em um minuto, com Retry-After.

As mesmas entradas na página da calculadoraCalculadora de sensor de efeito Hall, com estes valores