Aller au contenu

La version 0.1.0 est une première version, à l'essai. Voir ce qui n'est pas prouvé →

bogolang
EN

← Documentation

Calculs télécom et optique

Bilans radio et fibre, pluie, trafic, voix, optique.

Toutes les pages de documentation

Cette page couvre les calculs télécom (radio, pluie, fibre, trafic, voix), les relevés optiques d'un équipement, et les noms des marquages DSCP et des ports connus. Les calculs travaillent sur les unités de types et unités, et n'ont besoin d'aucun équipement.

Chaque fonction suit une formule ou une recommandation nommée, écrite dans son texte d'aide. bogo doc NAME l'affiche. Chaque chiffre ici est une estimation pour la planification. Une mesure sur la vraie liaison est la vraie réponse.

Radio

Commande Donne Formule
fspl(distance: Distance, freq: Frequency) Gain, l'affaiblissement en espace libre sous forme de chiffre positif UIT-R P.525 : L = 32.44 + 20 log10(f MHz) + 20 log10(d km)
fresnel(distance: Distance, freq: Frequency, zone: int = 1) Distance, le rayon de la zone de Fresnel zone au milieu du bond UIT-R P.530, P.526 : r = sqrt(n * longueur d'onde * d / 4) à mi-bond
link_budget(tx: Power, gains: list[Gain], losses: list[Gain], sensitivity: Power) Budget rx = tx + sum(gains) - sum(losses); marge = rx - sensibilité
eirp(tx: Power, antenna: Gain, cable_loss: Gain) Power PIRE = tx - perte du câble + gain d'antenne (définition UIT-R)
combine(a: Power, b: Power) Power, la somme de deux puissances additionnées en milliwatts
  • Une perte est donnée sous forme de nombre positif. link_budget et eirp refusent une perte négative. Un gain peut être négatif.
  • Un Budget a .rx: Power, .margin: Gain et .ok, vrai quand la marge vaut zéro ou plus. Affiché, il dit si la liaison passe.
  • Power + Power est refusé par la vérification, car deux chiffres en dBm ne s'additionnent pas. combine additionne les puissances en milliwatts : deux signaux de -3 dBm donnent environ 0 dBm.
Bogolang
loss: Gain = fspl(12km, 18GHz)
b: Budget = link_budget(18dBm, [38dBi, 38dBi], [loss, 2dB], -70dBm)
print(b)
print(b.rx, b.margin, b.ok)
print(fresnel(10km, 5.8GHz))
print(eirp(20dBm, 24dBi, 1.5dB))
print(combine(-3dBm, -3dBm))

La sortie :

rx -47.137dBm, margin 22.863dB: the link closes
-47.137dBm 22.863dB True
11.368m
42.5dBm
0.01dBm

Pluie

Commande Donne
rain_fade(distance: Distance, freq: Frequency, rain_rate: float, polarization: str = 'horizontal') Gain, la perte que la pluie ajoute pendant 0,01 pour cent d'une année moyenne
rain_availability(margin: Gain, distance: Distance, freq: Frequency, rain_rate: float, polarization: str = 'horizontal', *, latitude: float) Percent, la part d'une année moyenne pendant laquelle le bond reste en service face à la pluie

L'ingénieur donne les valeurs liées au lieu. Bogolang ne porte aucune carte de pluie et ne suppose aucun lieu sur Terre.

  • rain_rate est R0.01 en mm/h : l'intensité de pluie dépassée pendant 0,01 pour cent de l'année sur le site, d'après les cartes UIT-R P.837 ou des relevés locaux.
  • latitude est la latitude du bond en degrés, nord ou sud. Elle n'a pas de valeur par défaut. La méthode de l'UIT a une forme en dessous de 30 degrés et une autre à partir de 30 degrés, et aucune valeur unique n'est juste pour tous les ingénieurs.
  • polarization vaut "horizontal" ou "vertical".

La méthode :

  • Perte par km : gamma = k * R^alpha, avec k et alpha tirés de l'UIT-R P.838-3.
  • Longueur effective du bond, d'après l'UIT-R P.530-12 section 2.4.1 : r = 1 / (1 + d / d0), d0 = 35 exp(-0.015 R0.01) km, et A0.01 = gamma * d * r.
  • Autres parts de l'année, d'après l'UIT-R P.530-12 : une formule aux latitudes de 30 degrés ou plus, une autre en dessous. rain_availability trouve la part où l'évanouissement égale la marge.

Limites, telles que le code les énonce :

  • La P.530-12 dit que la méthode vaut au moins jusqu'à 40 GHz et 60 km. Bogolang accepte de 1 à 100 GHz et jusqu'à 60 km.
  • rain_availability ne peut pas promettre plus de 99,999 pour cent : une marge plus grande donne 99.999. Une marge inférieure à l'évanouissement à 1 pour cent de l'année donne 99.0, ce qui veut dire 99 pour cent ou moins.
  • Les deux ne comptent que la pluie. Elles ne comptent pas l'évanouissement par trajets multiples, l'obstruction ni la panne de matériel.
Bogolang
fade: Gain = rain_fade(12km, 18GHz, 42.0, "vertical")
print(fade)
print(rain_availability(30dB, 12km, 18GHz, 42.0, "vertical", latitude=45.0))
print(rain_availability(30dB, 12km, 18GHz, 42.0, "vertical", latitude=10.0))
23.855dB
99.995pct
99.996pct

L'intensité de pluie 42.0 et les deux latitudes ne sont que des exemples.

Un bond complet

L'exemple radio_link assemble tout cela pour un bond de 12 km à 18 GHz. Sa sortie :

Hop site-a to site-b: 12km at 18GHz, vertical polarization
  Free-space loss     139.137dB
  First Fresnel zone  7.069m radius at mid-hop
  Received level      -47.137dBm
  Fade margin         22.863dB
  Rain fade (0.01%)   23.855dB at 42.0 mm/h
  Availability (rain) 99.989pct, about 59 min down a year
  Target 99.99pct: the hop misses the target

Fibre

Commande Donne
fibre_loss(distance: Distance, wavelength: Wavelength, connectors: int, splices: int, *, per_km: Gain \| None = None, per_connector: Gain = 0.5dB, per_splice: Gain = 0.1dB) Gain, la perte prévue du tronçon

La méthode est le bilan de perte de la TIA-568 et de la CEI 61280-4 : km * per_km + connecteurs * per_connector + épissures * per_splice.

Sans per_km, la perte par km vient de la longueur d'onde, à 15 nm près de part et d'autre :

Longueur d'onde dB par km Fibre
850 nm 3.0 multimode
1300 nm 1.0 multimode
1310 nm 0.35 monomode
1550 nm 0.22 monomode
1625 nm 0.25 monomode

1300 et 1310 se chevauchent : la plus proche est utilisée, et 1305 nm compte comme 1300 (multimode). Donner per_km lève le doute. Une autre longueur d'onde sans per_km est une erreur. Ce sont des valeurs de planification. La perte réelle est ce que mesure une source lumineuse avec un wattmètre optique, ou un OTDR.

Bogolang
print(fibre_loss(12km, 1310nm, connectors=2, splices=6))
print(fibre_loss(30km, 1550nm, 2, 10, per_km=0.25dB, per_connector=0.75dB))
5.8dB
10dB

Trafic et voix

Commande Donne Formule
erlang_b(traffic: Traffic, lines: int) Percent, la part des appels bloqués Erlang B, par la récurrence stable de l'UIT-T E.520 et du manuel d'ingénierie du télétrafic de l'UIT-D
erlang_c(traffic: Traffic, agents: int) Percent, la part des appels qui attendent Erlang C à partir d'Erlang B : C = N * B / (N - A * (1 - B)). Quand le trafic est égal ou supérieur au nombre d'agents, 100 pour cent
mos(loss: Percent, delay: Duration, jitter: Duration, codec: str) float, qualité d'appel estimée de 1.0 à 4.5 Modèle E de l'UIT-T G.107, forme simplifiée (Cole et Rosenbluth, 2001), Ie et Bpl tirés de l'UIT-T G.113 Appendice I
codec_bandwidth(codec: str, layer: str = 'ip') Rate, un appel dans un sens (charge utile + en-têtes) * 8 * paquets par seconde

Le trafic s'écrit en erlangs : 10erl.

À propos de mos :

  • delay est dans un seul sens. Deux fois la gigue est ajoutée pour la mémoire tampon de gigue, ainsi que le délai du codec lui-même.
  • Codecs : G.711, G.722, G.723.1, G.726, G.729A. Les écritures courantes sont lues aussi : g711, pcmu, pcma, g729, g729ab. Un autre nom est une erreur qui liste les noms connus.
  • G.722 est noté comme G.711. G.726 n'a pas de chiffre de perte dans la G.113, il utilise donc celui de G.711 : sa note est optimiste.
  • C'est une estimation tirée d'un modèle simplifié, pas une mesure.

À propos de codec_bandwidth :

  • layer="ip" compte 40 octets d'en-têtes IP, UDP et RTP. layer="ethernet" ajoute 18 octets (14 d'en-tête et 4 de FCS).
  • Les paquets sont espacés de 20 ms, 30 ms pour G.723.1, comme dans le document de Cisco « Voice Over IP: Per Call Bandwidth Consumption ».
  • Le chiffre de G.723.1 n'a pas été vérifié par rapport à un tableau publié.
