final fixes and initial release

Author: mrfrase3

.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish Package to npmjs
+on:
+  release:
+    types: [published]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      # Setup .npmrc file to publish to npm
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+          scope: '@duinoapp'
+      - run: yarn
+      - run: yarn build
+      - run: yarn publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

LICENSE

@@ -0,0 +1,7 @@
+Copyright 2024 Fraser Bullock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -23,6 +23,108 @@ This project aims to achieve the following:
   - Support ESP devices
   - Platform for easy addition of new protocols
 
+## Usage
+
+install your favourite way
+```bash
+npm install @duinoapp/upload-multitool
+yarn add @duinoapp/upload-multitool
+pnpm add @duinoapp/upload-multitool
+```
+
+This package exports a few utilities, the main one is upload
+
+```js
+import { upload } from '@duinoapp/upload-multitool';
+import type { ProgramConfig } from '@duinoapp/upload-multitool';
+import { SerialPort } from 'serialport';
+
+const serialport = new SerialPort({ path: '/dev/example', baudRate: 115200 });
+
+const config = {
+  // for avr boards, the compiled hex
+  bin: compiled.hex,
+  // for esp boards, the compiled files and flash settings
+  files: compiled.files,
+  flashFreq: compiled.flashFreq,
+  flashMode: compiled.flashMode,
+  // baud rate to connect to bootloader
+  speed: 115200,
+  // baud rate to use for upload (ESP)
+  uploadSpeed: 115200,
+  // the tool to use, avrdude or esptool
+  tool: 'avr',
+  // the CPU of the device
+  cpu: 'atmega328p',
+  // a standard out interface ({ write(msg: string): void })
+  stdout: process.stdout,
+  // whether or not to log to stdout verbosely
+  verbose: true,
+  // handle reconnecting to AVR109 devices when connecting to the bootloader
+  // the device ID changes for the bootloader, meaning in some OS's a new connection is required
+  // avr109Reconnect?: (opts: ReconnectParams) => Promise<SerialPort>;
+} as ProgramConfig;
+
+const res = await upload(serial.port, config);
+
+```
+
+If you want to programmatically check if a tool/cpu is supported:
+
+```js
+import { isSupported } from '@duinoapp/upload-multitool';
+
+console.log(isSupported('avr', 'atmega328p')); // true
+```
+
+Also exports some helpful utilities:
+
+```js
+import { WebSerialPort, SerialPortPromise, WebSerialPortPromise } from '@duinoapp/upload-multitool';
+
+// WebSerialPort is a drop-in web replacement for serialport, with some useful static methods:
+
+// Check whether the current browser supports the Web Serial API
+// https://developer.mozilla.org/en-US/docs/Web/API/Web_Serial_API#browser_compatibility
+WebSerialPort.isSupported() // true/false
+
+// request a serial connection from the user,
+// first param takes requestPort options: https://developer.mozilla.org/en-US/docs/Web/API/Serial/requestPort#parameters
+// second params takes the default open options 
+const serialport = WebSerialPort.requestPort({}, { baudRate: 115200 });
+serialport.open((err) => {
+  if (!err) serialport.write('hello', (err2) => ...)
+});
+
+// get a list of the serial connections that have already been requested:
+const list = WebSerialPort.list();
+
+// A wrapper util around SerialPort that exposes the same methods but with promises
+const serial = new SerialPortPromise(await WebSerialPort.requestPort());
+await serial.open();
+await serial.write('hello');
+
+// A Merged class of both WebSerialPort and SerialPortPromise, probably use this one
+const serial = WebSerialPortPromise.requestPort();
+await serial.open();
+await serial.write('hello');
+```
+
+### Upload return
+The upload function will return an object:
+```ts
+{
+  // the time it took to complete the upload
+  time: number
+  // the final serial port used. In most cases the serial port passes in
+  // if you pass in a non promise port, internally it will wrap with SerialPortPromise
+  // if you pass in a promise port, it is likely the same object, you can check with the serialport.key value on SerialPortPromise
+  // if using AVR109 and a reconnect is needed, this will likely be a new connection.
+  serialport: SerialPortPromise | WebSerialPortPromise
+}
+```
+
+
 ## Get in touch 
 You can contact me in the #multitool-general channel of the duinoapp discord
 

examples/index.html

@@ -5,7 +5,6 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <script src="../dist/index.umd.js"></script>
-    <script src="../dist/web-serialport.umd.js"></script>
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/css/xterm.css">
     <script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/xterm.js"></script>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/js-yaml/4.1.0/js-yaml.min.js"></script>
@@ -32,7 +31,7 @@ <h1>Upload Multitool</h1>
       <div id="terminal"></div>
     </div>
     <script>
