diff mbox series

[01/20] target/loongarch: Add README

Message ID 1624881885-31692-2-git-send-email-gaosong@loongson.cn (mailing list archive)
State New, archived
Headers show
Series Add LoongArch linux-user emulation support | expand

Commit Message

gaosong June 28, 2021, 12:04 p.m. UTC
This patch give an introduction to the LoongArch target.

Signed-off-by: Song Gao <gaosong@loongson.cn>
---
 MAINTAINERS             |  5 +++++
 target/loongarch/README | 16 ++++++++++++++++
 2 files changed, 21 insertions(+)
 create mode 100644 target/loongarch/README

Comments

Philippe Mathieu-Daudé June 28, 2021, 6:40 p.m. UTC | #1
On 6/28/21 2:04 PM, Song Gao wrote:
> This patch give an introduction to the LoongArch target.
> 
> Signed-off-by: Song Gao <gaosong@loongson.cn>
> ---
>  MAINTAINERS             |  5 +++++
>  target/loongarch/README | 16 ++++++++++++++++
>  2 files changed, 21 insertions(+)
>  create mode 100644 target/loongarch/README
> 
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 3ff56f5..f207805 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -209,6 +209,11 @@ F: disas/hppa.c
>  F: hw/net/*i82596*
>  F: include/hw/net/lasi_82596.h
>  
> +LoongArch TCG CPUS
> +M: Song Gao <gaosong@loongson.cn>
> +S: Maintained
> +F: target/loongarch/
> +
>  M68K TCG CPUs
>  M: Laurent Vivier <laurent@vivier.eu>
>  S: Maintained
> diff --git a/target/loongarch/README b/target/loongarch/README
> new file mode 100644
> index 0000000..0addfc7
> --- /dev/null
> +++ b/target/loongarch/README
> @@ -0,0 +1,16 @@
> +LoongArch is the general processor architecture of Loongson.
> +
> +The following versions of the LoongArch core are supported
> +    core: 3A5000
> +    https://github.com/loongson/LoongArch-Documentation/releases/download/LoongArch-Vol1-v3/LoongArch-Vol1-v1.00-EN.pdf
> +
> +There are several code directories
> +
> +    1 qemu/target/loongarch
> +        This is the instruction emulation directory
> +    2 qemu/linux-user/loongarch64
> +        Linux-user simulation
> +    3 qemu/hw/loongarch
> +        System simulation
> +    4 qemu/tests/tcg/loongarch
> +        Linux-user test

No qemu/ prefix.
gaosong June 29, 2021, 7:33 a.m. UTC | #2
Hi, Philippe,

On 06/29/2021 02:40 AM, Philippe Mathieu-Daudé wrote:
> On 6/28/21 2:04 PM, Song Gao wrote:
>> This patch give an introduction to the LoongArch target.
>>
>> Signed-off-by: Song Gao <gaosong@loongson.cn>
>> ---
>>  MAINTAINERS             |  5 +++++
>>  target/loongarch/README | 16 ++++++++++++++++
>>  2 files changed, 21 insertions(+)
>>  create mode 100644 target/loongarch/README
>>
>> diff --git a/MAINTAINERS b/MAINTAINERS
>> index 3ff56f5..f207805 100644
>> --- a/MAINTAINERS
>> +++ b/MAINTAINERS
>> @@ -209,6 +209,11 @@ F: disas/hppa.c
>>  F: hw/net/*i82596*
>>  F: include/hw/net/lasi_82596.h
>>  
>> +LoongArch TCG CPUS
>> +M: Song Gao <gaosong@loongson.cn>
>> +S: Maintained
>> +F: target/loongarch/
>> +
>>  M68K TCG CPUs
>>  M: Laurent Vivier <laurent@vivier.eu>
>>  S: Maintained
>> diff --git a/target/loongarch/README b/target/loongarch/README
>> new file mode 100644
>> index 0000000..0addfc7
>> --- /dev/null
>> +++ b/target/loongarch/README
>> @@ -0,0 +1,16 @@
>> +LoongArch is the general processor architecture of Loongson.
>> +
>> +The following versions of the LoongArch core are supported
>> +    core: 3A5000
>> +    https://github.com/loongson/LoongArch-Documentation/releases/download/LoongArch-Vol1-v3/LoongArch-Vol1-v1.00-EN.pdf
>> +
>> +There are several code directories
>> +
>> +    1 qemu/target/loongarch
>> +        This is the instruction emulation directory
>> +    2 qemu/linux-user/loongarch64
>> +        Linux-user simulation
>> +    3 qemu/hw/loongarch
>> +        System simulation
>> +    4 qemu/tests/tcg/loongarch
>> +        Linux-user test
> 
> No qemu/ prefix.
> OK, We'll do it. 

thanks
Alex Bennée June 29, 2021, 11:13 a.m. UTC | #3
Song Gao <gaosong@loongson.cn> writes:

> This patch give an introduction to the LoongArch target.
>
> Signed-off-by: Song Gao <gaosong@loongson.cn>
> ---
>  MAINTAINERS             |  5 +++++
>  target/loongarch/README | 16 ++++++++++++++++
>  2 files changed, 21 insertions(+)
>  create mode 100644 target/loongarch/README
>
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 3ff56f5..f207805 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -209,6 +209,11 @@ F: disas/hppa.c
>  F: hw/net/*i82596*
>  F: include/hw/net/lasi_82596.h
>  
> +LoongArch TCG CPUS
> +M: Song Gao <gaosong@loongson.cn>
> +S: Maintained
> +F: target/loongarch/
> +
>  M68K TCG CPUs
>  M: Laurent Vivier <laurent@vivier.eu>
>  S: Maintained
> diff --git a/target/loongarch/README b/target/loongarch/README
> new file mode 100644
> index 0000000..0addfc7
> --- /dev/null
> +++ b/target/loongarch/README
> @@ -0,0 +1,16 @@
> +LoongArch is the general processor architecture of Loongson.
> +
> +The following versions of the LoongArch core are supported
> +    core: 3A5000
> +
> https://github.com/loongson/LoongArch-Documentation/releases/download/LoongArch-Vol1-v3/LoongArch-Vol1-v1.00-EN.pdf

This part, perhaps slightly expanded is probably better aimed at
docs/system/target-loongarch.rst so it can be included in the generated
manual. Bonus points for something along the lines of
docs/system/arm/versatile.rst where you give a quick breakdown of the
kernel config and an example command line.

> +
> +There are several code directories
> +
> +    1 qemu/target/loongarch
> +        This is the instruction emulation directory
> +    2 qemu/linux-user/loongarch64
> +        Linux-user simulation
> +    3 qemu/hw/loongarch
> +        System simulation
> +    4 qemu/tests/tcg/loongarch
> +        Linux-user test
Peter Maydell June 29, 2021, 11:52 a.m. UTC | #4
On Mon, 28 Jun 2021 at 13:04, Song Gao <gaosong@loongson.cn> wrote:
>
> This patch give an introduction to the LoongArch target.
>
> Signed-off-by: Song Gao <gaosong@loongson.cn>
> ---

> +There are several code directories
> +
> +    1 qemu/target/loongarch
> +        This is the instruction emulation directory
> +    2 qemu/linux-user/loongarch64
> +        Linux-user simulation
> +    3 qemu/hw/loongarch
> +        System simulation
> +    4 qemu/tests/tcg/loongarch
> +        Linux-user test

This isn't particularly specific to loongarch -- it's how
all QEMU targets are structured. So I'm not sure you need
to document it in an loongarch-specific README.

thanks
-- PMM
gaosong June 30, 2021, 1:09 a.m. UTC | #5
Hi, Alex,

On 06/29/2021 07:13 PM, Alex Bennée wrote:
> 
> Song Gao <gaosong@loongson.cn> writes:
> 
>> This patch give an introduction to the LoongArch target.
>>
>> Signed-off-by: Song Gao <gaosong@loongson.cn>
>> ---
>>  MAINTAINERS             |  5 +++++
>>  target/loongarch/README | 16 ++++++++++++++++
>>  2 files changed, 21 insertions(+)
>>  create mode 100644 target/loongarch/README
>>
>> diff --git a/MAINTAINERS b/MAINTAINERS
>> index 3ff56f5..f207805 100644
>> --- a/MAINTAINERS
>> +++ b/MAINTAINERS
>> @@ -209,6 +209,11 @@ F: disas/hppa.c
>>  F: hw/net/*i82596*
>>  F: include/hw/net/lasi_82596.h
>>  
>> +LoongArch TCG CPUS
>> +M: Song Gao <gaosong@loongson.cn>
>> +S: Maintained
>> +F: target/loongarch/
>> +
>>  M68K TCG CPUs
>>  M: Laurent Vivier <laurent@vivier.eu>
>>  S: Maintained
>> diff --git a/target/loongarch/README b/target/loongarch/README
>> new file mode 100644
>> index 0000000..0addfc7
>> --- /dev/null
>> +++ b/target/loongarch/README
>> @@ -0,0 +1,16 @@
>> +LoongArch is the general processor architecture of Loongson.
>> +
>> +The following versions of the LoongArch core are supported
>> +    core: 3A5000
>> +
>> https://github.com/loongson/LoongArch-Documentation/releases/download/LoongArch-Vol1-v3/LoongArch-Vol1-v1.00-EN.pdf
> 
> This part, perhaps slightly expanded is probably better aimed at
> docs/system/target-loongarch.rst so it can be included in the generated
> manual. Bonus points for something along the lines of
> docs/system/arm/versatile.rst where you give a quick breakdown of the
> kernel config and an example command line.
> 
>> +
>> +There are several code directories
>> +
>> +    1 qemu/target/loongarch
>> +        This is the instruction emulation directory
>> +    2 qemu/linux-user/loongarch64
>> +        Linux-user simulation
>> +    3 qemu/hw/loongarch
>> +        System simulation
>> +    4 qemu/tests/tcg/loongarch
>> +        Linux-user test
> 
> 
This is a good suggestion, I‘ll do it.

thanks.
gaosong June 30, 2021, 1:22 a.m. UTC | #6
Hi, Peter,

On 06/29/2021 07:52 PM, Peter Maydell wrote:
> On Mon, 28 Jun 2021 at 13:04, Song Gao <gaosong@loongson.cn> wrote:
>>
>> This patch give an introduction to the LoongArch target.
>>
>> Signed-off-by: Song Gao <gaosong@loongson.cn>
>> ---
> 
>> +There are several code directories
>> +
>> +    1 qemu/target/loongarch
>> +        This is the instruction emulation directory
>> +    2 qemu/linux-user/loongarch64
>> +        Linux-user simulation
>> +    3 qemu/hw/loongarch
>> +        System simulation
>> +    4 qemu/tests/tcg/loongarch
>> +        Linux-user test
> 
> This isn't particularly specific to loongarch -- it's how
> all QEMU targets are structured. So I'm not sure you need
> to document it in an loongarch-specific README.
> 
> thanks
> -- PMM
> 

This part is redundant, I'll change it as Alex suggests.

> 
> This part, perhaps slightly expanded is probably better aimed at
> docs/system/target-loongarch.rst so it can be included in the generated
> manual. Bonus points for something along the lines of
> docs/system/arm/versatile.rst where you give a quick breakdown of the
> kernel config and an example command line.
> 

thanks
diff mbox series

Patch

diff --git a/MAINTAINERS b/MAINTAINERS
index 3ff56f5..f207805 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -209,6 +209,11 @@  F: disas/hppa.c
 F: hw/net/*i82596*
 F: include/hw/net/lasi_82596.h
 
+LoongArch TCG CPUS
+M: Song Gao <gaosong@loongson.cn>
+S: Maintained
+F: target/loongarch/
+
 M68K TCG CPUs
 M: Laurent Vivier <laurent@vivier.eu>
 S: Maintained
diff --git a/target/loongarch/README b/target/loongarch/README
new file mode 100644
index 0000000..0addfc7
--- /dev/null
+++ b/target/loongarch/README
@@ -0,0 +1,16 @@ 
+LoongArch is the general processor architecture of Loongson.
+
+The following versions of the LoongArch core are supported
+    core: 3A5000
+    https://github.com/loongson/LoongArch-Documentation/releases/download/LoongArch-Vol1-v3/LoongArch-Vol1-v1.00-EN.pdf
+
+There are several code directories
+
+    1 qemu/target/loongarch
+        This is the instruction emulation directory
+    2 qemu/linux-user/loongarch64
+        Linux-user simulation
+    3 qemu/hw/loongarch
+        System simulation
+    4 qemu/tests/tcg/loongarch
+        Linux-user test