Jeg manglet en Mac-app til Kardia – så vi bygget en
Fra et konkret behov til en fungerende Mac-app: Bluetooth-opptak, lokale EKG-data og utfordringene som gjenstår før signalene kan valideres.
Hovedbilde: KI-generert illustrasjon laget for Skjld Labs. Det ekte skjermbildet nedenfor dokumenterer Mac-appen.
Nytt fra labben · Skjld Labs
Det startet med et konkret behov: Jeg hadde en KardiaMobile 6L, men manglet en Mac-app for å bruke den slik jeg ønsket.
Et håndholdt EKG som er enkelt å ta i bruk
KardiaMobile 6L fra AliveCor er en liten, håndholdt EKG-enhet i lommeformat. Den brukes sammen med en mobiltelefon og kan registrere seks EKG-avledninger på omtrent 30 sekunder. De seks avledningene gir ulike perspektiver på hjertets elektriske aktivitet: I, II, III, aVR, aVL og aVF.
Det kompakte formatet og den korte opptakstiden gjør den lettvint å ta frem og bruke. I den offisielle Kardia-appen kan opptakene vises, lagres og deles med lege. For meg gjorde dette Kardia til et interessant utgangspunkt: En anvendelig liten enhet som jeg også ønsket å kunne bruke direkte fra Mac-en. Les mer om KardiaMobile 6L hos produsenten.
Det ble utgangspunktet for et prosjekt hos Skjld Labs. Kunne vi koble enheten direkte til Mac-en, hente inn signalet over Bluetooth og vise det i en enkel, lokal app?
Nå har vi en fungerende prototype. Den finner enheten, kobler seg til og viser signalene mens opptaket pågår. Underveis har prosjektet også gitt oss en nyttig påminnelse om hvor mye arbeid som ligger mellom å få data på skjermen og å vite nøyaktig hva dataene betyr.
Fra Bluetooth-pakker til kurver
Løsningen er en liten, selvstendig Mac-app bygget med SwiftUI og Apples Bluetooth-rammeverk. Den trenger ingen konto eller skytjeneste. Opptakene behandles lokalt og lagres først når brukeren velger det.
Appen tar opp omtrent 30 sekunder om gangen. To kanaler kommer fra enheten, og fire andre avledninger beregnes fra disse. Ved lagring følger både de opprinnelige Bluetooth-pakkene, de dekodede prøvene og informasjon om opptaket med.
Det siste er viktig for videre utvikling. Når vi endrer noe i dekodingen, kan vi gå tilbake til originaldataene og kontrollere resultatet.
Arbeidet bygger på offentlig dokumenterte protokollobservasjoner fra åpen kildekode-prosjektet kardia-rs. Selve Mac-appen er en egen Swift-implementasjon.
Den første utfordringen er å få forbindelsen til å fungere
Bluetooth-forbindelsen består av flere trinn. Appen må finne enheten mens den er våken, koble til, oppdage de riktige tjenestene, aktivere meldinger og sende en startkommando i forventet format. macOS håndterer eventuell paring og tilgang.
At enheten dukker opp i et søk, betyr derfor ikke at datastrømmen er klar. Hvert trinn må fungere, og feil må håndteres uten at mottatte data går tapt.
En annen utfordring er at protokollobservasjoner fra én fastvareversjon ikke automatisk gjelder alle andre. Appen tolker derfor bare det pakkeformatet vi har implementert støtte for. Kommer en pakke med uventet lengde, stopper opptaket og bevarer råpakken for undersøkelse.
Hva har vi faktisk fått bekreftet?
I et lagret testopptak fra 6. november 2026 mottok appen 1 001 EKG-pakker med totalt 9 009 prøvepar. Ingen av EKG-pakkene hadde uventet lengde. Den observerte gjennomsnittlige takten tilsvarte omtrent 300 prøvepar i sekundet.
Vi har også kontrollert eksporten mot originalpakkene. Alle eksporterte signalverdier og pakketidsstempler samsvarte.
Det gir et konkret grunnlag for videre arbeid: Vi kan vise at de mottatte dataene blir dekodet og eksportert som forventet.
Den største utfordringen er å vite hva vi kan stole på
En kurve på skjermen er bare starten.
Vi har ennå ikke validert forholdet mellom råverdiene og fysisk spenning, eller signalets polaritet. Visningen skalerer dessuten hver kurve automatisk. Den er nyttig for å følge signalet, men gir ikke grunnlag for å sammenligne amplituder som på et kalibrert EKG.
Tidsinformasjonen har også begrensninger. Appen registrerer når Mac-en mottar pakkene. Bluetooth kan levere data ujevnt, og en riktig gjennomsnittlig mottakstakt beviser ikke at alle prøver har kommet frem. Bedre kontroll av timing og mulige datatap er derfor en del av det videre arbeidet.
Det finnes også mer praktiske forbedringspunkter. Ulagrede opptak ligger bare i minnet og kan forsvinne hvis appen krasjer. Mulige neste forbedringer er gjenoppretting, mer fullstendig informasjon om hvert opptak og flere tester av feil under tilkobling og lagring.
Prototypen gir foreløpig ingen diagnose, pulsberegning eller automatiske målinger. Den er eksperimentell og ikke medisinsk validert. Kardia Reader er et uavhengig prosjekt uten tilknytning til AliveCor.
Kildekoden er offentlig
Vi har publisert kildekoden til Mac-appen på GitHub: Skjld Labs – Kardia ECG Reader for macOS. Repositoriet inneholder den kommenterte Swift-koden, bygge- og testskript og en README som forklarer oppsett, bruk, eksportformat og kjente begrensninger. Det inneholder ingen private EKG-opptak eller ferdigbygde appfiler.
Vil du undersøke løsningen eller bygge den selv? Start med byggeinstruksjonene i README og notatene om Bluetooth-protokollen og datatolkningen. Dagens byggeoppsett krever en Apple Silicon-Mac, macOS 14 eller nyere og full Xcode. Publiseringen gjør implementasjonen etterprøvbar; kalibrering, polaritet og medisinsk signalnøyaktighet er fortsatt ikke validert.
Videre i labben
Neste naturlige steg er å gjøre opptakene mer robuste og lettere å etterprøve: kontrollere enhetens kommandosvar, forbedre timingdiagnostikken og teste flere feilsituasjoner. Kalibrering mot en kjent referanse må også på plass før vi kan stole på en visning i fysiske enheter.
Prosjektet begynte fordi jeg manglet en Mac-app. Nå har vi en lokal prototype som faktisk henter inn og viser data fra enheten – og et tydeligere bilde av hva som må til for å utvikle den videre.