Editing HV Syscall Reference

Jump to navigation Jump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
[[Category:Software]]
= HV Syscalls =
= HV Syscalls =


Line 221: Line 222:
|R4
|R4
|vas_id - virtual address space id of the PPE
|vas_id - virtual address space id of the PPE
|-
|R5
|htab_size_log2 - 18, 19 or 20 (256KB, 512KB or 1MB)
|-
|R6
|number_of_sizes - How many page sizes are specified in page_sizes
|-
|R7
|page_sizes - see lv1_construct_virtual_address_space
|}
|}


Line 236: Line 228:
Regardless of the ppe_id, when called from kernel module init function, vas_id always seems to be 11.
Regardless of the ppe_id, when called from kernel module init function, vas_id always seems to be 11.
----
----
=== lv1_query_logical_partition_address_region_info ===
=== lv1_query_logical_partition_address_region_info ===


Line 785: Line 776:
=== lv1_detect_pending_interrupts ===
=== lv1_detect_pending_interrupts ===


Not used in current kernel. Used in ps2_gxemu.
Not used in current kernel.


===== Abstract Call =====
===== Abstract Call =====
Line 800: Line 791:
|-
|-
|R3
|R3
|p1 - unknown (only 0 value is supported)
|p1 - unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 808: Line 799:
|-
|-
|R3
|R3
|Status
|Status?
|-
|-
|R4
|R4
|v1 - irq_bitmap[0]
|v1 - Unknown
|-
|-
|R5
|R5
|v2 - irq_bitmap[1]
|v2 - Unknown
|-
|-
|R6
|R6
|v3 - irq_bitmap[2]
|v3 - Unknown
|-
|-
|R7
|R7
|v4 - irq_bitmap[3]
|v4 - Unknown
|-
|-
|}
|}


Notes:<br>
Notes:
Return 256 bit irq bitmap for previously connected irq plugs (using lv1_connect_irq_plug).<br>
 
Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
----
----
=== lv1_end_of_interrupt ===
=== lv1_end_of_interrupt ===


Line 1,274: Line 1,264:
|}
|}
----
----
=== lv1_undocumented_function_62 ===
SPE (isolation, it updates a SLB entry, writes to SLB_Index, SLB_VSID, SLB_ESID and SLB_Invalidate_Entry registers)
----
=== lv1_set_slb_for_logical_spu ===
=== lv1_set_slb_for_logical_spu ===


Line 1,655: Line 1,638:
----
----
=== lv1_undocumented_function_89 ===
=== lv1_undocumented_function_89 ===
SPE (writes to MFC_TLB_Invalidate_Entry register)


Exists in PAL 1.7; Returned -6 (LV1_NO_ENTRY) when passed 0 in R3 to R10.
Exists in PAL 1.7; Returned -6 (LV1_NO_ENTRY) when passed 0 in R3 to R10.
----
----
=== lv1_create_repository_node ===
=== lv1_create_repository_node ===


Line 1,928: Line 1,908:
|00000000000000 (0)
|00000000000000 (0)
|00000000000000 (0)
|00000000000000 (0)
|System Debug Flag
|–
|-
|-
|sys.flash.boot.#0
|sys.flash.boot.#0
Line 2,036: Line 2,016:
|}
|}
----
----
=== lv1_modify_repository_node_value ===
=== lv1_modify_repository_node_value ===


Line 2,174: Line 2,153:
=== lv1_set_dabr ===
=== lv1_set_dabr ===


Sets dabr (Data Address Breakpoint Register) and dabrx (Data Address Breakpoint Register Extension)
Sets dabr (data address breakpoint register) - an exception should be thrown upon access to data at this address (range?)


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_set_dabr( /*IN*/ dabr, dabrx);
  result = lv1_set_dabr( /*IN*/ dabr, DABR_KERNEL | DABR_USER);


===== Parameters =====
===== Parameters =====
Line 2,189: Line 2,168:
|-
|-
|R3
|R3
|dabr - see notes
|dabr - data address
|-
|-
|R4
|R4
|dabrx - see notes
|(DABR_KERNEL | DABR_USER) - see notes
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,205: Line 2,184:


Notes:
Notes:
*DABR:
Bit(s) Name Description
0:60  DAB  Data Address Breakpoint
61    BT  Breakpoint Translation
62    DW  Data Write
63    DR  Data Read


*DABRX
DABR_KERNEL and DABR_USER are defined in “setup.c” as follows
Bit(s) Name  Description
0:59        Reserved
60    BTI  Breakpoint Translation Ignore
61:63  PRIVM Privilege Mask
61    HYP  Hypervisor state - unsupported in LV1
62    PNH  Privileged but Non-Hypervisor state
63    PRO  Problem state
When PRIVM in dabrx is 0 or when any unsupported or reserved bit in dabrx is active, both dabr and dabrx writes are not performed and 0x2FFFFFFEF is returned. <br><br>
DABRX is defined in “setup.c” as follows
  enum {DABR_USER = 1, DABR_KERNEL = 2,};
  enum {DABR_USER = 1, DABR_KERNEL = 2,};
----
----
=== lv1_set_vmx_graphics_mode ===
=== lv1_set_vmx_graphics_mode ===


Line 2,263: Line 2,226:
The Cell Broadband Engine Programming Handbook has this to say on the subject: The first implementation of the Cell Broadband Engine Architecture (CBEA) (the CBE processor) supports instructions with a graphics rounding mode. This mode allows programs written with vector/SIMD multimedia extension instructions to produce floating-point results that are equivalent in precision to those written in the SPU instruction set. In this mode, as in the SPU environment, the default rounding mode is round to zero, denormals are treated as zero, and there are no infinities or NaNs.
The Cell Broadband Engine Programming Handbook has this to say on the subject: The first implementation of the Cell Broadband Engine Architecture (CBEA) (the CBE processor) supports instructions with a graphics rounding mode. This mode allows programs written with vector/SIMD multimedia extension instructions to produce floating-point results that are equivalent in precision to those written in the SPU instruction set. In this mode, as in the SPU environment, the default rounding mode is round to zero, denormals are treated as zero, and there are no infinities or NaNs.


This call change bit 12 (known as grap_md or grap_mode in various documents) in the HID1 register. Hardware Implementation Register 1 is a HV privileged resource, hence to change the mode from Supervisor mode requires a HV call.
To change this mode, bit 12 in the HID1 register (known as grap_md or grap_mode in various documents). HID1 is a HV privileged resource, hence to change the mode from Supervisor mode requires a HV call.


Reference Documents: Cell Broadband Engine Programming Handbook V1.1 Cell Broadband Engine Registers V1.5
Reference Documents: Cell Broadband Engine Programming Handbook V1.1 Cell Broadband Engine Registers V1.5
Line 2,273: Line 2,236:
When recompiled into Kernel module init function, accepts values of 0 and 1 for p1. All other values return -17 (LV1_ILLEGAL_PARAMETER_VALUE)
When recompiled into Kernel module init function, accepts values of 0 and 1 for p1. All other values return -17 (LV1_ILLEGAL_PARAMETER_VALUE)
----
----
=== lv1_set_thread_switch_control_register ===
=== lv1_set_thread_switch_control_register ===


Line 2,307: Line 2,269:
Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
----
----
=== lv1_authenticate_program_segment ===
=== lv1_undocumented_function_99 ===
previous alias: lv1_undocumented_function_99
 
SPE (isolation, syscall 0x10043, syscall 0x10042, syscall 0x1004A)


Exists in PAL 1.7; Returned -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
Exists in PAL 1.7; Returned -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
----
----
=== lv1_undocumented_function_102 ===
=== lv1_undocumented_function_102 ===
Returns current TB ticks


Exists in PAL 1.7; Returned 0 (LV1_SUCCESS) and R4 = 0x692F5D1E7h when passed 0 in R3 to R10.
Exists in PAL 1.7; Returned 0 (LV1_SUCCESS) and R4 = 0x692F5D1E7h when passed 0 in R3 to R10.
----
----
=== lv1_get_total_execution_time ===
=== lv1_get_total_execution_time ===


Line 2,382: Line 2,337:
Exists in PAL 1.7. Returns the same as [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
Exists in PAL 1.7. Returns the same as [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
----
----
=== lv1_read_remote_file ===
=== lv1_undocumented_function_110 ===
 
Exists in PAL 1.7. Returns -6 (LV1_NO_ENTRY) in R3, rest same as  [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
----
=== lv1_undocumented_function_111 ===
 
Exists in PAL 1.7. Returns -6 (LV1_NO_ENTRY) in R3, rest same as  [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
----
=== lv1_undocumented_function_112 ===
 
Exists in PAL 1.7. Returns -6 (LV1_NO_ENTRY) in R3, rest same as  [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
----
=== lv1_undocumented_function_114 ===


===== Parameters =====
===== Parameters =====
Line 2,393: Line 2,360:
|-
|-
|R3
|R3
|u32 type
|start -
|-
|-
|R4
|R4
|u32 *path
|page_size -
|-
|-
|R5
|R5
|u64 offset
|size -  
|-
|R6
|u32 *buf
|-
|R7
|u64 size
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,413: Line 2,374:
|-
|-
|R3
|R3
|status - 0 = OK, LV1_TYPE_MISMATCH when type is not 1. Other values are unknown but indicate failure.
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|-
|R4
|R4
|n_read
|lpar_addr -
|-
|-
|}
|}
----
----


=== lv1_write_remote_file ===
=== lv1_undocumented_function_115 ===


===== Parameters =====
===== Parameters =====
Line 2,432: Line 2,394:
|-
|-
|R3
|R3
|u32 type
|lpar_addr -  
|-
|R4
|u32 *path
|-
|R5
|u64 offset
|-
|R6
|u32 *buf
|-
|R7
|u64 size
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,452: Line 2,402:
|-
|-
|R3
|R3
|status
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|n_write
|-
|-
|}
|}
----
----
=== lv1_get_remote_file_size ===
 
=== lv1_allocate_io_segment ===
 
Allocate an io segment.
 
===== kboot Call =====
 
result = lv1_allocate_io_segment( /*IN*/ ioas_id, segment_size, io_page_size, /*OUT*/ &ioif_addr );


===== Parameters =====
===== Parameters =====
Line 2,470: Line 2,426:
|-
|-
|R3
|R3
|u32 type
|ioas_id - io address space id
|-
|-
|R4
|R4
|u32 *path
|segment_size - io segment size
|-
|R5
|io_page_size - io page size, 0xC, 0×10, 0×14
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,481: Line 2,440:
|-
|-
|R3
|R3
|status
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|-
|R4
|R4
|file_size
|ioif_addr - io interface address
|-
|-
|}----
|}
=== lv1_map_physical_address_region ===
 
Notes:
 
Code taken from kboot-10\dl\linux-2.6.16\sound\powerpc\snd_ps3pf.c (kboot-20061208)
ret64 = lv1_allocate_io_segment(0,          /* io space */
    IO_SEGMENTSIZE, /* segment size */
    IO_PAGESIZE_SHIFT, /* io page size */
    &(ioif_map_info_array[current_segment].ioif_addr));
----
=== lv1_release_io_segment ===
 
Release an io segment.
 
===== kboot Call =====
 
result = lv1_release_io_segment( /*IN*/ ioas_id, ioif_addr );


===== Parameters =====
===== Parameters =====
Line 2,498: Line 2,472:
|-
|-
|R3
|R3
|start -  
|ioas_id - io address space id
|-
|-
|R4
|R4
|page_size -  
|ioif_addr - io interface address
|-
|-
|R5
! colspan="2" | Outputs
|size -
|-
! colspan="2" | Outputs
|-
|-
!Register
!Register
Line 2,513: Line 2,484:
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|lpar_addr -
|-
|-
|}
|}


Notes:
Code taken from kboot-10\dl\linux-2.6.16\sound\powerpc\snd_ps3pf.c (kboot-20061208)
ret64 = lv1_release_io_segment(0, /* io space */
    ioif_map_info_array[current_segment].ioif_addr);
----
----
=== lv1_allocate_ioid ===
Not used in current kernel.


=== lv1_unmap_physical_address_region ===
===== Abstract Call =====
 
result = lv1_allocate_ioid( /*IN*/ p1, /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 2,532: Line 2,510:
|-
|-
|R3
|R3
|lpar_addr -
|SBZ
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,540: Line 2,518:
|-
|-
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status?
|-
|R4
|the ioid
|-
|-
|}
|}


Notes:


Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
----
----
=== lv1_release_ioid ===


=== lv1_allocate_io_segment ===
Not used in current Kernel.


Allocate an io segment.
===== Abstract Call =====


===== kboot Call =====
  result = lv1_release_ioid( /*IN*/ p1, p2 );
 
  result = lv1_allocate_io_segment( /*IN*/ ioas_id, segment_size, io_page_size, /*OUT*/ &ioif_addr );


===== Parameters =====
===== Parameters =====
Line 2,564: Line 2,546:
|-
|-
|R3
|R3
|ioas_id - io address space id
|p1 - Unknown
|-
|-
|R4
|R4
|segment_size - io segment size
|p2 - Unknown
|-
|R5
|io_page_size - io page size, 0xC, 0×10, 0×14
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,578: Line 2,557:
|-
|-
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status?
|-
|R4
|ioif_addr - io interface address
|-
|-
|}
|}
Line 2,587: Line 2,563:
Notes:
Notes:


Code taken from kboot-10\dl\linux-2.6.16\sound\powerpc\snd_ps3pf.c (kboot-20061208)
Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
ret64 = lv1_allocate_io_segment(0,          /* io space */
----
    IO_SEGMENTSIZE, /* segment size */
=== lv1_construct_io_irq_outlet ===
    IO_PAGESIZE_SHIFT, /* io page size */
    &(ioif_map_info_array[current_segment].ioif_addr));
----
=== lv1_release_io_segment ===


Release an io segment.
Construct an outlet for a non-virtualized device interrupt.


===== kboot Call =====
===== Kernel Call =====


  result = lv1_release_io_segment( /*IN*/ ioas_id, ioif_addr );
  result = lv1_construct_io_irq_outlet( /*IN*/ interrupt_id, /*OUT*/ &outlet );


===== Parameters =====
===== Parameters =====
Line 2,610: Line 2,582:
|-
|-
|R3
|R3
|ioas_id - io address space id
|interrupt_id - interrupt id
|-
|R4
|ioif_addr - io interface address
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,622: Line 2,591:
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|outlet - interrupt outlet
|-
|-
|}
|}
Notes:
Code taken from kboot-10\dl\linux-2.6.16\sound\powerpc\snd_ps3pf.c (kboot-20061208)
ret64 = lv1_release_io_segment(0, /* io space */
    ioif_map_info_array[current_segment].ioif_addr);
