Sections de la documentation

Recherche de bandes 5G NR — fréquences n78, NR-ARFCN et blocs de ressources

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

Slug 5g-nr-band-lookup. Recherchez n'importe quelle bande de fonctionnement 5G NR de la Release 18 du 3GPP : fréquences de liaison montante et descendante, écart duplex, plage NR-ARFCN de la bande, conversion du NR-ARFCN en fréquence et inversement, et blocs de ressources pour une largeur de bande de canal et un espacement des sous-porteuses.

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 5g-nr-band-lookup
Nom	Unité	Plage	Valeur par défaut	Description
bandnombre	aucune	au moins 1	78	Numéro de bande sans le n, d'après TS 38.101-1 (FR1) ou TS 38.101-2 (FR2) : 78 pour n78, 257 pour n257
channelBandwidthnombre	MHz	au moins 3	100	Largeur de bande du canal de l'UE ; de 3 à 100 MHz en FR1, de 50 à 2000 MHz en FR2
scsnombre	kHz	au moins 15	30	15, 30 ou 60 kHz en FR1 ; 60 ou 120 kHz en FR2 (480 et 960 kHz en n263)
arfcnnombre	aucune	au moins 0	636666	Numéro de canal à convertir en fréquence, de 0 à 3279165 sur le raster global
frequencynombre	MHz	au moins 0	3549.99	Fréquence à convertir en NR-ARFCN le plus proche

Sorties

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

Sorties de 5g-nr-band-lookup
Champ	Unité	Description
arfcnFrequencyprincipale	MHz	Fréquence du NR-ARFCN
frequencyRange	aucune	Gamme de fréquences (1 = FR1, 2 = FR2)
dlLow	MHz	Bord inférieur de la liaison descendante
dlHigh	MHz	Bord supérieur de la liaison descendante
ulLow	MHz	Bord inférieur de la liaison montante
ulHigh	MHz	Bord supérieur de la liaison montante
duplexSpacing	MHz	Écart duplex, DL − UL (0 = TDD)
dlArfcnFirst	aucune	Premier NR-ARFCN de la liaison descendante
dlArfcnLast	aucune	Dernier NR-ARFCN de la liaison descendante
ulArfcnFirst	aucune	Premier NR-ARFCN de la liaison montante
ulArfcnLast	aucune	Dernier NR-ARFCN de la liaison montante
channelRaster	kHz	Raster de canaux le plus fin
resourceBlocks	aucune	Blocs de ressources (N_RB)
transmissionBandwidth	MHz	Largeur de bande de transmission (N_RB × 12 × SCS)
frequencyArfcn	aucune	NR-ARFCN de la fréquence

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

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 calculateurRecherche de bandes 5G NR — fréquences n78, NR-ARFCN et blocs de ressources, avec ces valeurs