Browse Source

Обновить 'README.md'

mtroshechkin 2 years ago
parent
commit
fbc6ffb9f4
1 changed files with 22 additions and 6 deletions
  1. 22 6
      README.md

+ 22 - 6
README.md

@@ -2,6 +2,21 @@
 Сборка осуществляется командой `make HARDWARE=<hw> VERBOSE=1 DEBUG=0 PRINTF=custom MAC=<mac_adr>`
 Сборка осуществляется командой `make HARDWARE=<hw> VERBOSE=1 DEBUG=0 PRINTF=custom MAC=<mac_adr>`
 Пример: `make HARDWARE=bt6711_v1 VERBOSE=1 DEBUG=0 PRINTF=custom MAC=EC-4C-4D-00-EE-DC`
 Пример: `make HARDWARE=bt6711_v1 VERBOSE=1 DEBUG=0 PRINTF=custom MAC=EC-4C-4D-00-EE-DC`
 
 
+Данный репозиторий является единой кодовой базой для всех устрйоств линейки BT-67xx, сборка под каждое устройство определяется параметрами команды `make`. Коды поддерживаемых устройств перечислены в файле `jenkins-env.groovy` (переменная devices = []). Эти же коды используются в релизных тегах.
+#### ВНИМАНИЕ! 
+Коды для команды make отличаются. Они должны быть написаны ТОЛЬКО с использованием знака "_".
+Все имеющиеся коды устройств и параметры для команды `make` перечислены в таблице:
+| Код | Параметр сборки | Примечание |
+| -------- | -------- | -------- |
+| bt6703 | `HARDWARE=bt6703` | Билайн |
+| bt6703 | `HARDWARE=bt6703_rt` | Ростелеком |
+| bt6703 | `HARDWARE=bt6707` |  |
+| bt6709 | `HARDWARE=bt6709` | Билайн |
+| bt6709-mts | `HARDWARE=bt6709_mts` | МТС |
+| bt6710 | `HARDWARE=bt6710` |  |
+| bt6711 | `HARDWARE=bt6711` |  |
+| bt6711-v1 | `HARDWARE=bt6711_v1` |  |
+
 Возможна сборка в докер-контейнере с подготовленным окружением и необходимым тулчейном. Актуальный образ для сборки указан в файле `jenkins-env.groovy` (переменная `buildenvImage`). Полная команда для сборки в таком случае выглядит так:
 Возможна сборка в докер-контейнере с подготовленным окружением и необходимым тулчейном. Актуальный образ для сборки указан в файле `jenkins-env.groovy` (переменная `buildenvImage`). Полная команда для сборки в таком случае выглядит так:
 ```
 ```
 git clone https://192.168.24.200:3000/ebalbekova/bt-67xx_universal_hw.git 
 git clone https://192.168.24.200:3000/ebalbekova/bt-67xx_universal_hw.git 
@@ -13,8 +28,9 @@ docker run \
 ```
 ```
 Сборка при помощи докера является предпочтительным способом отладки ПО разработчиком. В этом случае исключены ошибки при несовпадении окружения на ПК разработчика и на сервере автосборки.
 Сборка при помощи докера является предпочтительным способом отладки ПО разработчиком. В этом случае исключены ошибки при несовпадении окружения на ПК разработчика и на сервере автосборки.
 ## Ветвление
 ## Ветвление
-Основная ветка для разработки - `master`
-Иные ветки несут вспомогательный (временный) характер для разработки или отладки отдельных функций. Сборка этих веток автоматически не осуществляется.
+Основная ветка для разработки - `master`. <br />
+Иные ветки несут вспомогательный (временный) характер для разработки новых фич или отладки отдельных функций. Автоматическая сборка этих веток не осуществляется.
+
 ## Тегирование
 ## Тегирование
 Все релизы ПО осуществляются по тегам. Теги проставляются только по определенному шаблону.
 Все релизы ПО осуществляются по тегам. Теги проставляются только по определенному шаблону.
 Все теги, проставленные не по шаблону, не учитываются системой сборки и несут вспомогательный характер (удобство разработчика)
 Все теги, проставленные не по шаблону, не учитываются системой сборки и несут вспомогательный характер (удобство разработчика)
@@ -29,7 +45,7 @@ docker run \
 и релиз сервисной флешки (префикс `service_`)
 и релиз сервисной флешки (префикс `service_`)
 
 
 ## Автоматическая сборка
 ## Автоматическая сборка
-Сборка осуществляется на сервере Jenkins в пайплайне: http://192.168.24.203:8080/view/BT-67xx/job/bt-67xx_universal_hw/
-Настроены сборки при каждом коммите в ветку `master` и при обнаружении нового тега (независимо от ветки). В любом случае система собирает все возможные варианты ПО (для всех вариантов контроллеров), но при релизе публикует только ПО для выбранного устройства.
-Результаты сборки попадают на сервер Artifactory http://192.168.24.227:8082/ui/native/firmware/BT-67xx/bt67xx_universal_hw/
-Все настройки для автоматической сборки (с подробным описанием) хранятся в файле `jenkins-env.groovy` в корне данного репозитория. По окончании сборки релиза всем указанным в настройках адресатам рассылается информационное письмо со ссылкой на хранилище результатам сборки. Так же информационное письмо отправляется разработчику при неудачных сборках очередного коммита в основную ветку.
+* Сборка осуществляется на сервере Jenkins в пайплайне: http://192.168.24.203:8080/view/BT-67xx/job/bt-67xx_universal_hw/. В нем настроены сборки при каждом коммите в ветку `master` и при обнаружении нового тега (независимо от ветки). В любом случае система собирает все возможные варианты ПО (для всех вариантов контроллеров), но при релизе публикует только ПО для выбранного устройства.
+* Результаты сборки попадают на сервер Artifactory http://192.168.24.227:8082/ui/native/firmware/BT-67xx/bt67xx_universal_hw/
+* Переменные окружения (настройки) для автоматической сборки, с их подробным описанием, хранятся в файле `jenkins-env.groovy` в корне данного репозитория.
+* По окончанию сборки релиза всем указанным в настройках адресатам рассылается информационное письмо со ссылкой на хранилище результатам сборки. <br />Так же информационное письмо отправляется разработчику при неудачных сборках очередного коммита в основную ветку.