Maskinoversettelse, ikke gjennomgått av en morsmålsbruker. Engelsk er referansen.

TidssynkroniseringRediger på GitHubKilde: docs/HARDWARE-SAFETY.md

Maskinvaresikkerhet: hva Kshana gjør med maskinvare, og hva den aldri gjør

Status: juridisk gjennomgang hos eieren venter. De juridiske merknadene nedenfor er vedlikeholdernes lesning av offentlige kilder, skrevet slik at en bruker vet hvor grensene går. De er ikke juridisk rådgivning, de er ikke gjennomgått av en advokat, og lovgivningen varierer fra land til land. Les dem som en grunn til å spørre en advokat, ikke som en tillatelse.

Kshana er veiledende programvare for forskning, simulering og testing. Den er ikke typegodkjent utstyr og vurderer eller godkjenner verken en mottaker, en klokke eller et laboratorium. Se den veiledende erklæringen i README.

Regelen#

Mottak er produktet. Sending er aldri en del av den åpne motoren.

  • Kshana inneholder ingen kode som styrer en sender. Det finnes ingen SDR-sendebane (ingen sendekall til UHD, HackRF, bladeRF eller Soapy), og ingen jamming- eller spoofing-bølgeform skrives til en fil som er ment for avspilling.
  • Filene Kshana skriver (IQ-scener, SigMF- og ION .sdrx-opptak, NMEA- og bench-eksporter) beskriver simulerte, legitime signaler eller bevegelser, og metadataene Kshana skriver for en scene sier at den er skrevet av kshana iq scene (ION .sdrx-kommentaren sier at det er en simulert scene, ikke et opptak).
  • Der et eksperiment trenger RF på en benk, produserer operatørens eget utstyr det, i operatørens egen skjermede kasse, under operatørens egen tillatelse. Kshana registrerer det operatøren sier ble gjort, og utleder det aldri.

Trinn#

Hvert trinn sier hva Kshana gjør, hvilken maskinvare som er involvert, hvem som sender RF (hvis noen), og porten som må holde før Kshana behandler resultatet som evidens.

Trinn Kshana sin rolle Maskinvare RF-utsendelse Port Status i 0,38
0 Filer: avspillingslogger, IQ, bench-eksporter, direkte NMEA eller UBX over stdin, TCP eller UDP ingen ingen ingen levert
1 Passivt mottak: mottakere skrivebeskyttet; tidslogger (linuxptp, chrony, TICC); IMU-CSV; iq monitor --follow på en voksende SigMF-fil brukerens mottakere, grandmaster, SDR i mottak ingen enhver konfigurasjonsskriving til en mottaker krever en uttrykkelig --configure; standarden er skrivebeskyttet delvis levert: formater for tidslogger, holdover-test, iq monitor --follow; seriell mottakerinngang er planlagt
2 Laboratorieorkestrering uten RF fra Kshana: en spesifikasjon av testforhold, operatørtrinn (trekke ut antennen, starte simulatoren) som varsles og tidsstemples, tur-retur-scoring og evidens simulatorer og skjermede bokser som laboratoriet eier bare fra laboratoriets simulator, ledningsbundet en signert lab-attestation (nedenfor) registrert i bevispakken; Kshana nekter å score en laboratoriekjøring uten den registreringen er implementert i bevispakker; nektelsen av å score uten den er det ikke ennå (det finnes ingen kommando for laboratoriekjøring)
3 Ledningsbundet avspilling av legitime GNSS IQ-scener: Kshana skriver scenefilen, og brukeren spiller den av med eget verktøy inn i en kabel med dempere og en enhet under test i en RF-kasse brukerens SDR, dempere og kasse bare ledningsbundet, brukerens ansvar ingen sendekode i den åpne motoren; bølgeformer for interferens og spoofing holdes utenfor omfanget; eksportkontrollgjennomgang; advokat ikke i den åpne motoren; en oppgave for den kommersielle utgaven som må gjøres sammen med en advokat
4 Lukket sløyfe med RF-maskinvare i sanntid (hardware-in-the-loop) partnerens utstyr partner integrer i stedet gjennom spesifikasjonen for trinn 2 ikke planlagt

«Levert» betyr at koden er i denne utgivelsen. Ingenting i denne tabellen sier at noe trinn har vært brukt sammen med noen partner, noe laboratorium eller noen myndighet; ingen har det.

Prinsipper#

  1. Mottak er produktet, og sending er aldri en del av den åpne koden.
  2. Hver maskinvareøkt gir en bevispakke med hasher av inndataene, forholdene og terskelene som ble brukt.
  3. En attest om ledningsbundet eller skjermet oppsett registreres, og utledes aldri.
  4. Tall som kommer fra maskinvare forblir MODELLED til en uavhengig ekstern referanse stemmer (for eksempel en referansebane fra et laboratorium eller en referanseklokke). En terskel som er fastsatt på forhånd, løsnes ikke etter en kjøring.
  5. Antenner med kontrollerte mønstre, treghetsenheter og atomklokker i brikkestørrelse behandles som datakilder (mønstre, logger, publiserte stabilitetskurver), ikke som enheter Kshana styrer.
  6. Ordbruk: et resultat er «målt mot masken» eller «gir belegg for» et krav. Kshana sier ikke at et utstyr oppfyller en standard, og ingen har vurdert eller godkjent det.

