Radix cross Linux

Index: README.md
===================================================================
--- README.md	(nonexistent)
+++ README.md	(revision 411)
@@ -0,0 +1,102 @@
+
+
+gd32-dfu-utils, riscv-openocd:
+=============================
+
+Пакеты для **Slackware** можно загрузить с FTP-сервера https://ftp.radix-linux.su:
+
+[3pp/RISC-V-Development/gd32-dfu-utils/package/0.9/](https://ftp.radix-linux.su/3pp/RISC-V-Development/gd32-dfu-utils/package/0.9/)
+[3pp/RISC-V-Development/riscv-openocd/package/0.12.0/](https://ftp.radix-linux.su/3pp/RISC-V-Development/riscv-openocd/package/0.12.0/)
+
+Исходные архивы:
+
+[3pp/RISC-V-Development/gd32-dfu-utils/src/](https://ftp.radix-linux.su/3pp/RISC-V-Development/gd32-dfu-utils/src/)
+[3pp/RISC-V-Development/riscv-openocd/src/](https://ftp.radix-linux.su/3pp/RISC-V-Development/riscv-openocd/src/)
+
+Скрипты SlackBuild для сборки пакетов:
+
+[3pp/RISC-V-Development/gd32-dfu-utils/slackware-build/0.9/](https://ftp.radix-linux.su/3pp/RISC-V-Development/gd32-dfu-utils/slackware-build/0.9/)
+[3pp/RISC-V-Development/riscv-openocd/slackware-build/0.12.0/](https://ftp.radix-linux.su/3pp/RISC-V-Development/riscv-openocd/slackware-build/0.12.0/)
+
+
+Подключение Longan Nano:
+=======================
+
+Подключить адаптер [SiPEED](https://www.promelec.ru/product/10720759/) к [Longan Nano](https://longan.sipeed.com/en/),
+подключить разъем **USB-C** к источнику питания или компьютеру, подключить **USB** адаптер **SiPEED** к компьютеру, где установлены
+пакеты gd32-dfu-utils, riscv-openocd.
+
+На плате [Longan Nano](https://longan.sipeed.com/en/) нажать и удерживать кнопку **BOOT**, кратко нажать и отпустить
+кнопку **RESET** и затем отпустить кнопку **BOOT**.
+
+Проверить подключение с помошью команды:
+
+```Bash
+ sudo dfu-util -l
+
+ dfu-util 0.9
+
+ Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc.
+ Copyright 2010-2016 Tormod Volden and Stefan Schmidt
+ This program is Free Software and has ABSOLUTELY NO WARRANTY
+ Please report bugs to http://sourceforge.net/p/dfu-util/tickets/
+
+ Found DFU: [28e9:0189] ver=0100, devnum=29, cfg=1, intf=0, path="5-1.2", alt=1, name="@Option Bytes  /0x1FFFF800/01*016Be", serial="3CBJ"
+ Found DFU: [28e9:0189] ver=0100, devnum=29, cfg=1, intf=0, path="5-1.2", alt=0, name="@Internal Flash  /0x08000000/128*001Kg", serial="3CBJ"
+
+ Если устройство обнаружено, можно приступать к прошивке.
+```
+<br>
+
+Прошивка:
+========
+
+Запись на устройство выполняется с помощью команды:
+
+```Bash
+sudo dfu-util -d 28e9:0189 -a 0 --dfuse-address 0x08000000:leave -D .riscv-newlib/longan-nano/display.bin
+```
+
+или
+
+```Bash
+sudo dfu-util -d 28e9:0189 -a 0 --dfuse-address 0x08000000:leave -D .riscv-newlib/longan-nano/led.bin
+```
+
+По окончании записи адаптер SiPEED можно отключить.
+
+Теперь при подаче питания на USB-C разъем Longan Nano, будет виден результат работы программ.
+Если прошит образ led.bin, то будет мигать светодиод. Если же прошит образ display.bin, то LCD Display
+будет периодически заливаться разными цветами в бесконечном цикле.
+<br>
+
+Отладка (gdb):
+=============
+
+```Bash
+sudo riscv-openocd -f src/openocd/openocd_ft2232.cfg
+
+(gdb) target extended-remote :3333
+
+(gdb) load
+
+(gdb) break main
+
+(gdb) continue
+```
+<br>
+
+Работа от имени non-root пользователя:
+=====================================
+
+Чтобы работать от имени простого пользователя, необходимо добавить следующие udev-правила,
+например, в файл **/lib/udev/rules.d/70-ttyusb.rules**:
+
+```Bash
+SUBSYSTEM=="usb", ATTRS{idVendor}=="28e9", ATTRS{idProduct}=="0189", MODE="0666"
+SUBSYSTEM=="usb_device", ATTRS{idVendor}=="28e9", ATTRS{idProduct}=="0189", MODE="0666"
+```
+<br>
+
+**Enjoy**.
+