Bluetooth-version för smarta glasögon, mall för fallstudier, är ett dokument som du kan kopiera. Vi publicerar det eftersom en Bluetooth-kvalificering är ett av de få programområden inom denna kategori där en bra dokumentation verkligen är mer värdefull än en bra produkt. Alla kan ange ett versionsnummer. Dokumentationen visar vad som testades, under vilka förhållanden och vad man fann.
Vår publicerade position är mallens fasta del. K01 och K02 publicerar Bluetooth 5.3; D11, LC-105-1, D12, LC-105-2, YK12, G07, YKC02, D17, ZH12, A07, AR-glasögonposten och posten för AI-elektrokromiska glasögon publicerar 5.4. Fjorton av de tjugåtta modellerna publicerar ingen version, och elva av dem är kameramodeller. Den verifierade enhetslistan, antalet samtidiga anslutningar, fodralets samexistensbeteende och uppdateringsvägen publiceras inte för någon modell. Dessa fyra luckor är exakt vad en fallstudie är avsedd att täppa till.
Bluetooth-version för smarta glasögon: elva kolumner som gör en radiodokumentation återanvändbar
En dokumentation är återanvändbar när nästa program kan använda den utan att behöva upprepa arbetet. Prüvningen av detta är enkel: kan någon annan läsa dokumentet, upprepa metoden och komma fram till samma slutsats? En dokumentation som endast beskriver resultat klarar inte denna prövning, eftersom ett resultat inte kan upprepas.
De elva kolumnerna nedan utgör strukturen. De är inte en mall för brödtext, utan de fält som dokumentationen måste innehålla. Det första att observera är att fyra av dem finns för att dokumentera något som inte är känt.
Referens och datum. Fallets referens, författaren och datumet. Den här kolumnen utför nästan inget arbete men avgör allt, eftersom en radiodokumentation utan datum är en dokumentation som inte kan jämföras med något annat. Diskussionen om Bluetooth-versionering tar upp vad som händer med samma fakta när flottan växer, och det är just tillväxten som gör en dokumentation utan datum värdelös.
Program och kanal. Produkten, marknaden, kanalen och storleken på den population den betjänar. Ett kvalificeringsresultat gäller en avgränsad del, inte universellt, och omfattningen måste skrivas in i dokumentationen i stället för att antydas.
Modell och beteckning. Den exakta modellsträngen eller en uttrycklig anmärkning om att modellen saknar beteckning. I vår katalog saknar tre poster all modellbeteckning. En dokumentation som omfattar någon av dem måste ange detta, eftersom ett resultat knutet till en namnlös produkt inte kan överföras till en namngiven produkt.
Publicerad rad för radio. Versionen när en sådan publiceras och en anmärkning om att ingen publiceras när det inte finns någon. Fjorton modeller saknar versionsnummer, elva av dem är kameramodeller. Det ärliga sättet att dokumentera detta är som en efterfrågad rad, inte som en överhoppad rad.
Modulens artikelnummer. Den styrda komponenten. Det är denna kolumn som avslöjar ett komponentbyte i efterhand och som gör att en dokumentation som endast bygger på ett versionsnummer är svagare än den verkar.
Imagenivå. Den firmware som körs på de utvärderade enheterna. Radiobeteende är en egenskap hos en image och inte hos en modell. En dokumentation som utelämnar detta kan inte jämföras med en senare testning av samma produkt.
Lista över värdarenheter. De modeller som testats, deras operativsystemsversioner och den andel av kundbasen som respektive modell representerar. Det är denna andel som gör en teknisk lista till ett kommersiellt beslut.
Miljö. Rummet, trafiken på 2.4 GHz, avståndet och förflyttningen under testet. En anslutningssekvens som lyckas i en testmiljö säger ingenting om verkstadsgolvet. Miljön är den del som normalt utelämnas och alltid spelar roll.
Metod och upprepningar. Vad som gjordes, i vilken ordning, hur många gånger och mot ett protokoll som skrevs före den första avläsningen. En metod som en annan köpare kan upprepa är värd flera gånger mer än ett resultat som inte kan upprepas.
Resultat, inklusive misslyckandena. Utfallet för varje kombination, med misslyckandena kvar i dokumentet. En dokumentation som endast innehåller godkända resultat är en annons.
Öppna poster och deras ansvariga. Vad som förblev öppet, varför och vem som ska åtgärda det. Den här kolumnen är skillnaden mellan en kvalificering och ett påstående.
Elva är fler än de flesta team kommer att fylla i på första försöket, och det är värt att veta vilka kolumner som kan tas bort utan att skadet registret. De fyra som inte kan tas bort är referens och datum, modell och beteckning, metod samt resultat med felen – de fyra gör dokumentet användbart över huvud taget. Listan över värd-enheter och miljön är det som gör det överförbart till ett annat program. De återstående fyra – den publicerade raden för radio, modulens artikelnummer, bildnivån och de öppna punkterna – kan läggas till allt eftersom programmet utvecklas, och ett register som börjar med sju kolumner och växer är ett bättre resultat än ett register som väntar på elva kolumner innan det skrivs.
Ordningen i vilken kolumnnerna fylls spelar större roll än det ser ut. De tidiga kolumnerna är billiga att fylla i och de ändrar kostnaden för allt som följer: en modellbeteckning som visar sig vara fel från början kostar en eftermiddag, och samma problem som upptäcks i kolumn tio kostar hela programmet.

