Laitteistoturvallisuus: mitä Kshana tekee laitteistolla ja mitä se ei koskaan tee

Tila: omistajan juridinen tarkastus kesken. Alla olevat juridiset huomautukset ovat ylläpitäjien tulkinta julkisista lähteistä, ja ne on kirjoitettu, jotta käyttäjä tietää, missä rajat ovat. Ne eivät ole oikeudellista neuvontaa, lakimies ei ole tarkistanut niitä, ja lainsäädäntö vaihtelee maittain. Lue ne syynä kysyä lakimieheltä, älä lupana.

Kshana on ohjeellinen ohjelmisto tutkimukseen, simulointiin ja testaukseen. Se ei ole tyyppihyväksytty laite, eikä se arvioi tai hyväksy vastaanotinta, kelloa tai laboratoriota. Katso ohjeellisuutta koskeva lausunto README-tiedostosta.

Sääntö#

Vastaanotto on tuote. Lähettäminen ei koskaan kuulu avoimeen moottoriin.

Kshana ei sisällä lähetintä ohjaavaa koodia. SDR-lähetyspolkua ei ole (ei UHD-, HackRF-, bladeRF- eikä Soapy-lähetyskutsua), eikä mitään häirinnän tai harhautuksen aaltomuotoa kirjoiteta toistoa varten tarkoitettuun tiedostoon.
Kshanan kirjoittamat tiedostot (IQ-kohtaukset, SigMF-tallenteet ja ION-tallenteet (.sdrx), NMEA- ja bench-viennit) kuvaavat simuloituja, sallittuja signaaleja tai liikettä, ja Kshanan kohtaukselle kirjoittama metadata kertoo, että sen on kirjoittanut kshana iq scene (ION-tiedoston (.sdrx) kommentti kertoo, että kyseessä on simuloitu kohtaus, ei tallenne).
Kun koe tarvitsee RF-signaalia laboratoriopöydällä, sen tuottaa käyttäjän oma laitteisto käyttäjän omassa kotelossa käyttäjän oman luvan nojalla. Kshana kirjaa sen, minkä käyttäjä sanoo tehdyn, eikä koskaan päättele sitä.

Vaiheet#

Jokainen vaihe nimeää, mitä Kshana tekee, mitä laitteistoa on mukana, kuka lähettää RF-signaalia (jos kukaan), ja portin, jonka on täytyttävä, ennen kuin Kshana käsittelee tuloksen todisteena.

Vaihe	Kshanan rooli	Laitteisto	RF-lähetys	Portti	Tila versiossa 0,38
0	Tiedostot: toistolokit, IQ, bench-viennit, reaaliaikainen NMEA tai UBX stdin-, TCP- tai UDP-kautta	ei mitään	ei mitään	ei mitään	toimitettu
1	Passiivinen vastaanotto: vastaanottimet vain luku -tilassa; ajoituslokit (linuxptp, chrony, TICC); IMU-CSV; `iq monitor --follow` kasvavalla SigMF-tiedostolla	käyttäjän vastaanottimet, grandmaster-kello, SDR vastaanottotilassa	ei mitään	vastaanottimen jokainen asetusten kirjoitus vaatii nimenomaisen valitsimen `--configure`; oletus on vain luku	osittain toimitettu: ajoituslokien formaatit, `holdover-test`, `iq monitor --follow`; sarjaporttivastaanottimen syöte on suunniteltu
2	Laboratorion orkestrointi ilman Kshanan RF-lähetystä: testiolosuhteiden määrittely, operaattorin vaiheet (antennin irrotus, simulaattorin käynnistys) kehotettuna ja aikaleimattuna, kierrospisteytys ja todisteet	laboratorion omat simulaattorit, suojatut kotelot	vain laboratorion simulaattorilta, johdettuna	allekirjoitettu `lab-attestation` (jäljempänä) kirjataan todistepakettiin; Kshana kieltäytyy pisteyttämästä laboratorioajoa ilman sitä	kirjaus on toteutettu todistepaketeissa; kieltäytyminen pisteyttää ilman sitä ei vielä (laboratorioajokomentoa ei ole)
3	Sallittujen GNSS-IQ-kohtausten johdettu toisto: Kshana kirjoittaa kohtaustiedoston, ja käyttäjä toistaa sen omalla työkalullaan kaapelin kautta, jossa on vaimentimet ja testattava laite RF-kotelossa	käyttäjän SDR, vaimentimet ja kotelo	vain johdettuna, käyttäjän vastuulla	avoimessa moottorissa ei ole lähetyskoodia; häirinnän ja harhautuksen aaltomuodot jäävät soveltamisalan ulkopuolelle; vientivalvonnan tarkastus; lakimies	ei avoimessa moottorissa; kaupallisen version kohde, joka tehdään lakimiehen kanssa
4	Reaaliaikainen suljetun silmukan RF-laitteisto silmukassa (hardware-in-the-loop)	kumppanin laitteisto	kumppani	integroi sen sijaan vaiheen 2 määrittelyn kautta	ei suunniteltu

”Toimitettu” tarkoittaa, että koodi on tässä julkaisussa. Mikään tämän taulukon kohta ei sano, että jotakin vaihetta olisi käytetty minkään kumppanin, laboratorion tai viranomaisen kanssa; yhtäkään ei ole käytetty.

Periaatteet#

