README.adoc

= LoongArch Documentation Loongson Technology Corporation Limited

Click the links below for more details:

• https://loongson.github.io/LoongArch-Documentation/README-EN.html[English]
• https://loongson.github.io/LoongArch-Documentation/README-CN.html[中文]

== Introduction

The documentation for LoongArch.

• You can find documents online https://loongson.github.io/LoongArch-Documentation[here].

• You can find all historical versions https://github.com/loongson/LoongArch-Documentation/releases[here].

The HTML versions are more readable than the PDF versions, not only because there exists tables of excessive length, but also because the theme of HTML versions is easier to customize. To make it easier to download, each HTML page contains embedded CSS and images.

== Documents

• LoongArch Reference Manual - Volume 1: Basic Architecture: This manual describes the basic part of the LoongArch architecture. ** https://loongson.github.io/LoongArch-Documentation/LoongArch-Vol1-EN.html[HTML version]. ** https://loongson.github.io/LoongArch-Documentation/LoongArch-Vol1-EN.pdf[PDF version]. ** https://github.com/loongson/LoongArch-Documentation/releases/latest/download/LoongArch-Vol1-v1.10-CN.pdf[Original document].

• LoongArch Reference Manual - Volume 2: Vector Extensions: This manual describes the vector extensions (SIMD and Advanced SIMD Extensions) of the LoongArch architecture. (TBD) ** HTML version. ** PDF version. ** Original document.

• LoongArch Reference Manual - Volume 3: Virtualization and Binary Translation Extensions: This manual describes the virtualization and binary translation extensions of the LoongArch architecture. (TBD) ** HTML version. ** PDF version. ** Original document.

• Loongson 3A5000/3B5000 Processor Reference Manual - Multicore Processor Architecture, Register Descriptions and System Software Programming Guide: This manual introduces the Loongson 3A5000/3B5000 multicore processor architecture and register descriptions. ** https://loongson.github.io/LoongArch-Documentation/Loongson-3A5000-usermanual-EN.html[HTML version]. ** https://loongson.github.io/LoongArch-Documentation/Loongson-3A5000-usermanual-EN.pdf[PDF version]. ** https://github.com/loongson/LoongArch-Documentation/releases/latest/download/Loongson-3A5000-usermanual-v1.03-CN.pdf[Original document].

• Loongson 7A1000 Bridge User Manual: This manual describes the overall bridge architecture, clock structure, address space, configuration registers, and individual functional interfaces, primarily for BIOS and kernel developers. ** https://loongson.github.io/LoongArch-Documentation/Loongson-7A1000-usermanual-EN.html[HTML version]. ** https://loongson.github.io/LoongArch-Documentation/Loongson-7A1000-usermanual-EN.pdf[PDF version]. ** https://github.com/loongson/LoongArch-Documentation/releases/latest/download/Loongson-7A1000-usermanual-v2.00-CN.pdf[Original document].

• LoongArch ELF ABI: This manual describes the LoongArch ELF ABI. ** https://loongson.github.io/LoongArch-Documentation/LoongArch-ELF-ABI-EN.html[HTML version]. ** https://loongson.github.io/LoongArch-Documentation/LoongArch-ELF-ABI-EN.pdf[PDF version].

• LoongArch Processor SMBIOS Spec: This document introduces additional information about LoongArch in SMBIOS. ** https://loongson.github.io/LoongArch-Documentation/LoongArch-Processor-SMBIOS-Spec-EN.html[HTML version].