Vis kilden til Ekom/Prosjektering og bygging/Dokumentasjon

= Hensikt og omfang =
== Hensikt ==
I dette kapittel angis generelle krav som stilles til dokumentasjon for teleanlegg/ekomnett. Hensikten er å tilstrebe en mest mulig enhetlig dokumentering for Bane NORs ekomnett gjennom hele livssyklusen for systemene og anleggene.

== Omfang ==
De krav som er gitt gjelder dokumentasjon som er relatert til bygging og prosjektering av telesystemer og -anlegg, inklusiv dokumentasjon som kreves i forbindelse med forvaltning, drift og vedlikehold (FDV-dokumentasjon). 

{{lærebokstoff|Øvrige krav for enhetlig håndtering av teknisk dokumentasjon i Bane NOR er forankret i konsernprosedyren "Håndtering av teknisk dokumentasjon - STY-604942
Konsernprosedyren gjelder ikke for driftsinformasjonssystemer og 3D-modeller.
Database for teknisk informasjon om sluttproduktet der informasjonen ikke er beskrevet i dokumenter, men som felter i en database. Denne informasjonen hentes enten fra dokumenter eller fra informasjonsmodeller (Cad-tegninger, 3D-modeller osv.). 
I Bane NOR er følgende systemer eksempler på driftsinformasjonssystem BaneData, '''Telemator''' og Lydia}}

