ドキュメントの問題へ

（PPトランスレーターによる注意-問題は私たちだけにあり、データシートにパラメーターが表示されない場合は、それらの読み方がわからないか、日付が間違っており、実際の日付がどこかにあることを望んでいました。ジャックは、私が最も正しい日付にアクセスできることを望んでおり、本当にすべてが非常に悪いことを意味します）。



サプライヤーは、説明に一致するコンポーネントの納入を保証する必要がありますか？ そしてその逆に、実際のコンポーネントと一致する記述を達成する方法は？



最近、エンジニアからいくつかの手紙を受け取りました。エンジニアからは、さまざまなコンポーネントが正常に機能しないことがわかりました。 この現象は新しいものとは言えません。1970年代に、NECが最初のフロッピーディスクコントローラを作成した方法を覚えています。 いくつかのレジスタの説明が間違っていました。 そのとき、最も頻繁に使用されるビットを反転して説明するか、移動するというジョーク（涙による笑いの例）がありました。 この問題は、当業界で多かれ少なかれ長い間働いていたすべての人が直面していました。



昔は、コンポーネントは単純で、説明は短いものでした。 単純なコンポーネントを完全に記述することは難しくありません。 現在、7404ギアインバーターでも27ページの技術的な説明があります！



MCUとSoCはもう少し複雑です。 小型の8ビットデバイスには、数百ページの仕様があります。 より複雑なデバイスの場合、数千を要する場合があります。 人は完璧ではないので、ドキュメンテーションの優秀さをどのように期待できますか？



ただし、技術的な説明が保証されていることが不可欠です。 文書に示されているようにコンポーネントを使用した場合、サプライヤーは機能することを確認する必要があります。



通常、データテーブルは正しくありません。 多くの場合、コンポーネント自体には欠点があります。 ある特派員は、通常の8ビットMCUでは、数十の命令のうちの1つが正しく機能しないと不満を述べました。 プロバイダーは、「他の誰もアセンブラーを使用しておらず、Cコンパイラーはこの命令を使用していない」と回答しました。



技術的な説明が動作の保証ではなくなった場合、なぜそれが必要なのですか？



エラーを発見した顧客はこれをサプライヤに報告できます。サプライヤはコンポーネント/ドキュメントを修正するか、エラーシートを発行します。 しかし、もう1つのよくある不満は、少なくとも一部のプロバイダーがヘルプのリクエストに応答しないことです。 今日、多くの場合、サポートフォーラムにリダイレクトされます。ここでは、ほとんどの「サポート」が他のクライアントによって提供されます（PP-多くのフォーラムには会社の代表者がいます。 顧客とのコミュニケーションは、会社によってまったく考慮されない場合があります。 フォーラムはプロバイダーにとって非常に効果的ですが、多くの場合ユーザーのニーズを満たしません。



日付が最大tPLHが22 nsであることを示す7404を使用する場合、コンポーネントが正しく使用されていれば、指定された値より遅くなることは決してないはずです。 たとえば、どのモードでもMCUタイマーの動作に自信を持ってはいけませんか？



何が起きているのか、どう感じますか？ そして、メーカーの意見を聞きたいと思います（匿名の条件で可能です）。



（PPは、国内企業の開発者との私の典型的な会話です。「ページの説明に間違いがあります。ありがとうございます。」」サイトを再設計する時間）



PP他のメーカーは大いにen望し始めており、ドキュメントの品質を上げることを余儀なくされています。