Riistvara ohutus: mida Kshana riistvaraga teeb ja mida ta kunagi ei tee

Seis: omaniku õigusülevaatus ootel. Allpool toodud õiguslikud märkused on hoidjate arusaam avalikest allikatest, kirjutatud nii, et kasutaja teaks, kus piirid asuvad. Need ei ole õigusnõu, neid ei ole jurist üle vaadanud ja seadused erinevad riigiti. Neid tuleks käsitleda põhjusena juristilt küsida, mitte loana.

Kshana on nõuandev tarkvara uurimiseks, simulatsiooniks ja katsetamiseks. See ei ole tüübikinnitust omav seade ning ei hinda ega kiida heaks vastuvõtjat, kella ega laboratooriumi. Vt README-s olevat nõuandvat avaldust.

Reegel#

Toode on vastuvõtt. Edastamine ei kuulu kunagi avatud mootorisse.

Kshanas ei ole koodi, mis juhiks saatjat. SDR-i saatmisteed ei ole (ühtegi UHD, HackRF, bladeRF või Soapy saatmiskutset), ning ühtegi segamis- ega spuufimislainekuju ei kirjutata taasesituseks mõeldud faili.
Failid, mida Kshana kirjutab (IQ-stseenid, SigMF-i ja ION-i .sdrx salvestised, NMEA ja bench-eksport), kirjeldavad simuleeritud, seaduslikke signaale või liikumist ning stseeni jaoks kirjutatud metaandmed ütlevad, et selle kirjutas kshana iq scene (ION-i .sdrx kommentaar ütleb, et tegemist on simuleeritud stseeniga, mitte salvestisega).
Kui katse vajab RF-i laboripingil (bench), tekitab selle operaatori enda seadmestik operaatori enda kestas ja operaatori enda loa alusel. Kshana salvestab selle, mida operaator ütleb tehtuks, ega järeldata seda kunagi.

Etapid#

Iga etapp nimetab, mida Kshana teeb, millist riistvara kasutatakse, kes RF-i kiirgab (kui keegi), ja värava, mis peab kehtima enne, kui Kshana käsitleb tulemust tõendina.

Etapp	Kshana roll	Riistvara	RF-kiirgus	Värav	Seis versioonis 0,38
0	Failid: taasesituslogid, IQ, bench-eksport, otse-NMEA või UBX stdin-i, TCP või UDP kaudu	puudub	puudub	puudub	tarnitud
1	Passiivne vastuvõtt: vastuvõtjad ainult lugemiseks; ajastuslogid (linuxptp, chrony, TICC); IMU CSV; `iq monitor --follow` kasvaval SigMF-failil	kasutaja vastuvõtjad, suurmeister (grandmaster), SDR vastuvõtus	puudub	iga vastuvõtjasse tehtav konfiguratsioonikirjutus nõuab selgesõnalist `--configure`; vaikimisi on ainult lugemine	osaliselt tarnitud: ajastuslogi vormingud, `holdover-test`, `iq monitor --follow`; jadavastuvõtja sisend on kavandatud
2	Laboriorkestreerimine ilma Kshana RF-ita: katsetingimuste spetsifikatsioon, operaatori sammud (antenni eemaldamine, simulaatori käivitamine) küsitud ja ajatembeldatud, ringteekonna hindamine ja tõendid	labori enda simulaatorid, varjestatud kastid	ainult labori simulaatorist, juhtmega	allkirjastatud `lab-attestation` (allpool) salvestatakse tõendipaketti; Kshana keeldub ilma selleta laborikäivitust hindamast	kirje on tõendipakettides realiseeritud; keeldumist ilma selleta hindamast veel ei ole (laborikäivituse käsku ei ole)
3	Seaduslike GNSS-i IQ-stseenide juhtmega taasesitus: Kshana kirjutab stseenifaili ja kasutaja esitab selle oma tööriistaga uuesti kaabli kaudu, millel on sumbistid ja testitav seade RF-kestas	kasutaja SDR, sumbistid, kest	ainult juhtmega, kasutaja vastutus	avatud mootoris ei ole saatekoodi; häire- ja spuufimislainekujud jäävad ulatusest välja; ekspordikontrolli läbivaatus; jurist	ei kuulu avatud mootorisse; kommertsväljaande ülesanne, mida tuleb teha juristiga
4	Reaalajas suletud ahelaga RF-riistvara silmuses (hardware-in-the-loop)	partneri seadmestik	partner	integreerida selle asemel etapi 2 spetsifikatsiooni kaudu	ei ole kavas

„Tarnitud“ tähendab, et kood on selles väljalaskes olemas. Midagi selles tabelis ei väida, et ühtegi etappi oleks kasutatud ühegi partneri, labori või ametiasutusega; ühtegi ei ole.

Põhimõtted#