Fylla kolumnnerna utifrån de publicerade raderna
Den andra halvan av mallens användbarhet är att de flesta kolumner kan fyllas i innan ett enda test har körts, vilket förkortar programmet och gör luckorna synliga tidigt.
Referens och datum är administrativt. Programmet och kanalen kommer från beställningen. Kolumnen för modell och beteckning kan fyllas i utifrån ordern och byggkortet, och kontrollen som den möjliggör är just den som betyder något: om beteckningen på enheten skiljer sig från beteckningen på ordern, skrivs registret om fel produkt. Den publicerade raden för radio är en uppslagslista för fjorton modeller och en dokumenterad förfrågan om de andra fjorton.
Modulens artikelnummer är en förfrågan till fabriken, och det är den förfrågan som har längst ledtid, eftersom det är den som avgör om en förändring alls kan upptäckas. Bildnivån läses av från de enheter som står framför dig. Listan över värd-enheter är en förhandling med kanalen, och andelssiffrorna är den del som kanalen sällan har att lämna ifrån sig.
Miljön beslutas innan proven anländer, och det bör vara den miljö som produkten faktiskt kommer att befinna sig i. Det är den kolumn som avgör om registret är värt något senare: en kvalificering som körs i ett tyst rum ger ett resultat som inte kan citeras för en busy butikgolv, och att citera det ändå är sämre än att inte ha något resultat alls.
Metoden, resultaten och de öppna punkterna är de tre kolumner som bara testet kan fylla i, och de är skälet till att registret skrivs medan arbetet pågår i stället för att rekonstrueras i efterhand. Ett register som sätts ihop i slutet utifrån anteckningar och minne tappar exakt de två saker ett senare program behöver: ordningsföljden och felen.
Vem som fyller i varje kolumn är en praktisk fråga som en mall bör svara på, eftersom en kolumn utan ansvarig är en kolumn som inte fylls i. Referensen, programmets omfattning och miljön är köparens. Modellen och beteckningen, modulens artikelnummer och bildnivån är leverantörens, och det är de tre som vanligtvis kräver en förfrågan. Listan över värd-enheter är gemensam: kundbasen kommer från kanalen och operativsystemets versioner kommer från supportdatan. Metoden förhandlas mellan parterna, och den bör vara överenskommen skriftligen innan den första enheten sätts på. Resultaten tillhör den som körde testet, och de öppna punkterna tillhör namngivna individer med datum mot sig. Sex parter, och en mall som inte anger vilken part som äger vilken kolumn kommer att fyllas i av den part som har minst annat att göra.
Ett genomfört exempel gör mekanismen konkret. Ta K01, som anger Bluetooth 5.3, en arkitektur med dubbla 90 mAh-celler, magnetisk laddning och en angiven driftstid på cirka åtta timmar. Dess post inleds med beteckningen och datumet; den publicerade raden för radiosystem fylls i från katalogen; modulens artikelnummer och bildnivån begärs från fabriken; listan med värdar hämtas från kanalens supportdata; och miljön ställs in på den butikslokal där produkten ska finnas i stället för på en testbänk. Kolumnen för kundernas andel väcker omedelbart en fråga som köparen måste besvara före testet: K01:s värdar är två generationer gamla, så en betydande del av kundbasen kan köra ett operativsystem som ingen aktuell telefon använder. Den frågan är värd att ställa, och det är mallen som har producerat den — inte något köparen råkade tänka på. Samma post för en av kameramodellerna inleds med en begäran i stället för en sökning, eftersom ingen kameramodel publicerar någon radioversion alls — vilket är exakt den typ av skillnad som en återanvändbar struktur bör göra synlig redan på första sidan.

