| .. SPDX-License-Identifier: GPL-2.0+: | |
| .. index:: | |
| single: loady (command) | |
| loady command | |
| ============= | |
| Synopsis | |
| -------- | |
| :: | |
| loady [addr [baud]] | |
| Description | |
| ----------- | |
| The loady command is used to transfer a file to the device via the serial line | |
| using the YMODEM protocol. | |
| The number of transferred bytes is saved in environment variable filesize. | |
| addr | |
| load address, defaults to environment variable loadaddr or if loadaddr is | |
| not set to configuration variable CONFIG_SYS_LOAD_ADDR | |
| baud | |
| baud rate for the ymodem transmission. After the transmission the baud | |
| rate is reset to the original value. | |
| Example | |
| ------- | |
| In the example below the terminal emulation program picocom was used to | |
| transfer a file to the device. | |
| After entering the loady command the key sequence <CTRL-A><CTRL-S> is used to | |
| let picocom prompt for the file name. Picocom invokes the program sz for the | |
| file transfer. | |
| :: | |
| => loady 80064000 115200 | |
| ## Ready for binary (ymodem) download to 0x80064000 at 115200 bps... | |
| C | |
| *** file: BOOTRISCV64.EFI | |
| $ sz -b -vv BOOTRISCV64.EFI | |
| Sending: BOOTRISCV64.EFI | |
| Bytes Sent: 398976 BPS:7883 | |
| Sending: | |
| Ymodem sectors/kbytes sent: 0/ 0k | |
| Transfer complete | |
| *** exit status: 0 *** | |
| /1(CAN) packets, 4 retries | |
| ## Total Size = 0x0006165f = 398943 Bytes | |
| => echo ${filesize} | |
| 6165f | |
| => | |
| Transfer can be cancelled by pressing 3 times <CTRL+C> after two seconds | |
| of inactivity on terminal. | |
| Configuration | |
| ------------- | |
| The command is only available if CONFIG_CMD_LOADB=y. | |
| Initial timeout in seconds while waiting for transfer is configured by | |
| config option CMD_LOADXY_TIMEOUT or by env variable $loadxy_timeout. | |
| Setting it to 0 means infinite timeout. |