sportident.js 1.0.0

package/src/SiCard/types/siCard8Examples.ts

@@ -0,0 +1,152 @@
+import _ from 'lodash';
+import * as utils from '../../utils';
+import type { SiCardSample } from '../ISiCardExamples';
+
+const cache = {};
+
+const getFullTimesPage = utils.cached(cache, () =>
+	utils.unPrettyHex(`
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+    `)
+);
+const getNoTimesPage = utils.cached(cache, () =>
+	utils.unPrettyHex(`
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+    `)
+);
+
+export const getCardWith16Punches = utils.cached(cache, () => ({
+	cardData: {
+		uid: 0x772a4299,
+		cardNumber: 2345678,
+		startTime: {time:8721+43200, weekcounter: 0, weekday: 3},
+		finishTime: null,
+		checkTime: {time:8735+43200, weekcounter: 3, weekday: 3},
+		punchCount: 16,
+		punches: [
+			{ code: 31, time: {time:7967+43200, weekcounter: 1, weekday: 7} },
+			{ code: 32, time: {time:8224, weekcounter: 2, weekday: 0} },
+			{ code: 33, time: {time:8481+43200, weekcounter: 2, weekday: 0} },
+			{ code: 34, time: {time:8738, weekcounter: 2, weekday: 1} },
+			{ code: 35, time: {time:8995+43200, weekcounter: 2, weekday: 1} },
+			{ code: 36, time: {time:9252, weekcounter: 2, weekday: 2} },
+			{ code: 37, time: {time:9509+43200, weekcounter: 2, weekday: 2} },
+			{ code: 38, time: {time:9766, weekcounter: 2, weekday: 3} },
+			{ code: 39, time: {time:10023+43200, weekcounter: 2, weekday: 3} },
+			{ code: 40, time: {time:10280, weekcounter: 2, weekday: 4} },
+			{ code: 41, time: {time:10537+43200, weekcounter: 2, weekday: 4} },
+			{ code: 42, time: {time:10794, weekcounter: 2, weekday: 5} },
+			{ code: 43, time: {time:11051+43200, weekcounter: 2, weekday: 5} },
+			{ code: 44, time: {time:11308, weekcounter: 2, weekday: 6} },
+			{ code: 45, time: {time:11565+43200, weekcounter: 2, weekday: 6} },
+			{ code: 46, time: {time:11822, weekcounter: 2, weekday: 7} }
+		],
+		cardHolder: {
+			firstName: 'a',
+			lastName: 'b',
+			isComplete: true
+		}
+	},
+	storageData: [
+		...utils.unPrettyHex(`
+                77 2A 42 99 EA EA EA EA 37 02 22 1F 07 03 22 11
+                EE EE EE EE 0F 7F 10 09 0F 23 CA CE 06 0F 61 53
+                61 3B 62 3B EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+            `),
+		...utils.unPrettyHex(`
+                20 20 20 20 20 20 20 20 1F 1F 1F 1F 20 20 20 20
+                21 21 21 21 22 22 22 22 23 23 23 23 24 24 24 24
+                25 25 25 25 26 26 26 26 27 27 27 27 28 28 28 28
+                29 29 29 29 2A 2A 2A 2A 2B 2B 2B 2B 2C 2C 2C 2C
+                2D 2D 2D 2D 2E 2E 2E 2E EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+            `)
+	]
+}));
+
+export const getFullCard = utils.cached(cache, () => ({
+	cardData: {
+		uid: 0x772a4299,
+		cardNumber: 2345678,
+		startTime: {time:8721+43200, weekcounter: 0, weekday: 3},
+		finishTime: {time:8481+43200, weekcounter: 0, weekday: 3},
+		checkTime: {time:8735+43200, weekcounter: 3, weekday: 3},
+		punchCount: 30,
+		punches: _.range(30).map(() => ({ code: 32, time: {time:8224, weekcounter: 2, weekday: 0} })),
+		cardHolder: {
+			firstName: 'a',
+			lastName: 'b',
+			isComplete: true
+		}
+	},
+	storageData: [
+		...utils.unPrettyHex(`
+                77 2A 42 99 EA EA EA EA 37 02 22 1F 07 03 22 11
+                07 04 21 21 0F 7F 1E 09 0F 23 CA CE 06 0F 61 53
+                61 3B 62 3B EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+            `),
+		...getFullTimesPage()
+	]
+}));
+
+export const getEmptyCard = utils.cached(cache, () => ({
+	cardData: {
+		uid: 0x772a4299,
+		cardNumber: 2345678,
+		startTime: {time:8721+43200, weekcounter: 0, weekday: 3},
+		finishTime: null,
+		checkTime: {time:8735+43200, weekcounter: 3, weekday: 3},
+		punchCount: 0,
+		punches: [],
+		cardHolder: {
+			firstName: undefined,
+			lastName: undefined,
+			isComplete: false
+		}
+	},
+	storageData: [
+		...utils.unPrettyHex(`
+                77 2A 42 99 EA EA EA EA 37 02 22 1F 07 03 22 11
+                EE EE EE EE 0F 7F 00 09 0F 23 CA CE 06 0F 61 53
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+            `),
+		...getNoTimesPage()
+	]
+}));
+
+export const getSiCard8Examples = (): { [name: string]: SiCardSample } => ({
+	cardWith16Punches: getCardWith16Punches(),
+	fullCard: getFullCard(),
+	emptyCard: getEmptyCard()
+});

