1

Pålogging og avlogging av kjøretøy

Pålogging og avlogging av kjøretøy er en svært kritisk funksjon som binder alle dataemner som produseres av et kjøretøy til Tjenestemottakers digitale kundetjenester samt er det som muliggjør utnyttelse av de samme dataemnene til utarbeidelse av statistikk og innsikt.

Pålogging

Pålogging skal sendes senest 5 minutter før kjøretøyet starter på en avgang. For første avgang i blokken ønsker vi dette senest ved utkjøring fra depot.

Pålogging skal sendes så snart et kjøretøy skal overta for et annet på samme blokk.

Det skal sendes ny pålogging for hver blokk hvis det er flere blokker i vognløpet.

Det skal ikke sendes pålogginger utover dette.

Avlogging

Avlogging skal sendes når et kjøretøy ikke lenger skal betjene avgangene det er logget inn på.

Oppdatering

Oppdatering skal sendes når et kjøretøy kun skal betjene deler av avgangene det er logget inn på.

Unnlatelse

Hvis operatøren av ulike grunner ikke kan gjennomføre, eller planlegger å sløyfe en tur, skal turen ikke tildeles et kjøretøy, men registreres som utelatt.

Unnlatelse skal sendes så snart operatøren planlegger å sløyfe en tur.

Gyldige meldinger

• Pålogging og avlogging skal bruke korrekte referanser som er definert i Ruters operasjonelle plandatabase.

• Pålogging skal angi en gyldig API versjon. Denne API versjonen skal brukes i all kommunikasjon med kjøretøyet.

Pålogging skal være mottatt:

• Senest 20 minutter etter planlagt avgang fra første holdeplass.

Avlogging skal være mottatt:

• Senest 2 timer etter planlagt ankomst på siste holdeplass.

• Ved bytte av kjøretøy i en blokk skal eksisterende kjøretøy sende avlogging. Nytt kjøretøy sender ny pålogging før det starter på kjøreoppdraget. Dersom det nye kjøretøyet sender pålogging av type REPLACEMENT vil det gamle kjøretøyet logges ut. Dette teller som en godkjent avlogging.

Unnlatelse skal være mottatt:

• Senest 20 minutter etter planlagt avgang fra første holdeplass.

En avgang blir godkjent hvis:

a) Den har korrekt pålogging og avlogging, eller

b) Den har korrekt unnlatelse.

1

Oppdragsutveksling Ruter Førerapp

Pull-out og Pull-in

Så fort som mulig.

Pull-out

• 0 min etter planlagt oppstart av innleietid.

Pull-in

• Max 2 timer etter avtalt slutt av innleietid.

En blokk blir godkjent hvis og bare hvis den har korrekt pull-out og pull-in.

1

Oppdragsutveksling SUTI

Oppdragsbekreftelse gjelder overføring, oppdatering og avslutning av aktuelle oppdrag.

• Tjenesteyter må bekrefte mottatt oppdrag gjennom SUTI-Grensesnittet.

• Tjenesteyter melder tilbake tildelt bil (løyve).

• Kjøretøyet registrerer faktiske hente- og leveringstider, inkludert GPS posisjon. 

Godkjent dersom alle krav er godkjent.

1

Oppdragsrapportering Y2M

Tjenesteyter utveksler data i henhold til grensesnitt beskrevet for funksjonsnivå Y2M.

Godkjent dersom alle krav er godkjent.

2

Posisjon

Posisjon brukes av Tjenestemottaker til å generere fremdrifts-status på turer og vognløp. Denne fremdrifts-statusen brukes til å gi kunder sanntidsinformasjon om avganger, ankomster, forsinkelser og avvik, både om bord i kjøretøyet, men også i andre kundekanaler. Fremdrifts-status er også viktig for å kunne utarbeide statistikk og innsikt om avviklingen av Tjenestemottakers tjenester.

Posisjon skal konfigureres opp til å sende 1 gang/sekundet med beste kvalitet under rådende forhold.

For å ta høyde for dårlig mobildekning tillater vi noe datatap.

For å ta høyde for at meldingen sendes over mqtt med QoS=0 telles ikke kortere brudd i datastrømmen.

For å ta høyde for at strøm blir skrudd av mellom passasjerturer, feks. ved en pause ignoreres brudd som skjer der kjøretøyet sto stille. Da kan også messageNumber resettes til 0.Brudd i datastrømmen der kjøretøyet stod stille ignoreres.

• messageNumber skal øke med 1 for hver sendte melding. Hvis messageNumber ikke øker regnes ikke meldingen som korrekt mottatt.