Vastaanotto on tuote, eikä lähettäminen koskaan kuulu avoimeen koodiin.
Jokaisesta laitteistoistunnosta syntyy todistepaketti, jossa on syötteiden, olosuhteiden ja käytettyjen kynnysten tiivisteet.
Johdettu tai suojattu vahvistus kirjataan, ei koskaan päätellä.
Laitteistosta saadut luvut pysyvät MODELLED-tasolla, kunnes riippumaton ulkoinen oraakkeli on samaa mieltä (esimerkiksi laboratorion todellinen reitti tai vertailukello). Ennalta rekisteröityä kynnystä ei löysennetä ajon jälkeen.
Hallitun kuvion antennit, inertiayksiköt ja sirumittakaavan atomikellot käsitellään datalähteinä (kuviot, lokit, julkaistut vakauskäyrät), ei laitteina, joita Kshana ohjaa.
Sanamuoto: tulos on ”mitattu maskia vasten” tai ”tukee todisteita (supports evidence for)” jostakin vaatimuksesta. Kshana ei sano, että laite täyttää standardin, eikä kukaan ole arvioinut tai hyväksynyt sitä.

Juridiset huomautukset (omistajan juridinen tarkastus kesken)#

GNSS-signaalien vastaanotto on laillista lähes kaikkialla. Lähettäminen GNSS-kaistoilla ei ole.

Yhdysvallat. Tahallinen radioviestinnän häiritseminen on kielletty säännöksellä 47 U.S.C. §333, ja FCC ryhtyy täytäntöönpanotoimiin häirintälaitteita vastaan (https://www.fcc.gov/general/jammer-enforcement). Laboratoriopöydältä lähetetty signaali voi ulottua pöytää kauemmas.
Muualla. Ylläpitäjät eivät ole tarkastaneet muiden maiden lainsäädäntöä. gps-sdr-simin ympärillä oleva yhteisö toteaa, että sen tulosteen lähettäminen on lailla kielletty useimmissa maissa; pidä tätä työoletuksena kaikkialla, missä lakimies ei ole sanonut toisin.
Suojattu tai johdettu kokoonpano on turvatoimi, ei lupa. Jäljempänä oleva vahvistus kirjaa turvatoimen, jonka operaattori sanoo olleen käytössä. Se ei tee lähetyksestä laillista.
Tallentaminen. Radiosignaalien tallentaminen voi herättää yksityisyyteen ja laillisuuteen liittyviä kysymyksiä joissakin paikoissa. iq monitor --follow ja kaikki tallennusohjeet ovat vain vastaanottavia, ja operaattori vastaa siitä, missä ja mitä hän tallentaa.
Vientivalvonta. Signaaligeneraattoreita ohjaava hardware-in-the-loop-ohjelmisto voi kuulua vientivalvontasääntöjen piiriin. Siksi vaihe 3 on avoimen moottorin ulkopuolella.
Mikään tässä ei ole suositus tai sopimus. Mitään sääntelyviranomaista, testialuetta, laboratoriota tai toimittajaa ei ole konsultoitu tästä asiakirjasta, eikä kukaan ole sopinut mistään sen sisällöstä.

Kenttä `lab-attestation`#

Vaiheesta 2 alkaen ajoon, jossa oli mukana laboratoriolaitteita, liittyy olio lab-attestation, joka kirjataan todistepakettiin syötteiden tiivisteiden viereen. Se on nimetyn operaattorin lausuma, ei mittaus, eikä Kshana varmenna sitä.

[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

Mitä on toteutettu versiossa 0,38:

kshana receiver-trust evidence ... --lab-attestation <file.toml> tarkistaa tiedoston ja kirjaa vahvistuksen paketin tiedostoon manifest.json. Manifesti on paketin Ed25519-allekirjoituksen kattama, joten kirjausta ei voi muokata rikkomatta varmennusta. Sama on käytettävissä Python-funktion evidence_create argumenttina lab_attestation ja MCP-työkalun create_evidence_pack argumenttina lab_attestation_toml (selainversio ei luo paketteja).
Paketti, joka on tehty ilman vahvistusta, on tavu tavulta sama kuin ennen.
kshana evidence verify raportoi vahvistuksen ja toteaa sen olevan ”nimetyn operaattorin vahvistama; Kshana ei ole varmentanut” (attested by the named operator; not verified by Kshana).
Vahvistus, joka on puutteellinen tai jonka setup ei ole conducted eikä shielded (ilmateitse toimivaa kokoonpanoa ei hyväksytä laboratorioajoksi), hylätään, eikä pakettia tehdä.

Mitä ei ole vielä toteutettu: vaiheen 2 sääntö, jonka mukaan Kshana kieltäytyy pisteyttämästä laboratorioajoa, jolla ei ole vahvistusta. Mikään komento ei ota laboratorioajolippua versiossa 0,38, joten kieltäydyttävää ei ole; sääntö tulee laboratorion orkestrointikomentojen mukana. Vahvistus kirjaa operaattorin lausuman turvatoimesta. Se ei tee mistään lähetyksestä laillista eikä muuta tuloksen merkintää: pisteytetty laboratorioajo on MODELLED, ellei ulkoinen oraakkeli ole samaa mieltä.

Mitä tämä tarkoittaa osallistujalle#

Älä lisää lähetyspolkua, lähetysriippuvuutta tai lähetysesimerkkiä avoimeen moottoriin.
Älä lisää aaltomuotogeneraattoria, jonka tuloste on toistoa varten tarkoitettu häirintä- tai harhautussignaali.
Uudet laitteistosyötteet ovat oletuksena vain luku -tilassa; kirjoitus vaatii nimenomaisen lipun ja rivin tässä tiedostossa.
Uusi laitteistoon koskeva komento tulee jokaiselle pinnalle tai merkitään N/A:ksi perusteluineen tiedostossa SURFACES.md, ja sen vaihe ilmoitetaan tässä.