package/src/SiCard/types/siCard9Examples.ts

@@ -0,0 +1,143 @@
+import _ from 'lodash';
+import * as utils from '../../utils';
+import type { SiCardSample } from '../ISiCardExamples';
+
+const cache = {};
+
+const getFullTimesPage = utils.cached(cache, () =>
+	utils.unPrettyHex(`
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+        20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+    `)
+);
+const getNoTimesPage = utils.cached(cache, () =>
+	utils.unPrettyHex(`
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+        EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+    `)
+);
+
+export const getCardWith16Punches = utils.cached(cache, () => ({
+	cardData: {
+		uid: 0x772a4299,
+		cardNumber: 1234567,
+		startTime: {time:8721+43200, weekcounter: 0, weekday: 3},
+		finishTime: null,
+		checkTime: {time:8735+43200, weekcounter: 3, weekday: 3},
+		punchCount: 16,
+		punches: [
+			{ code: 31, time: {time:7967+43200, weekcounter: 1, weekday: 7} },
+			{ code: 32, time: {time:8224, weekcounter: 2, weekday: 0} },
+			{ code: 33, time: {time:8481+43200, weekcounter: 2, weekday: 0} },
+			{ code: 34, time: {time:8738, weekcounter: 2, weekday: 1} },
+			{ code: 35, time: {time:8995+43200, weekcounter: 2, weekday: 1} },
+			{ code: 36, time: {time:9252, weekcounter: 2, weekday: 2} },
+			{ code: 37, time: {time:9509+43200, weekcounter: 2, weekday: 2} },
+			{ code: 38, time: {time:9766, weekcounter: 2, weekday: 3} },
+			{ code: 39, time: {time:10023+43200, weekcounter: 2, weekday: 3} },
+			{ code: 40, time: {time:10280, weekcounter: 2, weekday: 4} },
+			{ code: 41, time: {time:10537+43200, weekcounter: 2, weekday: 4} },
+			{ code: 42, time: {time:10794, weekcounter: 2, weekday: 5} },
+			{ code: 43, time: {time:11051+43200, weekcounter: 2, weekday: 5} },
+			{ code: 44, time: {time:11308, weekcounter: 2, weekday: 6} },
+			{ code: 45, time: {time:11565+43200, weekcounter: 2, weekday: 6} },
+			{ code: 46, time: {time:11822, weekcounter: 2, weekday: 7} }
+		],
+		cardHolder: {
+			firstName: 'a',
+			lastName: 'b',
+			isComplete: true
+		}
+	},
+	storageData: [
+		...utils.unPrettyHex(`
+                77 2A 42 99 EA EA EA EA 37 02 22 1F 07 03 22 11
+                EE EE EE EE 0F 7F 10 09 0F 12 D6 87 06 0F 61 53
+                61 3B 62 3B EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE 1F 1F 1F 1F 20 20 20 20
+                21 21 21 21 22 22 22 22 23 23 23 23 24 24 24 24
+                25 25 25 25 26 26 26 26 27 27 27 27 28 28 28 28
+                29 29 29 29 2A 2A 2A 2A 2B 2B 2B 2B 2C 2C 2C 2C
+                2D 2D 2D 2D 2E 2E 2E 2E EE EE EE EE EE EE EE EE
+            `),
+		...getNoTimesPage()
+	]
+}));
+
+export const getFullCard = utils.cached(cache, () => ({
+	cardData: {
+		uid: 0x772a4299,
+		cardNumber: 1234567,
+		startTime: {time:8721+43200, weekcounter: 0, weekday: 3},
+		finishTime: {time:8481+43200, weekcounter: 0, weekday: 3},
+		checkTime: {time:8735+43200, weekcounter: 3, weekday: 3},
+		punchCount: 50,
+		punches: _.range(50).map(() => ({ code: 32, time: {time: 8224 , weekcounter: 2, weekday: 0}})),
+		cardHolder: {
+			firstName: 'aaaaaaaaaaaaaaa',
+			lastName: 'bbbbbbb',
+			isComplete: true
+		}
+	},
+	storageData: [
+		...utils.unPrettyHex(`
+                77 2A 42 99 EA EA EA EA 37 02 22 1F 07 03 22 11
+                07 04 21 21 0F 7F 32 09 0F 12 D6 87 06 0F 61 53
+                61 61 61 61 61 61 61 61 61 61 61 61 61 61 61 3B
+                62 62 62 62 62 62 62 3B 20 20 20 20 20 20 20 20
+                20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+                20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+                20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+                20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
+            `),
+		...getFullTimesPage()
+	]
+}));
+
+export const getEmptyCard = utils.cached(cache, () => ({
+	cardData: {
+		uid: 0x772a4299,
+		cardNumber: 1234567,
+		startTime: {time:8721+43200, weekcounter: 0, weekday: 3},
+		finishTime: null,
+		checkTime: {time:8735+43200, weekcounter: 3, weekday: 3},
+		punchCount: 0,
+		punches: [],
+		cardHolder: {
+			firstName: undefined,
+			lastName: undefined,
+			isComplete: false
+		}
+	},
+	storageData: [
+		...utils.unPrettyHex(`
+                77 2A 42 99 EA EA EA EA 37 02 22 1F 07 03 22 11
+                EE EE EE EE 0F 7F 00 09 0F 12 D6 87 06 0F 61 53
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+                EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE
+            `),
+		...getNoTimesPage()
+	]
+}));
+
+export const getSiCard9Examples = (): { [name: string]: SiCardSample } => ({
+	cardWith16Punches: getCardWith16Punches(),
+	fullCard: getFullCard(),
+	emptyCard: getEmptyCard()
+});

