開発ツール on KnightLiブログ

CH347 開発用の共通リソースのコレクション: ドライバー、ツール、SPI フラッシュフラッシュ

Fri, 03 Apr 2026 10:00:00 +0800

この記事では、箱から出してすぐにデバッグとフラッシュを開始できるようにすることを目的として、CH347 を使用するときに最も頻繁に使用する一連のリソースをコンパイルします。

CH347 を初めて使用する場合は、次の順序で環境を準備することをお勧めします。

まずは公式商品ページをご覧いただき、記載内容をご確認ください
目的に応じて対応するドライバーをインストールしてください
SPI Flash フラッシュツールを準備し、接続検証を実行する

正式な入り口

CH347商品ページ：https://www.wch.cn/products/CH347.html

不明なソースや古いバージョンからドライバーパッケージを入手することを避けるために、最初に公式ページからダウンロードエリアにアクセスすることをお勧めします。

よく使用されるドライバー

1) `CH341PAR.EXE`

使用：

USB to JTAG / SPI / I2C / パラレルポート / GPIO およびその他のインターフェイスドライバー

該当するシナリオ:

マルチプロトコル通信や低レベルインターフェースのデバッグにCH347を使用する必要がある場合

2) `CH343SER.EXE`

使用：

USB から高速シリアルポートへの Windows 製造元のドライバー

該当するシナリオ:

主に CH347 をシリアルポートツールとして使用し、より高いシリアルポートレートを必要とします。

SPIフラッシュフラッシュツール

AsProgrammer：https://github.com/nofeletru/UsbAsp-flash

一般的な用途:

SPI NOR フラッシュの識別
チップIDの読み取り
元のファームウェアをバックアップする
ファームウェアの消去/書き込み/ベリファイ

推奨される操作順序 (落とし穴を避けるため)

ドライバーのインストール後、デバイスを抜き差しし、デバイスマネージャーを開いて正常に認識されるか確認してください。
初めてフラッシュする前に、「読み取り + バックアップ」を実行して元のコンテンツを保持します。
書き込み後は必ずご確認ください。「書き込みが成功しました」というプロンプトだけを見てはいけません。
チップが認識できない場合は、電源、レベル、配線を確認し、その後ソフトウェア構成を確認してください。

FFmpeg の `-map` パラメータの詳細な説明: ビデオ、オーディオ、および字幕ストリームの正確な選択

Thu, 02 Apr 2026 23:14:03 +0800

マルチオーディオトラックおよびマルチ字幕ビデオ処理では、-map は FFmpeg の最も重要で最も誤用されやすいパラメータの 1 つです。

-map を明示的に指定しない場合、FFmpeg はデフォルトのルールに従ってストリームを自動的に選択するため、多くの場合、期待した結果が得られません。例えば：

エクスポートすると字幕が失われる
間違ったオーディオトラック言語が選択されました
不要なデータストリームが混入している

この記事では、最も一般的なシナリオを使用して、-map の使用方法を説明します。

まずは「流れ」とは何かを理解する

通常、コンテナーファイルには複数のコンテンツストリーム (ストリーム) が存在します (mp4、mkv など)。一般的なものには次のようなものがあります。

ビデオストリーミング (v)
オーディオストリーム (a)
字幕ストリーム (s)
添付ファイル/データストリーム (フォント、表紙、章など)

まず ffprobe を使用して、ファイル内にどのようなストリームがあるかを確認できます。

`1`	`ffprobe -hide_banner input.mkv`

`-map` の基本構文

最も一般的な書き方は次のとおりです。

`1`	`-map input_index[:stream_type][:stream_index]`

例えば：

0:v: 1 番目の入力ファイルのすべてのビデオストリーム
0:a:0: 入力ファイル 1 のオーディオストリーム 1
1:s:1: 2 番目の入力ファイルの 2 番目の字幕ストリーム

例証します:

input_index は 0 から始まり、-i のシーケンスに対応します。
stream_index も 0 で始まります

実践例

1) ビデオは A から、音声は B から来ます

ffmpeg -i english.mp4 -i french.mp3 \
  -map 0:v:0 -map 1:a:0 \
  -c:v copy -c:a aac \
  french.mp4

意味：

english.mp4 の最初のビデオストリームを取得します
french.mp3 の最初のオーディオストリームを取得します
結合された出力は french.mp4 です。

2) 最初の入力のすべてのストリームを保持し、追加のオーディオトラックを追加します。

ffmpeg -i english.mp4 -i french.mp3 \
  -map 0 -map 1:a:0 \
  -c copy \
  english-french.mp4

意味：

-map 0 まず、すべてのストリームを最初の入力ファイルに取り込みます
2 番目の入力の最初のオーディオストリームを追加します

非常に実践的な 2 つの高度なテクニック

1) ネガティブマッピング: 不要なフローを除外します。

たとえば、最初の入力のすべてのストリームを保持しますが、2 番目のオーディオストリームを削除します。

`1`	`ffmpeg -i input.mkv -map 0 -map -0:a:1 -c copy output.mkv`

2) オプションのマッピング: ストリームは存在せず、中断されません。

一部のファイルには字幕がない場合があります。その場合は、? を使用できます。

`1`	`ffmpeg -i input.mp4 -map 0:v -map 0:a -map 0:s? -c copy output.mp4`

0:s? は、「字幕がある場合はマップし、字幕がない場合はスキップし、エラーは報告されない」ことを意味します。

一般的なピットの位置