= Generelle krav =
{{lærebokstoff|Generelle krav til dokumentasjon er gitt i [https://trv.banenor.no/wiki/Felles_bestemmelser/Generelle_bestemmelser#Dokumentasjon Felles bestemmelser/Generelle bestemmelser], avsnitt 13.}}
[[TRV:02277|'''''TRV:02277''''']]<br /><br />{{:TRV:02277}}

= Systemdokumentasjon =
{{lærebokstoff|Systemdokumentasjon beskriver oppbygging og virkemåte for et system, herunder en detaljert beskrivelse av system, delsystemer og systemkomponenter.}}

== Generelt ==
[[TRV:02278|'''''TRV:02278''''']]<br /><br />{{:TRV:02278}}
== Systembeskrivelse ==
[[TRV:02279|'''''TRV:02279''''']]<br /><br />{{:TRV:02279}}
== Spesifikasjoner ==
[[TRV:02280|'''''TRV:02280''''']]<br /><br />{{:TRV:02280}}

= Anleggsdokumentasjon =
{{lærebokstoff|Anleggsdokumentasjon beskriver det faktiske anlegget på en eller flere konkrete lokasjoner/strekninger. Anleggsdokumentasjonen er i sin natur lokal og beskriver noe som er plassert geografisk. Anleggsdokumentasjonen kan ikke gjenbrukes annet sted uten tilpasninger. Anleggsdokumentasjon involverer flere systemer og databaser i tillegg til skisser og skjematikk.

I hovedsak benyttes Banedata, Telemator/TelMe og VitalQIP i tillegg til skjematisk plan i Visio-format for registering og dokumentasjon av ekomnett.

Som bygget-dokumentasjon (romtegning, skjematisk plan - fremstilling av nettverk og koblinger, eventuelt befaringsrapporter) dokumenteres også i ProArc.
}}

== Generelt ==
{{lærebokstoff|Anleggsdokumentasjon vil kunne omfatte supplerende informasjon om 

* tillatelser, begrensninger i bruken, dispensasjoner og eventuelle gyldighetsperioder
* godkjente versjoner av programvare og data, hvis dette inngår i anlegget
* referanse til typer og sertifikater}}
[[TRV:02285|'''''TRV:02285''''']]<br /><br />{{:TRV:02285}}

== Skjematisk plan ==
[[TRV:02286|'''''TRV:02286''''']]<br /><br />{{:TRV:02286}}
[[TRV:02287|'''''TRV:02287''''']]<br /><br />{{:TRV:02287}}

== Installasjonsdesign og beskrivelse av enkeltinstallasjoner (Site Design) for GSM-R ==
=== Site Design Report  ===
{{lærebokstoff|En Site Design Report er en overordnet beskrivelse av en installasjon.

En Site Design Report forutsettes å inneholde 
* en beskrivelse av hvor en site er, hvordan man kommer seg dit og om det er spesielle ting som det må tas hensyn til ved site, slik som krav til følgetjeneste, krav om spesielle tillatelser eller nøkler for å komme inn
* et kart, oppriss eller arrangementstegning for aktuell site
* en liste over relevant dokumentasjon for installasjonen
* en liste over materiell
* en merkeliste og oversikt over objekter (kan inngå i materiell-listen)}}

=== Database for lokasjoner med GSM-R BTS, transmisjons eller radiolinjeutstyr.  ===
[[TRV:02288|'''''TRV:02288''''']]<br /><br />{{:TRV:02288}}

=== Final Tunnel Design Report ===
{{lærebokstoff|En Final Tunnel Design Report forutsettes å inneholde 

* en beskrivelse av hvor en site er, hvordan man kommer seg dit og om det er spesielle ting som det må tas hensyn til ved site, slik som krav til følgetjeneste, krav om spesielle tillatelser eller nøkler for å komme inn 
* et kart, oppriss eller arrangementstegning for aktuell site 
* en liste over relevant dokumentasjon for installasjonen 
* en liste over materiell
* en merkeliste og oversikt over objekter (kan inngå i materiell-listen)
* en overordnet beskrivelse av repeaterløsning, med skisse, dekningsbudsjett og en begrunnelse for valgt løsning}}

== Arrangementstegning ==
=== Romtegning og romplan ===
[[TRV:02289|'''''TRV:02289''''']]<br /><br />{{:TRV:02289}}
[[TRV:02290|'''''TRV:02290''''']]<br /><br />{{:TRV:02290}}
=== Arrangementstegning for nye lokasjoner utstyr for togradio ===
[[TRV:02291|'''''TRV:02291''''']]<br /><br />{{:TRV:02291}}

=== Arrangementstegning for lokasjoner med utstyr for tunnelradio ===
[[TRV:02292|'''''TRV:02292''''']]<br /><br />{{:TRV:02292}}
[[TRV:02293|'''''TRV:02293''''']]<br /><br />{{:TRV:02293}}

=== Overordnet situasjonsplan i tunneler ===
[[TRV:02294|'''''TRV:02294''''']]<br /><br />{{:TRV:02294}}
=== Innhold i utstyrsskap eller rack ===
[[TRV:02295|'''''TRV:02295''''']]<br /><br />{{:TRV:02295}}

== Kabelplan ==
{{lærebokstoff|For registrering av opplysninger i forbindelse med kabel og kabelplan, benyttes registreringsverktøyet Telemator/TelMe.

Se også kapittel 7 Kabelanlegg.}}

== Enlinjeskjema og kursfortegnelse ==
=== Enlinjeskjema for 230 / 400 VAC ===
{{lærebokstoff|Enlinjeskjema for 230/400 VAC er en elektrotegning(EL) som inneholder en oversikt over kurser for et anlegg, fra strømkilde til fordelingskurser med tilhørende sikringer.}}
[[TRV:02296|'''''TRV:02296''''']]<br /><br />{{:TRV:02296}}
=== Kursfortegnelse for 230 / 400 VAC sikringsskap ===
[[TRV:02297|'''''TRV:02297''''']]<br /><br />{{:TRV:02297}}
=== Dokumentasjon for DC-distribusjon (48 VDC eller tilsvarende) ===
[[TRV:02298|'''''TRV:02298''''']]<br /><br />{{:TRV:02298}}

= Dokumentasjon for godkjenning =
[[TRV:02312|'''''TRV:02312''''']]<br /><br />{{:TRV:02312}}
{{lærebokstoff|Som et ledd i operasjonalisering/overlevering av ny eller endret transmisjonsnett vil drift (FDV) kontrollere at anlegget er dokumentert i Telemator/TelMe

For større systemer som omfatter flere banestrekninger, kan det være aktuelt å gjennomføre 

* verifikasjon av systemfunksjon over tid (System Performance Verification, SPV)
* systemakseptansetest (System Acceptance Test, SAT)
* dekningstest (Drivetest)
* optimaliseringsvurdering
* sluttbefaring}}

= RAMS-dokumentasjon =
[[TRV:02313|'''''TRV:02313''''']]<br /><br />{{:TRV:02313}}

= Overleveringsprotokoll =
[[TRV:02314|'''''TRV:02314''''']]<br /><br />{{:TRV:02314}}

= Dokumentasjon for drift og vedlikehold =
[[TRV:02317|'''''TRV:02317''''']]<br /><br />{{:TRV:02317}}
[[TRV:02318|'''''TRV:02318''''']]<br /><br />{{:TRV:02318}}

= Registreringsverktøy =
Dette avsnittet stiller krav til ulike registreringsverktøy som benyttes i forbindelse med dokumentasjon av ekomnett. 

== Arkiv for lagring av teknisk dokumentasjon (ProArc) ==
[[TRV:02321|'''''TRV:02321''''']]<br /><br />{{:TRV:02321}}

== BaneData (BD) ==
[[TRV:02322|'''''TRV:02322''''']]<br /><br />{{:TRV:02322}}

== Configuration Management Data Base (CMDB) ==
{{lærebokstoff|For systemer hvor det er behov for en større grad av detaljering enn hva som er mulig i BaneData, benyttes egen CMDB, som administreres av infrastrukturforvalter. 
Format for registrering i (U)CMDB er underlagt Asset-Management strukturen i Bane NOR og lagt til KV-IKT enheten i Drift og Teknologi.

CMDB inneholder viktig informasjon om systemets konfigurasjon, som for eksempel type enhet, versjonsnummer av maskin- og programvare og sammenkopling av enheter.}}

== Kabel og koplingsregistreringsverktøy (Telemator/TelMe) ==
[[TRV:02324|'''''TRV:02324''''']]<br /><br />{{:TRV:02324}}

== Sentralt kabelregister ==
{{lærebokstoff|Bane NOR er pålagt å levere data til det sentrale kartforvaltningssystemet GIS/LINE. Alle kabler i ekomnettet registreres derfor i GIS/LINE for å redusere faren for overgraving og øke oppetiden på installasjoner. 

Bane NORs sentrale kabelregister oppdateres i forbindelse med nye eller endrede kabeltraséer.

Bane NOR er også omfattet av ledningsregistreringsforskriften  - ref, kravID TRV:08255}}

== IP-adresser for KV-IKT ==
[[TRV:02325|'''''TRV:02325''''']]<br /><br />{{:TRV:02325}}

== Nummerplan for togradiosystemet ==
[[TRV:02326|'''''TRV:02326''''']]<br /><br />{{:TRV:02326}}

= Referanser =
# STY-604942 Håndtering av teknisk dokumentasjon - konsernprosedyre   
# STY-605072 Beskrivelse av leveranse av FDV-dokumentasjon - brukerveiledning
# NS 5820 Dokumentasjon av utstyrsleveranser
# STY-600239 Håndbok Digital Planlegging i Bane NOR
# NS-EN ISO 5457 Teknisk produktspesifikasjon Størrelser og layout på tegneark
# TE.807900 Dokumentasjon fagområde Tele Merking og registrering av utstyr
# STY-605302 Prosjekter der tele og KV-IKT-anlegg inngår – prosedyre