github-mirrors/neorv32
1
0
Fork 0
mirror of https://github.com/stnolting/neorv32.git synced 2025-04-24 06:07:52 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

[docs] bootloader: added notes regarding 4kB upload issue

Browse source 
-> #215
This commit is contained in:
stnolting 2021-12-18 20:12:51 +01:00
parent 26bbea550e
commit eb58b7f71b
2 changed files with 10 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

6
docs/datasheet/software.adoc
View file

@ -448,6 +448,12 @@ Terminal console settings (`19200-8-N-1`):
* newline on `\r\n` (carriage return, newline)
* no transfer protocol / control flow protocol - just the raw byte stuff
[IMPORTANT]
_Any_ terminal program that can connect to a serial port should work. However, make sure the program
can transfer data in _raw_ byte mode without any protocol overhead around it. Some terminal programs struggle with
transmitting files larger than 4kB (see https://github.com/stnolting/neorv32/pull/215). Try a different program
if uploading a binary does not work (terminal stall).
The bootloader uses the LSB of the top entity's `gpio_o` output port as high-active status LED (all other
output pin are set to low level by the bootloader). After reset, this LED will start blinking at ~2Hz and the
following intro screen should show up in your terminal:

7
docs/userguide/executable_upload.adoc
View file

@ -19,10 +19,11 @@ run custom programs on your FPGA setup without having a UART.
from https://ttssh2.osdn.jp/index.html.en . On Linux you could use GTKTerm, which you can get here
https://github.com/Jeija/gtkterm.git (or install via your package manager).
[NOTE]
[IMPORTANT]
_Any_ terminal program that can connect to a serial port should work. However, make sure the program
can transfer data in _raw_ byte mode without any protocol overhead around it.
can transfer data in _raw_ byte mode without any protocol overhead around it. Some terminal programs struggle with
transmitting files larger than 4kB (see https://github.com/stnolting/neorv32/pull/215). Try a different program
if uploading a binary does not work (terminal stall).
[start=3]
. Open a connection to the the serial port your UART is connected to. Configure the terminal setting according to the