Commit cf9c427a87e1a1a5115ec60f7785f48c8b34a5f6

Authored by Heinrich Schuchardt
Committed by Andes
1 parent fd1f6e9a0b

doc: fix AX25-AE350 RISC-V documentation

Since commit 04883bf7acca ("doc: update AX25-AE350 RISC-V documentation")
`make htmldocs` produces a log of warnings like

doc/board/AndesTech/ax25-ae350.rst:373:
WARNING: Block quote ends without a blank line; unexpected unindent.
doc/board/AndesTech/ax25-ae350.rst:0:
WARNING: Undefined substitution referenced: "_ __ ___ _ __ | (___ | |_) |".

Reformat the problematic passages.

Fixes: 04883bf7acca ("doc: update AX25-AE350 RISC-V documentation")
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Reviewed-by: Jagan Teki <jagan@amarulasolutions.com>
Reviewed-by: Rick Chen <rick@andestech.com>
Tested-by: Bin Meng <bmeng.cn@gmail.com>

Showing 1 changed file with 168 additions and 167 deletions Side-by-side Diff

doc/board/AndesTech/ax25-ae350.rst
... ... @@ -62,10 +62,11 @@
62 62 --------------
63 63  
64 64 CONFIG_SKIP_LOWLEVEL_INIT:
65   - If you want to boot this system from SPI ROM and bypass e-bios (the
66   - other boot loader on ROM). You should undefine CONFIG_SKIP_LOWLEVEL_INIT
67   - in "include/configs/ax25-ae350.h".
68 65  
  66 +If you want to boot this system from SPI ROM and bypass e-bios (the
  67 +other boot loader on ROM). You should undefine CONFIG_SKIP_LOWLEVEL_INIT
  68 +in "include/configs/ax25-ae350.h".
  69 +
69 70 Build and boot steps
70 71 --------------------
71 72  
... ... @@ -165,7 +166,7 @@
165 166 crc32 for 80000000 ... 80050452 ==> 692dc44a
166 167 RISC-V #
167 168  
168   - *** power-off and power-on, this U-Boot is booted from spi flash ***
  169 + *** power-off and power-on, this U-Boot is booted from spi flash ***
169 170  
170 171 U-Boot 2018.01-rc2-00032-gf67dd47-dirty (Dec 21 2017 - 13:56:03 +0800)
171 172  
172 173  
173 174  
174 175  
175 176  
176 177  
177 178  
178 179  
179 180  
... ... @@ -365,169 +366,169 @@
365 366  
366 367 .. code-block:: none
367 368  
368   -U-Boot SPL 2020.01-rc1-00292-g67a3313-dirty (Nov 14 2019 - 11:26:21 +0800)
369   -Trying to boot from RAM
  369 + U-Boot SPL 2020.01-rc1-00292-g67a3313-dirty (Nov 14 2019 - 11:26:21 +0800)
  370 + Trying to boot from RAM
370 371  
371   -OpenSBI v0.5-1-gdd8ef28 (Nov 14 2019 11:08:39)
372   - ____ _____ ____ _____
373   - / __ \ / ____| _ \_ _|
374   - | | | |_ __ ___ _ __ | (___ | |_) || |
375   - | | | | '_ \ / _ \ '_ \ \___ \| _ < | |
376   - | |__| | |_) | __/ | | |____) | |_) || |_
377   - \____/| .__/ \___|_| |_|_____/|____/_____|
378   - | |
379   - |_|
  372 + OpenSBI v0.5-1-gdd8ef28 (Nov 14 2019 11:08:39)
  373 + ____ _____ ____ _____
  374 + / __ \ / ____| _ \_ _|
  375 + | | | |_ __ ___ _ __ | (___ | |_) || |
  376 + | | | | '_ \ / _ \ '_ \ \___ \| _ < | |
  377 + | |__| | |_) | __/ | | |____) | |_) || |_
  378 + \____/| .__/ \___|_| |_|_____/|____/_____|
  379 + | |
  380 + |_|
380 381  
381   -Platform Name : Andes AE350
382   -Platform HART Features : RV64ACIMSUX
383   -Platform Max HARTs : 4
384   -Current Hart : 0
385   -Firmware Base : 0x0
386   -Firmware Size : 84 KB
387   -Runtime SBI Version : 0.2
  382 + Platform Name : Andes AE350
  383 + Platform HART Features : RV64ACIMSUX
  384 + Platform Max HARTs : 4
  385 + Current Hart : 0
  386 + Firmware Base : 0x0
  387 + Firmware Size : 84 KB
  388 + Runtime SBI Version : 0.2
