Skip to content

Porting

If you are porting your scripts from an earlier version of the Ostinato Python API to a newer version, you will find helpful information here.

To version 1.0

  • Default MAC mode has changed from fixed to resolve; scripts which assumed the default mac mode as fixed MUST be changed to set the mac mode explicitly. e.g.
from ostinato.protocols.mac_pb2 import mac, Mac # <--- import Mac

    # ...

    p = s.protocol.add()
    p.protocol_id.id = ost_pb.Protocol.kMacFieldNumber
    p.Extensions[mac].dst_mac_mode = Mac.e_mm_fixed # <-- add this statement
    p.Extensions[mac].src_mac_mode = Mac.e_mm_fixed # <-- add this statement
    p.Extensions[mac].dst_mac = 0x001122334455
    p.Extensions[mac].src_mac = 0x00aabbccddee
  • A new API has been added DroneProxy.build() to explicitly trigger a prebuild of packets. Although optional, it is highly recommend to use this API before invoking startTransmit().
    # prebuild all packets to be sent before actually sending them
    build_cfg = ost_pb.BuildConfig()
    build_cfg.port_id.CopyFrom(tx_port.port_id[0])
    drone.build(build_cfg)
Back to top