Secciones de la documentación

Búsqueda de bandas 5G NR: frecuencias de n78, NR-ARFCN y bloques de recursos

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

Slug 5g-nr-band-lookup. Consulte cualquier banda de operación 5G NR de la Release 18 del 3GPP: frecuencias de enlace ascendente y descendente, separación dúplex, rango de NR-ARFCN de la banda, conversión de NR-ARFCN a frecuencia y viceversa, y los bloques de recursos para un ancho de banda de canal y una separación entre subportadoras.

Entradas

Envíe cada una de estas en inputs, en las unidades indicadas. La mayoría son obligatorias: una llamada a la que le falte una se rechaza (400) y no cuesta nada; una de la que la calculadora puede prescindir toma el valor predeterminado indicado. Una entrada fuera de su rango se calcula igualmente y se marca en la procedencia.

Entradas de 5g-nr-band-lookup
Nombre	Unidad	Rango	Valor predeterminado	Descripción
bandnúmero	ninguna	al menos 1	78	Número de la banda sin la n, según TS 38.101-1 (FR1) o TS 38.101-2 (FR2): 78 para n78, 257 para n257
channelBandwidthnúmero	MHz	al menos 3	100	Ancho de banda de canal del UE; en FR1 va de 3 a 100 MHz y en FR2 de 50 a 2000 MHz
scsnúmero	kHz	al menos 15	30	15, 30 o 60 kHz en FR1; 60 o 120 kHz en FR2 (480 y 960 kHz en n263)
arfcnnúmero	ninguna	al menos 0	636666	Número de canal que se convierte en frecuencia, de 0 a 3279165 en el ráster global
frequencynúmero	MHz	al menos 0	3549.99	Frecuencia que se convierte al NR-ARFCN más cercano

Salidas

Se devuelven en values, por nombre. Un valor ilimitado o no definido es null.

Salidas de 5g-nr-band-lookup
Campo	Unidad	Descripción
arfcnFrequencyprincipal	MHz	Frecuencia del NR-ARFCN
frequencyRange	ninguna	Rango de frecuencias (1 = FR1, 2 = FR2)
dlLow	MHz	Borde inferior del enlace descendente
dlHigh	MHz	Borde superior del enlace descendente
ulLow	MHz	Borde inferior del enlace ascendente
ulHigh	MHz	Borde superior del enlace ascendente
duplexSpacing	MHz	Separación dúplex, DL − UL (0 = TDD)
dlArfcnFirst	ninguna	NR-ARFCN del enlace descendente, primero
dlArfcnLast	ninguna	NR-ARFCN del enlace descendente, último
ulArfcnFirst	ninguna	NR-ARFCN del enlace ascendente, primero
ulArfcnLast	ninguna	NR-ARFCN del enlace ascendente, último
channelRaster	kHz	Ráster de canales más fino
resourceBlocks	ninguna	Bloques de recursos (N_RB)
transmissionBandwidth	MHz	Ancho de banda de transmisión (N_RB × 12 × SCS)
frequencyArfcn	ninguna	NR-ARFCN de la frecuencia

Cómo llamarla

Calcular: una llamada, la solicitud y la respuesta completas, y sus errores.
Cálculo por lotes: esta calculadora con otras, o un barrido, en una sola solicitud.
Resolver para un valor objetivo: el valor de una entrada que lleva una salida a un objetivo.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "5g-nr-band-lookup",
    "inputs": {
      "band": 78,
      "channelBandwidth": 100,
      "scs": 30,
      "arfcn": 636666,
      "frequency": 3549.99
    }
  }'

import rftools

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

result = client.calculate("5g-nr-band-lookup", {
    "band": 78,
    "channelBandwidth": 100,
    "scs": 30,
    "arfcn": 636666,
    "frequency": 3549.99,
})
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": "5g-nr-band-lookup",
    "inputs": {
      "band": 78,
      "channelBandwidth": 100,
      "scs": 30,
      "arfcn": 636666,
      "frequency": 3549.99
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "5g-nr-band-lookup",
	  "inputs": {
	    "band": 78,
	    "channelBandwidth": 100,
	    "scs": 30,
	    "arfcn": 636666,
	    "frequency": 3549.99
	  }
	}`)
	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": "5g-nr-band-lookup",
  "values": {
    "arfcnFrequency": 3549.99,
    "frequencyRange": 1,
    "dlLow": 3300,
    "dlHigh": 3800,
    "ulLow": 3300,
    "ulHigh": 3800,
    "duplexSpacing": 0,
    "dlArfcnFirst": 620000,
    "dlArfcnLast": 653333,
    "ulArfcnFirst": 620000,
    "ulArfcnLast": 653333,
    "channelRaster": 15,
    "resourceBlocks": 273,
    "transmissionBandwidth": 98.28,
    "frequencyArfcn": 636666
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:5g-nr-band-lookup",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "3GPP Release 18: TS 38.101-1 V18.15.0 and TS 38.101-2 V18.14.0, Tables 5.2-1, 5.3.2-1 and 5.4.2.3-1; TS 38.104 V18.15.0, Table 5.4.2.1-1",
    "assumptions": [
      {
        "code": "release-18-tables",
        "text": "Bands, NR-ARFCN ranges and N_RB come from the 3GPP Release 18 tables (TS 38.101-1 V18.15.0, TS 38.101-2 V18.14.0, TS 38.104 V18.15.0); a band added in a later release is reported as unknown."
      },
      {
        "code": "general-nrb-table",
        "text": "N_RB is read from the general table for the bandwidth and subcarrier spacing; whether the band allows that bandwidth (Table 5.3.5-1) is not checked."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "band": {
          "min": 1,
          "max": null,
          "unit": ""
        },
        "channelBandwidth": {
          "min": 3,
          "max": null,
          "unit": "MHz"
        },
        "scs": {
          "min": 15,
          "max": null,
          "unit": "kHz"
        },
        "arfcn": {
          "min": 0,
          "max": null,
          "unit": ""
        },
        "frequency": {
          "min": 0,
          "max": null,
          "unit": "MHz"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "band": 78,
      "channelBandwidth": 100,
      "scs": 30,
      "arfcn": 636666,
      "frequency": 3549.99
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "band"
      ],
      "msg": "Input should be a valid number, unable to parse string as a number",
      "input": "abc"
    }
  ]
}

Una entrada enviada como texto. No se contó nada.

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

Demasiadas solicitudes en un minuto, con Retry-After.

Las mismas entradas en la página de la calculadoraBúsqueda de bandas 5G NR: frecuencias de n78, NR-ARFCN y bloques de recursos, con estos valores