-map を使用すると、FFmpeg はデフォルトでストリームを自動的に選択しなくなるため、必要なものをすべて書き出す必要があります。
-c copy は、トランスコーディングを行わずにカプセル化とコピーのみを行います。ターゲットコンテナが特定のエンコーディングをサポートしていない場合でも、失敗します。
複数の入力を入力するときに最もよくある間違いは、シリアル番号を入力することです。シリアル番号は -i の順序にのみ依存することに注意してください。
安定したスクリプトを作成したい場合は、まず ffprobe を作成し、次に手書きよりも安定した -map を生成します。

要約する

-map の中核は 1 つの文です。「どの入力から、どのタイプのストリームを取得し、どのストリームを取得するか」を FFmpeg に明確に指示します。

マスタリング後は、複数のオーディオトラック、複数の字幕、ファイル間の結合などの複雑なシーンを安定して処理できるようになり、「エクスポート結果が間違っているが原因がわからない」という問題を回避できます。

プラグインによって引き起こされる VS Code の高い CPU 使用率をトラブルシューティングする方法

Wed, 01 Apr 2026 00:00:00 +0000

VS Code が突然フリーズしたり、ファンが激しく回転したり、CPU が長時間占有されたりした場合、最も一般的な原因は通常、エディタ自体ではなく、拡張プラグインの競合またはプラグインの異常な動作です。

この記事では、問題を特定するために最も時間を節約できる方法を優先して、すぐに実行できる一連のトラブルシューティングパスを示します。

最初に最速の位置決めを実行します: Extension Bisect を開始します

Start Extension Bisect の核となるアイデアは次の二項対立です。各ラウンドでは、拡張機能の半分が一時的に無効になり、再起動されます。「問題がまだ存在するかどうか」というフィードバックを通じて、疑わしいプラグインが見つかるまで範囲がすぐに狭められます。

操作手順:

Ctrl+Shift+P (macOS では Cmd+Shift+P) を押してコマンドパネルを開きます。
Start Extension Bisect を入力して実行します。
再起動するたびに、CPU 使用率とフリーズが再発するかどうかを観察します。
数回繰り返すと、VS Code によって疑わしい拡張機能のリストが表示されます。

位置決め後に何をするか

疑わしいプラグインを見つけたら、次の順序で対処することをお勧めします。

まずプラグインを最新バージョンに更新してください。
改善が見られない場合は、プラグインを一時的に無効にして 1 ～ 2 日間観察してください。
置き換え可能な機能を持つプラグインについては、より軽量なソリューションへの置き換えが優先されます。
このプラグインを使用する必要がある場合は、その詳細設定を確認し、不要なリアルタイム分析、インデックス作成、または監視機能をオフにしてください。

見落とされがちな2つの「増幅器」

主な原因がプラグインである場合でも、次の構成により CPU の問題が増幅されます。

検索範囲が大きすぎます
たとえば、ビルド製品、依存関係ディレクトリ、ログディレクトリをグローバル検索に含めると、引き続きプラグインとファイルインデックスに高い負荷がかかります。
ファイル監視には大きなディレクトリまたはソフトリンクが含まれています
ソフトリンク、キャッシュディレクトリ、および自動生成されたディレクトリは、簡単に多数のファイルイベントをトリガーし、拡張機能が繰り返し動作する可能性があります。

ディレクトリは、settings.json で適切に除外できます。たとえば、次のようになります。

{
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true,
    "**/build": true
  },
  "files.watcherExclude": {
    "**/.git/objects/**": true,
    "**/node_modules/**": true,
    "**/dist/**": true
  }
}

提案をレビューする

問題のあるプラグインを見つけた場合は、プラグイン名、トリガーとなるシナリオ、最終的な処理方法の 3 つの情報を記録することをお勧めします。
このようにして、次回環境を移行するかシステムを再インストールするときに、同様の問題をすぐに回避できます。

要約する

VS Code の高い CPU 使用率をトラブルシューティングするには、最初に Start Extension Bisect を使用して迅速に特定し、次に検索範囲とファイル監視範囲を組み合わせて収束させるのが最も効果的です。
最初に配置を決めてから最適化する方が、「多数のプラグインをやみくもに無効にする」よりも時間を節約でき、安定性も高くなります。

開発ツール on KnightLiブログ

CH347 開発用の共通リソースのコレクション: ドライバー、ツール、SPI フラッシュ フラッシュ

正式な入り口

よく使用されるドライバー

1) CH341PAR.EXE

2) CH343SER.EXE

SPIフラッシュフラッシュツール

推奨される操作順序 (落とし穴を避けるため)

FFmpeg の `-map` パラメータの詳細な説明: ビデオ、オーディオ、および字幕ストリームの正確な選択

まずは「流れ」とは何かを理解する

-map の基本構文

実践例

1) ビデオは A から、音声は B から来ます

2) 最初の入力のすべてのストリームを保持し、追加のオーディオ トラックを追加します。

非常に実践的な 2 つの高度なテクニック

1) ネガティブ マッピング: 不要なフローを除外します。

2) オプションのマッピング: ストリームは存在せず、中断されません。

一般的なピットの位置

要約する

プラグインによって引き起こされる VS Code の高い CPU 使用率をトラブルシューティングする方法

最初に最速の位置決めを実行します: Extension Bisect を開始します

位置決め後に何をするか

見落とされがちな2つの「増幅器」

提案をレビューする

要約する

CH347 開発用の共通リソースのコレクション: ドライバー、ツール、SPI フラッシュフラッシュ

1) `CH341PAR.EXE`

2) `CH343SER.EXE`

`-map` の基本構文

2) 最初の入力のすべてのストリームを保持し、追加のオーディオトラックを追加します。

1) ネガティブマッピング: 不要なフローを除外します。