• To påfølgende meldinger skal mottas med et intervall på max 3,5 sekunder. I praksis at kan 2 meldinger kan falle bort under sending. Meldinger som er mottatt mer enn 3,5 sekunder etter avsending teller ikke som mottatt.

• For intervall større enn 3,5 sekunder regnes 1 melding som ikke korrekt mottatt per påbegynte sekund det mangler posisjoner etter 3,5 sekunder.

• Påfølgende meldinger skal mottas med et intervall på minst 0,9 sekunder i gjennomsnitt.

• Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meter ignoreres. Dette gjelder også for messageNumber.

• Informasjon om satellittdekning og vertikal nøyaktighet skal alltid sendes med posisjons meldinger. Presisjonen på posisjoner skal alltid være med høyeste mulige presisjon i henhold til de rådende forhold gitt av disse parameterne.

• Ved mangel på GPS-dekning skal det fremdeles sendes meldinger med samme intervall men merket at det ikke er dekning eller eventuelt om det benyttes projeksjon (dead-reckoning) for å gi posisjon

Godkjent dersom >95% av alle posisjoner er korrekt mottatt.

3

Dynamisk passasjerinformasjon (destinasjon, journey, neste stopp, lydmelding)

Fremvisning av korrekt informasjon til passasjerene om bord er viktig for Tjenestemottaker.

Verifiser at:

• Utstyret har strøm

• All software er oppdatert til riktig versjon, konfigurert og kjører korrekt

• Sending og mottak av data fungerer som det skal 

Kvitteringsmeldinger

• Hver gang Tjenestemottaker sender Journey- eller NextStop-melding skal Tjenestemottaker motta kvitteringsmelding innen 60 sekunder fra hver enkelt skjerm om at meldingen er mottatt.

DPI-klienten er ansvarlig for å produsere kvitteringsmeldingen.

• Hver gang Tjenestemottaker sender Externaldisplay eller Audio-melding skal Tjenestemottaker motta kvitteringsmelding innen 60 sekunder fra kjøretøyet om at meldingen er mottatt.

Operatør er ansvarlig for å produsere og sende en kvitteringsmelding fra kjøretøyet umiddelbart etter mottak. 

Tilstandsmeldinger

Hver gang Tjenestemottaker sender en Journey-melding skal Tjenestemottaker motta en tilstandsmelding innen 60 sekunder fra hver enkelt skjerm.

Verifiser​ at følgende er korrekt:

• Browserversjon​

• Persistens / lagringsmuligheter​

• Korrekte software-versjoner ombord på kjøretøy:

  • DPI-klient

  • Mediapakkeversjon​

  • Ressurspakkeversjon

• Riktig skjermvisning (url)

• Tilgang til internett

DPI-klienten er ansvarlig for å produsere tilstandsmeldingen.

Operatør er ansvarlig for å oppdatere filer, overvåke nettverk / hardware, overvåke at browser fungerer osv.

Godkjent dersom minst 1 (en) tilstandsmelding fra hver konfigurerte skjerm, som oppfyller alle ytelseskrav er mottatt i løpet av måleperioden.

Godkjent dersom Tjenestemottaker har mottatt minst 97% av sendte kvitteringsmeldinger i løpet av måleperioden.

3

Salg av billetter

Salg av billetter er viktig for å gi inntektssikring for Tjenestemottaker

Sjåføren skal være pålogget på alle stoppesteder gjennom hele avgangen, f.o.m. første holdeplass t.o.m. siste.

På hver holdeplass/stoppested måler RuterSalg-diagnosemodulen at følgende krav er oppfylt:

• At sjåfør/operatør av billettsalget er pålogget

Godkjent dersom minst 95% av målte stoppesteder er godkjent.

3

Passasjertelling (APC)

Passasjertelling brukes av Tjenestemottaker for å vise fyllingsgrad på avganger i sanntid, for å kunne gi bedre informasjon til reisende, for å planlegge rutetilbudet, for å vurdere behov for innsatsbusser samt å utarbeide trafikkstatistikk for Tjenestemottakers nettverk. Tellinger kan bli delt eksternt etter utarbeidede prinsipper for å sikre kundene en mer helhetlig og sømløs reise på tvers av mobilitetsleverandører. Passasjertelling brukes også til å validere at kjøretøyets dørsensorer fungerer.

APC tjeneste

For busser som kan leverer doors_individually skal APC-melding sendes pr. dør til tjenestemottaker etter at dør har blitt endret fra DoorOpen=true til DoorOpen=false. Busser som kun sender sensors/door skal APC-melding sendes pr. dør til tjenestemottaker etter at dørstatus har blitt endret fra anyDoorOpen til allDoorsClosed.

