Illegal instruction dispatch documents (#10) and cleanup

CHANGELOG.md

@@ -6,6 +6,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 ### Added
+- S-level Illegal instruction exception is now delegated into S-level software handler.
 
 ### Modified
 

README.md

@@ -31,7 +31,7 @@ RustSBI implementation on production use.
 The RustSBI project contains three parts: the RustSBI library `rustsbi`, reference implementation
 in `platform`, and a simple operating system kernel to test SBI implementations in `test-kernel`.
 
-The test kernel is under development. Boot this kernel using your platform,
+The test kernel is used to test SBI functions. Boot this kernel using your platform,
 it will call all SBI calls and run instructions to test if underlying SBI environment is okay.
 if this kernel reports 'Ok' and exits normally, it means that your SBI implementation is correct.
 

platform/qemu/README.md

@@ -6,7 +6,7 @@ Compile and run with:
 just run
 ```
 
-Expected output should be:
+When running `just run`, the test kernel will build and run. Expected output should be:
 
 ```shell
    Compiling rustsbi-qemu v0.1.0 (.../rustsbi/platform/qemu)
@@ -25,9 +25,8 @@ Expected output should be:
 [rustsbi] medeleg: 0xb1ab
 [rustsbi-dtb] Hart count: cluster0 with 2 cores
 [rustsbi] Kernel entry: 0x80200000
-[rustsbi-panic] panicked at 'invalid instruction, mepc: 0000000080200000, instruction: 0000000000000000', platform/qemu/src/main.rs:456:17
-[rustsbi-panic] system shutdown scheduled due to RustSBI panic
+<< Test-kernel: Hart id = 0, DTB physical address = 0x1020
+>> Test-kernel: Trigger illegal exception
+<< Test-kernel: Illegal exception
+<< Test-kernel: SBI test success, shutdown
 ```
-
-Error 'invalid instruction' is expected, that means you should install
-your kernel here at `0x80200000`.