led-matrix-controllers 0.1.1 → 0.2.0

package/dist/led-matrix-controllers.browser.mjs

@@ -1,2 +1,2 @@
-const t=9,e=34,r=12972,a=[50,172],i=32,n=[0,32],s=Object.freeze([0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,2,2,2,2,2,2,2,2,2,3,3,3,3,3,3,3,4,4,4,4,4,4,5,5,5,5,6,6,6,6,6,7,7,7,7,8,8,8,9,9,9,10,10,10,11,11,11,12,12,12,13,13,14,14,14,15,15,16,16,17,17,17,18,18,19,19,20,20,21,22,22,23,23,24,24,25,26,26,27,27,28,29,29,30,31,32,32,33,34,34,35,36,37,38,38,39,40,41,42,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,66,67,68,69,70,71,73,74,75,76,78,79,80,82,83,84,86,87,88,90,91,93,94,96,97,99,100,102,103,105,106,108,110,111,113,115,116,118,120,121,123,125,127,128,130,132,134,136,138,140,141,143,145,147,149,151,153,155,157,159,161,164,166,168,170,172,174,177,179,181,183,186,188,190,193,195,197,200,202,205,207,210,212,215,217,220,222,225,228,230,233,236,238,241,244,247,249,252,255]),o=[],c=[{vendorId:12972,productId:32}];class l extends Error{constructor(){super("User cancelled device selection."),this.name=this.constructor.name,this.date=new Date}}class d{constructor(t){this.#t=t}async send(t,e){if(e.length<t.bytes)e=function(t,e,r=0){return t.concat(new Array(e-t.length).fill(r))}(e,t.bytes);else if(e.length>t.bytes)throw new Error("Unable to send report: too many bytes");const r=new Uint8Array(e).buffer;t.feature?await this.#t.sendFeatureReport(t.id,r):await this.#t.sendReport(t.buffer)}async receive(t){let e=[];if(!t.feature)throw new Error("Invalid operation");return e=await this.#t.receiveFeatureReport(t.id),e.byteLength!=t.bytes&&console.error(`reply length=${e.byteLength} (exp ${t.bytes})`),e}#t}const h={id:1,bytes:307,feature:!0},w={id:2,bytes:16,feature:!0},u={id:4,bytes:306,feature:!0},p=0,y=1,f=2,m=3,O=5,E=0;class A{constructor(t){this.#e=t}async info(){const t=await this.#e.receive(h);return{sleep_pin:t.getUint8(1),dip1_pin:t.getUint8(2),intb_pin:t.getUint8(3),state_flags:t.getUint8(4),id_reg:t.getUint8(5),config_reg:t.getUint8(6),global_brightness:t.getUint8(7),display_width:t.getUint8(8),display_height:t.getUint8(9),timeout_ms:t.getUint32(10)}}async wake(){await this.#e.send(w,[y,!1])}async sleep(){await this.#e.send(w,[y,!0])}async disableSleep(){await this.#e.send(w,[m,255,255,255,255])}async disableDeepSleep(){await this.#e.send(w,[f,1])}async disableSleepTimer(){await this.#e.send(w,[m,0,0,0,0])}async enableDeepSleep(){await this.#e.send(w,[f,0])}async enableSleepTimer(t){const e=new DataView(new ArrayBuffer(4));e.setInt32(0,t,!1),await this.#e.send(w,[m,e.getUint8(0),e.getUint8(1),e.getUint8(2),e.getUint8(3)])}async reboot(t){await this.#e.send(w,[p,t])}async drawPixel(t,e,r){await this.#e.send(w,[O,e,t,r])}async drawLine({r1:t,c1:e},{r2:r,c2:a},i){await this.#e.send(w,[O,t,e,r,a,i])}async bootloader(){await this.reboot(E)}async draw(t){await this.#e.send(u,t.flat().map(t=>s[Math.floor(255*(t??0))]))}async verifyFirmware(){try{const t=await this.info();return 34==t.display_height&&9==t.display_width}catch{return!1}}async version(){return{major:1,minor:0}}#e}class _{static async make(t){const e=await async function(){if(o&&o.length>0)return o.pop();if(o.push(...await navigator.hid.getDevices()),o&&o.length>0)return o.pop();if(o.push(...await navigator.hid.requestDevice({filters:c})),o&&o.length>0)return o.pop();throw new l}();if(e){if("sparkle"===t)return await _.makeSparkleController(e);if("detect"===t)return await _.makeDetectedController(e);throw new Error(`Unsupported firmware type: ${t}`)}}static async makeSparkleController(t){if(t)return await t.open(),new A(new d(t))}static async makeDetectedController(t){const e=await _.makeSparkleController(t);if(e.verifyFirmware())return e}}class g{constructor(t){this.#r=`port-mutex-${Math.random().toString()}`,this.#a=new Map,this.#i=t}async acquire(t){const e=new Error("created bad cb").stack;await this.#n(async()=>{try{await t(this.#i)}catch(t){console.error("Error occured in anonymous callback."),console.error("Original error:",t),console.error("--- This callback was created at ---\n",e)}})}async acquireIdempotent(t,e){const r=new Error("created bad cb").stack;this.#a.has(t)&&console.info(`"${t}" request coalesced.`),this.#a.set(t,async()=>{try{await e(this.#i)}catch(t){console.error("Error occured in anonymous callback."),console.error("Original error:",t),console.error("--- This callback was created at ---\n",r)}}),await this.#n(()=>this.#s(t))}async#n(t){return navigator.locks.request(this.#r,t)}async#s(t){if(this.#a.has(t)){const e=this.#a.get(t);this.#a.delete(t),await e()}}#r;#a;#i}class b{constructor(t){this.#o=t}async rx(t,e=3e3){if(null===this.#o)throw new Error("attempted RX before port initialization.");if(this.#o.readable.locked)throw new Error("attempted RX while port locked.");const r=[],a=this.#o.readable.getReader(),i=setTimeout(()=>a.cancel(),e);try{for(;r.length<t;){const{value:t,done:e}=await a.read();if(r.push(...t??[]),e||!t)break}}finally{clearTimeout(i),a.releaseLock()}return r}async tx(t){if(null===this.#o)throw new Error("attempted TX before port initialization.");if(this.#o.writable.locked)throw new Error("attempted TX while port locked.");const e=this.#o.writable.getWriter();try{await e.write(new Uint8Array(t))}finally{await e.close()}}#o}class T extends Error{constructor(){super("User cancelled port selection."),this.name=this.constructor.name,this.date=new Date}}class I extends Error{constructor(){super("Selected port already in use."),this.name=this.constructor.name,this.date=new Date}}async function M(t){try{await t.close()}catch(t){if("InvalidStateError"!=t.name&&"Failed to execute 'close' on 'SerialPort': The port is already closed."!=t.message)throw t}}const S=Object.freeze({ANIMATE:4,BRIGHTNESS:0,BOOTLOADER:2,DRAW:6,DRAW_GREY_COL_BUFFER:8,GAME_CTRL:17,GAME_STATUS:18,PANIC:5,PATTERN:1,SLEEP:3,STAGE_GREY_COL:7,START_GAME:16,VERSION:32}),x=Object.freeze({GRAY_8BIT:"8-bit",MONO_1BIT:"1-bit"});class R{constructor(t){this.#c=x.MONO_1BIT,this.#l=t}async bootloader(){await this.#l.acquire(async t=>{await t.tx([...a,S.BOOTLOADER])})}async draw(t){if(this.#c==x.GRAY_8BIT){const e=Array.from({length:9},(e,r)=>new Array({length:34},(e,a)=>GAMMA[Math.floor(255*(t[a][r]??0))]));await this.#l.acquireIdempotent("drawMatrix",async t=>{for(let r=0;r<9;r++)await t.tx([S.STAGE_GREY_COL,r,...e[r]]);await t.tx([S.DRAW_GREY_COL_BUFFER])})}else if(this.#c==x.MONO_1BIT){let e=0,r=new Uint8Array(39).fill(0);for(let a=0;a<34;a++)for(let i=0;i<9;i++)t[a][i]&&(r[e>>3]|=1<<e%8),e++;await this.#l.acquireIdempotent("drawMatrix",async t=>{await t.tx([...a,S.DRAW,...r])})}}async verifyFirmware(){let t=null;await this.#l.acquire(async e=>{await e.tx([...a,S.VERSION]),t=await e.rx(32)});const e=32==t.length,r=t.slice(3).every(t=>0==t);return e&&r}async version(){let t={};return await this.#l.acquire(async e=>{await e.tx([...a,S.VERSION]);const r=await e.rx(32);t.major=r[0],t.minor=r[1]>>4,t.patch=15&r[1],t.preRelease=1==r[2]}),t}#c;#l}const D=Object.freeze({NOOP:0,ANIMATION_DIAMOND:100,ANIMATION_FIRE:98,ANIMATION_FIREPLACE:102,ANIMATION_GEAR:103,ANIMATION_RING:114,ANIMATION_STARTUP:97,ANIMATION_STARTUP_ONCE:65,BOOTLOADER:101,DRAW_PWM:109,DRAW_PWM_BLOCKING:77,DRAW_SCALE:110,DRAW_SCALE_BLOCKING:78,FLUSH_CMD_QUEUE:99,TEST_PATTERN:116,SET_CONST_PWM:119,SET_CONST_SCALE:115,SET_PX_PWM:112,SET_PX_SCALE:113,IDENT:127}),N=/^Sig\sFW\sLED\sMatrix\sFW\sV(\d+)\.(\d+)$/;class k{constructor(t){this.#l=t}async bootloader(){await this.#l.acquire(async t=>{await t.tx([D.BOOTLOADER])})}async draw(t){this.#d||(await this.#l.acquire(async t=>{await t.tx([D.SET_CONST_SCALE,32])}),this.#d=!0);const e=t.flat().map(t=>s[Math.floor(255*(t??0))]);await this.#l.acquireIdempotent("drawMatrix",async t=>{await t.tx([D.DRAW_PWM,...e])})}async verifyFirmware(){let t=null;return await this.#l.acquire(async e=>{await e.tx([D.IDENT]),t=await e.rx(25)}),t=String.fromCharCode(...t),t.match(N)}async version(){let t=null;await this.#l.acquire(async e=>{await e.tx([D.IDENT]),t=await e.rx(25)}),t=String.fromCharCode(...t);const e=t.match(N);return e&&3==e.length?{major:e[1],minor:e[2]}:null}#l;#d}class C{static async make(t){const e=await async function(){try{const t=await navigator.serial.requestPort(),{usbProductId:e,usbVendorId:r}=t;return console.log("Selected port:",t),e&&r&&console.log(`VID:PID ${r}:${e}`),t}catch(t){throw"NotFoundError"==t.name?new T:"InvalidStateError"==t.name?new I:t}}();if(e){if("framework-official"===t)return await C.makeDefaultController(e);if("sigroot"===t)return await C.makeSigrootController(e);if("detect"===t)return await C.makeDetectedController(e);throw new Error(`Unsupported firmware type: ${t}`)}}static async makeDefaultController(t){if(t?.connected)return await M(t),await t.open({baudRate:115200}),new R(new g(new b(t)))}static async makeSigrootController(t){if(t?.connected)return await M(t),await t.open({baudRate:115200}),new k(new g(new b(t)))}static async makeDetectedController(t){const e=await this.makeDefaultController(t);if(await e.verifyFirmware())return e;const r=await this.makeSigrootController(t);return await r.verifyFirmware()?r:void 0}}export{s as GAMMA,e as HEIGHT,_ as HIDControllerFactory,i as PID,n as PID_ARR,C as SerialControllerFactory,r as VID,a as VID_ARR,t as WIDTH};
+const e=9,t=34,a=12972,r=[50,172],i=32,n=[0,32],s=Object.freeze([0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,2,2,2,2,2,2,2,2,2,3,3,3,3,3,3,3,4,4,4,4,4,4,5,5,5,5,6,6,6,6,6,7,7,7,7,8,8,8,9,9,9,10,10,10,11,11,11,12,12,12,13,13,14,14,14,15,15,16,16,17,17,17,18,18,19,19,20,20,21,22,22,23,23,24,24,25,26,26,27,27,28,29,29,30,31,32,32,33,34,34,35,36,37,38,38,39,40,41,42,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,66,67,68,69,70,71,73,74,75,76,78,79,80,82,83,84,86,87,88,90,91,93,94,96,97,99,100,102,103,105,106,108,110,111,113,115,116,118,120,121,123,125,127,128,130,132,134,136,138,140,141,143,145,147,149,151,153,155,157,159,161,164,166,168,170,172,174,177,179,181,183,186,188,190,193,195,197,200,202,205,207,210,212,215,217,220,222,225,228,230,233,236,238,241,244,247,249,252,255]),o=[],c=[{usbVendorId:a,usbProductId:32}];class l extends Error{constructor(){super("User cancelled port selection."),this.name=this.constructor.name,this.date=new Date}}class d extends Error{constructor(){super("Selected port already in use."),this.name=this.constructor.name,this.date=new Date}}async function u(){try{if(o&&o.length>0)return o.pop();if(o.push(...await navigator.serial.getPorts()),o&&o.length>0)return o.pop();if(o.push(...await navigator.serial.requestPort({filters:c})),o&&o.length>0)return o.pop()}catch(e){throw"NotFoundError"==e.name?new l:"InvalidStateError"==e.name?new d:e}}async function w(e){try{await e.close()}catch(e){if("InvalidStateError"!=e.name&&"Failed to execute 'close' on 'SerialPort': The port is already closed."!=e.message)throw e}}class h{constructor(e){this.#e=`port-mutex-${Math.random().toString()}`,this.#t=new Map,this.#a=e}async acquire(e){const t=new Error("created bad cb").stack;await this.#r(async()=>{try{await e(this.#a)}catch(e){console.error("Error occured in anonymous callback."),console.error("Original error:",e),console.error("--- This callback was created at ---\n",t)}})}async acquireIdempotent(e,t){const a=new Error("created bad cb").stack;this.#t.has(e)&&console.info(`"${e}" request coalesced.`),this.#t.set(e,async()=>{try{await t(this.#a)}catch(e){console.error("Error occured in anonymous callback."),console.error("Original error:",e),console.error("--- This callback was created at ---\n",a)}}),await this.#r(()=>this.#i(e))}async#r(e){return navigator.locks.request(this.#e,e)}async#i(e){if(this.#t.has(e)){const t=this.#t.get(e);this.#t.delete(e),await t()}}#e;#t;#a}class p{constructor(e){this.#n=e}async rx(e,t=3e3){if(null===this.#n)throw new Error("attempted RX before port initialization.");if(this.#n.readable.locked)throw new Error("attempted RX while port locked.");const a=[],r=this.#n.readable.getReader(),i=setTimeout(()=>r.cancel(),t);try{for(;a.length<e;){const{value:e,done:t}=await r.read();if(a.push(...e??[]),t||!e)break}}finally{clearTimeout(i),r.releaseLock()}return a}async tx(e){if(null===this.#n)throw new Error("attempted TX before port initialization.");if(this.#n.writable.locked)throw new Error("attempted TX while port locked.");const t=this.#n.writable.getWriter();try{await t.write(new Uint8Array(e))}finally{await t.close()}}#n}const y=Object.freeze({ANIMATE:4,BRIGHTNESS:0,BOOTLOADER:2,DRAW:6,DRAW_GREY_COL_BUFFER:8,GAME_CTRL:17,GAME_STATUS:18,PANIC:5,PATTERN:1,SLEEP:3,STAGE_GREY_COL:7,START_GAME:16,VERSION:32});let _=class{constructor(e=null){this.portMutex=e}async bootloader(){await this.portMutex.acquire(async e=>{await e.tx([...r,y.BOOTLOADER])})}async draw(e){let t=0,a=new Uint8Array(39).fill(0);for(let r=0;r<34;r++)for(let i=0;i<9;i++)e[r][i]&&(a[t>>3]|=1<<t%8),t++;await this.portMutex.acquireIdempotent("drawMatrix",async e=>{await e.tx([...r,y.DRAW,...a])})}async drawGrayscale(e){const t=Array.from({length:9},(t,a)=>new Array({length:34},(t,r)=>GAMMA[Math.floor(255*(e[r][a]??0))]));await this.portMutex.acquireIdempotent("drawMatrix",async e=>{for(let a=0;a<9;a++)await e.tx([y.STAGE_GREY_COL,a,...t[a]]);await e.tx([y.DRAW_GREY_COL_BUFFER])})}async version(){let e={};return await this.portMutex.acquire(async t=>{await t.tx([...r,y.VERSION]);const a=await t.rx(32);e.major=a[0],e.minor=a[1]>>4,e.patch=15&a[1],e.preRelease=1==a[2]}),e}};class A extends _{async bootloader(){return super.bootloader()}async connect(){const e=await u();e?.connected&&(await w(e),await e.open({baudRate:115200}),this.portMutex=new h(new p(e)))}async draw(e){switch(this.#s){case BitDepth.GRAY_8BIT:super.drawGrayscale(e);break;case BitDepth.MONO_1BIT:super.draw(e)}}async verifyFirmware(){try{const e=await super.version();return e&&null!=e.major&&null!=e.minor&&null!=e.patch&&null!=e.preRelease}catch{return!1}}async version(){return super.version()}#s}const m=Object.freeze({NOOP:0,ANIMATION_DIAMOND:100,ANIMATION_FIRE:98,ANIMATION_FIREPLACE:102,ANIMATION_GEAR:103,ANIMATION_RING:114,ANIMATION_STARTUP:97,ANIMATION_STARTUP_ONCE:65,BOOTLOADER:101,DRAW_PWM:109,DRAW_PWM_BLOCKING:77,DRAW_SCALE:110,DRAW_SCALE_BLOCKING:78,FLUSH_CMD_QUEUE:99,TEST_PATTERN:116,SET_CONST_PWM:119,SET_CONST_SCALE:115,SET_PX_PWM:112,SET_PX_SCALE:113,IDENTITY_STRING:127}),E=/^Sig\sFW\sLED\sMatrix\sFW\sV(\d+)\.(\d+)$/;class f{constructor(e=null){this.portMutex=e}async bootloader(){await this.portMutex.acquire(async e=>{await e.tx([m.BOOTLOADER])})}async identityString(){let e=null;return await this.portMutex.acquire(async t=>{await t.tx([m.IDENTITY_STRING]),e=await t.rx(25)}),String.fromCharCode(...e)}async setPixelPwm(e,t,a){await this.portMutex.acquire(async r=>{await r.tx([m.SET_PX_PWM,t,e,a])})}async setGlobalPwm(e){await this.portMutex.acquire(async t=>{await t.tx([m.SET_CONST_PWM,e])})}async setMatrixPwm(e){await this.portMutex.acquireIdempotent("drawMatrix",async t=>{await t.tx([m.DRAW_PWM].concat(e.flat().map(e=>s[Math.floor(255*(e??0))])))})}async setPixelAnalog(e,t,a){await this.portMutex.acquire(async r=>{await r.tx([m.SET_PX_SCALE,t,e,a])})}async setGlobalAnalog(e){await this.portMutex.acquire(async t=>{await t.tx([m.SET_CONST_SCALE,e])})}async setMatrixAnalog(e){await this.portMutex.acquireIdempotent("drawMatrix",async t=>{await t.tx([m.DRAW_SCALE].concat(e.flat().map(e=>s[Math.floor(255*(e??0))])))})}}class T extends f{async bootloader(){await super.bootloader()}async connect(){const e=await u();e?.connected&&(await w(e),await e.open({baudRate:115200}),this.portMutex=new h(new p(e)))}async draw(e){this.#o||(await super.setGlobalAnalog(32),this.#o=!0),await super.setMatrixPwm(e)}async verifyFirmware(){return null!=await this.version()}async version(){const e=(await super.identityString()).match(E);return e&&3==e.length?{major:e[1],minor:e[2]}:null}#o}const g=[],b=[{vendorId:a,productId:32}];class x extends Error{constructor(){super("User cancelled device selection."),this.name=this.constructor.name,this.date=new Date}}class M{constructor(e){this.#c=e}async send(e,t){if(t.length<e.bytes)t=function(e,t,a=0){return e.concat(new Array(t-e.length).fill(a))}(t,e.bytes);else if(t.length>e.bytes)throw new Error("Unable to send report: too many bytes");const a=new Uint8Array(t).buffer;e.feature?await this.#c.sendFeatureReport(e.id,a):await this.#c.sendReport(e.id,a)}async request(e){let t=[];if(!e.feature)throw new Error("Invalid operation");if(t=await this.#c.receiveFeatureReport(e.id),t.byteLength!=e.bytes){const a=e.bytes,r=t.byteLength;console.error(`reply length=${r} (expected ${a})`)}return t}#c}const v={id:1,bytes:307,feature:!0},I={id:2,bytes:16,feature:!0},S={id:4,bytes:306,feature:!0},O=0,R=1,N=2,D=3,P=5,U=0;class G{constructor(e=null){this.device=e}async info(){const e=await this.device.request(v);return{sleep_pin:e.getUint8(1),dip1_pin:e.getUint8(2),intb_pin:e.getUint8(3),state_flags:e.getUint8(4),id_reg:e.getUint8(5),config_reg:e.getUint8(6),global_brightness:e.getUint8(7),display_width:e.getUint8(8),display_height:e.getUint8(9),timeout_ms:e.getUint32(10),version_major:e.getUint8(14),version_minor:e.getUint8(15)}}async wake(){await this.device.send(I,[R,!1])}async sleep(){await this.device.send(I,[R,!0])}async disableSleep(){await this.device.send(I,[D,255,255,255,255])}async disableDeepSleep(){await this.device.send(I,[N,1])}async disableSleepTimer(){await this.device.send(I,[D,0,0,0,0])}async enableDeepSleep(){await this.device.send(I,[N,0])}async enableSleepTimer(e){const t=new DataView(new ArrayBuffer(4));t.setInt32(0,e,!1),await this.device.send(I,[D,t.getUint8(0),t.getUint8(1),t.getUint8(2),t.getUint8(3)])}async reboot(e){await this.device.send(I,[O,e])}async drawMatrix(e){await this.device.send(S,e.flat().map(e=>s[Math.floor(255*(e??0))]))}async drawPixel(e,t,a){await this.device.send(I,[P,t,e,a])}async drawLine({r1:e,c1:t},{r2:a,c2:r},i){await this.device.send(I,[P,e,t,a,r,i])}device}class L extends G{async bootloader(){await super.reboot(U)}async connect(){const e=await async function(){if(g&&g.length>0)return g.pop();if(g.push(...await navigator.hid.getDevices()),g&&g.length>0)return g.pop();if(g.push(...await navigator.hid.requestDevice({filters:b})),g&&g.length>0)return g.pop();throw new x}();e&&(await e.open(),this.device=new M(e))}async draw(e){await super.drawMatrix(e)}async verifyFirmware(){try{const e=await super.info();return e.display_height==HEIGHT&&e.display_width==WIDTH}catch{return!1}}async version(){const e=await super.info();return null!=e.version_major&&null!=e.version_minor&&(e.version_major>0||e.version_minor>0)?{major:e.version_major,minor:e.version_minor}:{major:1,minor:0}}}class C{static async detectSerial(){const e=new A,t=new T;return await e.connect(),await e.verifyFirmware()?e:(await t.connect(),await t.verifyFirmware()?t:null)}static async detectHID(){const e=new L;return await e.connect(),await e.verifyFirmware()?e:null}}export{A as DefaultController,s as GAMMA,t as HEIGHT,C as HardwareControllerFactory,i as PID,n as PID_ARR,T as SigrootController,L as SparkleController,a as VID,r as VID_ARR,e as WIDTH};
 //# sourceMappingURL=led-matrix-controllers.browser.mjs.map

package/dist/led-matrix-controllers.browser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"led-matrix-controllers.browser.mjs","sources":["../src/hardware-constants.js","../src/usb-hid/environments/web/device.js","../src/usb-hid/environments/web/HIDOperations.js","../src/usb-hid/environments/web/util.js","../src/usb-hid/firmware/sparkle/reports.js","../src/usb-hid/firmware/sparkle/SparkleController.js","../src/usb-hid/HIDControllerFactory.js","../src/usb-serial/environments/web/PortMutex.js","../src/usb-serial/environments/web/PortOperations.js","../src/usb-serial/environments/web/port.js","../src/usb-serial/firmware/framework-official/commands.js","../src/usb-serial/firmware/framework-official/DefaultController.js","../src/usb-serial/firmware/sigroot/commands.js","../src/usb-serial/firmware/sigroot/SigrootController.js","../src/usb-serial/SerialControllerFactory.js"],"sourcesContent":["export const WIDTH = 9;\r\nexport const HEIGHT = 34;\r\nexport const VID = 0x32AC;\r\nexport const VID_ARR = [0x32, 0xAC];\r\nexport const PID = 0x0020;\r\nexport const PID_ARR = [0x00, 0x20];\r\n\r\nexport const GAMMA = Object.freeze([\r\n  0, 0, 0, 0, 0, 0, 0, 1, \r\n  1, 1, 1, 1, 1, 1, 1, 1, \r\n  1, 1, 1, 1, 1, 1, 1, 1, \r\n  1, 1, 1, 1, 1, 1, 1, 1, \r\n  1, 1, 1, 2, 2, 2, 2, 2, \r\n  2, 2, 2, 2, 3, 3, 3, 3, \r\n  3, 3, 3, 4, 4, 4, 4, 4, \r\n  4, 5, 5, 5, 5, 6, 6, 6, \r\n  6, 6, 7, 7, 7, 7, 8, 8, \r\n  8, 9, 9, 9, 10, 10, 10, 11, \r\n  11, 11, 12, 12, 12, 13, 13, 14, \r\n  14, 14, 15, 15, 16, 16, 17, 17, \r\n  17, 18, 18, 19, 19, 20, 20, 21, \r\n  22, 22, 23, 23, 24, 24, 25, 26, \r\n  26, 27, 27, 28, 29, 29, 30, 31, \r\n  32, 32, 33, 34, 34, 35, 36, 37, \r\n  38, 38, 39, 40, 41, 42, 42, 43, \r\n  44, 45, 46, 47, 48, 49, 50, 51, \r\n  52, 53, 54, 55, 56, 57, 58, 59, \r\n  60, 61, 62, 63, 64, 66, 67, 68, \r\n  69, 70, 71, 73, 74, 75, 76, 78, \r\n  79, 80, 82, 83, 84, 86, 87, 88, \r\n  90, 91, 93, 94, 96, 97, 99, 100, \r\n  102, 103, 105, 106, 108, 110, 111, 113, \r\n  115, 116, 118, 120, 121, 123, 125, 127, \r\n  128, 130, 132, 134, 136, 138, 140, 141, \r\n  143, 145, 147, 149, 151, 153, 155, 157, \r\n  159, 161, 164, 166, 168, 170, 172, 174, \r\n  177, 179, 181, 183, 186, 188, 190, 193, \r\n  195, 197, 200, 202, 205, 207, 210, 212, \r\n  215, 217, 220, 222, 225, 228, 230, 233, \r\n  236, 238, 241, 244, 247, 249, 252, 255\r\n]);\r\n","import { PID, VID } from '../../../hardware-constants.js';\r\n\r\nconst extraDevices = [];\r\n\r\nconst filters = [\r\n  {\r\n    vendorId: VID,\r\n    productId: PID,\r\n  }\r\n]\r\n\r\nexport class DeviceSelectionCancelled extends Error {\r\n  constructor() {\r\n    super('User cancelled device selection.');\r\n    this.name = this.constructor.name;\r\n    this.date = new Date();\r\n  }\r\n}\r\n\r\nexport async function getDevice() {\r\n  if (extraDevices && extraDevices.length > 0) {\r\n    return extraDevices.pop();\r\n  }\r\n\r\n  extraDevices.push(...(await navigator.hid.getDevices()));\r\n  if (extraDevices && extraDevices.length > 0) {\r\n    return extraDevices.pop();\r\n  }\r\n\r\n  extraDevices.push(...(await navigator.hid.requestDevice({ filters })));\r\n  if (extraDevices && extraDevices.length > 0) {\r\n    return extraDevices.pop();\r\n  }\r\n\r\n  throw new DeviceSelectionCancelled();\r\n}\r\n","import { pad } from './util.js';\r\n\r\nexport class HIDOperations {\r\n  constructor(device) {\r\n    this.#device = device;\r\n  }\r\n\r\n  async send(report, data) {\r\n    if (data.length < report.bytes) {\r\n      data = pad(data, report.bytes);\r\n    } else if (data.length > report.bytes) {\r\n      throw new Error('Unable to send report: too many bytes');\r\n    }\r\n\r\n    const buffer = new Uint8Array(data).buffer;\r\n\r\n    if (report.feature)  {\r\n      await this.#device.sendFeatureReport(report.id, buffer);\r\n    } else {\r\n      await this.#device.sendReport(report.buffer);\r\n    }\r\n  }\r\n\r\n  async receive(report) {\r\n    let reply = [];\r\n\r\n    if (report.feature) {\r\n      reply = await this.#device.receiveFeatureReport(report.id);\r\n    } else {\r\n      /* \r\n       * HID input reports are used for unprompted data.\r\n       * An event system must be used.\r\n       * See WebHID `HIDInputReportEvent`\r\n       */\r\n      throw new Error('Invalid operation');\r\n    }\r\n\r\n    if (reply.byteLength != report.bytes) {\r\n      console.error(`reply length=${reply.byteLength} (exp ${report.bytes})`);\r\n    }\r\n\r\n    return reply;\r\n  }\r\n\r\n  #device;\r\n}\r\n","export function pad(arr, len, val=0x00) {\r\n  return arr.concat(new Array(len - arr.length).fill(val));\r\n}\r\n","export const Reports = {\r\n  GLITTER_DEVICE_INFO: {\r\n    id: 0x01,\r\n    bytes: 307,\r\n    feature: true,\r\n  },\r\n  GLITTER_BASIC_CMD: {\r\n    id: 0x02,\r\n    bytes: 16,\r\n    feature: true,\r\n  },\r\n  GLITTER_GRID_PWM_CNTL: {\r\n    id: 0x03,\r\n    bytes: 306,\r\n    feature: true,\r\n  },\r\n  GLITTER_GRID_PWM_CNTL: {\r\n    id: 0x04,\r\n    bytes: 306,\r\n    feature: true,\r\n  }\r\n}\r\n\r\nexport const Commands = {\r\n  GLITTER_CMD_REBOOT: 0x00,\r\n  GLITTER_CMD_SLEEP: 0x01,\r\n  GLITTER_CMD_WAKE_ON_COMMAND: 0x02,\r\n  GLITTER_CMD_SET_SLEEP_TIMEOUT: 0x03,\r\n  GLITTER_CMD_SET_GLOBAL_BRIGHTNESS: 0x04,\r\n  GLITTER_CMD_DRAW_PIXEL: 0x05,\r\n  GLITTER_CMD_DRAW_LINE: 0x06\r\n}\r\n\r\nexport const BootMode = {\r\n  BOOTSEL: 0x00,\r\n  NORMAL: 0x01,\r\n}\r\n","import { GAMMA, HEIGHT, WIDTH } from '../../../hardware-constants.js';\r\nimport { BootMode, Commands, Reports } from './reports.js';\r\n\r\nexport { BootMode } from './reports.js';\r\n\r\nexport class SparkleController {\r\n  constructor(hidOps) {\r\n    this.#hidOps = hidOps;\r\n  }\r\n\r\n  async info() {\r\n    const infoRaw = await this.#hidOps.receive(Reports.GLITTER_DEVICE_INFO);\r\n\r\n    return {\r\n      sleep_pin: infoRaw.getUint8(1),\r\n      dip1_pin: infoRaw.getUint8(2),\r\n      intb_pin: infoRaw.getUint8(3),\r\n      state_flags: infoRaw.getUint8(4),\r\n      id_reg: infoRaw.getUint8(5),\r\n      config_reg: infoRaw.getUint8(6),\r\n      global_brightness: infoRaw.getUint8(7),\r\n      display_width: infoRaw.getUint8(8),\r\n      display_height: infoRaw.getUint8(9),\r\n      timeout_ms: infoRaw.getUint32(10),\r\n    };\r\n  }\r\n\r\n  async wake() {\r\n    await this.#hidOps.send(\r\n      Reports.GLITTER_BASIC_CMD,\r\n      [Commands.GLITTER_CMD_SLEEP, false]\r\n    );\r\n  }\r\n\r\n  async sleep() {\r\n    await this.#hidOps.send(\r\n      Reports.GLITTER_BASIC_CMD,\r\n      [Commands.GLITTER_CMD_SLEEP, true]\r\n    );\r\n  }\r\n\r\n  async disableSleep() {\r\n    await this.#hidOps.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [Commands.GLITTER_CMD_SET_SLEEP_TIMEOUT, 0xff, 0xff, 0xff, 0xff]\r\n    );\r\n  }\r\n\r\n  async disableDeepSleep() {\r\n    await this.#hidOps.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [Commands.GLITTER_CMD_WAKE_ON_COMMAND, 0x01]\r\n    );\r\n  }\r\n\r\n  async disableSleepTimer() {\r\n    await this.#hidOps.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [Commands.GLITTER_CMD_SET_SLEEP_TIMEOUT, 0x00, 0x00, 0x00, 0x00]\r\n    );\r\n  }\r\n  \r\n  async enableDeepSleep() {\r\n    await this.#hidOps.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [Commands.GLITTER_CMD_WAKE_ON_COMMAND, 0x00]\r\n    );\r\n  }\r\n\r\n  async enableSleepTimer(milliseconds) {\r\n    const view = new DataView(new ArrayBuffer(4));\r\n    const littleEndian = false;\r\n    view.setInt32(0, milliseconds, littleEndian);\r\n    await this.#hidOps.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [\r\n        Commands.GLITTER_CMD_SET_SLEEP_TIMEOUT, \r\n        view.getUint8(0), \r\n        view.getUint8(1), \r\n        view.getUint8(2), \r\n        view.getUint8(3),\r\n      ]\r\n    );\r\n  }\r\n\r\n  async reboot(mode) {\r\n    await this.#hidOps.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [Commands.GLITTER_CMD_REBOOT, mode]\r\n    );\r\n  }\r\n\r\n  async drawPixel(r, c, brightness) {\r\n    await this.#hidOps.send(\r\n      Reports.GLITTER_BASIC_CMD,\r\n      [Commands.GLITTER_CMD_DRAW_PIXEL, c, r, brightness]\r\n    );\r\n  }\r\n\r\n  async drawLine({r1, c1}, {r2, c2}, brightness) {\r\n    await this.#hidOps.send(\r\n      Reports.GLITTER_BASIC_CMD,\r\n      [Commands.GLITTER_CMD_DRAW_PIXEL, r1, c1, r2, c2, brightness]\r\n    );\r\n  }\r\n\r\n  // --- generic methods ---\r\n\r\n  async bootloader() {\r\n    await this.reboot(BootMode.BOOTSEL);\r\n  }\r\n  \r\n  async draw(matrix) {\r\n    await this.#hidOps.send(\r\n      Reports.GLITTER_GRID_PWM_CNTL,\r\n      matrix.flat().map(v => GAMMA[Math.floor((v ?? 0) * 255)])\r\n    );\r\n  }\r\n\r\n  async verifyFirmware() {\r\n    try {\r\n      const info = await this.info();\r\n      return (\r\n        info.display_height == HEIGHT &&\r\n        info.display_width == WIDTH\r\n      );\r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  async version() {\r\n    // Not Available\r\n    return { major: 1, minor: 0 };\r\n  }\r\n\r\n  #hidOps;\r\n}\r\n","import { getDevice } from './environments/web/device.js';\r\nimport { HIDOperations } from './environments/web/HIDOperations.js';\r\nimport { SparkleController } from './firmware/sparkle/SparkleController.js';\r\n\r\nexport class HIDControllerFactory {\r\n  static async make(firmware) {\r\n    const device = await getDevice();\r\n    if (device) {\r\n      if (firmware === 'sparkle') {\r\n        return await HIDControllerFactory.makeSparkleController(device);\r\n      } else if (firmware === 'detect') {\r\n        return await HIDControllerFactory.makeDetectedController(device);\r\n      } else {\r\n        throw new Error(`Unsupported firmware type: ${firmware}`);\r\n      }\r\n    }\r\n  }\r\n\r\n  static async makeSparkleController(device) {\r\n    if (device) {\r\n      await device.open();\r\n      return new SparkleController(\r\n        new HIDOperations(device)\r\n      );\r\n    }\r\n  }\r\n\r\n  static async makeDetectedController(device) {\r\n    const ctrl1 = await HIDControllerFactory.makeSparkleController(device);\r\n    if (ctrl1.verifyFirmware()) {\r\n      return ctrl1;\r\n    }\r\n  }\r\n}\r\n","export class PortMutex {\r\n  constructor(portOperations) {\r\n    this.#lockName = `port-mutex-${Math.random().toString()}`;\r\n    this.#deduper = new Map();\r\n    this.#portOps = portOperations;\r\n  }\r\n\r\n  async acquire(fn) {\r\n    const trace = new Error('created bad cb').stack;\r\n\r\n    await this.#enqueue(async () => {\r\n      try {\r\n        await fn(this.#portOps);\r\n      } catch (e) {\r\n        console.error('Error occured in anonymous callback.');\r\n        console.error('Original error:', e);\r\n        console.error('--- This callback was created at ---\\n', trace);\r\n      }\r\n    });\r\n  }\r\n\r\n  async acquireIdempotent(key, fn) {\r\n    const trace = new Error('created bad cb').stack;\r\n\r\n    if  (this.#deduper.has(key)) {\r\n      console.info(`\"${key}\" request coalesced.`);\r\n    }\r\n\r\n    this.#deduper.set(key, async () => {\r\n      try {\r\n        await fn(this.#portOps);\r\n      } catch (e) {\r\n        console.error('Error occured in anonymous callback.');\r\n        console.error('Original error:', e);\r\n        console.error('--- This callback was created at ---\\n', trace);\r\n      }\r\n    });\r\n\r\n    await this.#enqueue(() => this.#execDedupedOp(key));\r\n  }\r\n\r\n  async #enqueue(fn) {\r\n    // `navigator.locks` maintains queue and provides mutual exclusion.\r\n    return navigator.locks.request(this.#lockName, fn);\r\n  }\r\n\r\n  async #execDedupedOp(key) {\r\n    if (this.#deduper.has(key)) {\r\n      const fn = this.#deduper.get(key);\r\n      this.#deduper.delete(key);\r\n      await fn();\r\n    }\r\n  }\r\n\r\n  #lockName;\r\n  #deduper;\r\n  #portOps;\r\n}\r\n","export class PortOperations {\r\n  constructor(port) {\r\n    this.#port = port;\r\n  }\r\n\r\n  async rx(length, timeout=3000) {\r\n    if (this.#port === null) {\r\n      throw new Error('attempted RX before port initialization.');\r\n    }\r\n\r\n    /*\r\n     * ReadableStream's built-in locking mechanism cannot be awaited or otherwise\r\n     * asynchronously acquired. A PortMutex must be used.\r\n     */\r\n    if (this.#port.readable.locked) {\r\n      throw new Error('attempted RX while port locked.');\r\n    }\r\n\r\n    const response = [];\r\n    const reader = this.#port.readable.getReader();\r\n    const timeoutHandle = setTimeout(() => reader.cancel(), timeout);\r\n\r\n    try {\r\n      // Response may be divided across multiple reads\r\n      while (response.length < length) {\r\n        const { value, done } = await reader.read();\r\n        response.push(...(value ?? []));\r\n        if (done || !value) break;\r\n      }\r\n    } finally {\r\n      clearTimeout(timeoutHandle);\r\n      reader.releaseLock();\r\n    }\r\n\r\n    return response;\r\n  }\r\n\r\n  async tx(buffer) {\r\n    if (this.#port === null) {\r\n      throw new Error('attempted TX before port initialization.');\r\n    }\r\n    \r\n    /*\r\n     * WritableStream's built-in locking mechanism cannot be awaited or otherwise\r\n     * asynchronously acquired. A PortMutex must be used.\r\n     */\r\n    if (this.#port.writable.locked) {\r\n      throw new Error('attempted TX while port locked.');\r\n    }\r\n\r\n    const writer = this.#port.writable.getWriter();\r\n\r\n    try {\r\n      await writer.write(new Uint8Array(buffer));\r\n    } finally {\r\n      /* \r\n       * The writer must be completely torn down between every single write.\r\n       * Many parsers can't handle delayed flushing and write coalescing.\r\n       * Command sequences will fail if `releaseLock()` is used here.\r\n       */\r\n      await writer.close();\r\n    }\r\n  }\r\n\r\n  #port;\r\n}\r\n","export class PortSelectionCancelled extends Error {\r\n  constructor() {\r\n    super('User cancelled port selection.');\r\n    this.name = this.constructor.name;\r\n    this.date = new Date();\r\n  }\r\n}\r\n\r\nexport class PortUnavailable extends Error {\r\n  constructor() {\r\n    super('Selected port already in use.');\r\n    this.name = this.constructor.name;\r\n    this.date = new Date();\r\n  }\r\n}\r\n\r\nexport async function getPort() {\r\n  try {\r\n    const port = await navigator.serial.requestPort();\r\n    const { usbProductId, usbVendorId } = port;\r\n    console.log('Selected port:', port);\r\n    if (usbProductId && usbVendorId) {\r\n      console.log(`VID:PID ${usbVendorId}:${usbProductId}`);\r\n    }\r\n    return port;\r\n  } catch (e) {\r\n    if (e.name == 'NotFoundError') {\r\n      throw new PortSelectionCancelled();\r\n    } else if (e.name == 'InvalidStateError') {\r\n      throw new PortUnavailable();\r\n    } else {\r\n      throw e;\r\n    }\r\n  }\r\n}\r\n\r\nexport async function close(port) {\r\n  try {\r\n    await port.close();\r\n  } catch(e) {\r\n    if (e.name != 'InvalidStateError') {\r\n      if (e.message != \"Failed to execute 'close' on 'SerialPort': The port is already closed.\") {\r\n        throw e;\r\n      }\r\n    }\r\n  }\r\n}\r\n","// All replies to all commands are 32 bytes\r\nexport const RX_PACKET_SZ = 32;\r\n\r\nexport const Command = Object.freeze({\r\n  ANIMATE: 0x04,\r\n  BRIGHTNESS: 0x00,\r\n  BOOTLOADER: 0x02,\r\n  DRAW: 0x06,\r\n  DRAW_GREY_COL_BUFFER: 0x08,\r\n  GAME_CTRL: 0x11,\r\n  GAME_STATUS: 0x12,\r\n  PANIC: 0x05,\r\n  PATTERN: 0x01,\r\n  SLEEP: 0x03,\r\n  STAGE_GREY_COL: 0x07,\r\n  START_GAME: 0x10,\r\n  VERSION: 0x20,\r\n});\r\n\r\n// Used with Command.PATTERN\r\nexport const Pattern = Object.freeze({\r\n  DISPLAY_LOTUS_HORIZONTAL: 0x03,\r\n  DISPLAY_LOTUS_VERTICAL: 0x07,\r\n  DISPLAY_PANIC: 0x06,\r\n  DOUBLE_GRADIENT: 0x02,\r\n  FULL_BRIGHTNESS: 0x05,\r\n  GRADIENT: 0x01,\r\n  PERCENTAGE: 0x00,\r\n  ZIG_ZAG: 0x04,\r\n});\r\n\r\n// DRAW or DRAW_GREY_COL_BUFFER\r\nexport const BitDepth = Object.freeze({\r\n  GRAY_8BIT: '8-bit',\r\n  MONO_1BIT: '1-bit',\r\n})\r\n","import { HEIGHT, VID_ARR, WIDTH } from '../../../hardware-constants.js';\r\nimport { BitDepth, Command, RX_PACKET_SZ } from './commands.js';\r\n\r\nexport class DefaultController {\r\n  constructor(portMutex) {\r\n    this.#bitDepth = BitDepth.MONO_1BIT;\r\n    this.#portMutex = portMutex;\r\n  }\r\n\r\n  async bootloader() {\r\n    await this.#portMutex.acquire(async p => {\r\n      await p.tx([...VID_ARR, Command.BOOTLOADER]);\r\n    });\r\n  }\r\n\r\n  async draw(matrix) {\r\n    if (this.#bitDepth == BitDepth.GRAY_8BIT) {\r\n      // Transpose & Gamma Correction\r\n      const payloads = Array.from(\r\n        { length: WIDTH }, \r\n        (_, c) => new Array(\r\n          { length: HEIGHT }, \r\n          (_, r) => GAMMA[Math.floor((matrix[r][c] ?? 0) * 255)]\r\n        )\r\n      );\r\n\r\n      // Only execute the most recent call \r\n      await this.#portMutex.acquireIdempotent(\r\n        'drawMatrix', \r\n        async p => {\r\n          for (let i = 0; i < WIDTH; i++) {\r\n            await p.tx([Command.STAGE_GREY_COL, i, ...payloads[i]]);\r\n          }\r\n          await p.tx([Command.DRAW_GREY_COL_BUFFER]);\r\n        }\r\n      );\r\n    }\r\n\r\n    else if (this.#bitDepth == BitDepth.MONO_1BIT) {\r\n      let index = 0;\r\n      let output = new Uint8Array(39).fill(0);\r\n\r\n      // Pack cells into bits\r\n      for (let r = 0; r < HEIGHT; r++) {\r\n        for (let c = 0; c < WIDTH; c++) {\r\n          if (matrix[r][c]) {\r\n            output[index >> 3] |= 1 << index % 8;\r\n          }\r\n          index++;\r\n        }\r\n      }\r\n\r\n      await this.#portMutex.acquireIdempotent(\r\n        'drawMatrix', \r\n        async p => {\r\n          await p.tx([...VID_ARR, Command.DRAW, ...output]);\r\n        }\r\n      );\r\n    }\r\n  }\r\n\r\n  async verifyFirmware() {\r\n    let packet = null;\r\n\r\n    await this.#portMutex.acquire(async p => {\r\n      await p.tx([...VID_ARR, Command.VERSION]);\r\n      packet = await p.rx(RX_PACKET_SZ);\r\n    });\r\n\r\n    const isPacket = packet.length == RX_PACKET_SZ;\r\n    const isPadded = packet.slice(3).every(e => e == 0x00);\r\n\r\n    return isPacket && isPadded;\r\n  }\r\n\r\n  async version() {\r\n    let ver = {};\r\n\r\n    await this.#portMutex.acquire(async p => {\r\n      await p.tx([...VID_ARR, Command.VERSION]);\r\n      const response = await p.rx(RX_PACKET_SZ);\r\n\r\n      // MMMMMMMM mmmmPPPP 0000000p\r\n      ver.major = response[0];\r\n      ver.minor = response[1] >> 4;\r\n      ver.patch = response[1] & 0x0F;\r\n      ver.preRelease = response[2] == 1;\r\n    });\r\n\r\n    return ver;\r\n  }\r\n\r\n  #bitDepth;\r\n  #portMutex;\r\n}\r\n","export const Command = Object.freeze({\r\n  /* 000 */ NOOP: 0x00,\r\n  /* 'd' */ ANIMATION_DIAMOND: 0x64,\r\n  /* 'b' */ ANIMATION_FIRE: 0x62,\r\n  /* 'f' */ ANIMATION_FIREPLACE: 0x66,\r\n  /* 'g' */ ANIMATION_GEAR: 0x67,\r\n  /* 'r' */ ANIMATION_RING: 0x72,\r\n  /* 'a' */ ANIMATION_STARTUP: 0x61,\r\n  /* 'A' */ ANIMATION_STARTUP_ONCE: 0x41,\r\n  /* 'e' */ BOOTLOADER: 0x65,\r\n  /* 'm' */ DRAW_PWM: 0x6D,\r\n  /* 'M' */ DRAW_PWM_BLOCKING: 0x4D,\r\n  /* 'n' */ DRAW_SCALE: 0x6E,\r\n  /* 'N' */ DRAW_SCALE_BLOCKING: 0x4E,\r\n  /* 'c' */ FLUSH_CMD_QUEUE: 0x63,\r\n  /* 't' */ TEST_PATTERN: 0x74,\r\n  /* 'w' */ SET_CONST_PWM: 0x77,\r\n  /* 's' */ SET_CONST_SCALE: 0x73,\r\n  /* 'p' */ SET_PX_PWM: 0x70,\r\n  /* 'q' */ SET_PX_SCALE: 0x71,\r\n  /* 127 */ IDENT: 0x7F,\r\n});\r\n\r\nexport const IDENT_STR_LEN = 25;\r\n\r\nexport const IDENT_STR_REGEX = /^Sig\\sFW\\sLED\\sMatrix\\sFW\\sV(\\d+)\\.(\\d+)$/;\r\n\r\nexport const IDENT_STR_PREFIX = 'Sig FW LED Matrix FW';\r\n","import { GAMMA } from '../../../hardware-constants.js';\r\nimport { Command, IDENT_STR_LEN, IDENT_STR_REGEX } from './commands.js';\r\n\r\nexport class SigrootController {\r\n  constructor(portMutex) {\r\n    this.#portMutex = portMutex;\r\n  }\r\n\r\n  async bootloader() {\r\n    await this.#portMutex.acquire(async p => {\r\n      await p.tx([Command.BOOTLOADER]);\r\n    });\r\n  }\r\n\r\n  async draw(matrix) {\r\n    if (!this.#scaleInitialized) {\r\n      await this.#portMutex.acquire(\r\n        async p => {\r\n          await p.tx([Command.SET_CONST_SCALE, 0x20]);\r\n        }\r\n      );\r\n      this.#scaleInitialized = true;\r\n    }\r\n\r\n    const bytes = matrix.flat().map(v => \r\n      GAMMA[Math.floor((v ?? 0) * 255)]\r\n    );\r\n\r\n    // Only execute the most recent call \r\n    await this.#portMutex.acquireIdempotent(\r\n      'drawMatrix', \r\n      async p => {\r\n        await p.tx([Command.DRAW_PWM, ...bytes]);\r\n      }\r\n    );\r\n  }\r\n\r\n  async verifyFirmware() {\r\n    let ident = null;\r\n\r\n    await this.#portMutex.acquire(async p => {\r\n      await p.tx([Command.IDENT]);\r\n      ident = await p.rx(IDENT_STR_LEN);\r\n    });\r\n\r\n    ident = String.fromCharCode(...ident);\r\n\r\n    return ident.match(IDENT_STR_REGEX);\r\n  }\r\n\r\n  async version() {\r\n    let ident = null;\r\n\r\n    await this.#portMutex.acquire(async p => {\r\n      await p.tx([Command.IDENT]);\r\n      ident = await p.rx(IDENT_STR_LEN);\r\n    });\r\n\r\n    ident = String.fromCharCode(...ident);\r\n\r\n    const match = ident.match(IDENT_STR_REGEX);\r\n\r\n    if (match && match.length == 3) {\r\n      return {\r\n        major: match[1],\r\n        minor: match[2]\r\n      }\r\n    } else {\r\n      return null;\r\n    }\r\n  }\r\n\r\n  #portMutex;\r\n  #scaleInitialized;\r\n}\r\n","import { PortMutex } from './environments/web/PortMutex.js';\r\nimport { PortOperations } from './environments/web/PortOperations.js';\r\nimport { close, getPort } from './environments/web/port.js';\r\nimport { DefaultController } from './firmware/framework-official/DefaultController.js';\r\nimport { SigrootController } from './firmware/sigroot/SigrootController.js';\r\n\r\nexport class SerialControllerFactory {\r\n  static async make(firmware) {\r\n    const port = await getPort();\r\n    if (port) {\r\n      if (firmware === 'framework-official') {\r\n        return await SerialControllerFactory.makeDefaultController(port);\r\n      } else if (firmware === 'sigroot') {\r\n        return await SerialControllerFactory.makeSigrootController(port);\r\n      } else if (firmware === 'detect') {\r\n        return await SerialControllerFactory.makeDetectedController(port);\r\n      } else {\r\n        throw new Error(`Unsupported firmware type: ${firmware}`);\r\n      }\r\n    }\r\n  }\r\n\r\n  static async makeDefaultController(port) {\r\n    if (port?.connected) {\r\n      await close(port);\r\n      await port.open({ baudRate: 115200 });\r\n      return new DefaultController(\r\n        new PortMutex(\r\n          new PortOperations(port)\r\n        )\r\n      );\r\n    }\r\n  }\r\n\r\n  static async makeSigrootController(port) {\r\n    if (port?.connected) {\r\n      await close(port);\r\n      await port.open({ baudRate: 115200 });\r\n      return new SigrootController(\r\n        new PortMutex(\r\n          new PortOperations(port)\r\n        )\r\n      );\r\n    }\r\n  }\r\n\r\n  static async makeDetectedController(port) {\r\n    const ctrl1 = await this.makeDefaultController(port);\r\n    if (await ctrl1.verifyFirmware()) {\r\n      return ctrl1;\r\n    }\r\n    const ctrl2 = await this.makeSigrootController(port);\r\n    if (await ctrl2.verifyFirmware()) {\r\n      return ctrl2;\r\n    }\r\n  }\r\n}\r\n"],"names":["WIDTH","HEIGHT","VID","VID_ARR","PID","PID_ARR","GAMMA","Object","freeze","extraDevices","filters","vendorId","productId","DeviceSelectionCancelled","Error","constructor","super","this","name","date","Date","HIDOperations","device","send","report","data","length","bytes","arr","len","val","concat","Array","fill","pad","buffer","Uint8Array","feature","sendFeatureReport","id","sendReport","receive","reply","receiveFeatureReport","byteLength","console","error","Reports","Commands","BootMode","SparkleController","hidOps","info","infoRaw","sleep_pin","getUint8","dip1_pin","intb_pin","state_flags","id_reg","config_reg","global_brightness","display_width","display_height","timeout_ms","getUint32","wake","sleep","disableSleep","disableDeepSleep","disableSleepTimer","enableDeepSleep","enableSleepTimer","milliseconds","view","DataView","ArrayBuffer","setInt32","reboot","mode","drawPixel","r","c","brightness","drawLine","r1","c1","r2","c2","bootloader","draw","matrix","flat","map","v","Math","floor","verifyFirmware","version","major","minor","HIDControllerFactory","make","firmware","async","pop","push","navigator","hid","getDevices","requestDevice","getDevice","makeSparkleController","makeDetectedController","open","ctrl1","PortMutex","portOperations","lockName","random","toString","deduper","Map","portOps","acquire","fn","trace","stack","enqueue","e","acquireIdempotent","key","has","set","execDedupedOp","locks","request","get","delete","PortOperations","port","rx","timeout","readable","locked","response","reader","getReader","timeoutHandle","setTimeout","cancel","value","done","read","clearTimeout","releaseLock","tx","writable","writer","getWriter","write","close","PortSelectionCancelled","PortUnavailable","message","Command","ANIMATE","BRIGHTNESS","BOOTLOADER","DRAW","DRAW_GREY_COL_BUFFER","GAME_CTRL","GAME_STATUS","PANIC","PATTERN","SLEEP","STAGE_GREY_COL","START_GAME","VERSION","BitDepth","GRAY_8BIT","MONO_1BIT","DefaultController","portMutex","bitDepth","p","payloads","from","_","i","index","output","packet","isPacket","isPadded","slice","every","ver","patch","preRelease","NOOP","ANIMATION_DIAMOND","ANIMATION_FIRE","ANIMATION_FIREPLACE","ANIMATION_GEAR","ANIMATION_RING","ANIMATION_STARTUP","ANIMATION_STARTUP_ONCE","DRAW_PWM","DRAW_PWM_BLOCKING","DRAW_SCALE","DRAW_SCALE_BLOCKING","FLUSH_CMD_QUEUE","TEST_PATTERN","SET_CONST_PWM","SET_CONST_SCALE","SET_PX_PWM","SET_PX_SCALE","IDENT","IDENT_STR_REGEX","SigrootController","scaleInitialized","ident","String","fromCharCode","match","SerialControllerFactory","serial","requestPort","usbProductId","usbVendorId","log","getPort","makeDefaultController","makeSigrootController","connected","baudRate","ctrl2"],"mappings":"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"}
+{"version":3,"file":"led-matrix-controllers.browser.mjs","sources":["../src/hardware-constants.js","../src/web-serial/port.js","../src/web-serial/PortMutex.js","../src/web-serial/PortOperations.js","../src/supported-firmware/FrameworkComputer/inputmodule-rs/commands.js","../src/supported-firmware/FrameworkComputer/inputmodule-rs/CommandAbstractionLayer.js","../src/supported-firmware/FrameworkComputer/inputmodule-rs/DefaultController.js","../src/supported-firmware/sigroot/FW_LED_Matrix_Firmware/commands.js","../src/supported-firmware/sigroot/FW_LED_Matrix_Firmware/CommandAbstractionLayer.js","../src/supported-firmware/sigroot/FW_LED_Matrix_Firmware/SigrootController.js","../src/web-hid/device.js","../src/web-hid/HIDOperations.js","../src/web-hid/util.js","../src/supported-firmware/vddCore/sparkle-fw16/reports.js","../src/supported-firmware/vddCore/sparkle-fw16/ReportAbstractionLayer.js","../src/supported-firmware/vddCore/sparkle-fw16/SparkleController.js","../src/HardwareControllerFactory.js"],"sourcesContent":["export const WIDTH = 9;\r\nexport const HEIGHT = 34;\r\nexport const VID = 0x32AC;\r\nexport const VID_ARR = [0x32, 0xAC];\r\nexport const PID = 0x0020;\r\nexport const PID_ARR = [0x00, 0x20];\r\n\r\nexport const GAMMA = Object.freeze([\r\n  0, 0, 0, 0, 0, 0, 0, 1, \r\n  1, 1, 1, 1, 1, 1, 1, 1, \r\n  1, 1, 1, 1, 1, 1, 1, 1, \r\n  1, 1, 1, 1, 1, 1, 1, 1, \r\n  1, 1, 1, 2, 2, 2, 2, 2, \r\n  2, 2, 2, 2, 3, 3, 3, 3, \r\n  3, 3, 3, 4, 4, 4, 4, 4, \r\n  4, 5, 5, 5, 5, 6, 6, 6, \r\n  6, 6, 7, 7, 7, 7, 8, 8, \r\n  8, 9, 9, 9, 10, 10, 10, 11, \r\n  11, 11, 12, 12, 12, 13, 13, 14, \r\n  14, 14, 15, 15, 16, 16, 17, 17, \r\n  17, 18, 18, 19, 19, 20, 20, 21, \r\n  22, 22, 23, 23, 24, 24, 25, 26, \r\n  26, 27, 27, 28, 29, 29, 30, 31, \r\n  32, 32, 33, 34, 34, 35, 36, 37, \r\n  38, 38, 39, 40, 41, 42, 42, 43, \r\n  44, 45, 46, 47, 48, 49, 50, 51, \r\n  52, 53, 54, 55, 56, 57, 58, 59, \r\n  60, 61, 62, 63, 64, 66, 67, 68, \r\n  69, 70, 71, 73, 74, 75, 76, 78, \r\n  79, 80, 82, 83, 84, 86, 87, 88, \r\n  90, 91, 93, 94, 96, 97, 99, 100, \r\n  102, 103, 105, 106, 108, 110, 111, 113, \r\n  115, 116, 118, 120, 121, 123, 125, 127, \r\n  128, 130, 132, 134, 136, 138, 140, 141, \r\n  143, 145, 147, 149, 151, 153, 155, 157, \r\n  159, 161, 164, 166, 168, 170, 172, 174, \r\n  177, 179, 181, 183, 186, 188, 190, 193, \r\n  195, 197, 200, 202, 205, 207, 210, 212, \r\n  215, 217, 220, 222, 225, 228, 230, 233, \r\n  236, 238, 241, 244, 247, 249, 252, 255\r\n]);\r\n","import { PID, VID } from '../hardware-constants.js';\r\n\r\nconst extraPorts = [];\r\n\r\nconst filters = [\r\n  {\r\n    usbVendorId: VID,\r\n    usbProductId: PID,\r\n  }\r\n];\r\n\r\nexport class PortSelectionCancelled extends Error {\r\n  constructor() {\r\n    super('User cancelled port selection.');\r\n    this.name = this.constructor.name;\r\n    this.date = new Date();\r\n  }\r\n}\r\n\r\nexport class PortUnavailable extends Error {\r\n  constructor() {\r\n    super('Selected port already in use.');\r\n    this.name = this.constructor.name;\r\n    this.date = new Date();\r\n  }\r\n}\r\n\r\nexport async function getPort() {\r\n  try {\r\n    if (extraPorts && extraPorts.length > 0) {\r\n      return extraPorts.pop();\r\n    }\r\n\r\n    extraPorts.push(...await navigator.serial.getPorts());\r\n    if (extraPorts && extraPorts.length > 0) {\r\n      return extraPorts.pop();\r\n    }\r\n\r\n    extraPorts.push(...await navigator.serial.requestPort({ filters }));\r\n    if (extraPorts && extraPorts.length > 0) {\r\n      return extraPorts.pop();\r\n    }\r\n\r\n  } catch (e) {\r\n    if (e.name == 'NotFoundError') {\r\n      throw new PortSelectionCancelled();\r\n    } else if (e.name == 'InvalidStateError') {\r\n      throw new PortUnavailable();\r\n    } else {\r\n      throw e;\r\n    }\r\n  }\r\n}\r\n\r\nexport async function close(port) {\r\n  try {\r\n    await port.close();\r\n  } catch(e) {\r\n    if (e.name != 'InvalidStateError') {\r\n      if (e.message != \"Failed to execute 'close' on 'SerialPort': The port is already closed.\") {\r\n        throw e;\r\n      }\r\n    }\r\n  }\r\n}\r\n","export class PortMutex {\r\n  constructor(portOperations) {\r\n    this.#lockName = `port-mutex-${Math.random().toString()}`;\r\n    this.#deduper = new Map();\r\n    this.#portOps = portOperations;\r\n  }\r\n\r\n  async acquire(fn) {\r\n    const trace = new Error('created bad cb').stack;\r\n\r\n    await this.#enqueue(async () => {\r\n      try {\r\n        await fn(this.#portOps);\r\n      } catch (e) {\r\n        console.error('Error occured in anonymous callback.');\r\n        console.error('Original error:', e);\r\n        console.error('--- This callback was created at ---\\n', trace);\r\n      }\r\n    });\r\n  }\r\n\r\n  async acquireIdempotent(key, fn) {\r\n    const trace = new Error('created bad cb').stack;\r\n\r\n    if  (this.#deduper.has(key)) {\r\n      console.info(`\"${key}\" request coalesced.`);\r\n    }\r\n\r\n    this.#deduper.set(key, async () => {\r\n      try {\r\n        await fn(this.#portOps);\r\n      } catch (e) {\r\n        console.error('Error occured in anonymous callback.');\r\n        console.error('Original error:', e);\r\n        console.error('--- This callback was created at ---\\n', trace);\r\n      }\r\n    });\r\n\r\n    await this.#enqueue(() => this.#execDedupedOp(key));\r\n  }\r\n\r\n  async #enqueue(fn) {\r\n    // `navigator.locks` maintains queue and provides mutual exclusion.\r\n    return navigator.locks.request(this.#lockName, fn);\r\n  }\r\n\r\n  async #execDedupedOp(key) {\r\n    if (this.#deduper.has(key)) {\r\n      const fn = this.#deduper.get(key);\r\n      this.#deduper.delete(key);\r\n      await fn();\r\n    }\r\n  }\r\n\r\n  #lockName;\r\n  #deduper;\r\n  #portOps;\r\n}\r\n","export class PortOperations {\r\n  constructor(port) {\r\n    this.#port = port;\r\n  }\r\n\r\n  async rx(length, timeout=3000) {\r\n    if (this.#port === null) {\r\n      throw new Error('attempted RX before port initialization.');\r\n    }\r\n\r\n    /*\r\n     * ReadableStream's built-in locking mechanism cannot be awaited or otherwise\r\n     * asynchronously acquired. A PortMutex must be used.\r\n     */\r\n    if (this.#port.readable.locked) {\r\n      throw new Error('attempted RX while port locked.');\r\n    }\r\n\r\n    const response = [];\r\n    const reader = this.#port.readable.getReader();\r\n    const timeoutHandle = setTimeout(() => reader.cancel(), timeout);\r\n\r\n    try {\r\n      // Response may be divided across multiple reads\r\n      while (response.length < length) {\r\n        const { value, done } = await reader.read();\r\n        response.push(...(value ?? []));\r\n        if (done || !value) break;\r\n      }\r\n    } finally {\r\n      clearTimeout(timeoutHandle);\r\n      reader.releaseLock();\r\n    }\r\n\r\n    return response;\r\n  }\r\n\r\n  async tx(buffer) {\r\n    if (this.#port === null) {\r\n      throw new Error('attempted TX before port initialization.');\r\n    }\r\n    \r\n    /*\r\n     * WritableStream's built-in locking mechanism cannot be awaited or otherwise\r\n     * asynchronously acquired. A PortMutex must be used.\r\n     */\r\n    if (this.#port.writable.locked) {\r\n      throw new Error('attempted TX while port locked.');\r\n    }\r\n\r\n    const writer = this.#port.writable.getWriter();\r\n\r\n    try {\r\n      await writer.write(new Uint8Array(buffer));\r\n    } finally {\r\n      /* \r\n       * The writer must be completely torn down between every single write.\r\n       * Many parsers can't handle delayed flushing and write coalescing.\r\n       * Command sequences will fail if `releaseLock()` is used here.\r\n       */\r\n      await writer.close();\r\n    }\r\n  }\r\n\r\n  #port;\r\n}\r\n","// All replies to all commands are 32 bytes\r\nexport const RX_PACKET_SZ = 32;\r\n\r\nexport const Command = Object.freeze({\r\n  ANIMATE: 0x04,\r\n  BRIGHTNESS: 0x00,\r\n  BOOTLOADER: 0x02,\r\n  DRAW: 0x06,\r\n  DRAW_GREY_COL_BUFFER: 0x08,\r\n  GAME_CTRL: 0x11,\r\n  GAME_STATUS: 0x12,\r\n  PANIC: 0x05,\r\n  PATTERN: 0x01,\r\n  SLEEP: 0x03,\r\n  STAGE_GREY_COL: 0x07,\r\n  START_GAME: 0x10,\r\n  VERSION: 0x20,\r\n});\r\n\r\n// Used with Command.PATTERN\r\nexport const Pattern = Object.freeze({\r\n  DISPLAY_LOTUS_HORIZONTAL: 0x03,\r\n  DISPLAY_LOTUS_VERTICAL: 0x07,\r\n  DISPLAY_PANIC: 0x06,\r\n  DOUBLE_GRADIENT: 0x02,\r\n  FULL_BRIGHTNESS: 0x05,\r\n  GRADIENT: 0x01,\r\n  PERCENTAGE: 0x00,\r\n  ZIG_ZAG: 0x04,\r\n});\r\n\r\n// DRAW or DRAW_GREY_COL_BUFFER\r\nexport const BitDepth = Object.freeze({\r\n  GRAY_8BIT: '8-bit',\r\n  MONO_1BIT: '1-bit',\r\n})\r\n","import { HEIGHT, VID_ARR, WIDTH } from '../../../hardware-constants.js';\r\nimport { Command, RX_PACKET_SZ } from './commands.js';\r\n\r\nexport class CommandAbstractionLayer {\r\n  constructor(portMutex = null) {\r\n    this.portMutex = portMutex;\r\n  }\r\n\r\n  async bootloader() {\r\n    await this.portMutex.acquire(async p => {\r\n      await p.tx([...VID_ARR, Command.BOOTLOADER]);\r\n    });\r\n  }\r\n\r\n  async draw(matrix) {\r\n    let index = 0;\r\n    let output = new Uint8Array(39).fill(0);\r\n\r\n    // Pack cells into bits\r\n    for (let r = 0; r < HEIGHT; r++) {\r\n      for (let c = 0; c < WIDTH; c++) {\r\n        if (matrix[r][c]) {\r\n          output[index >> 3] |= 1 << index % 8;\r\n        }\r\n        index++;\r\n      }\r\n    }\r\n\r\n    await this.portMutex.acquireIdempotent(\r\n      'drawMatrix', \r\n      async p => {\r\n        await p.tx([...VID_ARR, Command.DRAW, ...output]);\r\n      }\r\n    );\r\n  }\r\n\r\n  async drawGrayscale(matrix) {\r\n    // Transpose & Gamma Correction\r\n    const buffers = Array.from(\r\n      { length: WIDTH }, \r\n      (_, c) => new Array(\r\n        { length: HEIGHT }, \r\n        (_, r) => GAMMA[Math.floor((matrix[r][c] ?? 0) * 255)]\r\n      )\r\n    );\r\n\r\n    // Only execute the most recent call \r\n    await this.portMutex.acquireIdempotent(\r\n      'drawMatrix', \r\n      async p => {\r\n        for (let i = 0; i < WIDTH; i++) {\r\n          await p.tx([Command.STAGE_GREY_COL, i, ...buffers[i]]);\r\n        }\r\n        await p.tx([Command.DRAW_GREY_COL_BUFFER]);\r\n      }\r\n    );\r\n  }\r\n\r\n  async version() {\r\n    let ver = {};\r\n\r\n    await this.portMutex.acquire(async p => {\r\n      await p.tx([...VID_ARR, Command.VERSION]);\r\n      const response = await p.rx(RX_PACKET_SZ);\r\n\r\n      // MMMMMMMM mmmmPPPP 0000000p\r\n      ver.major = response[0];\r\n      ver.minor = response[1] >> 4;\r\n      ver.patch = response[1] & 0x0F;\r\n      ver.preRelease = response[2] == 1;\r\n    });\r\n\r\n    return ver;\r\n  }\r\n}\r\n","import { close, getPort } from '../../../web-serial/port.js';\r\nimport { PortMutex } from '../../../web-serial/PortMutex.js';\r\nimport { PortOperations } from '../../../web-serial/PortOperations.js';\r\nimport { CommandAbstractionLayer } from './CommandAbstractionLayer.js';\r\n\r\nexport class DefaultController extends CommandAbstractionLayer {\r\n  async bootloader() {\r\n    return super.bootloader();\r\n  }\r\n\r\n  async connect() {\r\n    const port = await getPort();\r\n\r\n    if (port?.connected) {\r\n      await close(port);\r\n      await port.open({ baudRate: 115200 });\r\n      this.portMutex = new PortMutex(new PortOperations(port));\r\n    }\r\n  }\r\n\r\n  async draw(matrix) {\r\n    switch (this.#bitDepth) {\r\n\r\n      case BitDepth.GRAY_8BIT:\r\n        super.drawGrayscale(matrix);\r\n        break;\r\n\r\n      case BitDepth.MONO_1BIT:\r\n        super.draw(matrix);\r\n        break;\r\n    }\r\n  }\r\n\r\n  async verifyFirmware() {\r\n    try {\r\n      const version = await super.version();\r\n\r\n      return version\r\n        && version.major != undefined\r\n        && version.minor != undefined\r\n        && version.patch != undefined\r\n        && version.preRelease != undefined;\r\n        \r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  async version() {\r\n    return super.version();\r\n  }\r\n\r\n  #bitDepth;\r\n}\r\n","export const Command = Object.freeze({\r\n  /* 000 */ NOOP: 0x00,\r\n  /* 'd' */ ANIMATION_DIAMOND: 0x64,\r\n  /* 'b' */ ANIMATION_FIRE: 0x62,\r\n  /* 'f' */ ANIMATION_FIREPLACE: 0x66,\r\n  /* 'g' */ ANIMATION_GEAR: 0x67,\r\n  /* 'r' */ ANIMATION_RING: 0x72,\r\n  /* 'a' */ ANIMATION_STARTUP: 0x61,\r\n  /* 'A' */ ANIMATION_STARTUP_ONCE: 0x41,\r\n  /* 'e' */ BOOTLOADER: 0x65,\r\n  /* 'm' */ DRAW_PWM: 0x6D,\r\n  /* 'M' */ DRAW_PWM_BLOCKING: 0x4D,\r\n  /* 'n' */ DRAW_SCALE: 0x6E,\r\n  /* 'N' */ DRAW_SCALE_BLOCKING: 0x4E,\r\n  /* 'c' */ FLUSH_CMD_QUEUE: 0x63,\r\n  /* 't' */ TEST_PATTERN: 0x74,\r\n  /* 'w' */ SET_CONST_PWM: 0x77,\r\n  /* 's' */ SET_CONST_SCALE: 0x73,\r\n  /* 'p' */ SET_PX_PWM: 0x70,\r\n  /* 'q' */ SET_PX_SCALE: 0x71,\r\n  /* 127 */ IDENTITY_STRING: 0x7F,\r\n});\r\n\r\nexport const IDENTITY_STR_LEN = 25;\r\n\r\nexport const IDENTITY_STR_REGEX = /^Sig\\sFW\\sLED\\sMatrix\\sFW\\sV(\\d+)\\.(\\d+)$/;\r\n","import { GAMMA } from '../../../hardware-constants.js';\r\nimport { Command, IDENTITY_STR_LEN } from './commands.js';\r\n\r\nexport class CommandAbstractionLayer {\r\n  constructor(portMutex = null) {\r\n    this.portMutex = portMutex;\r\n  }\r\n\r\n  async bootloader() {\r\n    await this.portMutex.acquire(async p => {\r\n      await p.tx([Command.BOOTLOADER]);\r\n    });\r\n  }\r\n\r\n  async identityString() {\r\n    let ident = null;\r\n\r\n    await this.portMutex.acquire(async p => {\r\n      await p.tx([Command.IDENTITY_STRING]);\r\n      ident = await p.rx(IDENTITY_STR_LEN);\r\n    });\r\n\r\n    return String.fromCharCode(...ident);\r\n  }\r\n\r\n  async setPixelPwm(r, c, brightness) {\r\n    await this.portMutex.acquire(\r\n      async p => {\r\n        await p.tx([Command.SET_PX_PWM, c, r, brightness]);\r\n      }\r\n    );\r\n  }\r\n\r\n  async setGlobalPwm(brightness) {\r\n    await this.portMutex.acquire(\r\n      async p => {\r\n        await p.tx([Command.SET_CONST_PWM, brightness]);\r\n      }\r\n    );\r\n  }\r\n\r\n  async setMatrixPwm(matrix) {\r\n    // Only execute the most recent call \r\n    await this.portMutex.acquireIdempotent(\r\n      'drawMatrix', \r\n      async p => {\r\n        await p.tx(\r\n          [Command.DRAW_PWM].concat(\r\n            matrix.flat().map(v => \r\n              GAMMA[Math.floor((v ?? 0) * 255)]\r\n            )\r\n          )\r\n        );\r\n      }\r\n    );\r\n  }\r\n\r\n  async setPixelAnalog(r, c, brightness) {\r\n    await this.portMutex.acquire(\r\n      async p => {\r\n        await p.tx([Command.SET_PX_SCALE, c, r, brightness]);\r\n      }\r\n    );\r\n  }\r\n\r\n  async setGlobalAnalog(brightness) {\r\n    await this.portMutex.acquire(\r\n      async p => {\r\n        await p.tx([Command.SET_CONST_SCALE, brightness]);\r\n      }\r\n    );\r\n  }\r\n\r\n  async setMatrixAnalog(matrix) {\r\n    // Only execute the most recent call \r\n    await this.portMutex.acquireIdempotent(\r\n      'drawMatrix', \r\n      async p => {\r\n        await p.tx(\r\n          [Command.DRAW_SCALE].concat(\r\n            matrix.flat().map(v => \r\n              GAMMA[Math.floor((v ?? 0) * 255)]\r\n            )\r\n          )\r\n        );\r\n      }\r\n    );\r\n  }\r\n}\r\n","import { close, getPort } from '../../../web-serial/port.js';\r\nimport { PortMutex } from '../../../web-serial/PortMutex.js';\r\nimport { PortOperations } from '../../../web-serial/PortOperations.js';\r\nimport { CommandAbstractionLayer } from './CommandAbstractionLayer.js';\r\nimport { IDENTITY_STR_REGEX } from './commands.js';\r\n\r\nexport class SigrootController extends CommandAbstractionLayer {\r\n  async bootloader() {\r\n    await super.bootloader();\r\n  }\r\n\r\n  async connect() {\r\n    const port = await getPort();\r\n\r\n    if (port?.connected) {\r\n      await close(port);\r\n      await port.open({ baudRate: 115200 });\r\n      this.portMutex = new PortMutex(new PortOperations(port));\r\n    }\r\n  }\r\n\r\n  async draw(matrix) {\r\n    if (!this.#scaleInitialized) {\r\n      await super.setGlobalAnalog(0x20);\r\n      this.#scaleInitialized = true;\r\n    }\r\n\r\n    await super.setMatrixPwm(matrix);\r\n  }\r\n\r\n  async verifyFirmware() { \r\n    return await this.version() != null;\r\n  }\r\n\r\n  async version() {\r\n    const ident = await super.identityString();\r\n    const match = ident.match(IDENTITY_STR_REGEX);\r\n\r\n    if (match && match.length == 3) {\r\n      return {\r\n        major: match[1],\r\n        minor: match[2]\r\n      }\r\n    } else {\r\n      return null;\r\n    }\r\n  }\r\n\r\n  #scaleInitialized;\r\n}\r\n","import { PID, VID } from '../hardware-constants.js';\r\n\r\nconst extraDevices = [];\r\n\r\nconst filters = [\r\n  {\r\n    vendorId: VID,\r\n    productId: PID,\r\n  }\r\n];\r\n\r\nexport class DeviceSelectionCancelled extends Error {\r\n  constructor() {\r\n    super('User cancelled device selection.');\r\n    this.name = this.constructor.name;\r\n    this.date = new Date();\r\n  }\r\n}\r\n\r\nexport async function getDevice() {\r\n  if (extraDevices && extraDevices.length > 0) {\r\n    return extraDevices.pop();\r\n  }\r\n\r\n  extraDevices.push(...(await navigator.hid.getDevices()));\r\n  if (extraDevices && extraDevices.length > 0) {\r\n    return extraDevices.pop();\r\n  }\r\n\r\n  extraDevices.push(...(await navigator.hid.requestDevice({ filters })));\r\n  if (extraDevices && extraDevices.length > 0) {\r\n    return extraDevices.pop();\r\n  }\r\n\r\n  throw new DeviceSelectionCancelled();\r\n}\r\n","import { pad } from './util.js';\r\n\r\nexport class HIDOperations {\r\n  constructor(device) {\r\n    this.#device = device;\r\n  }\r\n\r\n  async send(report, data) {\r\n    if (data.length < report.bytes) {\r\n      data = pad(data, report.bytes);\r\n    } else if (data.length > report.bytes) {\r\n      throw new Error('Unable to send report: too many bytes');\r\n    }\r\n\r\n    const buffer = new Uint8Array(data).buffer;\r\n\r\n    if (report.feature)  {\r\n      await this.#device.sendFeatureReport(report.id, buffer);\r\n    } else {\r\n      await this.#device.sendReport(report.id, buffer);\r\n    }\r\n  }\r\n\r\n  async request(report) {\r\n    let reply = [];\r\n\r\n    if (report.feature) {\r\n      reply = await this.#device.receiveFeatureReport(report.id);\r\n    } else {\r\n      /* \r\n       * HID input reports are used for unprompted data.\r\n       * See WebHID `HIDInputReportEvent`\r\n       */\r\n      throw new Error('Invalid operation');\r\n    }\r\n\r\n    if (reply.byteLength != report.bytes) {\r\n      const exp = report.bytes;\r\n      const act = reply.byteLength;\r\n      console.error(`reply length=${act} (expected ${exp})`);\r\n    }\r\n\r\n    return reply;\r\n  }\r\n\r\n  #device;\r\n}\r\n","export function pad(arr, len, val=0x00) {\r\n  return arr.concat(new Array(len - arr.length).fill(val));\r\n}\r\n","export const Reports = {\r\n  GLITTER_DEVICE_INFO: {\r\n    id: 0x01,\r\n    bytes: 307,\r\n    feature: true,\r\n  },\r\n  GLITTER_BASIC_CMD: {\r\n    id: 0x02,\r\n    bytes: 16,\r\n    feature: true,\r\n  },\r\n  GLITTER_GRID_PWM_CNTL: {\r\n    id: 0x03,\r\n    bytes: 306,\r\n    feature: true,\r\n  },\r\n  GLITTER_GRID_PWM_CNTL: {\r\n    id: 0x04,\r\n    bytes: 306,\r\n    feature: true,\r\n  }\r\n}\r\n\r\nexport const Commands = {\r\n  GLITTER_CMD_REBOOT: 0x00,\r\n  GLITTER_CMD_SLEEP: 0x01,\r\n  GLITTER_CMD_WAKE_ON_COMMAND: 0x02,\r\n  GLITTER_CMD_SET_SLEEP_TIMEOUT: 0x03,\r\n  GLITTER_CMD_SET_GLOBAL_BRIGHTNESS: 0x04,\r\n  GLITTER_CMD_DRAW_PIXEL: 0x05,\r\n  GLITTER_CMD_DRAW_LINE: 0x06\r\n}\r\n\r\nexport const BootMode = {\r\n  BOOTSEL: 0x00,\r\n  NORMAL: 0x01,\r\n}\r\n","import { GAMMA } from '../../../hardware-constants.js';\r\nimport { Commands, Reports } from './reports.js';\r\n\r\nexport class ReportAbstractionLayer {\r\n  constructor(device = null) {\r\n    this.device = device;\r\n  }\r\n\r\n  async info() {\r\n    const infoRaw = await this.device.request(Reports.GLITTER_DEVICE_INFO);\r\n\r\n    return {\r\n      sleep_pin: infoRaw.getUint8(1),\r\n      dip1_pin: infoRaw.getUint8(2),\r\n      intb_pin: infoRaw.getUint8(3),\r\n      state_flags: infoRaw.getUint8(4),\r\n      id_reg: infoRaw.getUint8(5),\r\n      config_reg: infoRaw.getUint8(6),\r\n      global_brightness: infoRaw.getUint8(7),\r\n      display_width: infoRaw.getUint8(8),\r\n      display_height: infoRaw.getUint8(9),\r\n      timeout_ms: infoRaw.getUint32(10),\r\n      version_major: infoRaw.getUint8(14),\r\n      version_minor: infoRaw.getUint8(15),\r\n    };\r\n  }\r\n\r\n  async wake() {\r\n    await this.device.send(\r\n      Reports.GLITTER_BASIC_CMD,\r\n      [Commands.GLITTER_CMD_SLEEP, false]\r\n    );\r\n  }\r\n\r\n  async sleep() {\r\n    await this.device.send(\r\n      Reports.GLITTER_BASIC_CMD,\r\n      [Commands.GLITTER_CMD_SLEEP, true]\r\n    );\r\n  }\r\n\r\n  async disableSleep() {\r\n    await this.device.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [Commands.GLITTER_CMD_SET_SLEEP_TIMEOUT, 0xff, 0xff, 0xff, 0xff]\r\n    );\r\n  }\r\n\r\n  async disableDeepSleep() {\r\n    await this.device.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [Commands.GLITTER_CMD_WAKE_ON_COMMAND, 0x01]\r\n    );\r\n  }\r\n\r\n  async disableSleepTimer() {\r\n    await this.device.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [Commands.GLITTER_CMD_SET_SLEEP_TIMEOUT, 0x00, 0x00, 0x00, 0x00]\r\n    );\r\n  }\r\n  \r\n  async enableDeepSleep() {\r\n    await this.device.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [Commands.GLITTER_CMD_WAKE_ON_COMMAND, 0x00]\r\n    );\r\n  }\r\n\r\n  async enableSleepTimer(milliseconds) {\r\n    const view = new DataView(new ArrayBuffer(4));\r\n    const littleEndian = false;\r\n    view.setInt32(0, milliseconds, littleEndian);\r\n    await this.device.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [\r\n        Commands.GLITTER_CMD_SET_SLEEP_TIMEOUT, \r\n        view.getUint8(0), \r\n        view.getUint8(1), \r\n        view.getUint8(2), \r\n        view.getUint8(3),\r\n      ]\r\n    );\r\n  }\r\n\r\n  async reboot(mode) {\r\n    await this.device.send(\r\n      Reports.GLITTER_BASIC_CMD, \r\n      [Commands.GLITTER_CMD_REBOOT, mode]\r\n    );\r\n  }\r\n\r\n  async drawMatrix(matrix) {\r\n    await this.device.send(\r\n      Reports.GLITTER_GRID_PWM_CNTL,\r\n      matrix.flat().map(v => GAMMA[Math.floor((v ?? 0) * 255)])\r\n    );\r\n  }\r\n\r\n  async drawPixel(r, c, brightness) {\r\n    await this.device.send(\r\n      Reports.GLITTER_BASIC_CMD,\r\n      [Commands.GLITTER_CMD_DRAW_PIXEL, c, r, brightness]\r\n    );\r\n  }\r\n\r\n  async drawLine({r1, c1}, {r2, c2}, brightness) {\r\n    await this.device.send(\r\n      Reports.GLITTER_BASIC_CMD,\r\n      [Commands.GLITTER_CMD_DRAW_PIXEL, r1, c1, r2, c2, brightness]\r\n    );\r\n  }\r\n\r\n  device;\r\n}\r\n","import { getDevice } from '../../../web-hid/device.js';\r\nimport { HIDOperations } from '../../../web-hid/HIDOperations.js';\r\nimport { ReportAbstractionLayer } from './ReportAbstractionLayer.js';\r\nimport { BootMode } from './reports.js';\r\n\r\nexport class SparkleController extends ReportAbstractionLayer {\r\n  async bootloader() {\r\n    await super.reboot(BootMode.BOOTSEL);\r\n  }\r\n\r\n  async connect() {\r\n    const device = await getDevice();\r\n    if (device) {\r\n      await device.open();\r\n      this.device = new HIDOperations(device);\r\n    }\r\n  }\r\n  \r\n  async draw(matrix) {\r\n    await super.drawMatrix(matrix);\r\n  }\r\n\r\n  async verifyFirmware() {\r\n    try {\r\n      const info = await super.info();\r\n      return (\r\n        info.display_height == HEIGHT &&\r\n        info.display_width == WIDTH\r\n      );\r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  async version() {\r\n    const info = await super.info();\r\n    if (info.version_major != undefined \r\n      && info.version_minor != undefined\r\n      && (info.version_major > 0 || info.version_minor > 0)) {\r\n      return {\r\n        major: info.version_major,\r\n        minor: info.version_minor\r\n      }\r\n    } else {\r\n      // Sparkle <=1.1.1: Glitter version unavailable \r\n      return { major: 1, minor: 0 };\r\n    }\r\n  }\r\n}\r\n","import { DefaultController } from './supported-firmware/FrameworkComputer/inputmodule-rs/DefaultController.js';\r\nimport { SigrootController } from './supported-firmware/sigroot/FW_LED_Matrix_Firmware/SigrootController.js';\r\nimport { SparkleController } from './supported-firmware/vddCore/sparkle-fw16/SparkleController.js';\r\n\r\nexport class HardwareControllerFactory {\r\n  static async detectSerial() {\r\n    const c1 = new DefaultController();\r\n    const c2 = new SigrootController();\r\n\r\n    await c1.connect();\r\n    if (await c1.verifyFirmware()) {\r\n      return c1;\r\n    }\r\n    \r\n    await c2.connect()\r\n    if (await c2.verifyFirmware()) {\r\n      return c2;\r\n    } \r\n    \r\n    return null;\r\n  }\r\n\r\n  static async detectHID() {\r\n    const c1 = new SparkleController();\r\n    \r\n    await c1.connect();\r\n    if (await c1.verifyFirmware()) {\r\n      return c1;\r\n    } \r\n    \r\n    return null;\r\n  }\r\n}\r\n"],"names":["WIDTH","HEIGHT","VID","VID_ARR","PID","PID_ARR","GAMMA","Object","freeze","extraPorts","filters","usbVendorId","usbProductId","PortSelectionCancelled","Error","constructor","super","this","name","date","Date","PortUnavailable","async","getPort","length","pop","push","navigator","serial","getPorts","requestPort","e","close","port","message","PortMutex","portOperations","lockName","Math","random","toString","deduper","Map","portOps","acquire","fn","trace","stack","enqueue","console","error","acquireIdempotent","key","has","info","set","execDedupedOp","locks","request","get","delete","PortOperations","rx","timeout","readable","locked","response","reader","getReader","timeoutHandle","setTimeout","cancel","value","done","read","clearTimeout","releaseLock","tx","buffer","writable","writer","getWriter","write","Uint8Array","Command","ANIMATE","BRIGHTNESS","BOOTLOADER","DRAW","DRAW_GREY_COL_BUFFER","GAME_CTRL","GAME_STATUS","PANIC","PATTERN","SLEEP","STAGE_GREY_COL","START_GAME","VERSION","CommandAbstractionLayer$1","portMutex","bootloader","p","draw","matrix","index","output","fill","r","c","drawGrayscale","buffers","Array","from","_","floor","i","version","ver","major","minor","patch","preRelease","DefaultController","CommandAbstractionLayer","connect","connected","open","baudRate","bitDepth","BitDepth","GRAY_8BIT","MONO_1BIT","verifyFirmware","undefined","NOOP","ANIMATION_DIAMOND","ANIMATION_FIRE","ANIMATION_FIREPLACE","ANIMATION_GEAR","ANIMATION_RING","ANIMATION_STARTUP","ANIMATION_STARTUP_ONCE","DRAW_PWM","DRAW_PWM_BLOCKING","DRAW_SCALE","DRAW_SCALE_BLOCKING","FLUSH_CMD_QUEUE","TEST_PATTERN","SET_CONST_PWM","SET_CONST_SCALE","SET_PX_PWM","SET_PX_SCALE","IDENTITY_STRING","IDENTITY_STR_REGEX","identityString","ident","String","fromCharCode","setPixelPwm","brightness","setGlobalPwm","setMatrixPwm","concat","flat","map","v","setPixelAnalog","setGlobalAnalog","setMatrixAnalog","SigrootController","scaleInitialized","match","extraDevices","vendorId","productId","DeviceSelectionCancelled","HIDOperations","device","send","report","data","bytes","arr","len","val","pad","feature","sendFeatureReport","id","sendReport","reply","receiveFeatureReport","byteLength","exp","act","Reports","Commands","BootMode","ReportAbstractionLayer","infoRaw","sleep_pin","getUint8","dip1_pin","intb_pin","state_flags","id_reg","config_reg","global_brightness","display_width","display_height","timeout_ms","getUint32","version_major","version_minor","wake","sleep","disableSleep","disableDeepSleep","disableSleepTimer","enableDeepSleep","enableSleepTimer","milliseconds","view","DataView","ArrayBuffer","setInt32","reboot","mode","drawMatrix","drawPixel","drawLine","r1","c1","r2","c2","SparkleController","hid","getDevices","requestDevice","getDevice","HardwareControllerFactory","detectSerial","detectHID"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "led-matrix-controllers",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "main": "./src/index.js",
   "module": "./src/index.js",

package/src/HardwareControllerFactory.js

@@ -0,0 +1,33 @@
+import { DefaultController } from './supported-firmware/FrameworkComputer/inputmodule-rs/DefaultController.js';
+import { SigrootController } from './supported-firmware/sigroot/FW_LED_Matrix_Firmware/SigrootController.js';
+import { SparkleController } from './supported-firmware/vddCore/sparkle-fw16/SparkleController.js';
+
+export class HardwareControllerFactory {
+  static async detectSerial() {
+    const c1 = new DefaultController();
+    const c2 = new SigrootController();
+
+    await c1.connect();
+    if (await c1.verifyFirmware()) {
+      return c1;
+    }
+    
+    await c2.connect()
+    if (await c2.verifyFirmware()) {
+      return c2;
+    } 
+    
+    return null;
+  }
+
+  static async detectHID() {
+    const c1 = new SparkleController();
+    
+    await c1.connect();
+    if (await c1.verifyFirmware()) {
+      return c1;
+    } 
+    
+    return null;
+  }
+}

package/src/index.js

@@ -1,3 +1,5 @@
 export * from './hardware-constants.js'
-export * from './usb-hid/HIDControllerFactory.js';
-export * from './usb-serial/SerialControllerFactory.js';
+export * from './HardwareControllerFactory.js';
+export * from './supported-firmware/FrameworkComputer/inputmodule-rs/DefaultController.js';
+export * from './supported-firmware/sigroot/FW_LED_Matrix_Firmware/SigrootController.js'
+export * from './supported-firmware/vddCore/sparkle-fw16/SparkleController.js';

package/src/supported-firmware/FrameworkComputer/inputmodule-rs/CommandAbstractionLayer.js

@@ -0,0 +1,75 @@
+import { HEIGHT, VID_ARR, WIDTH } from '../../../hardware-constants.js';
+import { Command, RX_PACKET_SZ } from './commands.js';
+
+export class CommandAbstractionLayer {
+  constructor(portMutex = null) {
+    this.portMutex = portMutex;
+  }
+
+  async bootloader() {
+    await this.portMutex.acquire(async p => {
+      await p.tx([...VID_ARR, Command.BOOTLOADER]);
+    });
+  }
+
+  async draw(matrix) {
+    let index = 0;
+    let output = new Uint8Array(39).fill(0);
+
+    // Pack cells into bits
+    for (let r = 0; r < HEIGHT; r++) {
+      for (let c = 0; c < WIDTH; c++) {
+        if (matrix[r][c]) {
+          output[index >> 3] |= 1 << index % 8;
+        }
+        index++;
+      }
+    }
+
+    await this.portMutex.acquireIdempotent(
+      'drawMatrix', 
+      async p => {
+        await p.tx([...VID_ARR, Command.DRAW, ...output]);
+      }
+    );
+  }
+
+  async drawGrayscale(matrix) {
+    // Transpose & Gamma Correction
+    const buffers = Array.from(
+      { length: WIDTH }, 
+      (_, c) => new Array(
+        { length: HEIGHT }, 
+        (_, r) => GAMMA[Math.floor((matrix[r][c] ?? 0) * 255)]
+      )
+    );
+
+    // Only execute the most recent call 
+    await this.portMutex.acquireIdempotent(
+      'drawMatrix', 
+      async p => {
+        for (let i = 0; i < WIDTH; i++) {
+          await p.tx([Command.STAGE_GREY_COL, i, ...buffers[i]]);
+        }
+        await p.tx([Command.DRAW_GREY_COL_BUFFER]);
+      }
+    );
+  }
+
+  async version() {
+    let ver = {};
+
+    await this.portMutex.acquire(async p => {
+      await p.tx([...VID_ARR, Command.VERSION]);
+      const response = await p.rx(RX_PACKET_SZ);
+
+      // MMMMMMMM mmmmPPPP 0000000p
+      ver.major = response[0];
+      ver.minor = response[1] >> 4;
+      ver.patch = response[1] & 0x0F;
+      ver.preRelease = response[2] == 1;
+    });
+
+    return ver;
+  }
+}

package/src/supported-firmware/FrameworkComputer/inputmodule-rs/DefaultController.js

@@ -0,0 +1,54 @@
+import { close, getPort } from '../../../web-serial/port.js';
+import { PortMutex } from '../../../web-serial/PortMutex.js';
+import { PortOperations } from '../../../web-serial/PortOperations.js';
+import { CommandAbstractionLayer } from './CommandAbstractionLayer.js';
+
+export class DefaultController extends CommandAbstractionLayer {
+  async bootloader() {
+    return super.bootloader();
+  }
+
+  async connect() {
+    const port = await getPort();
+
+    if (port?.connected) {
+      await close(port);
+      await port.open({ baudRate: 115200 });
+      this.portMutex = new PortMutex(new PortOperations(port));
+    }
+  }
+
+  async draw(matrix) {
+    switch (this.#bitDepth) {
+
+      case BitDepth.GRAY_8BIT:
+        super.drawGrayscale(matrix);
+        break;
+
+      case BitDepth.MONO_1BIT:
+        super.draw(matrix);
+        break;
+    }
+  }
+
+  async verifyFirmware() {
+    try {
+      const version = await super.version();
+
+      return version
+        && version.major != undefined
+        && version.minor != undefined
+        && version.patch != undefined
+        && version.preRelease != undefined;
+        
+    } catch {
+      return false;
+    }
+  }
+
+  async version() {
+    return super.version();
+  }
+
+  #bitDepth;
+}

package/src/supported-firmware/sigroot/FW_LED_Matrix_Firmware/CommandAbstractionLayer.js

@@ -0,0 +1,89 @@
+import { GAMMA } from '../../../hardware-constants.js';
+import { Command, IDENTITY_STR_LEN } from './commands.js';
+
+export class CommandAbstractionLayer {
+  constructor(portMutex = null) {
+    this.portMutex = portMutex;
+  }
+
+  async bootloader() {
+    await this.portMutex.acquire(async p => {
+      await p.tx([Command.BOOTLOADER]);
+    });
+  }
+
+  async identityString() {
+    let ident = null;
+
+    await this.portMutex.acquire(async p => {
+      await p.tx([Command.IDENTITY_STRING]);
+      ident = await p.rx(IDENTITY_STR_LEN);
+    });
+
+    return String.fromCharCode(...ident);
+  }
+
+  async setPixelPwm(r, c, brightness) {
+    await this.portMutex.acquire(
+      async p => {
+        await p.tx([Command.SET_PX_PWM, c, r, brightness]);
+      }
+    );
+  }
+
+  async setGlobalPwm(brightness) {
+    await this.portMutex.acquire(
+      async p => {
+        await p.tx([Command.SET_CONST_PWM, brightness]);
+      }
+    );
+  }
+
+  async setMatrixPwm(matrix) {
+    // Only execute the most recent call 
+    await this.portMutex.acquireIdempotent(
+      'drawMatrix', 
+      async p => {
+        await p.tx(
+          [Command.DRAW_PWM].concat(
+            matrix.flat().map(v => 
+              GAMMA[Math.floor((v ?? 0) * 255)]
+            )
+          )
+        );
+      }
+    );
+  }
+
+  async setPixelAnalog(r, c, brightness) {
+    await this.portMutex.acquire(
+      async p => {
+        await p.tx([Command.SET_PX_SCALE, c, r, brightness]);
+      }
+    );
+  }
+
+  async setGlobalAnalog(brightness) {
+    await this.portMutex.acquire(
+      async p => {
+        await p.tx([Command.SET_CONST_SCALE, brightness]);
+      }
+    );
+  }
+
+  async setMatrixAnalog(matrix) {
+    // Only execute the most recent call 
+    await this.portMutex.acquireIdempotent(
+      'drawMatrix', 
+      async p => {
+        await p.tx(
+          [Command.DRAW_SCALE].concat(
+            matrix.flat().map(v => 
+              GAMMA[Math.floor((v ?? 0) * 255)]
+            )
+          )
+        );
+      }
+    );
+  }
+}

package/src/supported-firmware/sigroot/FW_LED_Matrix_Firmware/SigrootController.js

@@ -0,0 +1,50 @@
+import { close, getPort } from '../../../web-serial/port.js';
+import { PortMutex } from '../../../web-serial/PortMutex.js';
+import { PortOperations } from '../../../web-serial/PortOperations.js';
+import { CommandAbstractionLayer } from './CommandAbstractionLayer.js';
+import { IDENTITY_STR_REGEX } from './commands.js';
+
+export class SigrootController extends CommandAbstractionLayer {
+  async bootloader() {
+    await super.bootloader();
+  }
+
+  async connect() {
+    const port = await getPort();
+
+    if (port?.connected) {
+      await close(port);
+      await port.open({ baudRate: 115200 });
+      this.portMutex = new PortMutex(new PortOperations(port));
+    }
+  }
+
+  async draw(matrix) {
+    if (!this.#scaleInitialized) {
+      await super.setGlobalAnalog(0x20);
+      this.#scaleInitialized = true;
+    }
+
+    await super.setMatrixPwm(matrix);
+  }
+
+  async verifyFirmware() { 
+    return await this.version() != null;
+  }
+
+  async version() {
+    const ident = await super.identityString();
+    const match = ident.match(IDENTITY_STR_REGEX);
+
+    if (match && match.length == 3) {
+      return {
+        major: match[1],
+        minor: match[2]
+      }
+    } else {
+      return null;
+    }
+  }
+
+  #scaleInitialized;
+}

package/src/{usb-serial/firmware/sigroot → supported-firmware/sigroot/FW_LED_Matrix_Firmware}/commands.js

@@ -18,11 +18,9 @@ export const Command = Object.freeze({
   /* 's' */ SET_CONST_SCALE: 0x73,
   /* 'p' */ SET_PX_PWM: 0x70,
   /* 'q' */ SET_PX_SCALE: 0x71,
-  /* 127 */ IDENT: 0x7F,
+  /* 127 */ IDENTITY_STRING: 0x7F,
 });
 
-export const IDENT_STR_LEN = 25;
+export const IDENTITY_STR_LEN = 25;
 
-export const IDENT_STR_REGEX = /^Sig\sFW\sLED\sMatrix\sFW\sV(\d+)\.(\d+)$/;
-
-export const IDENT_STR_PREFIX = 'Sig FW LED Matrix FW';
+export const IDENTITY_STR_REGEX = /^Sig\sFW\sLED\sMatrix\sFW\sV(\d+)\.(\d+)$/;

package/src/{usb-hid/firmware/sparkle/SparkleController.js → supported-firmware/vddCore/sparkle-fw16/ReportAbstractionLayer.js}

@@ -1,15 +1,13 @@
-import { GAMMA, HEIGHT, WIDTH } from '../../../hardware-constants.js';
-import { BootMode, Commands, Reports } from './reports.js';
+import { GAMMA } from '../../../hardware-constants.js';
+import { Commands, Reports } from './reports.js';
 
-export { BootMode } from './reports.js';
-
-export class SparkleController {
-  constructor(hidOps) {
-    this.#hidOps = hidOps;
+export class ReportAbstractionLayer {
+  constructor(device = null) {
+    this.device = device;
   }
 
   async info() {
-    const infoRaw = await this.#hidOps.receive(Reports.GLITTER_DEVICE_INFO);
+    const infoRaw = await this.device.request(Reports.GLITTER_DEVICE_INFO);
 
     return {
       sleep_pin: infoRaw.getUint8(1),
@@ -22,46 +20,48 @@ export class SparkleController {
       display_width: infoRaw.getUint8(8),
       display_height: infoRaw.getUint8(9),
       timeout_ms: infoRaw.getUint32(10),
+      version_major: infoRaw.getUint8(14),
+      version_minor: infoRaw.getUint8(15),
     };
   }
 
   async wake() {
-    await this.#hidOps.send(
+    await this.device.send(
       Reports.GLITTER_BASIC_CMD,
       [Commands.GLITTER_CMD_SLEEP, false]
     );
   }
 
   async sleep() {
-    await this.#hidOps.send(
+    await this.device.send(
       Reports.GLITTER_BASIC_CMD,
       [Commands.GLITTER_CMD_SLEEP, true]
     );
   }
 
   async disableSleep() {
-    await this.#hidOps.send(
+    await this.device.send(
       Reports.GLITTER_BASIC_CMD, 
       [Commands.GLITTER_CMD_SET_SLEEP_TIMEOUT, 0xff, 0xff, 0xff, 0xff]
     );
   }
 
   async disableDeepSleep() {
-    await this.#hidOps.send(
+    await this.device.send(
       Reports.GLITTER_BASIC_CMD, 
       [Commands.GLITTER_CMD_WAKE_ON_COMMAND, 0x01]
     );
   }
 
   async disableSleepTimer() {
-    await this.#hidOps.send(
+    await this.device.send(
       Reports.GLITTER_BASIC_CMD, 
       [Commands.GLITTER_CMD_SET_SLEEP_TIMEOUT, 0x00, 0x00, 0x00, 0x00]
     );
   }
   
   async enableDeepSleep() {
-    await this.#hidOps.send(
+    await this.device.send(
       Reports.GLITTER_BASIC_CMD, 
       [Commands.GLITTER_CMD_WAKE_ON_COMMAND, 0x00]
     );
@@ -71,7 +71,7 @@ export class SparkleController {
     const view = new DataView(new ArrayBuffer(4));
     const littleEndian = false;
     view.setInt32(0, milliseconds, littleEndian);
-    await this.#hidOps.send(
+    await this.device.send(
       Reports.GLITTER_BASIC_CMD, 
       [
         Commands.GLITTER_CMD_SET_SLEEP_TIMEOUT, 
@@ -84,55 +84,32 @@ export class SparkleController {
   }
 
   async reboot(mode) {
-    await this.#hidOps.send(
+    await this.device.send(
       Reports.GLITTER_BASIC_CMD, 
       [Commands.GLITTER_CMD_REBOOT, mode]
     );
   }
 
+  async drawMatrix(matrix) {
+    await this.device.send(
+      Reports.GLITTER_GRID_PWM_CNTL,
+      matrix.flat().map(v => GAMMA[Math.floor((v ?? 0) * 255)])
+    );
+  }
+
   async drawPixel(r, c, brightness) {
-    await this.#hidOps.send(
+    await this.device.send(
       Reports.GLITTER_BASIC_CMD,
       [Commands.GLITTER_CMD_DRAW_PIXEL, c, r, brightness]
     );
   }
 
   async drawLine({r1, c1}, {r2, c2}, brightness) {
-    await this.#hidOps.send(
+    await this.device.send(
       Reports.GLITTER_BASIC_CMD,
       [Commands.GLITTER_CMD_DRAW_PIXEL, r1, c1, r2, c2, brightness]
     );
   }
 
-  // --- generic methods ---
-
-  async bootloader() {
-    await this.reboot(BootMode.BOOTSEL);
-  }
-  
-  async draw(matrix) {
-    await this.#hidOps.send(
-      Reports.GLITTER_GRID_PWM_CNTL,
-      matrix.flat().map(v => GAMMA[Math.floor((v ?? 0) * 255)])
-    );
-  }
-
-  async verifyFirmware() {
-    try {
-      const info = await this.info();
-      return (
-        info.display_height == HEIGHT &&
-        info.display_width == WIDTH
-      );
-    } catch {
-      return false;
-    }
-  }
-
-  async version() {
-    // Not Available
-    return { major: 1, minor: 0 };
-  }
-
-  #hidOps;
+  device;
 }

package/src/supported-firmware/vddCore/sparkle-fw16/SparkleController.js

@@ -0,0 +1,49 @@
+import { getDevice } from '../../../web-hid/device.js';
+import { HIDOperations } from '../../../web-hid/HIDOperations.js';
+import { ReportAbstractionLayer } from './ReportAbstractionLayer.js';
+import { BootMode } from './reports.js';
+
+export class SparkleController extends ReportAbstractionLayer {
+  async bootloader() {
+    await super.reboot(BootMode.BOOTSEL);
+  }
+
+  async connect() {
+    const device = await getDevice();
+    if (device) {
+      await device.open();
+      this.device = new HIDOperations(device);
+    }
+  }
+  
+  async draw(matrix) {
+    await super.drawMatrix(matrix);
+  }
+
+  async verifyFirmware() {
+    try {
+      const info = await super.info();
+      return (
+        info.display_height == HEIGHT &&
+        info.display_width == WIDTH
+      );
+    } catch {
+      return false;
+    }
+  }
+
+  async version() {
+    const info = await super.info();
+    if (info.version_major != undefined 
+      && info.version_minor != undefined
+      && (info.version_major > 0 || info.version_minor > 0)) {
+      return {
+        major: info.version_major,
+        minor: info.version_minor
+      }
+    } else {
+      // Sparkle <=1.1.1: Glitter version unavailable 
+      return { major: 1, minor: 0 };
+    }
+  }
+}

package/src/{usb-hid/environments/web → web-hid}/HIDOperations.js

@@ -17,11 +17,11 @@ export class HIDOperations {
     if (report.feature)  {
       await this.#device.sendFeatureReport(report.id, buffer);
     } else {
-      await this.#device.sendReport(report.buffer);
+      await this.#device.sendReport(report.id, buffer);
     }
   }
 
-  async receive(report) {
+  async request(report) {
     let reply = [];
 
     if (report.feature) {
@@ -29,14 +29,15 @@ export class HIDOperations {
     } else {
       /* 
        * HID input reports are used for unprompted data.
-       * An event system must be used.
        * See WebHID `HIDInputReportEvent`
        */
       throw new Error('Invalid operation');
     }
 
     if (reply.byteLength != report.bytes) {
-      console.error(`reply length=${reply.byteLength} (exp ${report.bytes})`);
+      const exp = report.bytes;
+      const act = reply.byteLength;
+      console.error(`reply length=${act} (expected ${exp})`);
     }
 
     return reply;

package/src/{usb-hid/environments/web → web-hid}/device.js

@@ -1,4 +1,4 @@
-import { PID, VID } from '../../../hardware-constants.js';
+import { PID, VID } from '../hardware-constants.js';
 
 const extraDevices = [];
 
@@ -7,7 +7,7 @@ const filters = [
     vendorId: VID,
     productId: PID,
   }
-]
+];
 
 export class DeviceSelectionCancelled extends Error {
   constructor() {

package/src/{usb-serial/environments/web → web-serial}/port.js

@@ -1,3 +1,14 @@
+import { PID, VID } from '../hardware-constants.js';
+
+const extraPorts = [];
+
+const filters = [
+  {
+    usbVendorId: VID,
+    usbProductId: PID,
+  }
+];
+
 export class PortSelectionCancelled extends Error {
   constructor() {
     super('User cancelled port selection.');
@@ -16,13 +27,20 @@ export class PortUnavailable extends Error {
 
 export async function getPort() {
   try {
-    const port = await navigator.serial.requestPort();
-    const { usbProductId, usbVendorId } = port;
-    console.log('Selected port:', port);
-    if (usbProductId && usbVendorId) {
-      console.log(`VID:PID ${usbVendorId}:${usbProductId}`);
+    if (extraPorts && extraPorts.length > 0) {
+      return extraPorts.pop();
     }
-    return port;
+
+    extraPorts.push(...await navigator.serial.getPorts());
+    if (extraPorts && extraPorts.length > 0) {
+      return extraPorts.pop();
+    }
+
+    extraPorts.push(...await navigator.serial.requestPort({ filters }));
+    if (extraPorts && extraPorts.length > 0) {
+      return extraPorts.pop();
+    }
+
   } catch (e) {
     if (e.name == 'NotFoundError') {
       throw new PortSelectionCancelled();

package/src/usb-hid/HIDControllerFactory.js

@@ -1,34 +0,0 @@
-import { getDevice } from './environments/web/device.js';
-import { HIDOperations } from './environments/web/HIDOperations.js';
-import { SparkleController } from './firmware/sparkle/SparkleController.js';
-
-export class HIDControllerFactory {
-  static async make(firmware) {
-    const device = await getDevice();
-    if (device) {
-      if (firmware === 'sparkle') {
-        return await HIDControllerFactory.makeSparkleController(device);
-      } else if (firmware === 'detect') {
-        return await HIDControllerFactory.makeDetectedController(device);
-      } else {
-        throw new Error(`Unsupported firmware type: ${firmware}`);
-      }
-    }
-  }
-
-  static async makeSparkleController(device) {
-    if (device) {
-      await device.open();
-      return new SparkleController(
-        new HIDOperations(device)
-      );
-    }
-  }
-
-  static async makeDetectedController(device) {
-    const ctrl1 = await HIDControllerFactory.makeSparkleController(device);
-    if (ctrl1.verifyFirmware()) {
-      return ctrl1;
-    }
-  }
-}

package/src/usb-serial/SerialControllerFactory.js

@@ -1,57 +0,0 @@
-import { PortMutex } from './environments/web/PortMutex.js';
-import { PortOperations } from './environments/web/PortOperations.js';
-import { close, getPort } from './environments/web/port.js';
-import { DefaultController } from './firmware/framework-official/DefaultController.js';
-import { SigrootController } from './firmware/sigroot/SigrootController.js';
-
-export class SerialControllerFactory {
-  static async make(firmware) {
-    const port = await getPort();
-    if (port) {
-      if (firmware === 'framework-official') {
-        return await SerialControllerFactory.makeDefaultController(port);
-      } else if (firmware === 'sigroot') {
-        return await SerialControllerFactory.makeSigrootController(port);
-      } else if (firmware === 'detect') {
-        return await SerialControllerFactory.makeDetectedController(port);
-      } else {
-        throw new Error(`Unsupported firmware type: ${firmware}`);
-      }
-    }
-  }
-
-  static async makeDefaultController(port) {
-    if (port?.connected) {
-      await close(port);
-      await port.open({ baudRate: 115200 });
-      return new DefaultController(
-        new PortMutex(
-          new PortOperations(port)
-        )
-      );
-    }
-  }
-
-  static async makeSigrootController(port) {
-    if (port?.connected) {
-      await close(port);
-      await port.open({ baudRate: 115200 });
-      return new SigrootController(
-        new PortMutex(
-          new PortOperations(port)
-        )
-      );
-    }
-  }
-
-  static async makeDetectedController(port) {
-    const ctrl1 = await this.makeDefaultController(port);
-    if (await ctrl1.verifyFirmware()) {
-      return ctrl1;
-    }
-    const ctrl2 = await this.makeSigrootController(port);
-    if (await ctrl2.verifyFirmware()) {
-      return ctrl2;
-    }
-  }
-}

package/src/usb-serial/firmware/framework-official/DefaultController.js

@@ -1,95 +0,0 @@
-import { HEIGHT, VID_ARR, WIDTH } from '../../../hardware-constants.js';
-import { BitDepth, Command, RX_PACKET_SZ } from './commands.js';
-
-export class DefaultController {
-  constructor(portMutex) {
-    this.#bitDepth = BitDepth.MONO_1BIT;
-    this.#portMutex = portMutex;
-  }
-
-  async bootloader() {
-    await this.#portMutex.acquire(async p => {
-      await p.tx([...VID_ARR, Command.BOOTLOADER]);
-    });
-  }
-
-  async draw(matrix) {
-    if (this.#bitDepth == BitDepth.GRAY_8BIT) {
-      // Transpose & Gamma Correction
-      const payloads = Array.from(
-        { length: WIDTH }, 
-        (_, c) => new Array(
-          { length: HEIGHT }, 
-          (_, r) => GAMMA[Math.floor((matrix[r][c] ?? 0) * 255)]
-        )
-      );
-
-      // Only execute the most recent call 
-      await this.#portMutex.acquireIdempotent(
-        'drawMatrix', 
-        async p => {
-          for (let i = 0; i < WIDTH; i++) {
-            await p.tx([Command.STAGE_GREY_COL, i, ...payloads[i]]);
-          }
-          await p.tx([Command.DRAW_GREY_COL_BUFFER]);
-        }
-      );
-    }
-
-    else if (this.#bitDepth == BitDepth.MONO_1BIT) {
-      let index = 0;
-      let output = new Uint8Array(39).fill(0);
-
-      // Pack cells into bits
-      for (let r = 0; r < HEIGHT; r++) {
-        for (let c = 0; c < WIDTH; c++) {
-          if (matrix[r][c]) {
-            output[index >> 3] |= 1 << index % 8;
-          }
-          index++;
-        }
-      }
-
-      await this.#portMutex.acquireIdempotent(
-        'drawMatrix', 
-        async p => {
-          await p.tx([...VID_ARR, Command.DRAW, ...output]);
-        }
-      );
-    }
-  }
-
-  async verifyFirmware() {
-    let packet = null;
-
-    await this.#portMutex.acquire(async p => {
-      await p.tx([...VID_ARR, Command.VERSION]);
-      packet = await p.rx(RX_PACKET_SZ);
-    });
-
-    const isPacket = packet.length == RX_PACKET_SZ;
-    const isPadded = packet.slice(3).every(e => e == 0x00);
-
-    return isPacket && isPadded;
-  }
-
-  async version() {
-    let ver = {};
-
-    await this.#portMutex.acquire(async p => {
-      await p.tx([...VID_ARR, Command.VERSION]);
-      const response = await p.rx(RX_PACKET_SZ);
-
-      // MMMMMMMM mmmmPPPP 0000000p
-      ver.major = response[0];
-      ver.minor = response[1] >> 4;
-      ver.patch = response[1] & 0x0F;
-      ver.preRelease = response[2] == 1;
-    });
-
-    return ver;
-  }
-
-  #bitDepth;
-  #portMutex;
-}

package/src/usb-serial/firmware/sigroot/SigrootController.js

@@ -1,75 +0,0 @@
-import { GAMMA } from '../../../hardware-constants.js';
-import { Command, IDENT_STR_LEN, IDENT_STR_REGEX } from './commands.js';
-
-export class SigrootController {
-  constructor(portMutex) {
-    this.#portMutex = portMutex;
-  }
-
-  async bootloader() {
-    await this.#portMutex.acquire(async p => {
-      await p.tx([Command.BOOTLOADER]);
-    });
-  }
-
-  async draw(matrix) {
-    if (!this.#scaleInitialized) {
-      await this.#portMutex.acquire(
-        async p => {
-          await p.tx([Command.SET_CONST_SCALE, 0x20]);
-        }
-      );
-      this.#scaleInitialized = true;
-    }
-
-    const bytes = matrix.flat().map(v => 
-      GAMMA[Math.floor((v ?? 0) * 255)]
-    );
-
-    // Only execute the most recent call 
-    await this.#portMutex.acquireIdempotent(
-      'drawMatrix', 
-      async p => {
-        await p.tx([Command.DRAW_PWM, ...bytes]);
-      }
-    );
-  }
-
-  async verifyFirmware() {
-    let ident = null;
-
-    await this.#portMutex.acquire(async p => {
-      await p.tx([Command.IDENT]);
-      ident = await p.rx(IDENT_STR_LEN);
-    });
-
-    ident = String.fromCharCode(...ident);
-
-    return ident.match(IDENT_STR_REGEX);
-  }
-
-  async version() {
-    let ident = null;
-
-    await this.#portMutex.acquire(async p => {
-      await p.tx([Command.IDENT]);
-      ident = await p.rx(IDENT_STR_LEN);
-    });
-
-    ident = String.fromCharCode(...ident);
-
-    const match = ident.match(IDENT_STR_REGEX);
-
-    if (match && match.length == 3) {
-      return {
-        major: match[1],
-        minor: match[2]
-      }
-    } else {
-      return null;
-    }
-  }
-
-  #portMutex;
-  #scaleInitialized;
-}