Melding må mottas maksimalt 30 sekunder etter endring av dørstatus.

For beregning av tjeneste tillates det avviket som gir færrest manglende meldinger i løpet av en måleperiode. Det tillates enten inntil tre (3) manglende meldinger pr. måleperiode eller melding fra 90% av totalt antall kombinasjoner av doors_individually = true/false eller melding fra 90% av betjente holdeplasser med dørlukking. 

APC presisjon

Presisjon mellom avstigende og påstigende måles per måleperiode. Hvis en måleperiode ikke tilfredsstiller kravet til presisjon, regnes presisjonen som underkjent for alle avganger i måleperioden.

Avviket må være mindre enn ti (10) personer, eller 10 % etter formelen for prosentvis avvik:

absolutt(påstigende-avstigende) / ((påstigende+avstigende)/2)

For beregning av presisjon tillates det avviket som gir minst tellefeil i løpet av en måleperiode.

Godkjent dersom alle krav er godkjent.

3

Dørstatus

Dørstatus brukes for å gi bedre sanntidsinformasjon, å styre trafikkprioritering samt å validere at passasjertellere fungerer.

For alternative konfigurasjoner kan dørstatus indikere tilgjengelighet for om bord- og avstigning. F.eks. landgang på ferger.

• Dørstatus pr dør sendes umiddelbart ved åpning og lukking. Status skal sendes i en gitt sekvens.

  • Åpen status skal etterfølges av lukket status og lukket status skal etterfølges av åpen status.

• Det tillates inntil 2 meldinger utenfor sekvens pr dør på kjøretøyet/fartøyet pr. tur i måleperioden.

• Se for øvrig krav til Passasjertelling. 

Godkjent dersom alle krav er godkjent.

3

Stoppsignal

Stoppsignal brukes for å gi bedre passasjerinformasjon ombord samt å forbedre fremdrifts-status på turer og vognløp.

• Stoppsignal sendes umiddelbart når reisende aktiverer dette hvis kjøretøyet/fartøyet har stoppsignal.

Godkjent dersom alle krav er godkjent.

3

Validering/aktivering av reiserett

Validering av reiserett bidrar til Tjenestemottakers inntektssikring

Det skal være mulig å validere reiseretter, og eventuelt ha enkel dialog med kunden, på alle stoppesteder gjennom hele avgangen, f.o.m. første holdeplass t.o.m. siste.

(Spesifiseres senere i.h.t. intensjonen.)

(Spesifiseres senere i.h.t. intensjonen.)

3

Odometer

Odometer brukes av Tjenestemottaker som en redundant løsning for posisjon der mottaksforholdene for posisjon er vanskelige eller satellittdekning ikke er tilgjengelig.

Odometer skal konfigureres opp til å sende 1 gang/sekundet, med høyeste oppløsning gitt av sensoren.

For å ta høyde for dårlig mobildekning tillater vi noe datatap.

For å ta høyde for at meldingen sendes over mqtt med QoS=0 telles ikke kortere brudd i datastrømmen.

For å ta høyde for at strøm blir skrudd av mellom passasjerturer, feks. ved en pause ignoreres brudd som skjer der kjøretøyet sto stille. Da kan også messageNumber resettes til 0.

Odometerverdien skal reflektere kjøretøyets totale kilometerstand der det er mulig.

• messageNumber skal øke med 1 for hver sendte melding. Hvis messageNumber ikke øker regnes ikke meldingen som korrekt mottatt.

• To påfølgende meldinger skal mottas med et intervall på max 3,5 sekunder. I praksis at 2 meldinger kan falle bort under sending. Meldinger som er mottatt mer enn 3,5 sekunder etter avsending teller ikke som mottatt.

• For intervall større enn 3,5 sekunder regnes 1 melding som ikke korrekt mottatt per påbegynte sekund det mangler posisjoner etter 3,5 sekunder.

• Påfølgende meldinger skal mottas med et intervall på minst 0,9 sekunder i gjennomsnitt.

• Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meter ignoreres. Dette gjelder også for messageNumber.

• Odometerverdien skal ikke nullstilles eller gjøre «roll-over» i løpet av en måleperiode.

Godkjent dersom >95% av alle odometer-meldinger er korrekt mottatt og det ikke gjøres en «roll-over» av odometerverdien i løpet av måleperioden.

3

Innetemperatur / Kabintemperatur