----
----
=== lv1_allocate_ioid ===
=== lv1_destruct_io_irq_outlet ===


Not used in current kernel.
Destruct a previously constructed device interrupt outlet.


===== Abstract Call =====
===== Kernel Call =====


  result = lv1_allocate_ioid( /*IN*/ p1, /*OUT*/ &v1 );
  result = lv1_destruct_io_irq_outlet( /*IN*/ outlet );


===== Parameters =====
===== Parameters =====
Line 2,648: Line 2,614:
|-
|-
|R3
|R3
|SBZ
|outlet - interrupt outlet
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,656: Line 2,622:
|-
|-
|R3
|R3
|Status?
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|the ioid
|-
|}
|}
----
=== lv1_map_htab ===


Notes:
Map the hash page table.


Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
===== Kernel Call =====
----
=== lv1_release_ioid ===


Not used in current Kernel.
  result = lv1_map_htab( /*IN*/ 0, /*OUT*/ &htab_addr );
 
===== Abstract Call =====
 
  result = lv1_release_ioid( /*IN*/ p1, p2 );


===== Parameters =====
===== Parameters =====
Line 2,684: Line 2,642:
|-
|-
|R3
|R3
|p1 - Unknown
|0 - Unknown (lpid?)
|-
|R4
|p2 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,697: Line 2,652:
|Status?
|Status?
|-
|-
|R4
|htab_addr - hash page table address
|}
|}


Notes:
Notes:


Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
In “htab.c” return code is assigned, but not used. Must be translated and ioremapped before it can be used in the kernel. It’s 1MB long
----
----
=== lv1_construct_io_irq_outlet ===
=== lv1_unmap_htab ===


Construct an outlet for a non-virtualized device interrupt.
Unmap the hash page table.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_construct_io_irq_outlet( /*IN*/ interrupt_id, /*OUT*/ &outlet );
  lv1_unmap_htab( /*IN*/ htab_addr );


===== Parameters =====
===== Parameters =====
Line 2,720: Line 2,677:
|-
|-
|R3
|R3
|interrupt_id - interrupt id
|htab_addr - hash page table address
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,728: Line 2,685:
|-
|-
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status?
|-
|R4
|outlet - interrupt outlet
|-
|}
|}
----
----
=== lv1_destruct_io_irq_outlet ===
=== lv1_undocumented_function_124 ===
 
Exists in PAL 1.7. Returns -6 (LV1_NO_ENTRY) in R3, rest same as  [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
----
=== lv1_undocumented_function_125 ===
 
Exists in PAL 1.7. Returns -6 (LV1_NO_ENTRY) in R3, rest same as  [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
----
=== lv1_undocumented_function_126 ===
 
Exists in PAL 1.7. Returns -6 (LV1_NO_ENTRY) in R3, rest same as  [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
----
=== lv1_get_version_info ===


Destruct a previously constructed device interrupt outlet.
Returns PS3 firmware version information.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_destruct_io_irq_outlet( /*IN*/ outlet );
  result = lv1_get_version_info( /*OUT*/ &raw );


===== Parameters =====
===== Parameters =====
{| class="wikitable"
{| class="wikitable"
|-
|-
! colspan="2" | Inputs
! colspan="2" | Outputs
|-
|-
!Register
!Register
Line 2,752: Line 2,717:
|-
|-
|R3
|R3
|outlet - interrupt outlet
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|-
! colspan="2" | Outputs
|R4
|-
|raw - firmware data (see notes)
!Register
!Description
|-
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|}
|}
Notes:
The firmware information is accessed using the following union:
union ps3_firmware_version {
u64 raw;
struct {
u16 pad;
u16 major;
u16 minor;
u16 rev;
};
};
----
----
=== lv1_map_htab ===
=== lv1_undocumented_function_134 ===
 
Exists in PAL 1.7. Returns 0 when passed R3-R10=0.
----
=== lv1_undocumented_function_135 ===
 
Exists in PAL 1.7. Returns -6 (LV1_NO_ENTRY) in R3, rest same as  [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
----
=== lv1_undocumented_function_136 ===
 
Exists in PAL 1.7. Returns -6 (LV1_NO_ENTRY) in R3, rest same as  [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
----
=== lv1_undocumented_function_137 ===
 
Exists in PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3-R10.
----
=== lv1_undocumented_function_138 ===
 
Exists in PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3-R10.
----
=== lv1_construct_lpm ===


Map the hash page table.
Not used in current kernel.


===== Kernel Call =====
===== Abstract Call =====


  result = lv1_map_htab( /*IN*/ 0, /*OUT*/ &htab_addr );
  result = lv1_construct_lpm( /*IN*/ p1, p2, p3, p4, p5, p6, /*OUT*/ &v1, &v2, &v3 );


===== Parameters =====
===== Parameters =====
Line 2,780: Line 2,773:
|-
|-
|R3
|R3
|0 - Unknown (lpid?)
|p1 - node_id, this is the node id of the processor, 0 is only valid value
|-
|-
! colspan="2" | Outputs
|R4
|p2 - tb_type, 0 is none, 1 is internal
|-
|R5
|p3 - Unknown, is 0
|-
|R6
|p4 - Unknown, is 0
|-
|R7
|p5 - tb_cache in lpar, 128 byte aligned
|-
|R8
|p6 - tb_cache_size
|-
! colspan="2" | Outputs
|-
|-
!Register
!Register
Line 2,788: Line 2,796:
|-
|-
|R3
|R3
|Status?
|Status
|-
|-
|R4
|R4
|htab_addr - hash page table address
|v1 - lpm_id
|-
|R5
|v2 - outlet_id
|-
|R6
|v3 - tb_size
|-
|}
|}
Notes:
In “htab.c” return code is assigned, but not used. Must be translated and ioremapped before it can be used in the kernel. It’s 1MB long
----
----
=== lv1_unmap_htab ===
=== lv1_destruct_lpm ===


Unmap the hash page table.
Not used in current kernel.


===== Kernel Call =====
===== Abstract Call =====


  lv1_unmap_htab( /*IN*/ htab_addr );
  result = lv1_destruct_lpm( /*IN*/ p1 );


===== Parameters =====
===== Parameters =====
Line 2,815: Line 2,826:
|-
|-
|R3
|R3
|htab_addr - hash page table address
|p1 - lpm_id
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,824: Line 2,835:
|R3
|R3
|Status?
|Status?
|-
|}
|}
----
----
=== lv1_read_remote_file_long_name ===
=== lv1_start_lpm ===
 
Not used in current kernel.
 
===== Abstract Call =====
 
result = lv1_start_lpm( /*IN*/ p1 );


===== Parameters =====
===== Parameters =====
Line 2,837: Line 2,855:
|-
|-
|R3
|R3
|u32 type
|p1 - lpm_id
|-
|-
|R4
! colspan="2" | Outputs
|u32 *path
|-
|R5
|u32 path_len
|-
|R6
|u64 offset
|-
|R7
|u32 *buf
|-
|R8
|u64 size
|-
! colspan="2" | Outputs
|-
|-
!Register
!Register
Line 2,860: Line 2,863:
|-
|-
|R3
|R3
|status
|Status?
|-
|R4
|n_read
|-
|-
|}
|}
----
----
=== lv1_write_remote_file_long_name ===
=== lv1_stop_lpm ===
 
Not used in current kernel.
 
===== Abstract Call =====
 
result = lv1_stop_lpm( /*IN*/ p1, /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 2,878: Line 2,884:
|-
|-
|R3
|R3
|u32 type
|p1 - Unknown
|-
|R4
|u32 *path
|-
|R5
|u32 path_len
|-
|R6
|u64 offset
|-
|R7
|u32 *buf
|-
|R8
|u64 size
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,901: Line 2,892:
|-
|-
|R3
|R3
|status
|Status?
|-
|-
|R4
|R4
|n_write
|v1 - Unknown
|-
|-
|}
|}
----
----
=== lv1_get_remote_file_size_long_name ===
=== lv1_copy_lpm_trace_buffer ===
 
Not used in current kernel.
 
===== Abstract Call =====
 
result = lv1_copy_lpm_trace_buffer( /*IN*/ p1, p2, p3 /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 2,919: Line 2,916:
|-
|-
|R3
|R3
|u32 type
|p1 - lpm_id
|-
|-
|R4
|R3
|u32 *path
|p2 - offset
|-
|-
|R5
|R3
|u32 path_len
|p3 - request
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,933: Line 2,930:
|-
|-
|R3
|R3
|status
|Status
|-
|-
|R4
|R4
|file_size
|v1 - tmp
|-
|-
|}
|}
----
----
=== lv1_get_version_info ===
=== lv1_add_lpm_event_bookmark ===


Returns PS3 firmware version information.
Not in current kernel.


===== Kernel Call =====
===== Abstract Call =====


  result = lv1_get_version_info( /*OUT*/ &raw );
  result = lv1_add_lpm_event_bookmark( /*IN*/ p1, p2, p3, p4, p5 );


===== Parameters =====
===== Parameters =====
{| class="wikitable"
{| class="wikitable"
|-
! colspan="2" | Inputs
|-
!Register
!Description
|-
|R3
|p1 - Unknown
|-
|R3
|p2 - Unknown
|-
|R3
|p3 - Unknown
|-
|R6
|p4 - Unknown
|-
|R7
|p5 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 2,957: Line 2,974:
|-
|-
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status?
|-
|-
|R4
|raw - firmware data (see notes)
|}
|}
----
=== lv1_delete_lpm_event_bookmark ===


Notes:
Not used in current kernel.


The firmware information is accessed using the following union:
===== Abstract Call =====
union ps3_firmware_version {
u64 raw;
struct {
u16 pad;
u16 major;
u16 minor;
u16 rev;
};
};
----
=== lv1_undocumented_function_134 ===


Exists in PAL 1.7. Returns 0 when passed R3-R10=0.
  result = lv1_delete_lpm_event_bookmark( /*IN*/ p1, p2, p3 );
----
=== lv1_undocumented_function_135 ===
 
Exists in PAL 1.7. Returns -6 (LV1_NO_ENTRY) in R3, rest same as  [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
----
=== lv1_undocumented_function_136 ===
 
Exists in PAL 1.7. Returns -6 (LV1_NO_ENTRY) in R3, rest same as  [[HV_Syscall_Reference#lv1_undocumented_function_105|lv1_undocumented_function_105]].
----
=== lv1_undocumented_function_137 ===
SPE
 
Exists in PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3-R10.
----
 
=== lv1_undocumented_function_138 ===
SPE
 
Exists in PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3-R10.
----
 
=== lv1_construct_lpm ===
 
Not used in current kernel.
 
===== Abstract Call =====
 
  result = lv1_construct_lpm( /*IN*/ p1, p2, p3, p4, p5, p6, /*OUT*/ &v1, &v2, &v3 );


===== Parameters =====
===== Parameters =====
Line 3,017: Line 2,995:
|-
|-
|R3
|R3
|p1 - node_id, this is the node id of the processor, 0 is only valid value
|p1 - Unknown
|-
|-
|R4
|R3
|p2 - tb_type, 0 is none, 1 is internal
|p2 - Unknown
|-
|-
|R5
|R3
|p3 - Unknown, is 0
|p3 - Unknown
|-
|R6
|p4 - Unknown, is 0
|-
|R7
|p5 - tb_cache in lpar, 128 byte aligned
|-
|R8
|p6 - tb_cache_size
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,040: Line 3,009:
|-
|-
|R3
|R3
|Status
|Status?
|-
|-
|R4
|}
|v1 - lpm_id
----
|-
=== lv1_set_lpm_interrupt_mask ===
|R5
|v2 - outlet_id
|-
|R6
|v3 - tb_size
|-
|}
----
=== lv1_destruct_lpm ===


Not used in current kernel.
Not used in current kernel.
Line 3,059: Line 3,019:
===== Abstract Call =====
===== Abstract Call =====


  result = lv1_destruct_lpm( /*IN*/ p1 );
  result = lv1_set_lpm_interrupt_mask( /*IN*/ p1, p2, p3, /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 3,070: Line 3,030:
|-
|-
|R3
|R3
|p1 - lpm_id
|p1 - Unknown
|-
|R3
|p2 - Unknown
|-
|R3
|p3 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,079: Line 3,045:
|R3
|R3
|Status?
|Status?
|-
|R4
|v1 - Unknown
|-
|-
|}
|}
----
----
=== lv1_start_lpm ===
=== lv1_get_lpm_interrupt_status ===


Not used in current kernel.
Not used in current kernel.
Line 3,088: Line 3,057:
===== Abstract Call =====
===== Abstract Call =====


  result = lv1_start_lpm( /*IN*/ p1 );
  result = lv1_get_lpm_interrupt_status( /*IN*/ p1, /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 3,099: Line 3,068:
|-
|-
|R3
|R3
|p1 - lpm_id
|p1 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,108: Line 3,077:
|R3
|R3
|Status?
|Status?
|-
|R4
|v1 - Unknown
|-
|-
|}
|}
----
----
=== lv1_stop_lpm ===
=== lv1_set_lpm_general_control ===


Not used in current kernel.
Not used in current kernel.
Line 3,117: Line 3,089:
===== Abstract Call =====
===== Abstract Call =====


  result = lv1_stop_lpm( /*IN*/ p1, /*OUT*/ &v1 );
  result = lv1_set_lpm_general_control( /*IN*/ p1, p2, p3, p4, p5, /*OUT*/ &v1, &v2 );


===== Parameters =====
===== Parameters =====
Line 3,129: Line 3,101:
|R3
|R3
|p1 - Unknown
|p1 - Unknown
|-
|R4
|p2 - Unknown
|-
|R5
|p3 - Unknown
|-
|R6
|p4 - Unknown
|-
|R7
|p5 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,140: Line 3,124:
|R4
|R4
|v1 - Unknown
|v1 - Unknown
|-
|R5
|v2 - Unknown
|-
|-
|}
|}
----
----
=== lv1_copy_lpm_trace_buffer ===
=== lv1_set_lpm_interval ===


Not used in current kernel.
Not used in current kernel.
Line 3,149: Line 3,136:
===== Abstract Call =====
===== Abstract Call =====


  result = lv1_copy_lpm_trace_buffer( /*IN*/ p1, p2, p3 /*OUT*/ &v1 );
  result = lv1_set_lpm_interval( /*IN*/ p1, p2, p3, /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 3,160: Line 3,147:
|-
|-
|R3
|R3
|p1 - lpm_id
|p1 - Unknown
|-
|-
|R3
|R4
|p2 - offset
|p2 - Unknown
|-
|-
|R3
|R5
|p3 - request
|p3 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,174: Line 3,161:
|-
|-
|R3
|R3
|Status
|Status?
|-
|-
|R4
|R4
|v1 - tmp
|v1 - Unknown
|-
|-
|}
|}
----
----
=== lv1_add_lpm_event_bookmark ===
=== lv1_set_lpm_trigger_control ===