388 389  
389   -PMP0: 0x0000000000000000-0x000000000001ffff (A)
390   -PMP1: 0x0000000000000000-0x00000001ffffffff (A,R,W,X)
  390 + PMP0: 0x0000000000000000-0x000000000001ffff (A)
  391 + PMP1: 0x0000000000000000-0x00000001ffffffff (A,R,W,X)
391 392  
392 393  
393   -U-Boot 2020.01-rc1-00292-g67a3313-dirty (Nov 14 2019 - 11:26:21 +0800)
  394 + U-Boot 2020.01-rc1-00292-g67a3313-dirty (Nov 14 2019 - 11:26:21 +0800)
394 395  
395   -DRAM: 1 GiB
396   -Flash: 64 MiB
397   -MMC: mmc@f0e00000: 0
398   -Loading Environment from SPI Flash... SF: Detected mx25u1635e with page size 256 Bytes, erase size 4 KiB, total 2 MiB
399   -OK
400   -In: serial@f0300000
401   -Out: serial@f0300000
402   -Err: serial@f0300000
403   -Net: no alias for ethernet0
  396 + DRAM: 1 GiB
  397 + Flash: 64 MiB
  398 + MMC: mmc@f0e00000: 0
  399 + Loading Environment from SPI Flash... SF: Detected mx25u1635e with page size 256 Bytes, erase size 4 KiB, total 2 MiB
  400 + OK
  401 + In: serial@f0300000
  402 + Out: serial@f0300000
  403 + Err: serial@f0300000
  404 + Net: no alias for ethernet0
404 405  
405   -Warning: mac@e0100000 (eth0) using random MAC address - a2:ae:93:7b:cc:8f
406   -eth0: mac@e0100000
407   -Hit any key to stop autoboot: 0
408   -6455 bytes read in 31 ms (203.1 KiB/s)
409   -20421684 bytes read in 8647 ms (2.3 MiB/s)
410   -## Booting kernel from Legacy Image at 00600000 ...
411   - Image Name:
412   - Image Type: RISC-V Linux Kernel Image (uncompressed)
413   - Data Size: 20421620 Bytes = 19.5 MiB
414   - Load Address: 00200000
415   - Entry Point: 00200000
416   - Verifying Checksum ... OK
417   -## Flattened Device Tree blob at 20000000
418   - Booting using the fdt blob at 0x20000000
419   - Loading Kernel Image
420   - Loading Device Tree to 000000001effb000, end 000000001efff936 ... OK
  406 + Warning: mac@e0100000 (eth0) using random MAC address - a2:ae:93:7b:cc:8f
  407 + eth0: mac@e0100000
  408 + Hit any key to stop autoboot: 0
  409 + 6455 bytes read in 31 ms (203.1 KiB/s)
  410 + 20421684 bytes read in 8647 ms (2.3 MiB/s)
  411 + ## Booting kernel from Legacy Image at 00600000 ...
  412 + Image Name:
  413 + Image Type: RISC-V Linux Kernel Image (uncompressed)
  414 + Data Size: 20421620 Bytes = 19.5 MiB
  415 + Load Address: 00200000
  416 + Entry Point: 00200000
  417 + Verifying Checksum ... OK
  418 + ## Flattened Device Tree blob at 20000000
  419 + Booting using the fdt blob at 0x20000000
  420 + Loading Kernel Image
  421 + Loading Device Tree to 000000001effb000, end 000000001efff936 ... OK
421 422  
422   -Starting kernel ...
  423 + Starting kernel ...