Bogolang
print(erlang_b(10erl, 15))
print(erlang_c(10erl, 12))
print(mos(1pct, 80ms, 10ms, "G.711"))
print(mos(1pct, 80ms, 10ms, "g729"))
print(codec_bandwidth("G.711"))
print(codec_bandwidth("G.711", layer="ethernet"))
print(codec_bandwidth("G.729"))
3.65pct
44.939pct
4.26
3.83
80kbps
87.2kbps
24kbps

Relevés optiques

Commande Donne
optics(d: Device) list[OpticReading], un par port ayant un relevé d'émission ou de réception, triés par port

Elle ouvre une session en lecture seule et envoie une seule commande :

Plateforme Commande
ios, iosxe show interfaces transceiver detail
junos show interfaces diagnostics optics \| display xml

Une autre plateforme est refusée avec une phrase qui nomme les plateformes qui fonctionnent.

Champ Type Ce qu'il contient
.port Intf Le port
.tx, .rx Power \| None Niveaux d'émission et de réception
.temperature float \| None Degrés Celsius
.rx_low, .rx_high, .tx_low, .tx_high Power \| None Les propres seuils d'alarme bas et haut de l'équipement
.status str "ok", "low", "high", "no light" ou "unknown"
.lane int \| None La voie d'une optique multivoie sur Junos ; vide sinon