Not in current kernel.
Not used in current kernel.


===== Abstract Call =====
===== Abstract Call =====


  result = lv1_add_lpm_event_bookmark( /*IN*/ p1, p2, p3, p4, p5 );
  result = lv1_set_lpm_trigger_control( /*IN*/ p1, p2, p3, /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 3,200: Line 3,187:
|p1 - Unknown
|p1 - Unknown
|-
|-
|R3
|R4
|p2 - Unknown
|p2 - Unknown
|-
|-
|R3
|R5
|p3 - Unknown
|p3 - Unknown
|-
|R6
|p4 - Unknown
|-
|R7
|p5 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,219: Line 3,200:
|R3
|R3
|Status?
|Status?
|-
|R4
|v1 - Unknown
|-
|-
|}
|}
----
----
=== lv1_delete_lpm_event_bookmark ===
=== lv1_set_lpm_counter_control ===


Not used in current kernel.
Not used in current kernel.
Line 3,228: Line 3,212:
===== Abstract Call =====
===== Abstract Call =====


  result = lv1_delete_lpm_event_bookmark( /*IN*/ p1, p2, p3 );
  result = lv1_set_lpm_counter_control( /*IN*/ p1, p2, p3, p4, /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 3,241: Line 3,225:
|p1 - Unknown
|p1 - Unknown
|-
|-
|R3
|R4
|p2 - Unknown
|p2 - Unknown
|-
|-
|R3
|R5
|p3 - Unknown
|p3 - Unknown
|-
|R6
|p4 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,254: Line 3,241:
|R3
|R3
|Status?
|Status?
|-
|R4
|v1 - Unknown
|-
|-
|}
|}
----
----
=== lv1_set_lpm_interrupt_mask ===
=== lv1_set_lpm_group_control ===


Not used in current kernel.
Not used in current kernel.
Line 3,263: Line 3,253:
===== Abstract Call =====
===== Abstract Call =====


  result = lv1_set_lpm_interrupt_mask( /*IN*/ p1, p2, p3, /*OUT*/ &v1 );
  result = lv1_set_lpm_group_control( /*IN*/ p1, p2, p3, /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 3,276: Line 3,266:
|p1 - Unknown
|p1 - Unknown
|-
|-
|R3
|R4
|p2 - Unknown
|p2 - Unknown
|-
|-
|R3
|R5
|p3 - Unknown
|p3 - Unknown
|-
|-
Line 3,295: Line 3,285:
|}
|}
----
----
=== lv1_get_lpm_interrupt_status ===
=== lv1_set_lpm_debug_bus_control ===


Not used in current kernel.
Not used in current kernel.
Line 3,301: Line 3,291:
===== Abstract Call =====
===== Abstract Call =====


  result = lv1_get_lpm_interrupt_status( /*IN*/ p1, /*OUT*/ &v1 );
  result = lv1_set_lpm_debug_bus_control( /*IN*/ p1, p2, p3, /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 3,313: Line 3,303:
|R3
|R3
|p1 - Unknown
|p1 - Unknown
|-
|R4
|p2 - Unknown
|-
|R5
|p3 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,327: Line 3,323:
|}
|}
----
----
=== lv1_set_lpm_general_control ===
=== lv1_set_lpm_counter ===


Not used in current kernel.
Not used in current kernel.
Line 3,333: Line 3,329:
===== Abstract Call =====
===== Abstract Call =====


  result = lv1_set_lpm_general_control( /*IN*/ p1, p2, p3, p4, p5, /*OUT*/ &v1, &v2 );
  result = lv1_set_lpm_counter( /*IN*/ p1, p2, p3, p4, p5, /*OUT*/ &v1, &v2 );


===== Parameters =====
===== Parameters =====
Line 3,374: Line 3,370:
|}
|}
----
----
=== lv1_set_lpm_interval ===
=== lv1_set_lpm_signal ===


Not used in current kernel.
Not used in current kernel.
Line 3,380: Line 3,376:
===== Abstract Call =====
===== Abstract Call =====


  result = lv1_set_lpm_interval( /*IN*/ p1, p2, p3, /*OUT*/ &v1 );
  result = lv1_set_lpm_signal( /*IN*/ p1, p2, p3, p4, p5, p6, p7 );


===== Parameters =====
===== Parameters =====
Line 3,398: Line 3,394:
|R5
|R5
|p3 - Unknown
|p3 - Unknown
|-
|R6
|p4 - Unknown
|-
|R7
|p5 - Unknown
|-
|R8
|p6 - Unknown
|-
|R9
|p7 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,406: Line 3,414:
|R3
|R3
|Status?
|Status?
|-
|R4
|v1 - Unknown
|-
|-
|}
|}
----
----
=== lv1_set_lpm_trigger_control ===
=== lv1_set_lpm_spr_trigger ===


Not used in current kernel.
Not used in current kernel.
Line 3,418: Line 3,423:
===== Abstract Call =====
===== Abstract Call =====


  result = lv1_set_lpm_trigger_control( /*IN*/ p1, p2, p3, /*OUT*/ &v1 );
  result = lv1_set_lpm_spr_trigger( /*IN*/ p1, p2 );


===== Parameters =====
===== Parameters =====
Line 3,433: Line 3,438:
|R4
|R4
|p2 - Unknown
|p2 - Unknown
|-
|R5
|p3 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,444: Line 3,446:
|R3
|R3
|Status?
|Status?
|-
|R4
|v1 - Unknown
|-
|-
|}
|}
----
----
=== lv1_set_lpm_counter_control ===
=== lv1_insert_htab_entry ===


Not used in current kernel.
Used in current kernel.


===== Abstract Call =====
===== Kernel Call =====


  result = lv1_set_lpm_counter_control( /*IN*/ p1, p2, p3, p4, /*OUT*/ &v1 );
  result = lv1_insert_htab_entry( /*IN*/ p1, p2, p3, p4, p5, p6, /*OUT*/ &v1, &v2, &v3 );


===== Parameters =====
===== Parameters =====
Line 3,467: Line 3,466:
|-
|-
|R3
|R3
|p1 - Unknown
|p1 - htab ID, 0 or returns -6
|-
|-
|R4
|R4
|p2 - Unknown
|p2 - hpte_group, 0 or returns -17
|-
|-
|R5
|R5
|p3 - Unknown
|p3 - hpte_v
|-
|-
|R6
|R6
|p4 - Unknown
|p4 - hpte_r
|-
|R7
|p5 - Bolted flag
|-
|R8
|p6 - flags?
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,487: Line 3,492:
|-
|-
|R4
|R4
|v1 - Unknown
|v1 - inserted_index
|-
|R5
|v2 - evicted_v
|-
|R6
|v3 - evicted_r
|-
|-
|}
|}
Notes: Kernel usage:
result = lv1_insert_htab_entry(PS3_LPAR_VAS_ID_CURRENT, hpte_group,
      hpte_v, hpte_r,
      HPTE_V_BOLTED, 0,
      &inserted_index,
      &evicted_v, &evicted_r);
----
----
=== lv1_set_lpm_group_control ===
=== lv1_read_virtual_uart ===


Not used in current kernel.
Read data from a VUART port into a provided buffer.


===== Abstract Call =====
===== Kernel Call =====


  result = lv1_set_lpm_group_control( /*IN*/ p1, p2, p3, /*OUT*/ &v1 );
  result = lv1_read_virtual_uart( /*IN*/ port_number, buffer, bytes, /*OUT*/ bytes_read );


===== Parameters =====
===== Parameters =====
Line 3,508: Line 3,526:
|-
|-
|R3
|R3
|p1 - Unknown
|port_number - VUART port number
|-
|-
|R4
|R4
|p2 - Unknown
|buffer - pointer to buffer (must be address in lpar)
|-
|-
|R5
|R5
|p3 - Unknown
|bytes - buffer size?
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,522: Line 3,540:
|-
|-
|R3
|R3
|Status?
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|-
|R4
|R4
|v1 - Unknown
|bytes_read - number of bytes read into buffer
|-
|-
|}
|}
----
----
=== lv1_set_lpm_debug_bus_control ===
=== lv1_write_virtual_uart ===


Not used in current kernel.
Write a buffer of data to a VUART port.


===== Abstract Call =====
===== Kernel Call =====


  result = lv1_set_lpm_debug_bus_control( /*IN*/ p1, p2, p3, /*OUT*/ &v1 );
  result = lv1_write_virtual_uart( /*IN*/ port_number, buffer, bytes, /*OUT*/ bytes_written );


===== Parameters =====
===== Parameters =====
Line 3,546: Line 3,564:
|-
|-
|R3
|R3
|p1 - Unknown
|port_number - VUART port number
|-
|-
|R4
|R4
|p2 - Unknown
|buffer - pointer to buffer (must be address in lpar)
|-
|-
|R5
|R5
|p3 - Unknown
|bytes - buffer size?
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,560: Line 3,578:
|-
|-
|R3
|R3
|Status?
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|-
|R4
|R4
|v1 - Unknown
|bytes_written - number of bytes written to VUART
|-
|-
|}
|}
----
----
=== lv1_set_lpm_counter ===
=== lv1_set_virtual_uart_param ===


Not used in current kernel.
Set a parameter for a port on the VUART.


===== Abstract Call =====
===== Kernel Call =====


  result = lv1_set_lpm_counter( /*IN*/ p1, p2, p3, p4, p5, /*OUT*/ &v1, &v2 );
  result = lv1_set_virtual_uart_param( /*IN*/ port_number, param_id, param_value );


===== Parameters =====
===== Parameters =====
Line 3,584: Line 3,602:
|-
|-
|R3
|R3
|p1 - Unknown
|port_number - VUART port number
|-
|-
|R4
|R4
|p2 - Unknown
|param_id - id of parameter to set (see notes)
|-
|-
|R5
|R5
|p3 - Unknown
|param_value - parameter value
|-
|R6
|p4 - Unknown
|-
|R7
|p5 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,604: Line 3,616:
|-
|-
|R3
|R3
|Status?
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|v1 - Unknown
|-
|R5
|v2 - Unknown
|-
|-
|}
|}
See [[HV_Syscall_Reference#lv1_get_virtual_uart_param|lv1_get_virtual_uart_param]] for parameter information.
----
----
=== lv1_set_lpm_signal ===
=== lv1_get_virtual_uart_param ===


Not used in current kernel.
Get a parameter for a port on the VUART.


===== Abstract Call =====
===== Kernel Call =====


  result = lv1_set_lpm_signal( /*IN*/ p1, p2, p3, p4, p5, p6, p7 );
  result = lv1_get_virtual_uart_param( /*IN*/ port_number, param_id, /*OUT*/ &param_value );


===== Parameters =====
===== Parameters =====
Line 3,631: Line 3,639:
|-
|-
|R3
|R3
|p1 - Unknown
|port_number - VUART port number
|-
|-
|R4
|R4
|p2 - Unknown
|param_id - id of parameter to set (see notes)
|-
|R5
|p3 - Unknown
|-
|R6
|p4 - Unknown
|-
|R7
|p5 - Unknown
|-
|R8
|p6 - Unknown
|-
|R9
|p7 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,657: Line 3,650:
|-
|-
|R3
|R3
|Status?
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|param_value - parameter value
|-
|-
|}
|}
----
=== lv1_set_lpm_spr_trigger ===


Not used in current kernel.
VUART parameters defined in vuart.c:
 
===== Abstract Call =====
 
result = lv1_set_lpm_spr_trigger( /*IN*/ p1, p2 );
 
===== Parameters =====
{| class="wikitable"
{| class="wikitable"
|-
|-
! colspan="2" | Inputs
!Parameter
!param_id
!Notes
|-
|-
!Register
|PARAM_TX_TRIGGER
!Description
|0
|
|-
|-
|R3
|PARAM_RX_TRIGGER
|p1 - Unknown
|1
|
|-
|PARAM_INTERRUPT_MASK
|2
|
|-
|PARAM_RX_BUF_SIZE
|3
|read only
|-
|-
|R4
|PARAM_RX_BYTES
|p2 - Unknown
|4
|read only
|-
|-
! colspan="2" | Outputs
|PARAM_TX_BUF_SIZE
|5
|read only, not referenced in current Kernel
|-
|-
!Register
|PARAM_TX_BYTES
!Description
|6
|read only, not referenced in current Kernel
|-
|-
|R3
|PARAM_INTERRUPT_STATUS
|Status?
|7
|read only
|-
|-
|}
|}
----
----
=== lv1_insert_htab_entry ===
=== lv1_configure_virtual_uart_irq ===


Used in current kernel.
Configure the VUART IRQ.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_insert_htab_entry( /*IN*/ p1, p2, p3, p4, p5, p6, /*OUT*/ &v1, &v2, &v3 );
  result = lv1_configure_virtual_uart_irq( /*IN*/ lpar_addr, /*OUT*/ &outlet );


===== Parameters =====
===== Parameters =====
Line 3,710: Line 3,715:
|-
|-
|R3
|R3
|p1 - htab ID, 0 or returns -6
|lpar_addr - logical partition address of virtual uart interrupt bitmap
|-
|-
|R4
! colspan="2" | Outputs
|p2 - hpte_group, 0 or returns -17
|-
|-
|R5
!Register
|p3 - hpte_v
!Description
|-
|-
|R6
|R3
|p4 - hpte_r
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R7
|p5 - Bolted flag
|-
|R8
|p6 - flags?
|-
! colspan="2" | Outputs
|-
!Register
!Description
|-
|R3
|Status?
|-
|-
|R4
|R4
|v1 - inserted_index
|outlet - irq outlet
|-
|R5
|v2 - evicted_v
|-
|R6
|v3 - evicted_r
|-
|-
|}
|}