package/src/SiDevice/INavigatorWebSerial.ts

@@ -0,0 +1,78 @@
+import type * as utils from '../utils';
+
+export interface WebSerialConnectEvent extends utils.IEvent<'connect'> {
+	device: WebSerialDevice;
+	target: unknown;
+	defaultPrevented: boolean;
+}
+
+export interface WebSerialDisconnectEvent extends utils.IEvent<'disconnect'> {
+	device: WebSerialDevice;
+	target: unknown;
+	defaultPrevented: boolean;
+}
+
+export type WebSerialEvents = {
+	connect: WebSerialConnectEvent;
+	disconnect: WebSerialDisconnectEvent;
+};
+
+interface SerialPortRequestOptions {
+	filters: SerialPortFilter[];
+}
+export interface Serial extends EventTarget {
+	onconnect: EventHandler | undefined;
+	ondisconnect: EventHandler | undefined;
+	getPorts(): Promise<WebSerialDevice[]>;
+	requestPort(options?: SerialPortRequestOptions): Promise<WebSerialDevice>; // Chromium implementation (spec: SerialOptions)
+}
+
+interface Navigator {
+	readonly serial: Serial;
+}
+
+interface RequestDeviceArgs {
+	filters: WebSerialDeviceFilter[];
+}
+
+interface WebSerialDeviceFilter {
+	usbVendorId?: number;
+	usbProductId?: number;
+}
+
+export interface WebSerialDevice {
+	onconnect: EventHandler;
+	ondisconnect: EventHandler;
+	readonly readable: ReadableStream; // Chromium implementation (spec: in)
+	readonly writable: WritableStream; // Chromium implementation (spec: out)
+	open(options: SerialOptions): Promise<void>;
+	close(): Promise<void>;
+	getInfo(): Partial<SerialPortInfo>;
+	forget(): Promise<void>;
+}
+type EventHandler = (event: Event) => void;
+type ParityType = 'none' | 'even' | 'odd' | 'mark' | 'space';
+type FlowControlType = 'none' | 'hardware';
+interface SerialOptions {
+	baudRate: number;
+	dataBits?: number | undefined;
+	stopBits?: number | undefined;
+	parity?: ParityType | undefined;
+	bufferSize?: number | undefined;
+	flowControl?: FlowControlType | undefined;
+}
+interface SerialPortInfo extends SerialPortInfoBase, SerialPortFilter {} // mix spec and Chromium implementation
+interface SerialPortInfoBase {
+	serialNumber: string;
+	manufacturer: string;
+	locationId: string;
+	vendorId: string;
+	vendor: string;
+	productId: string;
+	product: string;
+}
+
+interface SerialPortFilter {
+	usbVendorId: number;
+	usbProductId?: number | undefined;
+}