Comment l'état est déterminé :

  • Il compare le niveau de réception aux propres seuils d'alarme de l'équipement. Un niveau exactement sur un seuil est "ok".
  • "no light" est un niveau de réception de -40 dBm ou moins.
  • "unknown" : pas de relevé de réception, ou l'équipement ne donne pas de seuils.
  • Un port sans relevé optique est laissé de côté.
Bogolang
sw1: Device = Device(name="core-sw1", ip=192.0.2.1, platform="iosxe")
readings: list[OpticReading] = optics(sw1)
table(readings, ["port", "tx", "rx", "rx_low", "rx_high", "temperature", "status"])
for r in readings:
    if r.status != "ok":
        print(f"{r.port}: {r.status}, rx {r.rx}")

Exécuté avec --replay sur une sortie enregistrée écrite pour les tests :

port      tx       rx        rx_low    rx_high  temperature  status
--------  -------  --------  --------  -------  -----------  --------
Te1/1/1   -2.4dBm  -3.1dBm   -13.9dBm  2dBm            32.3  ok
Te1/1/2   -2.2dBm  -40dBm    -13.9dBm  2dBm            30.1  no light
Te1/1/3   -2.6dBm  -15.2dBm  -13.9dBm  2dBm            35.8  low
Te1/1/4   -1.9dBm  2.6dBm    -13.9dBm  2dBm              41  high
Te1/1/10  -3dBm    -5dBm                               29.5  unknown
Te1/1/2: no light, rx -40dBm
Te1/1/3: low, rx -15.2dBm
Te1/1/4: high, rx 2.6dBm
Te1/1/10: unknown, rx -5dBm

optics n'a jamais lu un vrai équipement. Ses lecteurs ont été écrits d'après les formes documentées des deux commandes. Une autre version peut formuler les en-têtes de son tableau autrement, et ne donnerait alors aucun relevé. Voir non prouvé.

Marquages et ports

Commande Donne
dscp(name: str) int : la valeur DSCP d'un nom, quelle que soit la casse
dscp_name(value: int) str : le nom d'une valeur de 0 à 63 ; une valeur sans nom donne son nombre
port_of(name: str) int : le port connu d'un nom de service, quelle que soit la casse
service_of(port: int) str : le nom de service principal d'un port connu

Noms DSCP : EF (46), AF11 à AF43, CS0 à CS7, default (ou BE) et VA (ou VOICE-ADMIT, 44). La valeur 0 est nommée default dans le sens retour. Un nom qui n'est pas dans la liste est une erreur qui liste les noms.

Les ports viennent d'une table fixe tirée du registre de l'IANA, si bien que chaque machine donne la même réponse. Elle contient environ 40 services, comme ssh, snmp, snmptrap, bgp, syslog, radius, sip. Certains ont un second nom : dns ou domain, http ou www. Un nom ou un port absent de la table est une erreur.

Bogolang
print(dscp("EF"), dscp("af41"), dscp("BE"))
print(dscp_name(46), dscp_name(34), dscp_name(0), dscp_name(5))
print(port_of("SSH"), port_of("snmptrap"), service_of(443), service_of(53))
46 34 0
EF AF41 default 5
22 162 https dns

ping, ping_all et trace prennent une valeur DSCP pour marquer leurs sondes, par exemple ping(192.0.2.10, dscp=dscp("EF")). Voir joignabilité.