Notes: Kernel usage:
Notes:
  result = lv1_insert_htab_entry(PS3_LPAR_VAS_ID_CURRENT, hpte_group,
 
      hpte_v, hpte_r,
Comment from interrupt.c:
      HPTE_V_BOLTED, 0,
  /**
      &inserted_index,
* The system supports only a single virtual uart, so multiple calls without
      &evicted_v, &evicted_r);
* freeing the interrupt will return a wrong state error.
*/
----
=== lv1_undocumented_function_167 ===
 
Exists on PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
----
=== lv1_undocumented_function_168 ===
 
Exists on PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
----
----
=== lv1_read_virtual_uart ===
=== lv1_open_device ===


Read data from a VUART port into a provided buffer.
Open the device for a given bus and device id.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_read_virtual_uart( /*IN*/ port_number, buffer, bytes, /*OUT*/ bytes_read );
  result = lv1_open_device( /*IN*/ bus_id, dev_id, 0 );


===== Parameters =====
===== Parameters =====
Line 3,770: Line 3,763:
|-
|-
|R3
|R3
|port_number - VUART port number
|bus_id - bus id
|-
|-
|R4
|R4
|buffer - pointer to buffer (must be address in lpar)
|dev_id - device id
|-
|-
|R5
|R5
|bytes - buffer size?
|0 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,784: Line 3,777:
|-
|-
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status: LV1_SUCCESS (0) - OK
|-
LV1_NO_ENTRY (-6) - invalid dev_id
|R4
LV1_BUSY (-9) - device already open
|bytes_read - number of bytes read into buffer
LV1_ILLEGAL_PARAMETER_VALUE (-17) - invalid bus_id
|-
|-
|}
|}
Notes:
Valid values for bus_id and dev_id can be obtained from the repository (see [[HV_Syscall_Reference#lv1_get_repository_node_value|lv1_get_repository_node_value]]).
Once open, functions such as [[HV_Syscall_Reference#lv1_map_device_mmio_region|lv1_map_device_mmio_region]] and [[HV_Syscall_Reference#lv1_allocate_device_dma_region|lv1_allocate_device_dma_region]] can be used to map the device into memory.
The value of R5 does not seem to affect the outcome of the call (powers of 2 in the 64 bit range were tested). One reason for the flag could be to indicate whether to open the device in shared mode or not (and thus prevent the LV1_BUSY return code).
----
----
=== lv1_write_virtual_uart ===
=== lv1_close_device ===


Write a buffer of data to a VUART port.
Close the device for a given bus and device id.


===== Kernel Call =====
===== Kernel Call =====


result = lv1_write_virtual_uart( /*IN*/ port_number, buffer, bytes, /*OUT*/ bytes_written );
result = lv1_close_device( /*IN*/ bus_id, dev_id );


===== Parameters =====
===== Parameters =====
Line 3,808: Line 3,809:
|-
|-
|R3
|R3
|port_number - VUART port number
|bus_id - bus id
|-
|-
|R4
|R4
|buffer - pointer to buffer (must be address in lpar)
|dev_id - device id
|-
|R5
|bytes - buffer size?
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,823: Line 3,821:
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|bytes_written - number of bytes written to VUART
|-
|-
|}
|}
----
----
=== lv1_set_virtual_uart_param ===
=== lv1_map_device_mmio_region ===


Set a parameter for a port on the VUART.
Map an MMIO region to the specified device.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_set_virtual_uart_param( /*IN*/ port_number, param_id, param_value );
  result = lv1_map_device_mmio_region( /*IN*/ bus_id, dev_id, bus_addr, size, page_size, /*OUT*/ &lpar_addr );


===== Parameters =====
===== Parameters =====
Line 3,846: Line 3,841:
|-
|-
|R3
|R3
|port_number - VUART port number
|bus_id - bus id
|-
|-
|R4
|R4
|param_id - id of parameter to set (see notes)
|dev_id - device id
|-
|-
|R5
|R5
|param_value - parameter value
|bus_addr - address of the region
|-
|-
! colspan="2" | Outputs
|R6
|size - size of the region
|-
|R7
|page_size - page size of the region
|-
! colspan="2" | Outputs
|-
|-
!Register
!Register
Line 3,861: Line 3,862:
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|lpar_addr - logical partition address of the mapped region
|-
|-
|}
|}
See [[HV_Syscall_Reference#lv1_get_virtual_uart_param|lv1_get_virtual_uart_param]] for parameter information.
----
----
=== lv1_get_virtual_uart_param ===
=== lv1_unmap_device_mmio_region ===


Get a parameter for a port on the VUART.
Unmap an MMIO region from the specified device.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_get_virtual_uart_param( /*IN*/ port_number, param_id, /*OUT*/ &param_value );
  result = lv1_unmap_device_mmio_region( /*IN*/ bus_id, dev_id, lpar_addr );


===== Parameters =====
===== Parameters =====
Line 3,883: Line 3,885:
|-
|-
|R3
|R3
|port_number - VUART port number
|bus_id - bus id
|-
|-
|R4
|R4
|param_id - id of parameter to set (see notes)
|dev_id - device id
|-
|R5
|lpar_addr - logical partition address of the mapped region
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,895: Line 3,900:
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|param_value - parameter value
|-
|-
|}
|}
----
=== lv1_allocate_device_dma_region ===
Allocate a DMA region for the specified device.


VUART parameters defined in vuart.c:
===== Kernel Call =====
 
result = lv1_allocate_device_dma_region( /*IN*/ bus_id, dev_id, io_size, io_pagesize, flag, &dma_region );
 
===== Parameters =====
{| class="wikitable"
{| class="wikitable"
|-
|-
!Parameter
! colspan="2" | Inputs
!param_id
!Notes
|-
|-
|PARAM_TX_TRIGGER
!Register
|0
!Description
|
|-
|-
|PARAM_RX_TRIGGER
|R3
|1
|bus_id - bus id
|
|-
|-
|PARAM_INTERRUPT_MASK
|R4
|2
|dev_id - device id
|
|-
|R5
|io_size - region size
|-
|R6
|io_pagesize - specified as a PAGE_SHIFT (i.e. n where pagesize = 2^n)
|-
|-
|PARAM_RX_BUF_SIZE
|R7
|3
|flag - 0=32 bit mode, 2=8 bit mode
|read only
|-
|-
|PARAM_RX_BYTES
! colspan="2" | Outputs
|4
|read only
|-
|-
|PARAM_TX_BUF_SIZE
!Register
|5
!Description
|read only, not referenced in current Kernel
|-
|-
|PARAM_TX_BYTES
|R3
|6
|Status - 0 = OK, Other values are unknown, but indicate failure.
|read only, not referenced in current Kernel
|-
|-
|PARAM_INTERRUPT_STATUS
|R4
|7
|dma_region - dma region address
|read only
|-
|-
|}
|}
Notes: When the device is little endian, the mode must be set to 8 bit for 8 bit DMA to work as expected, otherwise the bytes will be read/written in the wrong order. OTOH, this mode requires that 16 and 32-bit values are byte-swapped by the CPU since they will appear as little endian in memory.
----
----
=== lv1_configure_virtual_uart_irq ===
=== lv1_free_device_dma_region ===


Configure the VUART IRQ.
Free a previously allocated DMA region for the specified device.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_configure_virtual_uart_irq( /*IN*/ lpar_addr, /*OUT*/ &outlet );
  lv1_free_device_dma_region( /*IN*/ bus_id, dev_id, dma_region );


===== Parameters =====
===== Parameters =====
Line 3,959: Line 3,966:
|-
|-
|R3
|R3
|lpar_addr - logical partition address of virtual uart interrupt bitmap
|bus_id - bus id
|-
|R4
|dev_id - device id
|-
|R5
|dma_region - dma region address
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 3,967: Line 3,980:
|-
|-
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status?
|-
|R4
|outlet - irq outlet
|-
|-
|}
|}
Notes:
Comment from interrupt.c:
/**
* The system supports only a single virtual uart, so multiple calls without
* freeing the interrupt will return a wrong state error.
*/
----
----
=== lv1_undocumented_function_167 ===
=== lv1_map_device_dma_region ===
SPE (isolation, reads from SPU_Out_Intr_Mbox and MFC_CNTL registers)


Exists on PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
Map a DMA region for the specified device.
----
 
=== lv1_undocumented_function_168 ===
SPE (isolation, writes to MFC_CNTL register)
 
Exists on PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
----
 
=== lv1_open_device ===
 
Open the device for a given bus and device id.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_open_device( /*IN*/ bus_id, dev_id, 0 );
  result = lv1_map_device_dma_region( /*IN*/ bus_id, dev_id, lpar_addr, dma_region, size, flags );


===== Parameters =====
===== Parameters =====
Line 4,017: Line 4,007:
|-
|-
|R5
|R5
|0 - Unknown
|lpar_addr - logical partition address
|-
|R6
|dma_region - dma region address
|-
|R7
|size - region size
|-
|R8
|flags - see notes
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,025: Line 4,024:
|-
|-
|R3
|R3
|Status: LV1_SUCCESS (0) - OK
|Status - 0 = OK, Other values are unknown, but indicate failure.
LV1_NO_ENTRY (-6) - invalid dev_id
LV1_BUSY (-9) - device already open
LV1_ILLEGAL_PARAMETER_VALUE (-17) - invalid bus_id
|-
|-
|}
|}
Line 4,034: Line 4,030:
Notes:
Notes:


Valid values for bus_id and dev_id can be obtained from the repository (see [[HV_Syscall_Reference#lv1_get_repository_node_value|lv1_get_repository_node_value]]).
In “mm.c” and “ps3_storage.c”, flags parameter is always specified as 0xf800000000000000UL. They are the same flags as the IOPTE entry ones.
----
=== lv1_unmap_device_dma_region ===


Once open, functions such as [[HV_Syscall_Reference#lv1_map_device_mmio_region|lv1_map_device_mmio_region]] and [[HV_Syscall_Reference#lv1_allocate_device_dma_region|lv1_allocate_device_dma_region]] can be used to map the device into memory.
Unmap a DMA region for the specified device.


The value of R5 does not seem to affect the outcome of the call (powers of 2 in the 64 bit range were tested). One reason for the flag could be to indicate whether to open the device in shared mode or not (and thus prevent the LV1_BUSY return code).
===== Kernel Call =====
----
=== lv1_close_device ===


Close the device for a given bus and device id.
result = lv1_unmap_device_dma_region( /*IN*/ bus_id, dev_id, dma_region, size );
 
===== Kernel Call =====
 
result = lv1_close_device( /*IN*/ bus_id, dev_id );


===== Parameters =====
===== Parameters =====
Line 4,061: Line 4,053:
|R4
|R4
|dev_id - device id
|dev_id - device id
|-
|R5
|dma_region - dma region address
|-
|R6
|size - region size
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,072: Line 4,070:
|}
|}
----
----
=== lv1_map_device_mmio_region ===
=== lv1_read_pci_config ===


Map an MMIO region to the specified device.
Read external PCI config. ''PS3tool only?''


===== Kernel Call =====
===== kboot Call =====


  result = lv1_map_device_mmio_region( /*IN*/ bus_id, dev_id, bus_addr, size, page_size, /*OUT*/ &lpar_addr );
  result = lv1_read_pci_config( /*IN*/ bus_id, pci_bus_id, dev_id, func_id, offset, size, /*OUT*/ &config_data );


===== Parameters =====
===== Parameters =====
Line 4,089: Line 4,087:
|-
|-
|R3
|R3
|bus_id - bus id
|bus_id - ps3 bus id
|-
|-
|R4
|R4
|dev_id - device id
|pci_bus_id - pci bus id
|-
|-
|R5
|R5
|bus_addr - address of the region
|dev_id - pci device id
|-
|-
|R6
|R6
|size - size of the region
|func_id - pci function
|-
|-
|R7
|R7
|page_size - page size of the region
|offset - offset to store data within config_data
|-
|R8
|size - size of config_data
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,112: Line 4,113:
|-
|-
|R4
|R4
|lpar_addr - logical partition address of the mapped region
|config_data - pci config data
|-
|-
|}
|}
Notes:
Code taken from kboot-10\dl\linux-2.6.16\arch\powerpc\platforms\ps3pf\pci.c (kboot-20061208)
status = lv1_read_pci_config(p->bus_id, p->bus_pci_bus, p->bus_pci_dev, p->bus_pci_func,
(uint64_t)offset, size, &data);
----
----
=== lv1_unmap_device_mmio_region ===
=== lv1_write_pci_config ===


Unmap an MMIO region from the specified device.
Write external PCI config. ''PS3tool only?''


===== Kernel Call =====
===== kboot Call =====


  result = lv1_unmap_device_mmio_region( /*IN*/ bus_id, dev_id, lpar_addr );
  result = lv1_write_pci_config( /*IN*/ bus_id, pci_bus_id, dev_id, func_id, offset, size, config_data );


===== Parameters =====
===== Parameters =====
Line 4,133: Line 4,140:
|-
|-
|R3
|R3
|bus_id - bus id
|bus_id - ps3 bus id
|-
|-
|R4
|R4
|dev_id - device id
|pci_bus_id - pci bus id
|-
|-
|R5
|R5
|lpar_addr - logical partition address of the mapped region
|dev_id - pci device id
|-
|R6
|func_id - pci function
|-
|R7
|offset - offset to store data within config_data
|-
|R8
|size - size of config_data
|-
|R9
|config_data - pci config data
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,150: Line 4,169:
|-
|-
|}
|}
Notes:
Code taken from kboot-10\dl\linux-2.6.16\arch\powerpc\platforms\ps3pf\pci.c (kboot-20061208)
status = lv1_write_pci_config(p->bus_id, p->bus_pci_bus, p->bus_pci_dev, p->bus_pci_func,
    (uint64_t)offset, size, (uint64_t)val);
if(status) {
    /* lv1_write_pci_config can't write reg from 0x10 to 0x3f */
}
----
----
=== lv1_allocate_device_dma_region ===
=== lv1_read_pci_io ===


Allocate a DMA region for the specified device.
Not used in current kernel.


===== Kernel Call =====
===== Abstract Call =====


  result = lv1_allocate_device_dma_region( /*IN*/ bus_id, dev_id, io_size, io_pagesize, flag, /*OUT*/ &dma_region );
  result = lv1_read_pci_io( /*IN*/ p1, p2, p3, p4, /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 4,168: Line 4,196:
|-
|-
|R3
|R3
|bus_id - bus id
|p1 - Unknown
|-
|-
|R4
|R4
|dev_id - device id
|p2 - Unknown
|-
|-
|R5
|R5
|io_size - region size
|p3 - Unknown
|-
|-
|R6
|R6
|io_pagesize - specified as a PAGE_SHIFT (i.e. n where pagesize = 2^n)
|p4 - Unknown
|-
|R7
|flag - 0=32 bit mode, 2=8 bit mode
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,188: Line 4,213:
|-
|-
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status?
|-
|-
|R4
|R4
|dma_region - dma region address
|v1 - Unknown
|-
|-
|}
|}


Notes: When the device is little endian, the mode must be set to 8 bit for 8 bit DMA to work as expected, otherwise the bytes will be read/written in the wrong order. OTOH, this mode requires that 16 and 32-bit values are byte-swapped by the CPU since they will appear as little endian in memory.
Notes:
 
Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
----
----
=== lv1_write_pci_io ===


=== lv1_free_device_dma_region ===
Not used in current kernel.


Free a previously allocated DMA region for the specified device.
===== Abstract Call =====


===== Kernel Call =====
result = lv1_write_pci_io( /*IN*/ p1, p2, p3, p4, p5 );
 
