Анализатор 10G ethernet

немного посовещавшись, мы решили, что хорошо бы добавить некоторые пояснения к процессу обновления программного обеспечения для Беркут-ETX.

потому что, как показали недавно проведённые бесчеловечные эксперименты, непосвящённому в детали пользователю обновить прошивку не так просто. успех ждёт, в среднем, с пятой попытки. не потому, что руки кривые или механизм обновления не работает. вовсе нет. всё дело, как обычно, в нюансах.

а нюансы следующие:

• выключить контроль потока (flow control) в терминальной программе
• не пытаться ввести ATR на выключенном приборе
• правильно нажимать на скрытую кнопку сброса (до лёгкого щелчка), удерживая нажатой клавишу on/off

обновлённая инструкция — вот.

юзер-гайды для Беркут-ET лежат тут, а для Беркут-ETX — здесь.

скачивайте самый свежий файл, не ошибётесь.

счастливых обладателей самых лучших в мире тестеров-анализаторов ethernet просим не стесняться, скачивать, читать и задавать вопросы.

Раз

Создаем .tex файл, например, booklet.tex следующего содержания:

\documentclass[a4paper]{article}
\usepackage[final]{pdfpages}
\begin{document}
\includepdf[pages=-, booklet, landscape]{имя_файла.pdf}
\end{document}


Два

Компилируем файл с помощью программы pdflatex:

pdflatex booklet.tex

В результате получаем нужный нам документ booklet.pdf.

Три

Распечатываем документ, выбрав двухстороннюю печать по длинной стороне. Вот и все, брошюра готова.

А теперь поподробнее о директиве \includepdf: она служит для вставки в .tex файл страниц pdf-документа в нужном для формирования брошюры виде. Обязательным параметром является имя преобразуемого pdf-документа. В качестве необязательных параметров можно передать номера страниц, которые мы хотим преобразовать в брошюру (pages=- означает, что нужно преобразовать все страницы документа). Параметр booklet служит для расположения двух страниц на листе, landscape устанавливает альбомную ориентацию страницы.

Основным условием тестирования было то, что тестировщиком должен быть человек, никогда ранее не читавший руководство и не проводивший асимметричный тест. Раздел руководства был распечатан и передан для предварительного изучения коллеге из отдела конструкторов, задачей которого было попытаться самостоятельно провести описанный в руководстве тест. Также было предоставлено все необходимое для подключения прибора по схеме, описанной в руководстве.

Итак, после того, как материал был изучен, прибор подключен в соответствии со схемой, осталось выполнить указания из руководства и провести анализ. Что, к сожалению, вызвало некоторые трудности, т.к. оказалось, что подробно были описаны не все настройки прибора.

В результате решили:
— по возможности описать все трудности, с которыми может столкнуться пользователь при настройке прибора;
— пореже отсылать пользователя к материалам, описанным в предыдущих разделах;
— увеличить количество поясняющих скриншотов;
— привести не абстрактный, а конкретный пример проведения тестирования.

Полученное описание снова было показано пользователю и признано более понятным. Но, как говорится, нет предела совершенству. ;)

Проведя такое «тестирование» документации мы ещё раз убедились в том, что не все то, что понятно программистам и техническому писателю понятно пользователю.

Итак, вперёд, к более подробной и, следовательно, понятной для пользователя документации!

P.S. Большое спасибо тестировщику за дельные советы и интересные идеи. :)
P.P.S. А еще оказалось, что тестирование руководства пользователя полезно и для программистов: в результате тестирования было решено упростить для понимания
пользователя один из пунктов меню прибора.

Результаты оказались очень и очень положительными. Время, которое было потрачено на то, чтобы разобраться с особенностями пакета bytefield, с лихвой окупилось полученным результатом. В качестве примера приведу картинку, изображающую структуру пакета IPv4, полученную с использованием возможностей пакета bytefield:

Текст документа для получения этой красивой картинки:

    \setlength{\bitwidth}{3.5mm}
    \setlength{\byteheight}{10mm}

    \begin{bytefield}{32}
    \bitheader{0,3,4,7,8,15,16,18,19,31}\\
    \wordgroupr{Header}
    \bitbox{4}{Version} &
    \bitbox{4}{Header length} &
    \bitbox{8}{Differentiated Services} &
    \bitbox{16}{Total Length}\\
    \bitbox{16}{Identification} &
    \bitbox{3}{Flags} &
    \bitbox{13}{Fragment Offset}\\
    \bitbox{8}{Time to Live} &
    \bitbox{8}{Protocol} &
    \bitbox{16}{Header Checksum}\\
    \bitbox{32}{Source Address} \\
    \bitbox{32}{Destination Address} \\
    \bitbox{32}{Options (if Header Length > 5)}
    \endwordgroupr \\
    \bitbox{32}{Data}\\
    \end{bytefield}

Для получения цветной картинки нужно:

• определить команду \colorbitbox:

      \newcommand{\colorbitbox}[3]{%
      \rlap{\bitbox{#2}{\color{#1}\rule{\width}{\height}}}%
      \bitbox{#2}{#3}}
  

• определить цвета:

      \definecolor{lightpink}{rgb}{1,0.7,0.7}
      \definecolor{lightcyan}{rgb}{0.84,1,1}
      \definecolor{peachpuff}{rgb}{1,0.85,0.73}
  

• вместо команды \bitbox использовать команду \colorbitbox, например:

      \colorbitbox{peachpuff}{4}{Version}
  

  (вместо \bitbox{4}{Version})