= __Программное обеспечение блока MC04-DSL-3U__ =

== Будьте в курсе ==

Следите за сообщениями в нашем [blog: блоге] чтобы быть в курсе новостей программного обеспечения MC04-DSL-3U. Вы можете подписаться на [https://trac.adc-line.ru/cgi-bin/mailman/listinfo/mc04-dsl-3u-announce e-mail рассылку] об обновлениях программного обеспечения или следить за обновлениями с помощью  ленты [[Image(rss.gif, link=https://trac.adc-line.ru/sw-01/blog?format=rss, title=лента RSS, middle)]]. Также Вы можете просмотреть [http://trac.adc-line.ru/pipermail/mc04-dsl-3u-announce/ архив рассылки].

[[BlogList(recent=3, max_size=250, format=inline, heading=Последние посты в блоге:)]]

=== Последние изменения в коде sw ===

[[ChangeLog(sw:/, 3)]]

== Если Вы нашли баг ==

Если Вы считаете, что обнаружили ошибку в работе платы SW-01 или аппаратуры MC04-DSL-3U в целом, воспользуйтесь нашей системой контроля багов (bug tracking system). Вот несколько простых правил, следуя которым Вы сможете сообщить нам максимум полезной для обнаружения и исправления бага информации.

1. Убедитесь, что используете последние ревизии программного обеспечения. При необходимости обновите ПО аппаратуры. Возможно, что ошибка, с которой вы столкнулись, уже была исправлена.
1. '''Используйте поиск'''. Возможно, что ошибка, с которой вы столкнулись, нам уже известна, и по ней уже заведена карточка (ticket) в нашей системе. Воспользуйтесь [/search поиском] чтобы найти информацию о вашей проблеме. Возможно, она нами уже решена. Если Вы нашли карточку по вашей проблеме, и у Вас есть дополнительная информация, добавьте комментарий к существующему тикету. Если Вы не смогли найти карточку по вашей проблеме, создайте [/newticket новую карточку]. Пожалуйста, '''не создавайте''' новую карточку, если она дублирует существующую.
1. '''Подробно опишите проблему'''. Напишите, что и при каких обстоятельствах Вы делали, что ожидали получить в результате и что получили на самом деле. Чем подробнее будет описание, тем выше вероятность, что ситуацию удастся воспроизвести разработчикам.
 a. '''Укажите ревизию''' ПО платы, с которой наблюдается проблема. Ревизии ПО плат можно посмотреть на вкладке "Обновление ПО" веб-страницы аппаратуры. Если проблема возникла в результате обновления ПО (или сразу после него), укажите, '''с какой''' и '''на какую''' ревизии выполнялось обновление.
 a. '''Приложите скриншот''' страницы браузера, если баг связан с пользовательским интерфейсом (неправильно отображается веб-страница блока). Укажите название и версию браузера.
 a. '''Будьте точны в деталях'''. Старайтесь избегать общих фраз, например "''не работает ethernet''" или "''Выдается ошибка''". Вместо этого напишите "''нет прохождения пакетов ethernet из порта 8 в порт 9, хотя линк на обоих портах индицируется''" или "''после нажатия "OK" выдается ошибка "Число каналов DSL A должно быть в диапазоне 2...88''". Если возможно, копируйте сообщение об ошибке в текст карточки из окна браузера, а не пересказывайте его своими словами. Это позволит сэкономить ваше время и время разработчиков, затраченное на дополнительные уточнения.
 a. '''Приложите файл(ы) конфигурации''', если проблема связана непосредственно с работой аппаратуры. Для получения файла сначала нажмите кнопку "Сохранить конфигурацию", затем, после получения сообщения "Конфигурация успешно сохранена", нажмите кнопку "Скачать сохраненную конфигурацию" в левом верхнем углу веб-страницы аппаратуры.
 a. '''Приложите системные логи''', если проблема связана непосредственно с работой аппаратуры или обновлением ПО. Получить их можно с помощью кнопки "Журналы" на вкладке "Разное" веб-страницы аппаратуры. Если прикладываете журнал, проверьте, верное ли время показывают системные часы блока. Посмотреть системное время можно на вкладке "Часы" веб-страницы аппаратуры. Если системное время существенно отличается от истинного, укажите величину отставания или опережения. Это упростит анализ логов и позволит точнее сопоставить информацию системных журналов разных блоков.
1. '''Оставьте контактную информацию'''. Если Вы еще этого не сделали, укажите ваш адрес e-mail на странице [/prefs Предпочтения], это позволит Вам получать уведомления об изменении состояния карточек или появления новых комментариев, в которых у Вас могут попросить уточняющую информацию.
1. '''Создавайте один тикет на одну проблему'''. Не описывайте в одном тикете сразу несколько проблем (если нет веских оснований считать, что эти проблемы связаны и вызваны одной причиной) - это затруднит последующее отслеживание решения этих проблем. Создайте одтельные тикеты по каждой проблеме. В описании тикета или комментарии к нему можете дать ссылку на другие тикеты, если их описание может дополнить картину происходящего, например: "//См. также #2, #7//".
Обратите внимание, что для плат VE-01/VE-02 существует [ve: отдельный проект]. Об ошибках в работе этих плат сообщайте, пожалуйста, туда.

== Полезные хитрости (для экспертов): ==
- Обновление ПО ПЛИС {{{fpgactl -f /usr/share/sw/sw.rbf}}}
- Посмотреть законфигурирована ли ПЛИС {{{fpgactl -s}}}
- Резет кассеты {{{spictl 81 01 00 00}}}
- Лог swd:{{{cat /var/permlog/messages}}}
- Для того чтобы процесс swd не запускался повторно (если его убить) нужно создать файл {{{/tmp/restarting-swd}}}
- Вывод лога в реалтайме с грепом по слоту:  {{{swd -d 2>&1 |grep 'slot 01'}}}
- Команды мониторинга [[attachment:monitoring.txt]]. Например, запрос миба платы из браузера{{{ http://192.168.0.215/api.php?json={"cmd":"getMIB","slot":15} }}}
- Полный snmp oid {{{1.3.6.1.4.1.32109.9999.4.<slot>.<oid>}}}