423 424  
424   -OF: fdt: Ignoring memory range 0x0 - 0x200000
425   -Linux version 4.17.0-00253-g49136e10bcb2 (sqa@atcsqa07) (gcc version 7.3.0 (2019-04-06_nds64le-linux-glibc-v5_experimental)) #1 SMP PREEMPT Sat Apr 6 23:41:49 CST 2019
426   -bootconsole [early0] enabled
427   -Initial ramdisk at: 0x (ptrval) (13665712 bytes)
428   -Zone ranges:
429   - DMA32 [mem 0x0000000000200000-0x000000003fffffff]
430   - Normal empty
431   -Movable zone start for each node
432   -Early memory node ranges
433   - node 0: [mem 0x0000000000200000-0x000000003fffffff]
434   -Initmem setup node 0 [mem 0x0000000000200000-0x000000003fffffff]
435   -software IO TLB [mem 0x3b1f8000-0x3f1f8000] (64MB) mapped at [ (ptrval)- (ptrval)]
436   -elf_platform is rv64i2p0m2p0a2p0c2p0xv5-0p0
437   -compatible privileged spec version 1.10
438   -percpu: Embedded 16 pages/cpu @ (ptrval) s28184 r8192 d29160 u65536
439   -Built 1 zonelists, mobility grouping on. Total pages: 258055
440   -Kernel command line: console=ttyS0,38400n8 debug loglevel=7
441   -log_buf_len individual max cpu contribution: 4096 bytes
442   -log_buf_len total cpu_extra contributions: 12288 bytes
443   -log_buf_len min size: 16384 bytes
444   -log_buf_len: 32768 bytes
445   -early log buf free: 14608(89%)
446   -Dentry cache hash table entries: 131072 (order: 8, 1048576 bytes)
447   -Inode-cache hash table entries: 65536 (order: 7, 524288 bytes)
448   -Sorting __ex_table...
449   -Memory: 944428K/1046528K available (3979K kernel code, 246K rwdata, 1490K rodata, 13523K init, 688K bss, 102100K reserved, 0K cma-reserved)
450   -SLUB: HWalign=64, Order=0-3, MinObjects=0, CPUs=4, Nodes=1
451   -Preemptible hierarchical RCU implementation.
452   - Tasks RCU enabled.
453   -NR_IRQS: 72, nr_irqs: 72, preallocated irqs: 0
454   -riscv,cpu_intc,0: 64 local interrupts mapped
455   -riscv,cpu_intc,1: 64 local interrupts mapped
456   -riscv,cpu_intc,2: 64 local interrupts mapped
457   -riscv,cpu_intc,3: 64 local interrupts mapped
458   -riscv,plic0,e4000000: mapped 71 interrupts to 8/8 handlers
459   -clocksource: riscv_clocksource: mask: 0xffffffffffffffff max_cycles: 0x1bacf917bf, max_idle_ns: 881590412290 ns
460   -sched_clock: 64 bits at 60MHz, resolution 16ns, wraps every 4398046511098ns
461   -Console: colour dummy device 40x30
462   -Calibrating delay loop (skipped), value calculated using timer frequency.. 120.00 BogoMIPS (lpj=600000)
463   -pid_max: default: 32768 minimum: 301
464   -Mount-cache hash table entries: 2048 (order: 2, 16384 bytes)
465   -Mountpoint-cache hash table entries: 2048 (order: 2, 16384 bytes)
466   -Hierarchical SRCU implementation.
467   -smp: Bringing up secondary CPUs ...
468   -CPU0: online
469   -CPU2: online
470   -CPU3: online
471   -smp: Brought up 1 node, 4 CPUs
472   -devtmpfs: initialized
473   -random: get_random_u32 called from bucket_table_alloc+0x198/0x1d8 with crng_init=0
474   -clocksource: jiffies: mask: 0xffffffff max_cycles: 0xffffffff, max_idle_ns: 19112604462750000 ns
475   -futex hash table entries: 1024 (order: 4, 65536 bytes)
476   -NET: Registered protocol family 16
477   -Advanced Linux Sound Architecture Driver Initialized.
478   -clocksource: Switched to clocksource riscv_clocksource
479   -NET: Registered protocol family 2
480   -tcp_listen_portaddr_hash hash table entries: 512 (order: 1, 8192 bytes)
481   -TCP established hash table entries: 8192 (order: 4, 65536 bytes)
482   -TCP bind hash table entries: 8192 (order: 5, 131072 bytes)
483   -TCP: Hash tables configured (established 8192 bind 8192)
484   -UDP hash table entries: 512 (order: 2, 16384 bytes)
485   -UDP-Lite hash table entries: 512 (order: 2, 16384 bytes)
486   -NET: Registered protocol family 1
487   -RPC: Registered named UNIX socket transport module.
488   -RPC: Registered udp transport module.
489   -RPC: Registered tcp transport module.
490   -RPC: Registered tcp NFSv4.1 backchannel transport module.
491   -Unpacking initramfs...
492   -workingset: timestamp_bits=62 max_order=18 bucket_order=0
493   -NFS: Registering the id_resolver key type
494   -Key type id_resolver registered
495   -Key type id_legacy registered
496   -nfs4filelayout_init: NFSv4 File Layout Driver Registering...
497   -io scheduler noop registered
498   -io scheduler cfq registered (default)
499   -io scheduler mq-deadline registered
500   -io scheduler kyber registered
501   -Console: switching to colour frame buffer device 40x30
502   -Serial: 8250/16550 driver, 4 ports, IRQ sharing disabled
503   -console [ttyS0] disabled
504   -f0300000.serial: ttyS0 at MMIO 0xf0300020 (irq = 20, base_baud = 1228800) is a 16550A
505   -console [ttyS0] enabled
506   -console [ttyS0] enabled
507   -bootconsole [early0] disabled
508   -bootconsole [early0] disabled
509   -loop: module loaded
510   -tun: Universal TUN/TAP device driver, 1.6
511   -ftmac100: Loading version 0.2 ...
512   -ftmac100 e0100000.mac eth0: irq 21, mapped at (ptrval)
513   -ftmac100 e0100000.mac eth0: generated random MAC address 4e:fd:bd:f3:04:fc
514   -ftsdc010 f0e00000.mmc: mmc0 - using hw SDIO IRQ
515   -mmc0: new SDHC card at address d555
516   -ftssp010 card registered!
517   -mmcblk0: mmc0:d555 SD04G 3.79 GiB
518   -NET: Registered protocol family 10
519   - mmcblk0: p1
520   -Segment Routing with IPv6
521   -sit: IPv6, IPv4 and MPLS over IPv4 tunneling driver
522   -NET: Registered protocol family 17
523   -NET: Registered protocol family 15
524   -ALSA device list:
525   - #0: ftssp_ac97 controller
526   -Freeing unused kernel memory: 13520K
527   -This architecture does not have kernel memory protection.
528   -Sysinit starting
529   -Sat Apr 6 23:33:53 CST 2019
530   -nfs4flexfilelayout_init: NFSv4 Flexfile Layout Driver Registering...
  425 + OF: fdt: Ignoring memory range 0x0 - 0x200000
  426 + Linux version 4.17.0-00253-g49136e10bcb2 (sqa@atcsqa07) (gcc version 7.3.0 (2019-04-06_nds64le-linux-glibc-v5_experimental)) #1 SMP PREEMPT Sat Apr 6 23:41:49 CST 2019
  427 + bootconsole [early0] enabled
  428 + Initial ramdisk at: 0x (ptrval) (13665712 bytes)
  429 + Zone ranges:
  430 + DMA32 [mem 0x0000000000200000-0x000000003fffffff]
  431 + Normal empty
  432 + Movable zone start for each node
  433 + Early memory node ranges
  434 + node 0: [mem 0x0000000000200000-0x000000003fffffff]
  435 + Initmem setup node 0 [mem 0x0000000000200000-0x000000003fffffff]
  436 + software IO TLB [mem 0x3b1f8000-0x3f1f8000] (64MB) mapped at [ (ptrval)- (ptrval)]
  437 + elf_platform is rv64i2p0m2p0a2p0c2p0xv5-0p0
  438 + compatible privileged spec version 1.10
  439 + percpu: Embedded 16 pages/cpu @ (ptrval) s28184 r8192 d29160 u65536
  440 + Built 1 zonelists, mobility grouping on. Total pages: 258055
  441 + Kernel command line: console=ttyS0,38400n8 debug loglevel=7
  442 + log_buf_len individual max cpu contribution: 4096 bytes
  443 + log_buf_len total cpu_extra contributions: 12288 bytes
  444 + log_buf_len min size: 16384 bytes
  445 + log_buf_len: 32768 bytes
  446 + early log buf free: 14608(89%)
  447 + Dentry cache hash table entries: 131072 (order: 8, 1048576 bytes)
  448 + Inode-cache hash table entries: 65536 (order: 7, 524288 bytes)
  449 + Sorting __ex_table...
  450 + Memory: 944428K/1046528K available (3979K kernel code, 246K rwdata, 1490K rodata, 13523K init, 688K bss, 102100K reserved, 0K cma-reserved)
  451 + SLUB: HWalign=64, Order=0-3, MinObjects=0, CPUs=4, Nodes=1
  452 + Preemptible hierarchical RCU implementation.
  453 + Tasks RCU enabled.
  454 + NR_IRQS: 72, nr_irqs: 72, preallocated irqs: 0
  455 + riscv,cpu_intc,0: 64 local interrupts mapped
  456 + riscv,cpu_intc,1: 64 local interrupts mapped
  457 + riscv,cpu_intc,2: 64 local interrupts mapped
  458 + riscv,cpu_intc,3: 64 local interrupts mapped
  459 + riscv,plic0,e4000000: mapped 71 interrupts to 8/8 handlers
  460 + clocksource: riscv_clocksource: mask: 0xffffffffffffffff max_cycles: 0x1bacf917bf, max_idle_ns: 881590412290 ns
  461 + sched_clock: 64 bits at 60MHz, resolution 16ns, wraps every 4398046511098ns
  462 + Console: colour dummy device 40x30
  463 + Calibrating delay loop (skipped), value calculated using timer frequency.. 120.00 BogoMIPS (lpj=600000)
  464 + pid_max: default: 32768 minimum: 301
  465 + Mount-cache hash table entries: 2048 (order: 2, 16384 bytes)
  466 + Mountpoint-cache hash table entries: 2048 (order: 2, 16384 bytes)
  467 + Hierarchical SRCU implementation.
  468 + smp: Bringing up secondary CPUs ...
  469 + CPU0: online
  470 + CPU2: online
  471 + CPU3: online
  472 + smp: Brought up 1 node, 4 CPUs
  473 + devtmpfs: initialized
  474 + random: get_random_u32 called from bucket_table_alloc+0x198/0x1d8 with crng_init=0
  475 + clocksource: jiffies: mask: 0xffffffff max_cycles: 0xffffffff, max_idle_ns: 19112604462750000 ns
  476 + futex hash table entries: 1024 (order: 4, 65536 bytes)
  477 + NET: Registered protocol family 16
  478 + Advanced Linux Sound Architecture Driver Initialized.
  479 + clocksource: Switched to clocksource riscv_clocksource
  480 + NET: Registered protocol family 2
  481 + tcp_listen_portaddr_hash hash table entries: 512 (order: 1, 8192 bytes)
  482 + TCP established hash table entries: 8192 (order: 4, 65536 bytes)
  483 + TCP bind hash table entries: 8192 (order: 5, 131072 bytes)
  484 + TCP: Hash tables configured (established 8192 bind 8192)
  485 + UDP hash table entries: 512 (order: 2, 16384 bytes)
  486 + UDP-Lite hash table entries: 512 (order: 2, 16384 bytes)
  487 + NET: Registered protocol family 1
  488 + RPC: Registered named UNIX socket transport module.
  489 + RPC: Registered udp transport module.
  490 + RPC: Registered tcp transport module.
  491 + RPC: Registered tcp NFSv4.1 backchannel transport module.
  492 + Unpacking initramfs...
  493 + workingset: timestamp_bits=62 max_order=18 bucket_order=0
  494 + NFS: Registering the id_resolver key type
  495 + Key type id_resolver registered
  496 + Key type id_legacy registered
  497 + nfs4filelayout_init: NFSv4 File Layout Driver Registering...
  498 + io scheduler noop registered
  499 + io scheduler cfq registered (default)
  500 + io scheduler mq-deadline registered
  501 + io scheduler kyber registered
  502 + Console: switching to colour frame buffer device 40x30
  503 + Serial: 8250/16550 driver, 4 ports, IRQ sharing disabled
  504 + console [ttyS0] disabled
  505 + f0300000.serial: ttyS0 at MMIO 0xf0300020 (irq = 20, base_baud = 1228800) is a 16550A
  506 + console [ttyS0] enabled
  507 + console [ttyS0] enabled
  508 + bootconsole [early0] disabled
  509 + bootconsole [early0] disabled
  510 + loop: module loaded
  511 + tun: Universal TUN/TAP device driver, 1.6
  512 + ftmac100: Loading version 0.2 ...
  513 + ftmac100 e0100000.mac eth0: irq 21, mapped at (ptrval)
  514 + ftmac100 e0100000.mac eth0: generated random MAC address 4e:fd:bd:f3:04:fc
  515 + ftsdc010 f0e00000.mmc: mmc0 - using hw SDIO IRQ
  516 + mmc0: new SDHC card at address d555
  517 + ftssp010 card registered!
  518 + mmcblk0: mmc0:d555 SD04G 3.79 GiB
  519 + NET: Registered protocol family 10
  520 + mmcblk0: p1
  521 + Segment Routing with IPv6
  522 + sit: IPv6, IPv4 and MPLS over IPv4 tunneling driver
  523 + NET: Registered protocol family 17
  524 + NET: Registered protocol family 15
  525 + ALSA device list:
  526 + #0: ftssp_ac97 controller
  527 + Freeing unused kernel memory: 13520K
  528 + This architecture does not have kernel memory protection.
  529 + Sysinit starting
  530 + Sat Apr 6 23:33:53 CST 2019
  531 + nfs4flexfilelayout_init: NFSv4 Flexfile Layout Driver Registering...
531 532  
532 533 ~ #