lv1_free_device_dma_region( /*IN*/ bus_id, dev_id, dma_region );


===== Parameters =====
===== Parameters =====
Line 4,215: Line 4,241:
|-
|-
|R3
|R3
|bus_id - bus id
|p1 - Unknown
|-
|-
|R4
|R4
|dev_id - device id
|p2 - Unknown
|-
|-
|R5
|R5
|dma_region - dma region address
|p3 - Unknown
|-
|R6
|p4 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,232: Line 4,261:
|-
|-
|}
|}
Notes:
Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
----
----
=== lv1_map_device_dma_region ===
=== lv1_undocumented_function_182 ===
 
Exists in PAL 3.15. Nothing known so far.
Note: probably a function that allocates or frees memory.
----
=== lv1_undocumented_function_183 ===
 
Exists in PAL 3.15. Nothing known so far.
Note: probably a function that allocates or frees memory.
----
=== lv1_net_add_multicast_address ===


Map a DMA region for the specified device.
Add multicast address to the specified network device.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_map_device_dma_region( /*IN*/ bus_id, dev_id, lpar_addr, dma_region, size, flags );
  result = lv1_net_add_multicast_address( /*IN*/ bus_id, dev_id, addr, flag );


===== Parameters =====
===== Parameters =====
Line 4,256: Line 4,299:
|-
|-
|R5
|R5
|lpar_addr - logical partition address
|addr - see notes
|-
|-
|R6
|R6
|dma_region - dma region address
|flag - see notes
|-
|R7
|size - region size
|-
|R8
|flags - see notes
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,279: Line 4,316:
Notes:
Notes:


In “mm.c” and “ps3_storage.c”, flags parameter is always specified as 0xf800000000000000UL. They are the same flags as the IOPTE entry ones.
From “gelic_net.c”, addr can also take special values of 0 and GELIC_NET_BROADCAST_ADDR (0xffffffff) and flag is assigned values of 0 and 1.
----
----
=== lv1_unmap_device_dma_region ===
=== lv1_net_remove_multicast_address ===


Unmap a DMA region for the specified device.
Remove multicast address on the specified network device.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_unmap_device_dma_region( /*IN*/ bus_id, dev_id, dma_region, size );
  result = lv1_net_remove_multicast_address( /*IN*/ bus_id, dev_id, 0, 1 );


===== Parameters =====
===== Parameters =====
Line 4,304: Line 4,341:
|-
|-
|R5
|R5
|dma_region - dma region address
|0 - Unknown
|-
|-
|R6
|R6
|size - region size
|1 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,319: Line 4,356:
|}
|}
----
----
=== lv1_read_pci_config ===
=== lv1_net_start_tx_dma ===


Read external PCI config. ''PS3tool only?''
Start DMA transmit on the specified network device.


===== kboot Call =====
===== Kernel Call =====


  result = lv1_read_pci_config( /*IN*/ bus_id, pci_bus_id, dev_id, func_id, offset, size, /*OUT*/ &config_data );
  result = lv1_net_start_tx_dma( /*IN*/ bus_id, dev_id, bus_addr, 0 );


===== Parameters =====
===== Parameters =====
Line 4,336: Line 4,373:
|-
|-
|R3
|R3
|bus_id - ps3 bus id
|bus_id - bus id
|-
|-
|R4
|R4
|pci_bus_id - pci bus id
|dev_id - device id
|-
|-
|R5
|R5
|dev_id - pci device id
|bus_addr - dma address?
|-
|-
|R6
|R6
|func_id - pci function
|0 - Unknown
|-
|R7
|offset - offset to store data within config_data
|-
|R8
|size - size of config_data
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,360: Line 4,391:
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|config_data - pci config data
|-
|-
|}
|}
Notes:
Code taken from kboot-10\dl\linux-2.6.16\arch\powerpc\platforms\ps3pf\pci.c (kboot-20061208)
status = lv1_read_pci_config(p->bus_id, p->bus_pci_bus, p->bus_pci_dev, p->bus_pci_func,
(uint64_t)offset, size, &data);
----
----
=== lv1_write_pci_config ===
=== lv1_net_stop_tx_dma ===


Write external PCI config. ''PS3tool only?''
Stop DMA transmit on the specified network device.


===== kboot Call =====
===== Kernel Call =====


  result = lv1_write_pci_config( /*IN*/ bus_id, pci_bus_id, dev_id, func_id, offset, size, config_data );
  result = lv1_net_stop_tx_dma( /*IN*/ bus_id, dev_id, 0 );


===== Parameters =====
===== Parameters =====
Line 4,389: Line 4,411:
|-
|-
|R3
|R3
|bus_id - ps3 bus id
|bus_id - bus id
|-
|-
|R4
|R4
|pci_bus_id - pci bus id
|dev_id - device id
|-
|-
|R5
|R5
|dev_id - pci device id
|0 - Unknown
|-
|R6
|func_id - pci function
|-
|R7
|offset - offset to store data within config_data
|-
|R8
|size - size of config_data
|-
|R9
|config_data - pci config data
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,418: Line 4,428:
|-
|-
|}
|}
Notes:
Code taken from kboot-10\dl\linux-2.6.16\arch\powerpc\platforms\ps3pf\pci.c (kboot-20061208)
status = lv1_write_pci_config(p->bus_id, p->bus_pci_bus, p->bus_pci_dev, p->bus_pci_func,
    (uint64_t)offset, size, (uint64_t)val);
if(status) {
    /* lv1_write_pci_config can't write reg from 0x10 to 0x3f */
}
----
----
=== lv1_read_pci_io ===
=== lv1_net_start_rx_dma ===


Not used in current kernel.
Start DMA receive on the specified network device.


===== Abstract Call =====
===== Kernel Call =====


  result = lv1_read_pci_io( /*IN*/ p1, p2, p3, p4, /*OUT*/ &v1 );
  result = lv1_net_start_rx_dma( /*IN*/ bus_id, dev_id, bus_addr, 0 );


===== Parameters =====
===== Parameters =====
Line 4,445: Line 4,446:
|-
|-
|R3
|R3
|p1 - Unknown
|bus_id - bus id
|-
|-
|R4
|R4
|p2 - Unknown
|dev_id - device id
|-
|-
|R5
|R5
|p3 - Unknown
|bus_addr - dma address?
|-
|-
|R6
|R6
|p4 - Unknown
|0 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,462: Line 4,463:
|-
|-
|R3
|R3
|Status?
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|v1 - Unknown
|-
|-
|}
|}
----
=== lv1_net_stop_rx_dma ===


Notes:
Stop DMA receive on the specified network device.


Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
===== Kernel Call =====
----
=== lv1_write_pci_io ===


Not used in current kernel.
  result = lv1_net_stop_rx_dma( /*IN*/ bus_id, dev_id, 0 );
 
===== Abstract Call =====
 
  result = lv1_write_pci_io( /*IN*/ p1, p2, p3, p4, p5 );


===== Parameters =====
===== Parameters =====
Line 4,490: Line 4,484:
|-
|-
|R3
|R3
|p1 - Unknown
|bus_id - bus id
|-
|-
|R4
|R4
|p2 - Unknown
|dev_id - device id
|-
|-
|R5
|R5
|p3 - Unknown
|0 - Unknown
|-
|R6
|p4 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,507: Line 4,498:
|-
|-
|R3
|R3
|Status?
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|-
|}
|}
Notes:
Info taken from kboot-10\dl\linux-2.6.16\include\asm-powerpc\lv1calltab.h (kboot-20061208)
----
----
=== lv1_undocumented_function_182 ===
=== lv1_net_set_interrupt_status_indicator  ===


Exists in PAL 3.15. Nothing known so far.
Set the interrupt status indicator for the specified network device.
Note: probably a function that allocates or frees memory.
----
=== lv1_undocumented_function_183 ===
 
Exists in PAL 3.15. Nothing known so far.
Note: probably a function that allocates or frees memory.
----
=== lv1_net_add_multicast_address ===
 
Add multicast address to the specified network device.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_net_add_multicast_address( /*IN*/ bus_id, dev_id, addr, flag );
  result = lv1_net_set_interrupt_status_indicator( /*IN*/ bus_id, dev_id, irq_status_addr, 0 );


===== Parameters =====
===== Parameters =====
Line 4,548: Line 4,525:
|-
|-
|R5
|R5
|addr - see notes
|irq_status_addr - lpar address of the irq status indicator
|-
|-
|R6
|R6
|flag - see notes
|0 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,562: Line 4,539:
|-
|-
|}
|}
----
=== lv1_net_set_interrupt_mask ===


Notes:
Sets the interrupt mask for specified network device.


From “gelic_net.c”, addr can also take special values of 0 and GELIC_NET_BROADCAST_ADDR (0xffffffff) and flag is assigned values of 0 and 1.
===== Kernel Call =====
----
=== lv1_net_remove_multicast_address ===


Remove multicast address on the specified network device.
  result = lv1_net_set_interrupt_mask( /*IN*/ bus_id, dev_id, mask, 0 );
 
===== Kernel Call =====
 
  result = lv1_net_remove_multicast_address( /*IN*/ bus_id, dev_id, 0, 1 );


===== Parameters =====
===== Parameters =====
Line 4,590: Line 4,563:
|-
|-
|R5
|R5
|0 - Unknown
|mask - interrupt mask
|-
|-
|R6
|R6
|1 - Unknown
|0 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,605: Line 4,578:
|}
|}
----
----
=== lv1_net_start_tx_dma ===
=== lv1_net_control ===


Start DMA transmit on the specified network device.
Send a control command to the specified network device.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_net_start_tx_dma( /*IN*/ bus_id, dev_id, bus_addr, 0 );
  result = lv1_net_control( /*IN*/ bus_id, dev_id, p1, p2, p3, p4, /*OUT*/ &v1, &v2 );


===== Parameters =====
===== Parameters =====
Line 4,628: Line 4,601:
|-
|-
|R5
|R5
|bus_addr - dma address?
|p1 - command dependent input parameter
|-
|-
|R6
|R6
|0 - Unknown
|p2 - command dependent input parameter
|-
|R7
|p3 - command dependent input parameter
|-
|R8
|p4 - command dependent input parameter
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,640: Line 4,619:
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|v1 - command dependent output parameter
|-
|R5
|v2 - command dependent output parameter
|-
|-
|}
|}
----
----
=== lv1_net_stop_tx_dma ===
=== lv1_undocumented_function_195 ===
 
Exists in PAL 1.7. Returns -3 (LV1_NO_PRIVILEGE) when passed 0 in R3 to R10.
----
=== lv1_undocumented_function_196 ===
 
Exists in PAL 1.7. Returns -3 (LV1_NO_PRIVILEGE) when passed 0 in R3 to R10.
----
=== lv1_connect_interrupt_event_receive_port ===


Stop DMA transmit on the specified network device.
Assign a virtual interrupt to a system bus device.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_net_stop_tx_dma( /*IN*/ bus_id, dev_id, 0 );
  result = lv1_connect_interrupt_event_receive_port( /*IN*/ bus_id, dev_id, outlet, interrupt_id );


===== Parameters =====
===== Parameters =====
Line 4,660: Line 4,653:
|-
|-
|R3
|R3
|bus_id - bus id
|bus_id - device bus id
|-
|-
|R4
|R4
Line 4,666: Line 4,659:
|-
|-
|R5
|R5
|0 - Unknown
|outlet - interrupt outlet
|-
|R6
|interrupt_id - interrupt id
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,678: Line 4,674:
|}
|}
----
----
=== lv1_net_start_rx_dma ===
=== lv1_disconnect_interrupt_event_receive_port ===


Start DMA receive on the specified network device.
Disconnect a virtual interrupt from a system bus device.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_net_start_rx_dma( /*IN*/ bus_id, dev_id, bus_addr, 0 );
  result = lv1_disconnect_interrupt_event_receive_port( /*IN*/ bus_id, dev_id, outlet, interrupt_id );


===== Parameters =====
===== Parameters =====
Line 4,695: Line 4,691:
|-
|-
|R3
|R3
|bus_id - bus id
|bus_id - device bus id
|-
|-
|R4
|R4
Line 4,701: Line 4,697:
|-
|-
|R5
|R5
|bus_addr - dma address?
|outlet - interrupt outlet
|-
|-
|R6
|R6
|0 - Unknown
|interrupt_id - interrupt id
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,716: Line 4,712:
|}
|}
----
----
=== lv1_net_stop_rx_dma ===
=== lv1_get_spe_all_interrupt_statuses ===


Stop DMA receive on the specified network device.
Not used in current kernel.


===== Kernel Call =====
===== Abstract Call =====


  result = lv1_net_stop_rx_dma( /*IN*/ bus_id, dev_id, 0 );
  result = lv1_get_spe_all_interrupt_statuses( /*IN*/ p1, /*OUT*/ &v1 );


===== Parameters =====
===== Parameters =====
Line 4,733: Line 4,729:
|-
|-
|R3
|R3
|bus_id - bus id
|p1 - Unknown
|-
|R4
|dev_id - device id
|-
|R5
|0 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,747: Line 4,737:
|-
|-
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status?
|-
|R4
|v1 - Unknown
|-
|-
|}
|}
----
----
=== lv1_net_set_interrupt_status_indicator  ===
=== lv1_undocumented_function_200 ===
 
Exists in PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
----
=== lv1_undocumented_function_201 ===
 
Exists in PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
----
=== lv1_deconfigure_virtual_uart_irq ===


Set the interrupt status indicator for the specified network device.
Deconfigure the VUART IRQ.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_net_set_interrupt_status_indicator( /*IN*/ bus_id, dev_id, irq_status_addr, 0 );
  result = lv1_deconfigure_virtual_uart_irq();


===== Parameters =====
===== Parameters =====
{| class="wikitable"
{| class="wikitable"
|-
! colspan="2" | Inputs
|-
!Register
!Description
|-
|R3
|bus_id - bus id
|-
|R4
|dev_id - device id
|-
|R5
|irq_status_addr - lpar address of the irq status indicator
|-
|R6
|0 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,789: Line 4,773:
|}
|}
----
----
=== lv1_net_set_interrupt_mask ===
=== lv1_enable_logical_spe ===


Sets the interrupt mask for specified network device.
Enables a logical SPE.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_net_set_interrupt_mask( /*IN*/ bus_id, dev_id, mask, 0 );
  status = lv1_enable_logical_spe( /*IN*/ spe_id, resource_id );


===== Parameters =====
===== Parameters =====
Line 4,806: Line 4,790:
|-
|-
|R3
|R3
|bus_id - bus id
|spe_id - logical spe id
|-
|-
|R4
|R4
|dev_id - device id
|resource_id - spe resource id (prevously retrieved from Kernel repository)
|-
|R5
|mask - interrupt mask
|-
|R6
|0 - Unknown
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,827: Line 4,805:
|}
|}
----
----
=== lv1_net_control ===
=== lv1_undocumented_function_209 ===
 
