Share
Embed
WebUSBでレイヤーが低まるWeb開発
Chrome 61から使えるようになったWebUSB APIを使ってUSBデバイスと会話する方法を解説します。
これは2017年9月23日に行われた 第3回 カーネル/VM探検隊@北陸の発表資料です。
Fadis
September 23, 2017
Transcript
38 slides
-
σόΠεΛऔಘ͢Δ return navigator.usb.requestDevice( { 'filters': [ { 'vendorId': 0x1234, 'productId':
0x5678 } ] } ).then(device_ => { device = device_; return connect(); }).catch(error => { console.log('ଓΤϥʔ: ' + error); }); navigator.usb.requestDevieͰ ࢦఆͨ͠ϕϯμIDͱϓϩμΫτIDΛ࣋ͭ USBσόΠεͷଓΛཁٻ͢Δ -
௨৴Ͱ͖Δঢ়ଶʹ͢Δ return device.open().then(() => { if(device.configuration === null) { return
device.selectConfiguration(1); } }).then(() => { return device.claimInterface(1); }).then(() => { return device.claimInterface(0); }); configurationΛબͿ USBσόΠεෳͷػೳΛఏڙ͍ͯ͠Δ͜ͱ͕͋Δ ͲͷػೳΛ͏͔ΛબͿͷ͕configurationͷબ ඞཁͳΠϯλʔϑΣʔεΛ༗͢Δ -
σόΠεʹσʔλΛૹΔ/͏ device.transferIn(1, 1024).then(result => { something_on_recieved( result.data ); } σόΠε͔Βड৴
σόΠεʹૹ৴ ΤϯυϙΠϯτID ड৴͢ΔόΠτ PromiseͰड৴݁ՌͱDataView͕ฦͬͯདྷΔ device.transferOut(2, data).then(result => { something_on_sent(); } ΤϯυϙΠϯτID ૹ৴͢ΔArrayBuffer PromiseͰૹ৴݁Ռ͕ฦͬͯདྷΔ -
σόΠεʹσʔλΛૹΔ/͏ device.controlTransferOut({ 'requestType': 'class', 'recipient': 'interface', 'request': 0x22, 'value': 0x01,
'index': 0x00 }).then(result => { … } ίϯτϩʔϧసૹ device.controlTransferIn({ 'requestType': 'standard', 'recipient': 'device', 'request': 0x06, 'value': 0x0100, 'index': 0x0000 }, 0x12).then(result => { … } σόΠεͷใͷऔಘ σόΠεͷॳظԽΛߦ͏ -
$ modprobe libcomposite $ modprobe dummy_hcd $ cd /sys/kernel/config/usb_gadget $
mkdir g1 $ cd g1 $ mkdir functions/acm.g1 $ mkdir configs/c.1 $ ln -s functions/acm.g1 configs/c.1 $ echo 0x1234 >idVendor $ echo 0x5678 >idProduct $ echo dummy_udc.0 >UDC $ sleep 1 $ modprobe -r cdc_acm $ agetty 115200 ttyGS0 LinuxͷUSB GadgetͰ CDC ACMͷγϦΞϧ௨৴σόΠεΛ࡞Γ σόΠεଆͰgetty͢Δ ϗετଆυϥΠόΞϯϩʔυ͓ͯ͘͠ -
function flush() { writing = true; let buffer_ = buffer;
buffer = ''; device.transferOut(2, textEncoder.encode(buffer_)).then( result => { writing = false; if( buffer.length != 0 ) { flush(); } }).catch(error => { console.log(‘ૹ৴Τϥʔ: ' + error); writing = false; if( buffer.length != 0 ) { flush(); } }); } t.open( document.getElementById('terminal') ); t.on('key', function (key, ev) { if(device !== undefined) { if( !writing ) { buffer += key; flush(); } else { buffer += key; } } }); xterm.jsʹΩʔೖྗ͕͋ͬͨΒ ΤϯυϙΠϯτʹೖྗ༰Λྲྀ͢ -
let readLoop = () => { if( device ) {
device.transferIn(1, 1024).then(result => { let textDecoder = new TextDecoder(); t.write(textDecoder.decode(result.data)); readLoop(); }, error => { console.log( error ); readLoop(); }); } }; ΤϯυϙΠϯτ1Ͱ σόΠε͔ΒͷσʔλΛͪड͚ Կ͔ड͚औͬͨΒxterm.jsʹྲྀ͢ -
͜ͷUSBϑϥογϡϝϞϦΛ ϒϥβ͔ΒಡΉ $ modprobe -r uas $ modprobe -r mass_storage
·ͣΧʔωϧ͕अຐΛ͠ͳ͍Α͏ʹ͓ͯ͘͠ -
Command Block Wrapper SCSIίϚϯυ Command State Wrapper ίϚϯυͷ࣮ߦ݁Ռ ίϚϯυʹਵ͢Δ σʔλΛૹड৴
Bulk Only Transport ࡉ͔͍ετϨʔδͷૢ࡞ํ๏SCSIͦͷ·· -
Command Block Wrapper let cbw = ( tag, len, dir,
command ) => { let data = new Uint8Array( 15 + 16 ); data.set([ 0x55, 0x53, 0x42, 0x43, // USBC tag & 0xFF, ( tag >> 8 ) & 0xFF, ( tag >> 16 ) & 0xFF, ( tag >> 24 ) & 0xFF, // tag len & 0xFF, ( len >> 8 ) & 0xFF, ( len >> 16 ) & 0xFF, ( len >> 24 ) & 0xFF, // len dir << 7, // flags 0, // LUN command.byteLength // command length ], 0); data.set( command, 15 ); return device.transferOut( 2, data ); } 4$4*ίϚϯυʹ $#8ͷ ϔομΛ͚ͭͯ σόΠεʹ͛Δ -
Command State Wrapper let csw = () => { return
device.transferIn( 1, 13 ).then( result => { let state = result.data.getUint8( 12 ); return state == 0; } ); } ίϚϯυͷ࣮ߦ݁ՌΛσόΠε͔Βड͚औΔ -
ετϨʔδΛಡΉͷʹඞཁͳSCSIίϚϯυ INQUIRY TEST UNIT READY State? READ CAPACITY(10) READ(10) OK
* -6/ʹσόΠε͕ ͋Δ͜ͱΛ֬ೝ σόΠε͕ ར༻ՄೳʹͳΔͷΛͭ σόΠεͷ༰ྔͱ ηΫλαΠζΛऔಘ σόΠε͔Β σʔλΛಡΈग़͢ -
let inquiry = () => { let command = new
Uint8Array([ // INQUIRY LUN reserved reserved size reserved 0x12, 0, 0, 0, 36, 0 ]); return cbw( 1, 36, 1, command ).then( result => { return device.transferIn( 1, 36 ); }).then( result => { return result.data; }).then( data => { return csw().then( stat => { return { 'status': stat, 'data': data } }); }); } ඞཁͳSCSIίϚϯυΛ࣮͍ͯ͘͠ -
BIOSύϥϝʔλϒϩοΫ FAT32ͷϔομ 46 41 54 33 32 20 20 20
F A T 3 2 _ _ _ -
FAT32 let load_fat32 = partition => { return read( partition.at,
1 ).then( result => { let cluster_size = result.data.getUint8( 13 ); let reserved_sector_size = result.data.getUint16( 14, true ); let num_fats = result.data.getUint8( 16 ); let rde_size = result.data.getUint16( 17, true ); let fat_size = result.data.getUint32( 36, true ); let rde = result.data.getUint32( 44, true ); let fat_lba = partition.at + reserved_sector_size; return read( fat_lba, fat_size ).then( result => { let len = result.data.byteLength / 4; let fat = new Uint32Array( len ); for( let i = 0; i != len; i++ ) { fat[ i ] = result.data.getUint32( i * 4, true ); } let clusters_lba = fat_lba + num_fats * fat_size; let fsinfo = { 'cluster_size': cluster_size, 'fat': fat, 'clusters_lba': clusters_lba, 'rootdir_entry': rde BIOSύϥϝʔλϒϩοΫ͔Β ϑΝΠϧγεςϜΛಡΉͷʹඞཁͳΛऔಘ ΫϥελαΠζ FATͷͱαΠζͱ։࢝ηΫλ ϧʔτσΟϨΫτϦ͕ॻ͔Ε͍ͯΔҐஔ -
FAT32 result.data.getUint16( 14, true ); let num_fats = result.data.getUint8( 16
); let rde_size = result.data.getUint16( 17, true ); let fat_size = result.data.getUint32( 36, true ); let rde = result.data.getUint32( 44, true ); let fat_lba = partition.at + reserved_sector_size; return read( fat_lba, fat_size ).then( result => { let len = result.data.byteLength / 4; let fat = new Uint32Array( len ); for( let i = 0; i != len; i++ ) { fat[ i ] = result.data.getUint32( i * 4, true ); } let clusters_lba = fat_lba + num_fats * fat_size; let fsinfo = { 'cluster_size': cluster_size, 'fat': fat, 'clusters_lba': clusters_lba, 'rootdir_entry': rde }; return load_fat32file( fsinfo, fsinfo.rootdir_entry, 0 ).then( raw_root_dir => { let root_dir = parse_fat32directory( raw_root_dir ); FATʹ ࠓಡΜͰ͍ΔΫϥελͷ࣍ʹಡΉ͖Ϋϥελ͕ Ͳ͔͕͜ه͞Ε͍ͯΔ FATΛಡΉ -
FAT32 let fat = new Uint32Array( len ); for( let
i = 0; i != len; i++ ) { fat[ i ] = result.data.getUint32( i * 4, true ); } let clusters_lba = fat_lba + num_fats * fat_size; let fsinfo = { 'cluster_size': cluster_size, 'fat': fat, 'clusters_lba': clusters_lba, 'rootdir_entry': rde }; return load_fat32file( fsinfo, fsinfo.rootdir_entry, 0 ).then( raw_root_dir => { let root_dir = parse_fat32directory( raw_root_dir ); fsinfo[ 'rootdir' ] = root_dir; return fsinfo; }); }); }); }; ϧʔτσΟϨΫτϦΛಡΉ -
let get_fat32clusters_reversed = ( fsinfo, head ) => { let
next = fsinfo.fat[ head ] & 0x0FFFFFFF; if( next >= 0x00000002 && next <= 0x0ffffff6 ) { let tail = get_fat32clusters_reversed( fsinfo, next ); tail.push( head ); return tail; } else return [ head ]; }; ΫϥελνΣΠϯ FAT͔ΒಡΉඞཁ͕͋ΔΫϥελΛௐͯ -
let get_fat32clusters = ( fsinfo, head ) => { let
clusters = get_fat32clusters_reversed( fsinfo, head ); clusters.reverse(); let chunks = [ { 'at': clusters[ 0 ], 'length': 1 } ]; for( let i = 1; i != clusters.length; i++ ) { if( clusters[ i - 1 ] + 1 == clusters[ i ] ) { chunks[ chunks.length - 1 ].length++; } else { chunks.push( { 'at': clusters[ i ], 'length': 1 } ); } } return chunks; } ΫϥελνΣΠϯ ࿈ଓͨ͠Ϋϥελ·ͱΊͯ -
let load_fat32cluster = ( fsinfo, chunks, index, data ) =>
{ let lba = fsinfo.clusters_lba + ( chunks[ index ].at - 2 ) * fsinfo.cluster_size; return read( lba, chunks[ index ].length * fsinfo.cluster_size ).then( result => { data.push( result.data ); if( index + 1 < chunks.length ) { return load_fat32cluster( fsinfo, chunks, index + 1, data ); } else return data; }); } ΫϥελνΣΠϯ READ(10) -
let parse_fat32directory = ( data ) => { let files
= []; let lfn = []; for( let offset = 0; offset != data.byteLength; offset += 32 ) { let entry = data.subarray( offset, offset + 32 ); let attribute = entry[ 11 ]; let sfn_head = entry[ 0 ]; if( sfn_head == 0x00 ) { break; } else if( sfn_head == 0xE5 ) { continue; } else if( attribute == 0x0F ) { let fragment = new Uint8Array( 26 ); fragment.set( entry.subarray( 1, 11 ), 0 ); fragment.set( entry.subarray( 14, 26 ), 10 ); fragment.set( entry.subarray( 28, 32 ), 22 ); lfn.push( fragment ); σΟϨΫτϦΤϯτϦ ͦΜͳʹෳࡶ͡Όͳ͍ͷͰؾ߹͍Ͱύʔε͢Δ