Представительная линия: Мы все... Заметка
The Daily WTF на русском

Представительная линия: Мы все это регистрируем

Автор противопоставляет разочарования от плохой документации к программному обеспечению еще большим трудностям, связанным с плохо написанными техническими описаниями аппаратного обеспечения. Нахождение точной и полной документации для интегральных схем имеет решающее значение для разработчиков. Технические описания часто бывают неполными, неточными или даже на разных языках. Сложность современных чипов требует подробных технических описаний, но некоторые поставщики предоставляют недостаточную информацию, вынуждая пользователей проводить обратное проектирование функциональности. Расхождения между техническими описаниями и фактическим поведением чипа могут привести к критическим ошибкам, таким как неправильное определение выводов питания и повреждение компонентов. Хотя некоторые поставщики производят превосходные технические описания, соображения стоимости в области встраиваемых систем часто приводят к плохо документированному аппаратному обеспечению. Автор рассказывает о конкретном случае, когда в техническом описании чипа был описан "Регистр включения суперпользовательской фантастической функции". Этот регистр был с юмором сокращен до "SUFFER" (страдать), отражая опыт разработчика с трудными встраиваемыми проектами. Включение этой функции предназначалось для опытных пользователей, чтобы изменять поведение отладки. Значение сброса для этого регистра было всеми единицами, что указывало на то, что он был включен по умолчанию. Название регистра "SUFFER" точно отражает ощущение от работы с такой сложной документацией.