Å motta GNSS-signaler er lovlig nesten overalt. Å sende i GNSS-bånd er det ikke.

  • USA. Forsettlig forstyrrelse av radiokommunikasjon er forbudt etter 47 U.S.C. §333, og FCC håndhever mot jammere (https://www.fcc.gov/general/jammer-enforcement). En sending fra en benk kan nå utenfor benken.
  • Andre steder. Vedlikeholderne har ikke gjennomgått andre lands lovgivning. Fellesskapet rundt gps-sdr-sim oppgir at det er forbudt ved lov i de fleste land å sende utdataene fra den; behandle det som arbeidsantakelsen overalt hvor en advokat ikke har sagt noe annet.
  • Et skjermet eller ledningsbundet oppsett er en sikring, ikke en tillatelse. Attesten nedenfor registrerer sikringen operatøren sier var på plass. Den gjør ikke en utsendelse lovlig.
  • Opptak. Å ta opp radiosignaler kan reise spørsmål om personvern og lovlighet enkelte steder. iq monitor --follow og enhver opptaksoppskrift er kun for mottak, og operatøren er ansvarlig for hvor og hva de tar opp.
  • Eksportkontroll. Programvare for hardware-in-the-loop som styrer signalgeneratorer, kan falle inn under eksportkontrollregler. Derfor ligger trinn 3 utenfor den åpne motoren.
  • Ingenting her er en anbefaling eller en avtale. Ingen reguleringsmyndighet, testbane, noe laboratorium eller leverandør er konsultert om dette dokumentet eller har gått med på noe i det.

Feltet lab-attestation#

For trinn 2 og høyere har en kjøring som involverte laboratorieutstyr et lab-attestation-objekt, registrert i bevispakken ved siden av hashene av inndataene. Det er en erklæring fra en navngitt operatør, ikke en måling, og Kshana verifiserer den ikke.

[lab-attestation]                                     # or the same keys at the top level of the file
operator = "name or role of the person responsible"   # required
organisation = "laboratory or company"                # required
date = "2026-11-02"                                   # required, the day of the session
setup = "conducted"                                   # required: "conducted" or "shielded"
attenuation_db = 60.0                                 # required for "conducted": total, emitter to device
enclosure = "RF-shielded box, model and ID"           # required for "shielded"
emitter = "laboratory-owned simulator, model"         # required: what produced any RF
statement = "No emission outside the enclosure or cable path."   # required, free text
signature = "ed25519:..."                             # optional: the operator's own detached signature, recorded as given

Hva som er implementert i 0,38:

  • kshana receiver-trust evidence ... --lab-attestation <file.toml> validerer filen og registrerer attesten i pakkens manifest.json. Manifestet dekkes av pakkens Ed25519-signatur, så registreringen kan ikke redigeres uten å bryte verifiseringen. Det samme er tilgjengelig som argumentet lab_attestation i Python-funksjonen evidence_create og argumentet lab_attestation_toml i MCP-verktøyet create_evidence_pack (nettleserbygget oppretter ikke pakker).
  • En pakke laget uten en attest er byte for byte det den var før.
  • kshana evidence verify rapporterer attesten og sier at den er «attested by the named operator; not verified by Kshana».
  • En attest som er ufullstendig, eller hvis setup verken er conducted eller shielded (et oppsett over luften godtas ikke som en laboratoriekjøring), avvises, og ingen pakke lages.

Hva som ikke er implementert ennå: regelen i trinn 2 om at Kshana nekter å score en laboratoriekjøring som mangler attest. Ingen kommando tar et flagg for laboratoriekjøring i 0,38, så det er ingenting å avvise; regelen kommer med kommandoene for laboratorieorkestrering. En attest registrerer operatørens erklæring om en sikring. Den gjør ingen utsendelse lovlig, og den endrer ikke et resultats merking: en scoret laboratoriekjøring er MODELLED med mindre en ekstern referanse stemmer.

Hva dette betyr for en bidragsyter#

  • Ikke legg til en sendebane, en sendeavhengighet eller et sendeeksempel i den åpne motoren.
  • Ikke legg til en bølgeformgenerator hvis utdata er et jamming- eller spoofing-signal ment for avspilling.
  • Nye maskinvareinndata er skrivebeskyttet som standard; skriving krever et uttrykkelig flagg og en linje i denne filen.
  • En ny kommando som berører maskinvare kommer på hver flate eller merkes N/A med en begrunnelse i SURFACES.md, og oppgir trinnet sitt her.