package/src/SiDevice/INavigatorWebUsb.ts

@@ -0,0 +1,62 @@
+import type * as utils from '../utils';
+
+export interface WebUsbConnectEvent extends utils.IEvent<'connect'> {
+	device: WebUsbDevice;
+	target: unknown;
+	defaultPrevented: boolean;
+}
+
+export interface WebUsbDisconnectEvent extends utils.IEvent<'disconnect'> {
+	device: WebUsbDevice;
+	target: unknown;
+	defaultPrevented: boolean;
+}
+
+export type WebUsbEvents = {
+	connect: WebUsbConnectEvent;
+	disconnect: WebUsbDisconnectEvent;
+};
+
+export interface WebUsb extends utils.IEventTarget<WebUsbEvents> {
+	getDevices: () => Promise<WebUsbDevice[]>;
+	requestDevice: (args: RequestDeviceArgs) => Promise<WebUsbDevice>;
+}
+
+interface RequestDeviceArgs {
+	filters: WebUsbDeviceFilter[];
+}
+
+interface WebUsbDeviceFilter {
+	vendorId?: number;
+	productId?: number;
+}
+
+export interface WebUsbDevice {
+	configurations: any[];
+	serialNumber: string;
+	vendorId: number;
+	productId: number;
+	opened: boolean;
+	open: () => Promise<void>;
+	close: () => Promise<void>;
+	reset: () => Promise<void>;
+	selectConfiguration: (configuration: number) => Promise<void>;
+	claimInterface: (interfaceNumber: number) => Promise<void>;
+	releaseInterface: (interfaceNumber: number) => Promise<void>;
+	selectAlternateInterface: (interfaceNumber: number, alternate: number) => Promise<void>;
+	transferIn: (endpoint: number, length: number) => Promise<WebUsbTransferInData>;
+	transferOut: (endpoint: number, buffer: ArrayBuffer) => Promise<void>;
+	controlTransferOut: (endpoint: WebUsbControlTransferSetup, data?: ArrayBuffer) => Promise<void>;
+}
+
+export interface WebUsbTransferInData {
+	data?: DataView;
+}
+
+interface WebUsbControlTransferSetup {
+	recipient: string;
+	request: number;
+	requestType: string;
+	index: number;
+	value: number;
+}

package/src/SiDevice/ISiDevice.ts

