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_budgeteteirprefusent une perte négative. Un gain peut être négatif. - Un
Budgeta.rx: Power,.margin: Gainet.ok, vrai quand la marge vaut zéro ou plus. Affiché, il dit si la liaison passe. Power + Powerest refusé par la vérification, car deux chiffres en dBm ne s'additionnent pas.combineadditionne les puissances en milliwatts : deux signaux de -3 dBm donnent environ 0 dBm.
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_rateest 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.latitudeest 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.polarizationvaut"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_availabilitytrouve 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_availabilityne 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.
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.
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 :
delayest 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é.
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é.
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.
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é.