Exists in PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
----
=== lv1_gpu_open ===


Send a control command to the specified network device.
Open the GPU. Call [[HV_Syscall_Reference#lv1_gpu_close|lv1_gpu_close]] to close the GPU.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_net_control( /*IN*/ bus_id, dev_id, p1, p2, p3, p4, /*OUT*/ &v1, &v2 );
  status = lv1_gpu_open( /*IN*/ p1 );


===== Parameters =====
===== Parameters =====
Line 4,844: Line 4,826:
|-
|-
|R3
|R3
|bus_id - bus id
|p1 - Unknown, Kernel only ever passes 0, though other randomly chosen values seem to succeed.
|-
|-
|R4
! colspan="2" | Outputs
|dev_id - device id
|-
|-
|R5
!Register
|p1 - command dependent input parameter
!Description
|-
|-
|R6
|R3
|p2 - command dependent input parameter
|Status: 0 = LV1_SUCCESS, -6 = LV1_NO_ENTRY
|-
|-
|R7
|}
|p3 - command dependent input parameter
 
|-
Notes:
|R8
 
|p4 - command dependent input parameter
When called from Kernel module init function, if GPU is already open, subsequent calls to lv1_gpu_open return LV1_NO_ENTRY (-6). Closing the GPU and re-opening succeeds.
----
=== lv1_gpu_close ===
 
Closes the GPU. Must be called once for every call to [[HV_Syscall_Reference#lv1_gpu_open|lv1_gpu_open]].
 
===== Kernel Call =====
 
status = lv1_gpu_close();
 
===== Parameters =====
{| class="wikitable"
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,868: Line 4,860:
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|v1 - command dependent output parameter
|-
|R5
|v2 - command dependent output parameter
|-
|-
|}
|}
----
----
=== lv1_undocumented_function_195 ===
=== lv1_gpu_device_map ===
WLAN Gelic device


Exists in PAL 1.7. Returns -3 (LV1_NO_PRIVILEGE) when passed 0 in R3 to R10.
Map a device into logical address space. Address needs to be ioremapped before use.
----


=== lv1_undocumented_function_196 ===
===== kboot Call =====
WLAN Gelic device


Exists in PAL 1.7. Returns -3 (LV1_NO_PRIVILEGE) when passed 0 in R3 to R10.
  result = lv1_gpu_device_map( /*IN*/ dev_id, /*OUT*/ &lpar_addr, &lpar_size );
----
 
=== lv1_connect_interrupt_event_receive_port ===
 
Assign a virtual interrupt to a system bus device.
 
===== Kernel Call =====
 
  result = lv1_connect_interrupt_event_receive_port( /*IN*/ bus_id, dev_id, outlet, interrupt_id );


===== Parameters =====
===== Parameters =====
Line 4,906: Line 4,880:
|-
|-
|R3
|R3
|bus_id - device bus id
|dev_id - device id (see notes)
|-
|R4
|dev_id - device id
|-
|R5
|outlet - interrupt outlet
|-
|R6
|interrupt_id - interrupt id
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,924: Line 4,889:
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|R4
|lpar_addr - logical partition address of device block
|-
|R5
|lpar_size - size of device block
|-
|-
|}
|}
----
=== lv1_disconnect_interrupt_event_receive_port ===


Disconnect a virtual interrupt from a system bus device.
Notes:


===== Kernel Call =====
Info taken from kboot-10\dl\linux-2.6.16\sound\powerpc\snd_ps3pf.c (kboot-20061208) where the audio front-end registers are mapped into memory. Two calls to lv1_gpu_device_map are performed, the first when dev_id = 1, to obtain the audio interrupt (Audio IRQ Outlet) and a second time when dev_id = 2 to obtain a mapping of the register block (Audio Registers).


result = lv1_disconnect_interrupt_event_receive_port( /*IN*/ bus_id, dev_id, outlet, interrupt_id );
lpar_addr is a virtual address, created by the Hypervisor. Multiple calls to lv1_gpu_device_map with the same dev_id return successfully, but the lpar_address returned for each is different (if there have been no intermediary lv1_gpu_device_unmap calls). These various virtual lpar_addr values all alias the same physical location in memory.


===== Parameters =====
===== Test Results =====
{| class="wikitable"
{| class="wikitable"
|-
|-
! colspan="2" | Inputs
! colspan="5" | lv1_gpu_device_map
|-
|-
!Register
!dev_id
!Description
!result
!lpar_addr
!lpar_size
!Comment
|-
|-
|R3
|0
|bus_id - device bus id
|ffffffffffffffef
|98d2f7d44da1ceae
|0100000000000000
|result = LV1_ILLEGAL_PARAMETER_VALUE
|-
|-
|R4
|1
|dev_id - device id
|0000000000000000
|0000300000022000
|0000000000001000
|Audio IRQ Outlet (map1_dump)
|-
|-
|R5
|2
|outlet - interrupt outlet
|0000000000000000
|00003c0000128000
|0000000000008000
|Audio_Registers (map2_dump)
|-
|-
|R6
|3
|interrupt_id - interrupt id
|0000000000000000
|0000300000026000
|0000000000001000
|??? - Any attempt to dereference this lpar_addr locks up the PS3
|-
|-
! colspan="2" | Outputs
|4
|ffffffffffffffef
|0000300000026000
|0000000000001000
|result = LV1_ILLEGAL_PARAMETER_VALUE
|-
|-
!Register
|5
!Description
|0000000000000000
|0000300000028000
|0000000000001000
|??? - (map5_dump)
|-
|-
|R3
|6
|Status - 0 = OK, Other values are unknown, but indicate failure.
|0000000000000000
|0000300000029000
|0000000000001000
|??? - (map6_dump)
|-
|-
|}
|7
----
|0000000000000000
=== lv1_get_spe_all_interrupt_statuses ===
|00003000002A0000
 
|0000000000010000
Not used in current kernel.
|??? - (map7_dump)
 
|-
===== Abstract Call =====
|8
 
|0000000000000000
  result = lv1_get_spe_all_interrupt_statuses( /*IN*/ p1, /*OUT*/ &v1 );
|000030000002B000
 
|0000000000001000
===== Parameters =====
|video RAM at offset 0x0ff10000- (map8_dump)
{| class="wikitable"
|-
|9-255
| -20
|???
|???
|result = LV1_NOT_IMPLEMENTED
|-
|}
 
It is interesting that when dev_id = 4, LV1_ILLEGAL_PARAMETER_VALUE is returned with lpar_addr and lpar_size set to the values returned from the previous call - for the first call when dev_id = 0, values also appear to be set (though these could be garbage values)
 
===== Devices 1 & 2 =====
dev_id 1 gives a location used to process IRQ’s from the audio and dev_id 2 gives the base address of the Audio Hardware registers. From published Sony documents (http://www.watch.impress.co.jp/game/docs/20060329/3dps303.htm), Audio is believed to be on the RSX, this call seems to confirm that. Access to the audio after this mapping call (it would appear) bypasses the Hypervisor and occurs directly on the RSX hardware. 3,5,6,7,8 are currently unknown. Presumably 0 and 4 are otherwise valid parameters blocked by the Hypervisor for OtherOS (ie, they may function for Games) otherwise I would have expected a return result of -20 for them. So rather than just being a bridge for audio into HDMI, it is for all audio.
 
Also interesting is that the GPU version number returned by [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]] appears at address 0×10 in the device 1 dump, though this of course may be complete coincidence.
 
===== Device 7 =====
dev_id 7 appears to be a video device. It is not possible to map the entire reported memory space (0×10000), only areas 0×0000 to 0x0fff and 0×2000 to 0x2fff (discovered via laborious trial and error testing, mapping other areas causes the PS3 to hang without warning). In both mappable areas, the current screen resolution can be seen at locations 0×200 and 0×210. Changes to the ps3 video mode (e.g. using the ps3videomode utility) can be observed in the mapped areas, but modifying the values directly does not affect the screen resolution. Although both areas contain different values, there appear to be parts in common, as changing the values at 0×200 and 0×210 directly in one area also causes the same values in the other area to change.
 
Given the screen resolution connection, it could be possible that this device is a mapping of the GPU display heads:
 
*Out of 16Kb, only two areas are mappable (= number of accessible display heads)
*Mappable areas are 2Kb apart → 8 total display heads (= size of display heads array returned by [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]])
 
===== Device 8 =====
 
dev_id 8 appears to be a mapping of video RAM at offset 0x0ff10000. This region of video memory is referenced by RSX DMA objects but its purpose is unknown.
----
=== lv1_gpu_device_unmap ===
 
Unmaps the device from logical address space.
 
===== kboot Call =====
 
  lv1_gpu_device_unmap( /*IN*/ dev_id );
 
===== Parameters =====
{| class="wikitable"
|-
|-
! colspan="2" | Inputs
! colspan="2" | Inputs
Line 4,982: Line 5,013:
|-
|-
|R3
|R3
|p1 - Unknown
|dev_id - device id (see [[HV_Syscall_Reference#lv1_gpu_device_map|lv1_gpu_device_map]])
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 4,991: Line 5,022:
|R3
|R3
|Status?
|Status?
|-
|R4
|v1 - Unknown
|-
|-
|}
|}
----
=== lv1_undocumented_function_200 ===
SPE (isolation)


Exists in PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
Notes:
 
Info taken from kboot-10\dl\linux-2.6.16\sound\powerpc\snd_ps3pf.c (kboot-20061208)
----
----
=== lv1_gpu_memory_allocate ===


=== lv1_undocumented_function_201 ===
Allocate GPU memory.
SPE (isolation)
 
Exists in PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
----
 
=== lv1_deconfigure_virtual_uart_irq ===
 
Deconfigure the VUART IRQ.


===== Kernel Call =====
===== Kernel Call =====


  result = lv1_deconfigure_virtual_uart_irq();
  status = lv1_gpu_memory_allocate(ddr_size, 0, 0, 0, 0, &memory_handle, &ddr_lpar);


===== Parameters =====
===== Parameters =====
{| class="wikitable"
{| class="wikitable"
|-
|-
! colspan="2" | Outputs
! colspan="2" | Inputs
|-
|-
!Register
!Register
Line 5,026: Line 5,046:
|-
|-
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|ddr_size - amount of DDR to reserve? (see notes)
|-
|-
|}
|R4
----
|0 - Unknown. Max value 512*1024.
=== lv1_enable_logical_spe ===
 
Enables a logical SPE.
 
===== Kernel Call =====
 
status = lv1_enable_logical_spe( /*IN*/ spe_id, resource_id );
 
===== Parameters =====
{| class="wikitable"
|-
|-
! colspan="2" | Inputs
|R5
|0 - Unknown. Max value 3075*1024.
|-
|-
!Register
|R6
!Description
|0 - Unknown. Max value 15.
|-
|-
|R3
|R7
|spe_id - logical spe id
|0 - Unknown. Max value 8.
|-
|R4
|resource_id - spe resource id (prevously retrieved from Kernel repository)
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 5,058: Line 5,066:
|-
|-
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|status: 0 = LV1_SUCCESS, -17 = LV1_ILLEGAL_PARAMETER_VALUE
|-
|R4
|memory_handle - used by [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]] and [[HV_Syscall_Reference#lv1_gpu_memory_free|lv1_gpu_memory_free]]??
|-
|R5
|ddr_lpar - remappable address of allocated video memory, unused by Kernel.
|-
|-
|}
|}
----
=== lv1_undocumented_function_209 ===
SPE (isolation)


Exists in PAL 1.7. Returns -4 (LV1_DENIED_BY_POLICY) when passed 0 in R3 to R10.
Notes:
----
 
ddr_size accepts values (0..252) * 2^20 - values not divisible by 2^20 (1 MB) and above the range result in a return value of -17 (LV1_ILLEGAL_PARAMETER_VALUE). [Verified by Strontium Dog on an AU PS3 V1.5 firmware]


=== lv1_gpu_open ===
Bits 52-63 of ddr_size seem to be ignored or correspond to flags. The lower bits correspond to the amount of allocated video RAM. A call to [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]] using the returned memory_handle will create a RSX DMA object handle 0xfeed0000 corresponding to the region of allocated memory. Multiple calls to [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]] with non-zero ddr_size will change the start of this region. The DMA object limit is set to ddr_size - 1. Before FW 2.1, a ddr_size of 0 was accepted, in which case a DMA object starting at zero and of limit 0xffffffff was created. Note that in this case, the start of this region is always zero even if previous calls to [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]] with non-zero ddr_size were performed. As of FW 2.1 and above, a zero ddr_size is not accepted anymore.


Open the GPU. Call [[HV_Syscall_Reference#lv1_gpu_close|lv1_gpu_close]] to close the GPU.
Parameters r4-r7 are unknown. Maximum values for these parameters are respectively 512kB, 3075kB, 15 and 8. They refer to shared scarce resources, as allocations are retained across multiple calls to [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]]. When attached to a context during [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]], the values of these parameters are reported in the lpar_driver_info structure of the context.


===== Kernel Call =====
Cell separates multiple OS into Logical Partitions (lpar) described at http://research.scea.com/research/html/CellGDC05/13.html. PS3 GPU memory is referred to as DDR (or GDDR) whereas system memory is XDR. 256 MB of each are installed in PS3 though only XDR is currently available for use by OtherOS.


  status = lv1_gpu_open( /*IN*/ p1 );
To make use of the allocated DDR ddr_lpar needs to be transformed into a usable address using:
  ddr_address = ioremap_flags(ddr_lpar, ddr_size, _PAGE_NO_CACHE);
Be aware that the memory that holds the physical GPU frame buffer is not allocated by the Kernel, just used. So on the first call to this, some or all of the memory you request (depending on now much you request) may be actually used as the frame buffer. You will know this, because your writes to memory will mysteriously disappear up to 20ms after you perform them. Note that direct access to video ram is very slow (~10MB/s).


===== Parameters =====
===== Test Results =====
{| class="wikitable"
{| class="wikitable"
|-
! colspan="2" | Inputs
|-
|-
!Register
!Register
!Description
!Hex
!Decimal
!Comments
|-
|-
|R3
|R3
|p1 - Unknown, Kernel only ever passes 0, though other randomly chosen values seem to succeed.
|0x000000000fc00000
|(264241152)
|252 MB
|-
|-
! colspan="2" | Outputs
|R4
|0×0000000000000000
|(0)
|
|-
|-
!Register
|R5
!Description
|0×0000000000000000
|(0)
|
|-
|-
|R3
|R6
|Status: 0 = LV1_SUCCESS, -6 = LV1_NO_ENTRY
|0×0000000000000000
|(0)
|
|-
|-
|}
|R7
 
|0×0000000000000000
Notes:
|(0)
 
|
When called from Kernel module init function, if GPU is already open, subsequent calls to lv1_gpu_open return LV1_NO_ENTRY (-6). Closing the GPU and re-opening succeeds.
|-
! colspan="4" | Outputs
|-
|R3
|0×0000000000000000
|(0)
|LV1_SUCCESS
|-
|R4
|0x000000005a5a5a5b
|(...)
|memory handle
|-
|R5
|0x00007001a0000000
|(...)
|ddr logical partition address
|-
|}
----
----
=== lv1_gpu_close ===
=== lv1_gpu_memory_free ===