Kompatibilitetsregistret, en rad per värdar
Listan med värdf-enheter förtjänar en egen struktur, eftersom den är den del av posten som återanvänds mest och den del som oftast kollapsas till en enda mening.
Registret har en rad per värdar, och varje rad innehåller värdarmodellen, operativsystemets version, kundernas andel, antalet testade enheter, bildnivån, resultatet, antalet upprepningar och datumet. Åtta fält, en rad, och raden är evidensenheten.
Tre regler gör registret användbart. För det första är en rad bara komplett när den anger enheterna och bildnivån, eftersom ett resultat utan dessa uppgifter inte kan reproduceras. För det andra hör repetitionsantalet hemma i raden och inte i en not, eftersom två lyckade försök och ett är olika resultat och läsaren inte ska behöva ta reda på vilket hen tittar på. För det tredje är en misslyckad rad inte pinsam; den är den mest värdefulla raden i registret, eftersom den kan spara nästa program en vecka och ge fabriken något konkret att åtgärda.
Registret har också en naturlig gränsvillkor, och det är värt att skriva in det i posten i stället för att lämna det outtalat. När en ny värdarenhet dyker upp i kundbasen med en andel värd att bry sig om är registret inaktuellt, och posten måste ange det. En kvalificering är ett påstående om en population vid en viss tidpunkt, och populationen förändras. Köparens checklista är ett användbart komplement, och köpguiden täcker det omgivande urvalet.
En konvention gör registret mycket lättare att granska: varje kombination som inte testats får en egen rad och markeras som otestad, i stället för att utelämnas. En utelämnad kombination är osynlig för läsaren, eftersom en saknad rad och en godkänd rad ser likadana ut i en sammanfattning. En explicit otestad rad är ett påstående, och det är det påstående som ett senare program behöver mest — eftersom kombinationen som ingen testade är den kombination som dyker upp som ett kundklagagemål sex månader senare, och en explicit rad gör klagagemålet till en sökning i stället för en undersökning. Samma konvention gäller för modellsidan: en modell som omfattades av testet men inte testades visas som en otestad rad av samma skäl.
Kolumnen för kundernas andel förtjänar en anmärkning om hur den förändrar betydelsen av hela registret. Ett fel på en värdarenhet som täcker två procent av basen är en supportfråga och en dokumentationskorrigering. Ett fel på en värdarenhet som täcker trettio procent är ett beslut om att stoppa leveranserna. Registret är samma dokument i båda fallen, och det är kolumnen med kundernas andel som visar läsaren vilken av de två situationerna hen tittar på.