Innetemperatur kan brukes for å forbedre kundeopplevelse gjennom forbedret etterlevelse av krav til temperatur og mulighet for bedre forvaltning og styring av materiell. Innetemperatur kan også benyttes til bedre informasjon til reisende. 

Temperaturmålinger skal skje regelmessig og sendes hvert 10. sekund, med ett målepunkt per sensor.

Brudd i datastrømmen der kjøretøyet stod stille ignoreres. 

• Gjennomsnittlig intervall mellom meldinger skal være minst 8 og maks 12 sekunder i løpet av en måleperiode. 

• For intervall på minst 12 sekunder regnes 1 melding som ikke korrekt mottatt per påbegynte 60 sekunder det mangler melding. Det tillates 3 brudd i løpet av en tur. Eksempler: 

  • Et intervall på 12 sekunder regnes som 1 brudd i datastrømmen. 

  • Et intervall på 3 minutter og 11 sekunder (60+60+60+11 sekunder) regnes som 3 brudd i datastrømmen. 

  • Et intervall på 3 minutter og 12 sekunder (60+60+60+12 sekunder) regnes som 4 brudd og er ikke godkjent. 

• Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meter ignoreres. 

Godkjent dersom alle krav er godkjent.

3

Utendørstemperatur

Utendørstemperatur kan brukes for å forbedre prognose på avgangstider og kalibrering/analyse av passasjertellinger. Utendørstemperatur kan også brukes til å følge opp krav til inneklima.

Temperaturmålinger skal skje regelmessig og sendes hvert 60. sekund.

Brudd i datastrømmen der kjøretøyet stod stille ignoreres. 

• Gjennomsnittlig intervall mellom meldinger skal være minst 55 og maks 65 sekunder i løpet av en måleperiode. 

• For intervall på minst 65 sekunder regnes 1 melding som ikke korrekt mottatt per påbegynte 120 sekunder det mangler melding. Det tillates 3 brudd i løpet av en tur. Eksempler: 

  • Et intervall på 65 sekunder regnes som 1 brudd i datastrømmen. 

  • Et intervall på 7 minutter og 4 sekunder (120+120+120+64 sekunder) regnes som 3 brudd i datastrømmen. 

  • Et intervall på 7 minutter og 5 sekunder (120+120+120+65 sekunder) regnes som 4 brudd og er ikke godkjent. 

• Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meter ignoreres. 

Godkjent dersom alle krav er godkjent.

3

Vindusviskerstatus

Vindusviskerstatus brukes for å forbedre prognose på avgangstider. 

Sendes ved hver tilstandsendring av vindusviskerfunksjon.

Brudd i datastrømmen der kjøretøyet stod stille ignoreres. 

• Sendes ved hver tilstandsendring av vindusviskerfunksjon i en måleperiode.

• Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meter ignoreres. 

Godkjent dersom alle krav er godkjent.

3

Akselerometer

Akselerometer kan brukes for å skape ny innsikt om generell kundeopplevelse, sikkerhet og veikvalitet. Det kan også brukes til å bedre følge opp kundehenvendelser.

Akselerometermeldinger skal sendes regelmessig og hvert 10. sekund.

Brudd i datastrømmen der kjøretøyet stod stille ignoreres. 

• Gjennomsnittlig intervall mellom meldinger skal være minst 8 og maks 12 sekunder i løpet av en måleperiode. 

• For intervall på minst 12 sekunder regnes 1 melding som ikke korrekt mottatt per påbegynte 60 sekunder det mangler melding. Det tillates 3 brudd i løpet av en tur. Eksempler: 

  • Et intervall på 12 sekunder regnes som 1 brudd i datastrømmen. 

  • Et intervall på 3 minutter og 11 sekunder (60+60+60+11 sekunder) regnes som 3 brudd i datastrømmen. 

  • Et intervall på 3 minutter og 12 sekunder (60+60+60+12 sekunder) regnes som 4 brudd og er ikke godkjent. 

• Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meter ignoreres. 

Godkjent dersom alle krav er godkjent.

3

Energiforbruk (kWh)

(kun elektriske busser og fartøy)

Energiforbruk kan brukes til å samle innsikt om materiellet til ruteplanlegging og for etterlevelse av miljø- og bærekraftsmål.

Energiforbruket skal sendes regelmessig og hvert 60. sekund.

Brudd i datastrømmen der kjøretøyet stod stille ignoreres. 

• Gjennomsnittlig intervall mellom meldinger skal være minst 55 og maks 65 sekunder i løpet av en måleperiode. 