Closes the GPU. Must be called once for every call to [[HV_Syscall_Reference#lv1_gpu_open|lv1_gpu_open]].
Free memory handle returned by [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]]. Must be called to dispose of the handle returned by [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]].


===== Kernel Call =====
===== Kernel Call =====


  status = lv1_gpu_close();
  status = lv1_gpu_memory_free(ps3fb.memory_handle);


===== Parameters =====
===== Parameters =====
{| class="wikitable"
{| class="wikitable"
|-
! colspan="2" | Inputs
|-
!Register
!Description
|-
|R3
|Memory handle returned by [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]]
|-
|-
! colspan="2" | Outputs
! colspan="2" | Outputs
Line 5,122: Line 5,171:
|}
|}
----
----
=== lv1_gpu_device_map ===
=== lv1_gpu_context_iomap ===


Map a device into logical address space. Address needs to be ioremapped before use.
Map system RAM address to GPU through the Cell FlexIO interface.


===== kboot Call =====
===== Kernel Call =====


  result = lv1_gpu_device_map( /*IN*/ dev_id, /*OUT*/ &lpar_addr, &lpar_size );
  status = lv1_gpu_context_iomap(ps3fb.context_handle, GPU_IOIF,  
      xdr_lpar, ps3fb_videomemory.size, 0);


===== Parameters =====
===== Parameters =====
Line 5,139: Line 5,189:
|-
|-
|R3
|R3
|dev_id - device id (see notes)
|ps3fb.context_handle as allocated by [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]]
|-
|-
! colspan="2" | Outputs
|R4
|GPU_IOIF = 0x0d000000UL - GPU address where the system RAM virtual framebuffer is remapped
|-
|R5
|xdr_lpar - lpar version of the physical address of the virtual frame buffer in local memory. (Note: the lpar version = the physical address in the PS3)
|-
|R6
|ps3fb_videomemory.size = The size of the virtual frame buffer
|-
|R7
|0 - IOPTE flags - bitfield describing protection, coherency and ordering of the I/O mapping. Any combination of 0 or 2^{11 (cache hint),59 (read ordering),60 (write ordering),61 (coherency),62 (read protection) ,63 (write protection)} seems valid
|-
! colspan="2" | Outputs
|-
|-
!Register
!Register
Line 5,147: Line 5,209:
|-
|-
|R3
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|Status - 0 = OK, LV1_TYPE_MISMATCH (-8) if R5 set to a DDR lpar address, LV1_ILLEGAL_PARAMETER_VALUE (-17) if any other bit set in R7 than described above
|-
|R4
|lpar_addr - logical partition address of device block
|-
|R5
|lpar_size - size of device block
|-
|-
|}
|}