Registrera luckorna utan att fylla i dem
De fyra områden som inte publicerats i vår position — den verifierade enhetslistan, antalet samtidiga anslutningar, beteendet vid samtidig användning av flera enheter och uppdateringsvägen — är skälet till att det finns en post av det här slaget. Varje område är en rad som någon måste fylla i, och varje område är en rad som vanligtvis fylls med ett antagande.
Regeln för kolumnen med öppna punkter är att en lucka registreras som en lucka, med en orsak och en ansvarig. Inte ”okänt”, vilket låter som ett försummelse. Inte ett typiskt värde från branschen, vilket låter som en mätning. En mening som anger vad som inte testades, varför det inte testades och vad som skulle behöva hända för att det skulle testas.
Det finns ett skäl till att regeln här är striktare än på andra ställen. Vid en radiokvalificering tenderar en antagande som har skrivits ner som en fakta att bestå. Det kopieras till nästa specifikation, sedan till nästa förteckning, och får en historia av att ha blivit nedskrivet, vilket är en trovärdighet som ingen mätning bär med sig. Fallstudiemallen i det intilliggande batteriarbetet följer samma disciplin på strömsidan, och diskussionen om kvalitetssäkring täcker tillverkningssidan av samma fråga.
Det andra skälet är kommersiellt. En öppen punkt som registreras som öppen kan prissättas, schemaläggas och stängas. En öppen punkt som har fyllts i med en rimlig siffra kan inte upptäckas senare, vilket betyder att risken den representerade nu är osynlig i alla dokument som hänvisar till den.
Öppna punkter bör också granskas regelbundet i stället för vid slutet, och granskningen bör vara kort. Ta kolumnen med öppna punkter och fråga för varje punkt om den har stängts, om den fortfarande är relevant och om antagandet den ersatte nu har skrivits in i någon specifikation. Den sista frågan är den som fångar felmoden: en öppen punkt som har fyllts i i tysthet av en kollega som behövde fatta ett beslut, och vars värde nu finns i tre specifikationsblad och en förteckning. En kvartalsvis genomgång av kolumnen med öppna punkter, femton minuter varje, räcker för att förhindra det.
Hur den färdiga dokumentationen används igen
En kvalificeringsdokumentation tjänar sitt pris andra gången den läses, och det är där de flesta misslyckas. Den första läsningen sker veckan den publiceras, när teamet som utförde testet fortfarande finns i rummet. Den andra läsningen sker ett år senare, av ett annat team, i ett annat program, och det är den som avgör om dokumentationen var värd att skriva.
Fyra saker avgör om den andra läsningen fungerar. Dokumentationen är självständig, så att läsaren inte behöver rekonstruera metoden ur en kollegas minne. Den är verifierbar, så att läsaren kan kontrollera råresultaten i stället för att lita på sammanfattningen. Den är ärlig, så att misslyckanden och öppna punkter syns i stället för att begravas. Och den versionsstyrs, så att läsaren kan avgöra om den fortfarande beskriver produkten framför sig – en dokumentation som har ersatts bör markeras som ersatt, inte tas bort, eftersom förändringen av en produkt i sig är ett resultat.
Publicera den där leverantören kan se den. Ett kvalificeringsdokument som stannar inom köparens team ändrar ingenting i nästa program, och leverantören är den part som är bäst lämpad att rätta till de misslyckanden som finns i det. Raderna med misslyckanden är just därför dokumentets mest värdefulla del: de utgör den gemensamma arbetslistan mellan de två organisationerna.
Återanvändningsscenariorna är värda att ange, eftersom det är för dem dokumentationen köps. Ett nytt program på samma plattform hittar registerlistan och utvidgar den med en rad per ny värdenhet i stället för att köra hela sekvensen igen. Ett nytt program på en annan plattform hittar metoden och miljön och kopierar dem, vilket sparar de två veckor man annars skulle lägga på att utforma ett test från grunden. En leverantörsaudit hittar resultaten och misslyckandena och vet exakt vilka frågor som kan väntas. En kanalgranskning hittar de otestade raderna och vet vad som får och inte får påstås. Och en ny projektledare ärver ett dokument i stället för att ärva en uppsättning frågor.
Den totala kostnaden för dokumentationen är en eller två dagar av teamets tid plus själva testet, och återbäringen är att en upprepad kvalificeringscykel och en kompatibilitetsdisput undviks. Det är ett bra förhållande för ett dokument som samtidigt utgör beviset med vilket en kundtvist kan avgöras.
Det korta svaret: en kvalificeringsdokumentation är en leverabel, inte en intern anteckning, och vi stöttar gärna en sådan för alla program. Vi kommer också att vara tydliga med de fyra luckorna i vår publicerade position, eftersom en mall som låtsas att de är stängda ger en fallstudie som inte går att försvara senare.
Vi fyller inte i ett otestat område med en rimlig siffra, och vi godkänner inte ett resultat som inte har reproducerats. Det vi gör är att hjälpa dig att ta fram dokumentationen, köra testet och ge dig den råa dokumentationen, även de delar som inte fungerade.
Skicka din enhetslista och miljö, så återkommer vi med den färdiga dokumentationen och de fyra luckorna markerade som öppna där de fortfarande är öppna.
Relaterad läsning
- En komplett checklista för samma arbete — köparchecklista för SIG-certifiering
- Det omgivande urvalsarbetet — köp av augmented reality-glasögon
- Samma disciplin när det gäller strömförsörjningen — mall för fallstudier om batteritid
- Tillverkarsidan av frågan — kvalitetssäkring för konsumentelektronikvarumärken
- Vad som händer med samma uppgifter i stor skala — avancerade överväganden
Skicka er enhetslista och miljöbeskrivning, så returnerar vi det färdiga dokumentet med öppna luckor markerade som öppna där de fortfarande är öppna.