@@ -0,0 +1,48 @@
+import type { ISiTargetMultiplexer } from '../SiStation/ISiTargetMultiplexer';
+import * as utils from '../utils';
+
+/* eslint-disable no-unused-vars,no-shadow */
+export enum SiDeviceState {
+	Closed = 0,
+	Opening = 1,
+	Opened = 2,
+	Closing = 3
+}
+/* eslint-enable no-unused-vars,no-shadow */
+
+export interface ISiDeviceDriverData<T> {
+	driver: T;
+}
+
+export class DeviceClosedError extends utils.SiError {}
+
+export class SiDeviceStateChangeEvent extends utils.Event<'stateChange'> {
+	constructor(public siDevice: ISiDevice<ISiDeviceDriverData<unknown>>, public state: SiDeviceState) {
+		super();
+	}
+}
+export class SiDeviceReceiveEvent extends utils.Event<'receive'> {
+	constructor(public siDevice: ISiDevice<ISiDeviceDriverData<unknown>>, public uint8Data: number[]) {
+		super();
+	}
+}
+
+export type SiDeviceEvents = {
+	stateChange: SiDeviceStateChangeEvent;
+	receive: SiDeviceReceiveEvent;
+};
+
+export interface ISiDevice<T extends ISiDeviceDriverData<unknown>> extends utils.IEventTarget<SiDeviceEvents> {
+	name: string;
+	ident: string;
+	state: SiDeviceState;
+	setState: (newState: SiDeviceState) => void;
+	data: T;
+	siTargetMultiplexer?: ISiTargetMultiplexer;
+	open: () => Promise<ISiDevice<T>>;
+	close: () => Promise<ISiDevice<T>>;
+	receiveLoop: () => void;
+	shouldStopReceivingBecauseOfError: (error: unknown) => boolean;
+	receive: () => Promise<number[]>;
+	send: (buffer: number[]) => Promise<unknown>;
+}

package/src/SiDevice/ISiDeviceDriver.ts

@@ -0,0 +1,35 @@
+import * as utils from '../utils';
+import type { ISiDevice, ISiDeviceDriverData } from './ISiDevice';
+
+export interface ISiDeviceDriver<T extends ISiDeviceDriverData<unknown>> {
+	name: string;
+	open: (device: ISiDevice<T>) => Promise<unknown>;
+	close: (device: ISiDevice<T>) => Promise<unknown>;
+	receive: (device: ISiDevice<T>) => Promise<number[]>;
+	send: (device: ISiDevice<T>, buffer: number[]) => Promise<unknown>;
+}
+
+export interface ISiDeviceDriverWithDetection<T extends ISiDeviceDriverData<unknown>, U extends Array<unknown>> extends ISiDeviceDriver<T> {
+	detect: (...args: U) => Promise<ISiDevice<T>>;
+}
+
+export class SiDeviceAddEvent<T extends ISiDeviceDriverData<unknown>> extends utils.Event<'add'> {
+	constructor(public siDevice: ISiDevice<T>) {
+		super();
+	}
+}
+export class SiDeviceRemoveEvent<T extends ISiDeviceDriverData<unknown>> extends utils.Event<'remove'> {
+	constructor(public siDevice: ISiDevice<T>) {
+		super();
+	}
+}
+
+export type SiDeviceDriverWithAutodetectionEvents<T extends ISiDeviceDriverData<unknown>> = {
+	add: SiDeviceAddEvent<T>;
+	remove: SiDeviceRemoveEvent<T>;
+};
+
+export interface ISiDeviceDriverWithAutodetection<T extends ISiDeviceDriverData<unknown>> extends ISiDeviceDriver<T>, utils.IEventTarget<SiDeviceDriverWithAutodetectionEvents<T>> {
+	startAutoDetection: () => Promise<ISiDevice<T>[]>;
+	stopAutoDetection: () => Promise<unknown>;
+}

package/src/SiDevice/README.md

@@ -0,0 +1,13 @@
+# Drivers
+
+There are different ways to open a serial data connection to a SportIdent Main Station.
+Some Examples:
+
+- [WebUSB](https://wicg.github.io/webusb/)
+- [`chrome.serial`](https://developer.chrome.com/apps/serial)
+- [`chrome.usb`](https://developer.chrome.com/apps/usb)
+- Your custom python script piping the serial port into a WebSocket, which JavaScript then talks to
+
+## Interface
+
+see [`ISiDeviceDriver`](ISiDeviceDriver.ts)