Function: device_enable_peer_access

Product	Supported (√/x)
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas training products	√
Atlas inference products	√
Atlas 200I/500 A2 inference products	x

Enables data exchange between the current device and a specified device. Memory copy is enabled at the device level.

Call acl.rt.device_can_access_peer in advance to check whether data exchange is supported between the current device and the specified device. Call acl.rt.device_enable_peer_access twice to enable data exchange between two devices. For example, call acl.rt.device_enable_peer_access once to enable data exchange between device 0 and device 1, and call acl.rt.device_enable_peer_access again to enable data exchange between device 1 and device 0.

To disable data exchange between devices, call acl.rt.device_disable_peer_access.

C Prototype

aclError aclrtDeviceEnablePeerAccess(int32_t peerDeviceId, uint32_t flags)

Python Function

ret = acl.rt.device_enable_peer_access(peer_dev_id, flag)

Parameter	Description
peer_dev_id	Int, device ID, which must be different from the current device ID. Must be in the range of [0, Device count – 1]. Call acl.rt.get_device_count to obtain the device count.
flag	Reserved; must be set to 0.

Parameter

Description

peer_dev_id

Int, device ID, which must be different from the current device ID.

Must be in the range of [0, Device count – 1]. Call acl.rt.get_device_count to obtain the device count.

flag

Reserved; must be set to 0.

Return Value	Description
ret	Int, error code: 0 on success; else, failure.

Parent topic: Device Management