-      const { isSupported, upload } = uploadMultitool;
+      const { isSupported, upload, WebSerialPort } = uploadMultitool;
 
       const setStatus = (status) => {
         document.getElementById('status').innerHTML = status;

package.json

@@ -1,5 +1,5 @@
 {
-  "name": "upload-multitool",
+  "name": "@duinoapp/upload-multitool",
   "version": "0.0.1",
   "description": "Micro Controller Uploading Multitool",
   "main": "dist/index.js",

rollup.config.js

@@ -33,29 +33,4 @@ module.exports = [{
     nodeResolve({ preferBuiltins: false }),
     json(),
   ],
-}, {
-  input: 'dist/serialport/web-serialport.js',
-  output: [
-    {
-      file: 'dist/web-serialport.cjs',
-      format: 'cjs',
-    },
-    {
-      file: 'dist/web-serialport.mjs',
-      format: 'esm',
-    },
-    {
-      file: 'dist/web-serialport.umd.js',
-      format: 'umd',
-      name: 'WebSerialPort',
-    },
-  ],
-  context: 'this',
-  plugins: [
-    commonjs({
-      ignoreGlobal: true,
-    }),
-    nodePolyfills({ include: ['buffer'] }),
-    nodeResolve({ preferBuiltins: false }),
-  ],
 }];

src/avr/avr109/avr109.ts

@@ -1,6 +1,6 @@
 import { SerialPort } from 'serialport/dist/index.d';
 import { SerialPortPromise } from '../../serialport/serialport-promise';
-import { waitForOpen, setDTRRTS } from '../../util/serial-helpers';
+import { waitForOpen, castToSPP } from '../../util/serial-helpers';
 import asyncTimeout from '../../util/async-timeout';
 import { StdOut } from '../../index';
 
@@ -97,7 +97,7 @@ export default class AVR109 {
     this.opts = opts || {};
     this.signature = this.opts.signature || 'LUFACDC';
     this.quiet = this.opts.quiet || false;
-    this.serial = serial instanceof SerialPortPromise ? serial : new SerialPortPromise(serial);
+    this.serial = castToSPP(serial);
 
     this.hasAutoIncrAddr = false;
     this.bufferSize = 0;
@@ -446,7 +446,7 @@ export default class AVR109 {
         .then((serial: SerialPort | SerialPortPromise) => {
           clearTimeout(timeoutId);
           if (timedOut) return;
-          resolve(serial instanceof SerialPortPromise ? serial : new SerialPortPromise(serial));
+          resolve(castToSPP(serial));
         })
         .catch(reject);
     });
@@ -476,12 +476,12 @@ export default class AVR109 {
       await this.serial.open();
       await waitForOpen(this.serial);
     }
-    console.log(this.serial?.port);
+    // console.log(this.serial?.port);
     if (this.serial.baudRate !== this.opts.speed) {
       await this.serial.update({ baudRate: this.opts.speed || 57600 });
     }
     await asyncTimeout(200);
-    console.log('reconnected', Date.now() - ts);
+    // console.log('reconnected', Date.now() - ts);
   }
 
   async exitBootloader() {

src/avr/stk500-v1/stk500-v1.ts

@@ -3,7 +3,7 @@
 
 import { SerialPort } from 'serialport/dist/index.d';
 import { SerialPortPromise } from '../../serialport/serialport-promise';
-import { setDTRRTS } from '../../util/serial-helpers';
+import { setDTRRTS, castToSPP } from '../../util/serial-helpers';
 import asyncTimeout from '../../util/async-timeout';
 import { StdOut } from '../../index';
 
@@ -76,7 +76,7 @@ export default class STK500v1 {
   constructor(serial: SerialPort | SerialPortPromise, opts: STK500v1Options) {
     this.opts = opts || {};
     this.quiet = this.opts.quiet || false;
-    this.serial = serial instanceof SerialPortPromise ? serial : new SerialPortPromise(serial);
+    this.serial = castToSPP(serial);
   }
 
   log (...args: any[]) {
@@ -169,7 +169,7 @@ export default class STK500v1 {
 
 
   async sync(attempts = 3, timeout = 400, ogAttempts = attempts): Promise<Buffer|null> {
-    this.log(`sync ${attempts}`);
+    this.log(`sync ${attempts} ${timeout}`);
     try {
       const res = await this.sendCommand({
         cmd: [

src/avr/stk500-v2/stk500-v2.ts

@@ -2,7 +2,7 @@ import { SerialPort } from 'serialport/dist/index.d';
 import { SerialPortPromise } from '../../serialport/serialport-promise';
 
 import statics from './constants';
-import { setDTRRTS } from '../../util/serial-helpers';
+import { setDTRRTS, castToSPP } from '../../util/serial-helpers';
 import asyncTimeout from '../../util/async-timeout';
 import { StdOut } from '../../index';
 
@@ -51,7 +51,7 @@ export default class STK500v2 {
 
   constructor(serial: SerialPort | SerialPortPromise, opts: STK500v2Options) {
     this.opts = opts;
-    this.serial = serial instanceof SerialPortPromise ? serial : new SerialPortPromise(serial);
+    this.serial = castToSPP(serial);
     this.quiet = opts.quiet || false;
     this.sequence = 0;
   }

src/esp/loader.ts

@@ -1,8 +1,9 @@
 import { SerialPort } from 'serialport/dist/index.d';
-import { SerialPortPromise } from '../serialport/serialport-promise';
 import pako from 'pako';
 import MD5 from 'crypto-js/md5';
 import encBase64 from 'crypto-js/enc-base64';
+import { SerialPortPromise } from '../serialport/serialport-promise';
+import { castToSPP } from '../util/serial-helpers';
 import StubLoader from './stub-loader';
 import roms from './roms/index';
 import ROM from './roms/rom.d';
@@ -90,7 +91,7 @@ export default class ESPLoader {
   constructor(serial: SerialPort | SerialPortPromise, opts = {} as ESPOptions) {
     this.opts = opts || {};
     this.quiet = this.opts.quiet || false;
-    this.serial = serial instanceof SerialPortPromise ? serial : new SerialPortPromise(serial);
+    this.serial = castToSPP(serial);
     this.IS_STUB = false;
     this.chip = null;
     this.stdout = opts.stdout || process?.stdout || {