Notes:
This function creates a mapping in GPU address space so that the RSX can access system RAM. The Kernel uses it to associate the virtual framebuffer residing in system RAM to the GPU, so that so that transfers can be initiated by the RSX from the system RAM to the video RAM using the [[HV_Syscall_Reference#lv1_gpu_context_attribute|lv1_gpu_context_attribute]]:fb_blit() call.
 
Comments:
 
It was previously suspected that GPU_IOIF was the address of GPU MMIO registers. However GPU_IOIF is a GPU address, not a lpar address, and therefore has no meaning on the Linux side, and cannot be directly mapped from the Linux address space. Reserving the memory block (using request_mem_region) and mapping (using ioremap) results in a block of memory that is used by Linux (nothing resembling IO registers was observed whilst single frame stepping a gfx demo). [was: As you’ve previously discovered that the top of RAM is 0x0e00 0000, GPU_IOIF here is 16Mb below that. That’s typically the size of the a graphics card PCI IO region on a PC, so given the name, I’d strongly suggest it’s not GPU memory that’s being mapped but the GPU IO registers. Although why this address range would overlap with RAM is a mystery.]
 
GPU_IOIF was successfully set to other values (0×00000000, 0×02000000, 0×04000000) with Linux booting and displaying correctly. A value of 0x0f000000 causes the PS3 to hang (need to retest 0x0e0000000)


Info taken from kboot-10\dl\linux-2.6.16\sound\powerpc\snd_ps3pf.c (kboot-20061208) where the audio front-end registers are mapped into memory. Two calls to lv1_gpu_device_map are performed, the first when dev_id = 1, to obtain the audio interrupt (Audio IRQ Outlet) and a second time when dev_id = 2 to obtain a mapping of the register block (Audio Registers).
Although it looks like GPU_IOIF would overlap video RAM, the RSX differentiates between the two by associating different DMA objects to the source and destination of the blit. The source is associated with DMA object handle 0xfeed0001 which targets system memory, while the destination is associated with DMA object handle 0xfeed0000 which targets video memory. This has been observed by analysing the FIFO commands sent to the GPU by the hypervisor during the [[HV_Syscall_Reference#lv1_gpu_context_attribute|lv1_gpu_context_attribute]]:fb_setup() and [[HV_Syscall_Reference#lv1_gpu_context_attribute|lv1_gpu_context_attribute]]:fb_blit() calls.


lpar_addr is a virtual address, created by the Hypervisor. Multiple calls to lv1_gpu_device_map with the same dev_id return successfully, but the lpar_address returned for each is different (if there have been no intermediary lv1_gpu_device_unmap calls). These various virtual lpar_addr values all alias the same physical location in memory.
It seems a call to [[HV_Syscall_Reference#lv1_gpu_context_iomap|lv1_gpu_context_iomap]](handle, bus_addr, xdr_lpar, size, flags) is equivalent to a series of call to [[HV_Syscall_Reference#lv1_put_iopte|lv1_put_iopte]]:


===== Test Results =====
int i;
{| class="wikitable"
int context_number; /* derived from handle, 1st allocated context 0, 2nd allocated context 1, etc... */
|-
! colspan="5" | lv1_gpu_device_map
for (i = 0; i < size; i += 1024 * 1024) {
|-
lv1_put_iopte(0,            /* IO ASID */
!dev_id
      ((0x08ULL + context_number) << 28) | bus_addr) + i, /* IO address */
!result
      xdr_lpar + i, /* Logical Partition address */
!lpar_addr
              1,            /* PS3_AUDIO_IOID, actually RSX IOID */
!lpar_size
      flags);
!Comment
}
|-
Tested by replacing the call to [[HV_Syscall_Reference#lv1_gpu_context_iomap|lv1_gpu_context_iomap]] with the code above in ps3fb.c.
|0
----
|ffffffffffffffef
=== lv1_undocumented_function_222 ===
|98d2f7d44da1ceae
 
|0100000000000000
Located @ 0x20D648 in 3.15 HV.
|result = LV1_ILLEGAL_PARAMETER_VALUE
 
Does something with GPU Register 0x140, doesn't take arguments or return anything.
----
=== lv1_gpu_context_attribute ===
 
This is a multifunction call.
==== General Case ====
===== Abstract Call =====
 
status = lv1_gpu_context_attribute(ps3fb.context_handle, operation_code,
      p1, p2, p3, p4 );
 
===== Parameters =====
{| class="wikitable"
|-
|-
|1
! colspan="2" | Inputs
|0000000000000000
|0000300000022000
|0000000000001000
|Audio IRQ Outlet (map1_dump)
|-
|-
|2
!Register
|0000000000000000
!Description
|00003c0000128000
|0000000000008000
|Audio_Registers (map2_dump)
|-
|-
|3
|R3
|0000000000000000
|ps3fb.context_handle as allocated by [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]]
|0000300000026000
|0000000000001000
|??? - Any attempt to dereference this lpar_addr locks up the PS3
|-
|-
|4
|R4
|ffffffffffffffef
|operation_code - The code of the operation to perform.
|0000300000026000
|0000000000001000
|result = LV1_ILLEGAL_PARAMETER_VALUE
|-
|-
|5
|R5
|0000000000000000
|p1 - Parameter 1 to the operation
|0000300000028000
|-
|0000000000001000
|R6
|??? - (map5_dump)
|p2 - Parameter 2 to the operation
|-
|R7
|p3 - Parameter 3 to the operation
|-
|-
|6
|R8
|0000000000000000
|p4 - Parameter 4 to the operation
|0000300000029000
|0000000000001000
|??? - (map6_dump)
|-
|-
|7
! colspan="2" | Outputs
|0000000000000000
|00003000002A0000
|0000000000010000
|??? - (map7_dump)
|-
|-
|8
!Register
|0000000000000000
!Description
|000030000002B000
|0000000000001000
|video RAM at offset 0x0ff10000- (map8_dump)
|-
|-
|9-255
|R3
| -20
|Status - 0 = OK, Other values are unknown, but indicate failure.
|???
|???
|result = LV1_NOT_IMPLEMENTED
|-
|-
|}
|}


It is interesting that when dev_id = 4, LV1_ILLEGAL_PARAMETER_VALUE is returned with lpar_addr and lpar_size set to the values returned from the previous call - for the first call when dev_id = 0, values also appear to be set (though these could be garbage values)
===== Operations =====


===== Devices 1 & 2 =====
The operation code can be one of the following:
dev_id 1 gives a location used to process IRQ’s from the audio and dev_id 2 gives the base address of the Audio Hardware registers. From published Sony documents (http://www.watch.impress.co.jp/game/docs/20060329/3dps303.htm), Audio is believed to be on the RSX, this call seems to confirm that. Access to the audio after this mapping call (it would appear) bypasses the Hypervisor and occurs directly on the RSX hardware. 3,5,6,7,8 are currently unknown. Presumably 0 and 4 are otherwise valid parameters blocked by the Hypervisor for OtherOS (ie, they may function for Games) otherwise I would have expected a return result of -20 for them. So rather than just being a bridge for audio into HDMI, it is for all audio.


Also interesting is that the GPU version number returned by [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]] appears at address 0×10 in the device 1 dump, though this of course may be complete coincidence.
{| class="wikitable"
 
|-
===== Device 7 =====
!Operation
dev_id 7 appears to be a video device. It is not possible to map the entire reported memory space (0×10000), only areas 0×0000 to 0x0fff and 0×2000 to 0x2fff (discovered via laborious trial and error testing, mapping other areas causes the PS3 to hang without warning). In both mappable areas, the current screen resolution can be seen at locations 0×200 and 0×210. Changes to the ps3 video mode (e.g. using the ps3videomode utility) can be observed in the mapped areas, but modifying the values directly does not affect the screen resolution. Although both areas contain different values, there appear to be parts in common, as changing the values at 0×200 and 0×210 directly in one area also causes the same values in the other area to change.
!Code
 
!Details
Given the screen resolution connection, it could be possible that this device is a mapping of the GPU display heads:
!Address in 3.15
 
*Out of 16Kb, only two areas are mappable (= number of accessible display heads)
*Mappable areas are 2Kb apart → 8 total display heads (= size of display heads array returned by [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]])
 
===== Device 8 =====
 
dev_id 8 appears to be a mapping of video RAM at offset 0x0ff10000. This region of video memory is referenced by RSX DMA objects but its purpose is unknown.
----
=== lv1_gpu_device_unmap ===
 
Unmaps the device from logical address space.
 
===== kboot Call =====
 
lv1_gpu_device_unmap( /*IN*/ dev_id );
 
===== Parameters =====
{| class="wikitable"
|-
|-
! colspan="2" | Inputs
|No Entry
|0×0000
|Not a valid operation, returns LV1_NO_ENTRY (-6)
|
|-
|-
!Register
|L1GPU_CONTEXT_ATTRIBUTE_FIFO_SETUP
!Description
|0×0001
|fifo_setup
|0×210910
|-
|-
|R3
|Unknown
|dev_id - device id (see [[HV_Syscall_Reference#lv1_gpu_device_map|lv1_gpu_device_map]])
|0×0002
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|0x2108ec
|-
|-
! colspan="2" | Outputs
|Unknown
|0×0003
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|0x2107c0
|-
|-
!Register
|No Entry
!Description
|0×0004-0x00FF
|Not a valid operation, returns LV1_NO_ENTRY (-6)
|
|-
|-
|R3
|L1GPU_CONTEXT_ATTRIBUTE_DISPLAY_MODE_SET
|Status?
|0×0100
|display_mode_set
|0x21092c
|-
|-
|}
|L1GPU_CONTEXT_ATTRIBUTE_DISPLAY_SYNC
 
|0×0101
Notes:
|display_sync
 
|0×210318
Info taken from kboot-10\dl\linux-2.6.16\sound\powerpc\snd_ps3pf.c (kboot-20061208)
----
=== lv1_gpu_memory_allocate ===
 
Allocate GPU memory.
 
===== Kernel Call =====
 
status = lv1_gpu_memory_allocate(ddr_size, 0, 0, 0, 0, &memory_handle, &ddr_lpar);
 
===== Parameters =====
{| class="wikitable"
|-
|-
! colspan="2" | Inputs
|L1GPU_CONTEXT_ATTRIBUTE_DISPLAY_FLIP
|0×0102
|display_flip
|0×210588
|-
|-
!Register
|Unknown
!Description
|0×0103
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|0×210994
|-
|-
|R3
|Unknown
|ddr_size - amount of DDR to reserve? (see notes)
|0×0104
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|0×210754
|-
|-
|R4
|Unknown
|tile_max_size in bytes. Max value 512*1024.
|0×0105
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|0×210828
|-
|-
|R5
|Unknown
|zcull_max_size in bytes. Max value 3075*1024.
|0×0106
|-
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|R6
|0x2109ac
|tile_max_areas. Max value 15.
|-
|R7
|zcull_max_areas. Max value 8.
|-
! colspan="2" | Outputs
|-
!Register
!Description
|-
|R3
|status: 0 = LV1_SUCCESS, -17 = LV1_ILLEGAL_PARAMETER_VALUE
|-
|R4
|memory_handle - used by [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]] and [[HV_Syscall_Reference#lv1_gpu_memory_free|lv1_gpu_memory_free]]??
|-
|R5
|ddr_lpar - remappable address of allocated video memory, unused by Kernel.
|-
|}
 
Notes:
 
ddr_size accepts values (0..252) * 2^20 - values not divisible by 2^20 (1 MB) and above the range result in a return value of -17 (LV1_ILLEGAL_PARAMETER_VALUE). [Verified by Strontium Dog on an AU PS3 V1.5 firmware]
 
Bits 52-63 of ddr_size seem to be ignored or correspond to flags. The lower bits correspond to the amount of allocated video RAM. A call to [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]] using the returned memory_handle will create a RSX DMA object handle 0xfeed0000 corresponding to the region of allocated memory. Multiple calls to [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]] with non-zero ddr_size will change the start of this region. The DMA object limit is set to ddr_size - 1. Before FW 2.1, a ddr_size of 0 was accepted, in which case a DMA object starting at zero and of limit 0xffffffff was created. Note that in this case, the start of this region is always zero even if previous calls to [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]] with non-zero ddr_size were performed. As of FW 2.1 and above, a zero ddr_size is not accepted anymore.
 
Parameters r4-r7 are unknown. Maximum values for these parameters are respectively 512kB, 3075kB, 15 and 8. They refer to shared scarce resources, as allocations are retained across multiple calls to [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]]. When attached to a context during [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]], the values of these parameters are reported in the lpar_driver_info structure of the context.
 
Cell separates multiple OS into Logical Partitions (lpar) described at http://research.scea.com/research/html/CellGDC05/13.html. PS3 GPU memory is referred to as DDR (or GDDR) whereas system memory is XDR. 256 MB of each are installed in PS3 though only XDR is currently available for use by OtherOS.
 
To make use of the allocated DDR ddr_lpar needs to be transformed into a usable address using:
ddr_address = ioremap_flags(ddr_lpar, ddr_size, _PAGE_NO_CACHE);
Be aware that the memory that holds the physical GPU frame buffer is not allocated by the Kernel, just used. So on the first call to this, some or all of the memory you request (depending on now much you request) may be actually used as the frame buffer. You will know this, because your writes to memory will mysteriously disappear up to 20ms after you perform them. Note that direct access to video ram is very slow (~10MB/s).
 
===== Test Results =====
{| class="wikitable"
|-
!Register
!Hex
!Decimal
!Comments
|-
|R3
|0x000000000fc00000
|(264241152)
|252 MB
|-
|R4
|0×0000000000000000
|(0)
|
|-
|R5
|0×0000000000000000
|(0)
|
|-
|R6
|0×0000000000000000
|(0)
|
|-
|R7
|0×0000000000000000
|(0)
|
|-
! colspan="4" | Outputs
|-
|R3
|0×0000000000000000
|(0)
|LV1_SUCCESS
|-
|R4
|0x000000005a5a5a5b
|(...)
|memory handle
|-
|R5
|0x00007001a0000000
|(...)
|ddr logical partition address
|-
|}
----
=== lv1_gpu_memory_free ===
 
Free memory handle returned by [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]]. Must be called to dispose of the handle returned by [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]].
 
===== Kernel Call =====
 
status = lv1_gpu_memory_free(ps3fb.memory_handle);
 
===== Parameters =====
{| class="wikitable"
|-
! colspan="2" | Inputs
|-
!Register
!Description
|-
|R3
|Memory handle returned by [[HV_Syscall_Reference#lv1_gpu_memory_allocate|lv1_gpu_memory_allocate]]
|-
! colspan="2" | Outputs
|-
!Register
!Description
|-
|R3
|Status - 0 = OK, Other values are unknown, but indicate failure.
|-
|}
----
=== lv1_gpu_context_iomap ===
 
Map system RAM address to GPU through the Cell FlexIO interface.
 
===== Kernel Call =====
 
status = lv1_gpu_context_iomap(ps3fb.context_handle, GPU_IOIF,
      xdr_lpar, ps3fb_videomemory.size, 0);
 
===== Parameters =====
{| class="wikitable"
|-
! colspan="2" | Inputs
|-
!Register
!Description
|-
|R3
|ps3fb.context_handle as allocated by [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]]
|-
|R4
|GPU_IOIF = 0x0d000000UL - GPU address where the system RAM virtual framebuffer is remapped
|-
|R5
|xdr_lpar - lpar version of the physical address of the virtual frame buffer in local memory. (Note: the lpar version = the physical address in the PS3)
|-
|R6
|ps3fb_videomemory.size = The size of the virtual frame buffer
|-
|R7
|0 - IOPTE flags - bitfield describing protection, coherency and ordering of the I/O mapping. Any combination of 0 or 2^{11 (cache hint),59 (read ordering),60 (write ordering),61 (coherency),62 (read protection) ,63 (write protection)} seems valid
|-
! colspan="2" | Outputs
|-
!Register
!Description
|-
|R3
|Status - 0 = OK, LV1_TYPE_MISMATCH (-8) if R5 set to a DDR lpar address, LV1_ILLEGAL_PARAMETER_VALUE (-17) if any other bit set in R7 than described above
|-
|}
 
This function creates a mapping in GPU address space so that the RSX can access system RAM. The Kernel uses it to associate the virtual framebuffer residing in system RAM to the GPU, so that so that transfers can be initiated by the RSX from the system RAM to the video RAM using the [[HV_Syscall_Reference#lv1_gpu_context_attribute|lv1_gpu_context_attribute]]:fb_blit() call.
 
Comments:
 
It was previously suspected that GPU_IOIF was the address of GPU MMIO registers. However GPU_IOIF is a GPU address, not a lpar address, and therefore has no meaning on the Linux side, and cannot be directly mapped from the Linux address space. Reserving the memory block (using request_mem_region) and mapping (using ioremap) results in a block of memory that is used by Linux (nothing resembling IO registers was observed whilst single frame stepping a gfx demo). [was: As you’ve previously discovered that the top of RAM is 0x0e00 0000, GPU_IOIF here is 16Mb below that. That’s typically the size of the a graphics card PCI IO region on a PC, so given the name, I’d strongly suggest it’s not GPU memory that’s being mapped but the GPU IO registers. Although why this address range would overlap with RAM is a mystery.]
 
GPU_IOIF was successfully set to other values (0×00000000, 0×02000000, 0×04000000) with Linux booting and displaying correctly. A value of 0x0f000000 causes the PS3 to hang (need to retest 0x0e0000000)
 
Although it looks like GPU_IOIF would overlap video RAM, the RSX differentiates between the two by associating different DMA objects to the source and destination of the blit. The source is associated with DMA object handle 0xfeed0001 which targets system memory, while the destination is associated with DMA object handle 0xfeed0000 which targets video memory. This has been observed by analysing the FIFO commands sent to the GPU by the hypervisor during the [[HV_Syscall_Reference#lv1_gpu_context_attribute|lv1_gpu_context_attribute]]:fb_setup() and [[HV_Syscall_Reference#lv1_gpu_context_attribute|lv1_gpu_context_attribute]]:fb_blit() calls.
 
It seems a call to [[HV_Syscall_Reference#lv1_gpu_context_iomap|lv1_gpu_context_iomap]](handle, bus_addr, xdr_lpar, size, flags) is equivalent to a series of call to [[HV_Syscall_Reference#lv1_put_iopte|lv1_put_iopte]]:
 
int i;
int context_number; /* derived from handle, 1st allocated context 0, 2nd allocated context 1, etc... */
for (i = 0; i < size; i += 1024 * 1024) {
lv1_put_iopte(0,            /* IO ASID */
      ((0x08ULL + context_number) << 28) | bus_addr) + i, /* IO address */
      xdr_lpar + i, /* Logical Partition address */
              1,            /* PS3_AUDIO_IOID, actually RSX IOID */
      flags);
}
Tested by replacing the call to [[HV_Syscall_Reference#lv1_gpu_context_iomap|lv1_gpu_context_iomap]] with the code above in ps3fb.c.
----
=== lv1_undocumented_function_222 ===
 
Located @ 0x20D648 in 3.15 HV.
 
Does something with GPU Register 0x140, doesn't take arguments or return anything.
----
=== lv1_gpu_context_attribute ===
 
This is a multifunction call.
==== General Case ====
===== Abstract Call =====
 
status = lv1_gpu_context_attribute(ps3fb.context_handle, operation_code,
      p1, p2, p3, p4 );
 
===== Parameters =====
{| class="wikitable"
|-
! colspan="2" | Inputs
|-
!Register
!Description
|-
|R3
|ps3fb.context_handle as allocated by [[HV_Syscall_Reference#lv1_gpu_context_allocate|lv1_gpu_context_allocate]]
|-
|R4
|operation_code - The code of the operation to perform.
|-
|R5
|p1 - Parameter 1 to the operation
|-
|R6
|p2 - Parameter 2 to the operation
|-
|R7
|p3 - Parameter 3 to the operation
|-
|R8
|p4 - Parameter 4 to the operation
|-
! colspan="2" | Outputs
|-
!Register
!Description
|-
|-
|R3
|Unknown
|Status - 0 = OK, Other values are unknown, but indicate failure.
|0×0107
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0 – Doesn’t Exist in the 3.15 HV.
|N/A
|-
|-
|}
|Unknown
 
|0×0108
===== Operations =====
|Unknown function, returns LV1_ILLEGAL_PARAMETER_VALUE(-17) when called with 0,0,0,0
 
|0x21063c
The operation code can be one of the following:
 
{| class="wikitable"
|-
!Operation
!Code
!Details
!Address in 3.15
|-
|No Entry
|0×0000
|Not a valid operation, returns LV1_NO_ENTRY (-6)
|
|-
|L1GPU_CONTEXT_ATTRIBUTE_FIFO_SETUP
|0×0001
|fifo_setup
|0×210910
|-
|-
|Unknown
|Unknown
|0×0002
|0×0109
|fifo_pause, (rsx_ctx, 2, 0, 0, 0, 0)
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|0x2108ec
|0x2104e8
|-
|-
|Unknown
|Unknown
|0×0003
|0x010A
|fifo_continue,  (rsx_ctx, 3, 0, 0, 0, 0)
|0x2107c0
|-
|No Entry
|0×0004-0x00FF
|Not a valid operation, returns LV1_NO_ENTRY (-6)
|
|-
|L1GPU_CONTEXT_ATTRIBUTE_DISPLAY_MODE_SET
|0×0100
|display_mode_set
|0x21092c
|-
|L1GPU_CONTEXT_ATTRIBUTE_DISPLAY_SYNC
|0×0101
|display_sync
|0×210318
|-
|L1GPU_CONTEXT_ATTRIBUTE_DISPLAY_FLIP
|0×0102
|display_flip
|0×210588
|-
|Unknown
|0×0103
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|0×210994
|-
|Unknown
|0×0104
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|0×210754
|-
|Unknown
|0×0105
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|0×210828
|-
|Unknown
|0×0106
|cellGcmFunc4 ? , returns LV1_SUCCESS(0) when called with 0,0,0,0
|0x2109ac
|-
|Unknown
|0×0107
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0 – Doesn’t Exist in the 3.15 HV.
|N/A
|-
|Unknown
|0×0108
|set interrupt frequency, returns LV1_ILLEGAL_PARAMETER_VALUE(-17) when called with 0,0,0,0
|0x21063c
|-
|Unknown
|0×0109
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0
|0x2104e8
|-
|Unknown
|0x010A
|init gcm channel, (e.g. (rsx_ctx, 0x10A, 0, 0, 0x80000000, 0))
|0×210888
|0×210888
|-
|-
Line 5,655: Line 5,396:
|Unknown
|Unknown
|0×0202
|0×0202
|generate rsx graphics error ?, returns LV1_SUCCESS(0) when called with 0,0,0,0. See CN3
|Unknown function, returns LV1_SUCCESS(0) when called with 0,0,0,0. See CN3
|0x21083c
|0x21083c
|-
|-
Line 5,665: Line 5,406:
|Unknown
|Unknown
|0×0300
|0×0300
|tile, (set invalidate tile, set tile, bind tile, unbind tile)
|Unknown function, returns LV1_ILLEGAL_PARAMETER_VALUE(-17) when called with 0,0,0,0
|0x2108c0
|0x2108c0
|-
|-
|Unknown
|Unknown
|0×0301
|0×0301
|Zcull, (set Zcull, bind Zcull, unbind Zcull)
|Unknown function, returns LV1_ILLEGAL_PARAMETER_VALUE(-17) when called with 0,0,0,0
|0x2104bc
|0x2104bc
|-
|-
Line 6,611: Line 6,352:
----
----
=== lv1_undocumented_function_250 ===
=== lv1_undocumented_function_250 ===
Storage device


Exists in PAL 1.7. Returns -11 (LV1_WRONG_STATE) when passed 0 in R3 to R10.
Exists in PAL 1.7. Returns -11 (LV1_WRONG_STATE) when passed 0 in R3 to R10.
----
----
=== lv1_undocumented_function_251 ===
=== lv1_undocumented_function_251 ===
Storage device


Exists in PAL 1.7. Returns -11 (LV1_WRONG_STATE) when passed 0 in R3 to R10.
Exists in PAL 1.7. Returns -11 (LV1_WRONG_STATE) when passed 0 in R3 to R10.
----
----
=== lv1_undocumented_function_252 ===
=== lv1_undocumented_function_252 ===
Storage device


Exists in PAL 1.7. Returns -11 (LV1_WRONG_STATE) when passed 0 in R3 to R10.
Exists in PAL 1.7. Returns -11 (LV1_WRONG_STATE) when passed 0 in R3 to R10.
----
----
=== lv1_undocumented_function_253 ===
=== lv1_undocumented_function_253 ===
Storage device


Exists in PAL 1.7. Returns -11 (LV1_WRONG_STATE) when passed 0 in R3 to R10.
Exists in PAL 1.7. Returns -11 (LV1_WRONG_STATE) when passed 0 in R3 to R10.
----
----
=== lv1_storage_check_async_status ===
=== lv1_storage_check_async_status ===


Line 6,704: Line 6,437:


The code in the kernel does all manner of things to actually reboot, including sending vuart messages to some other process running in a different LPAR. I haven’t investigated enough to see exactly what it does, but calling lv1_panic(0) from my my code in the hypervisor causes a panic with the red light flashing until the power button is pressed whereas the kernel’s shutdown code doesn’t.
The code in the kernel does all manner of things to actually reboot, including sending vuart messages to some other process running in a different LPAR. I haven’t investigated enough to see exactly what it does, but calling lv1_panic(0) from my my code in the hypervisor causes a panic with the red light flashing until the power button is pressed whereas the kernel’s shutdown code doesn’t.
{{Development}}<noinclude>[[Category:Main]]</noinclude>
Please note that all contributions to PS3 Developer wiki are considered to be released under the GNU Free Documentation License 1.2 (see PS3 Developer wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following hCaptcha:

Cancel Editing help (opens in new window)

Templates used on this page:

Retrieved from "http://www.psdevwiki.com/ps3/HV_Syscall_Reference"