Toode on vastuvõtt ning edastamine ei kuulu kunagi avatud koodi.
Iga riistvaraseanss annab tõendipaketi, milles on sisendite, tingimuste ja kasutatud lävendite räsid.
Juhtmega või varjestatud seadistuse atesteering salvestatakse, seda ei järeldata kunagi.
Riistvarast pärit arvud jäävad MODELLED, kuni sõltumatu väline sõltumatu etalon nõustub (näiteks labori tõeline trajektoor või etalonkell). Eelregistreeritud lävi ei lõdvendata pärast käivitust.
Kontrollitud suunadiagrammiga antenne, inertsiaalseadmeid ja kiibimõõtmelisi aatomkellasid käsitletakse andmeallikatena (suunadiagrammid, logid, avaldatud stabiilsuskõverad), mitte seadmetena, mida Kshana juhib.
Sõnastus: tulemus on „mõõdetud maski suhtes“ või „toetab tõendeid (supports evidence for)“ nõude kohta. Kshana ei väida, et seade täidab standardi nõudeid, ning keegi ei ole seda hinnanud ega heaks kiitnud.

Õiguslikud märkused (omaniku õigusülevaatus ootel)#

GNSS-i signaalide vastuvõtmine on seaduslik peaaegu kõikjal. GNSS-i sagedusaladel edastamine ei ole.

Ameerika Ühendriigid. Tahtlik raadiosidehäirimine on keelatud seaduse 47 U.S.C. §333 alusel ning FCC võtab segajate vastu jõustamismeetmeid (https://www.fcc.gov/general/jammer-enforcement). Laboripingilt (bench) edastus võib ulatuda pingist kaugemale.
Mujal. Hoidjad ei ole teiste riikide õigust läbi vaadanud. gps-sdr-sim-i ümber olev kogukond väidab, et selle väljundi edastamine on enamikus riikides seadusega keelatud; seda tuleks pidada tööeelduseks kõikjal, kus jurist ei ole öelnud teisiti.
Varjestatud või juhtmega seadistus on kaitsemeede, mitte litsents. Allolev atesteering salvestab kaitsemeetme, mis operaatori sõnul oli rakendatud. See ei muuda kiirgust seaduslikuks.
Salvestamine. Raadiosignaalide salvestamine võib mõnes kohas tekitada privaatsus- ja seaduslikkuseküsimusi. iq monitor --follow ja iga püüdmisretsept on ainult vastuvõtvad ning operaator vastutab selle eest, kus ja mida ta salvestab.
Ekspordikontroll. Riistvara silmuses (hardware-in-the-loop) tarkvara, mis juhib signaaligeneraatoreid, võib kuuluda ekspordikontrolli reeglite alla. Seepärast jääb etapp 3 avatud mootorist välja.
Siin ei ole midagi toetuskiitust ega kokkulepet. Ühegi reguleerija, katsepolügooni, labori ega tarnijaga ei ole selle dokumendi kohta konsulteeritud ning ükski neist ei ole millegagi siin nõustunud.

Väli `lab-attestation`#

Etapi 2 ja kõrgema puhul kannab laboriseadmeid hõlmanud käivitus objekti lab-attestation, mis salvestatakse tõendipaketti sisendite räside kõrvale. See on nimetatud operaatori väide, mitte mõõtmine, ning Kshana seda ei kontrolli.

[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

Mis on realiseeritud versioonis 0,38:

kshana receiver-trust evidence ... --lab-attestation <file.toml> valideerib faili ja salvestab atesteeringu paketi failis manifest.json. Manifesti katab paketi Ed25519 allkiri, mistõttu kirjet ei saa muuta kontrollimist katkestamata. Sama on saadaval Pythoni evidence_create argumendina lab_attestation ja MCP tööriista create_evidence_pack argumendina lab_attestation_toml (brauseriversioon pakette ei loo).
Pakett, mis tehakse ilma atesteeringuta, on bait-baidilt selline, nagu see oli varem.
kshana evidence verify teatab atesteeringust ja ütleb, et see on „attested by the named operator; not verified by Kshana“.
Atesteering, mis on mittetäielik või mille setup ei ole ei conducted ega shielded (õhu kaudu tehtav seadistus ei ole laborikäivitusena aktsepteeritav), lükatakse tagasi ja paketti ei tehta.

Mis ei ole veel realiseeritud: etapi 2 reegel, mille kohaselt Kshana keeldub hindamast laborikäivitust, millel puudub atesteering. Ükski käsk ei võta versioonis 0,38 laborikäivituse lippu, seega ei ole millestki keelduda; reegel lisandub koos laboriorkestreerimise käskudega. Atesteering salvestab operaatori väite kaitsemeetme kohta. See ei muuda ühtegi kiirgust seaduslikuks ega muuda tulemuse märgist: hinnatud laborikäivitus on MODELLED, kui just väline sõltumatu etalon ei nõustu.

Mida see tähendab kaastöötajale#

Avatud mootorisse ei tohi lisada saatmisteed, saatmissõltuvust ega saatmisnäidet.
Ei tohi lisada lainekujugeneraatorit, mille väljund on taasesituseks mõeldud segamis- või spuufimissignaal.
Uued riistvarasisendid on vaikimisi ainult lugemiseks; kirjutamine nõuab selgesõnalist lippu ja rida selles failis.
Uus käsk, mis riistvaraga kokku puutub, lisatakse igale pinnale või märgitakse põhjendusega N/A failis SURFACES.md ning märgib siin oma etapi.