• For intervall på minst 65 sekunder regnes 1 melding som ikke korrekt mottatt per påbegynte 120 sekunder det mangler melding. Det tillates 3 brudd i løpet av en tur. Eksempler: 

  • Et intervall på 65 sekunder regnes som 1 brudd i datastrømmen. 

  • Et intervall på 7 minutter og 4 sekunder (120+120+120+64 sekunder) regnes som 3 brudd i datastrømmen. 

  • Et intervall på 7 minutter og 5 sekunder (120+120+120+65 sekunder) regnes som 4 brudd og er ikke godkjent. 

• Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meter ignoreres. 

Godkjent dersom alle krav er godkjent.

3

Batterinivå (SOC, kun elbuss)

Batterinivå brukes for å samle innsikt om bruk av elektriske kjøretøy og fartøy i rutetilbudet. 

Batterinivå skal sendes regelmessig og hvert 60. sekund. 

Brudd i datastrømmen der kjøretøyet stod stille ignoreres.

• Gjennomsnittlig intervall mellom meldinger skal være minst 55 og maks 65 sekunder i løpet av en måleperiode. 

• For intervall på minst 65 sekunder regnes 1 melding som ikke korrekt mottatt per påbegynte 120 sekunder det mangler melding. Det tillates 3 brudd i løpet av en tur. Eksempler: 

  • Et intervall på 65 sekunder regnes som 1 brudd i datastrømmen. 

  • Et intervall på 7 minutter og 4 sekunder (120+120+120+64 sekunder) regnes som 3 brudd i datastrømmen. 

  • Et intervall på 7 minutter og 5 sekunder (120+120+120+65 sekunder) regnes som 4 brudd og er ikke godkjent. 

• Brudd i datastrømmen der odometer viser at kjøretøyet flyttet seg mindre enn 10 meter ignoreres. 

Godkjent dersom alle krav er godkjent. 

3

Ladestatus (kun elektriske busser og fartøy)

Ladestatus brukes for å gi bedre sanntidsinformasjon samt å samle innsikt om bruk av el-busser i rutetilbudet.

Sendes ved hver tilstandsendring av ladestatus eller endring av ladeeffekt. 

• Meldinger skal sendes i forbindelse med all batterilading, både innenfor og utenfor måleperioder. Meldinger skal sendes ved hver tilstandsendring av ladestatus. Dersom meldingen inneholder ladeeffekt, skal det også sendes ny melding ved endring av ladeeffekt på mer enn 10 kW. 

• Det telles som brudd dersom det sendes to påfølgende meldinger med samme innhold. Brudd utenfor måleperiode telles i den påfølgende måleperioden. Det tillates 3 brudd per måleperiode. 

• Måleperioden er ikke godkjent dersom det ikke sendes melding om lading som kan knyttes til en økning av batterinivået med minst 10 prosentpoeng. 

Godkjent dersom alle krav er godkjent.

3

Vanntemperatur (kun fartøy) 

Vanntemperatur kan brukes for å gi informasjon om badetemperatur i Oslofjorden. 

Temperaturmålinger skal skje regelmessig og sendes hvert 60. sekund. 

• Gjennomsnittlig intervall mellom meldinger skal være innenfor et toleransevindu på 55-minst 55 og maks 65 sekunder i løpet av en måleperiode. 

• For intervall større på mer enn 120 sekunder regnes 1 melding som ikke korrekt mottatt per påbegynte 60 sekunder det mangler melding. Det tillates 3 brudd i løpet av en avgangtur. EksempelEksempler: 

  • Et intervall på 121-180 sekunder siden forrige melding regnes som 1 brudd i datastrømmen. 

  • Et intervall på 181-240 sekunder siden forrige melding regnes som 2 brudd i datastrømmen. 

Godkjent dersom alle krav er godkjent. 

3

Vind-data (kun fartøy) 

Vind-data kan brukes for å gi bedre informasjon om værforholdene i Oslofjorden. 

Vindmålinger skal skje regelmessig og sendes hvert 60. sekund. 

• Gjennomsnittlig intervall mellom meldinger skal være innenfor et toleransevindu på 55-minst 55 og maks 65 sekunder i løpet av en måleperiode. 

• For intervall større på mer enn 120 sekunder regnes 1 melding som ikke korrekt mottatt per påbegynte 60 sekunder det mangler melding. Det tillates 3 brudd i løpet av en avgangtur. EksempelEksempler: 

  • Et intervall på 121-180 sekunder siden forrige melding regnes som 1 brudd i datastrømmen. 

  • Et intervall på 181-240 sekunder siden forrige melding regnes som 2 brudd i datastrømmen. 

Godkjent dersom alle krav er godkjent.