Port to SpiNNaker Tools v2.0.0

[mossblaser]

I propose that once merged this marks v1.0.0 of Rig which we really should have reached ages ago...

• [x] Code review.
• [x] Plonk in the official released files from SpiNNaker Tools v2.0.0.

This commit migrates over to a release-candidate of SpiNNaker Tools 2.0.0 which includes and new SC&MP which notably no longer needs to know the size of the machine when booting nor requires that chip (0, 0) exist at all.

NOTE This commit includes an unofficial SpiNNaker Tools release candidate version of SC&MP, sark.struct and test application binary. These should be rebuilt using the officially released SpiNNaker Tools package before final release of these changes to Rig.

Changes:

• Boot-related changes:
  • MachineController.boot() may be called without arguments (giving a width and height result in a deprecation warning and the values being ignored.
  • The boot() function, by default, waits for the machine to report that it is completely booted before returning.
  • The boot functions now accept filenames for the boot and struct files.
  • Additional kwargs to boot functions now override values in the SV struct.
  • As a result, the custom arguments for setting the hardware version and LEDs (etc.) have been removed in favour of directly specifying the SV values. I am not aware of these actually being used anywhere.
  • The rig-boot command no longer takes any arguments indicating the size of the machine. Calling it with a width or height is now an error.
  • Associated documentation has been updated.
• Other machine-control changes:
  • Both new- and old-format version formats is understood by get_software_version for SpiNNaker and BMPs alike.
  • Version numbers are now reported as tuples (major, minor, patch) rather than floats. (A breaking change)
  • System-wide commands (e.g. signalling etc.) are now sent to chip (255, 255), an alias for the 'root chip' used to boot the machine rather than (0, 0) which may not exist.
  • A new 'root_chip' attribute will report the (x, y) coordinate of the chip used to boot the machine. This is useful for certain geometry functions (e.g. discovery of Ethernet chip locations).
• All SpiNN-5 board related geometry functions now take the coordinates of the root chip as arguments. This is important when doing calculations relating to machines which do not have a chip (0, 0). All internal uses of these functions have been updated to provide this information. The one example use of these functions in the documentation has been updated.
• Hints about the once-missing sark_tag_ptr function have been removed with the expectation that new applications will use Spinnaker Tools v2.0.0 which now includes this function.
• The test binary has been rebuilt using SpiNNaker Tools v2.0.0 and has a new Makefile for building against this version of the tools.
• The test suite now does not accept a width and height when running against real SpiNNaker hardware. The developer documentation and travis scripts have been updated accordingly.

[mundya]

MachineController.boot() may be called without arguments (giving a width and height result in a deprecation warning and the values being ignored.

Given that this is a major version bump I'd be happy skipping the deprecation stage and just remove those arguments.

Other than that this all sounds awesome and I'll review!

[mossblaser]

Given that this is a major version bump I'd be happy skipping the deprecation stage and just remove those arguments.

I'm leaving them since a good number of rig scripts are floating around which I would wish to remain working. Plus it means that doing pip upgrade will allow nengo_spinnaker/Pinus-Rigida to benefit from hardware black-listing, faster booting, and general SC&MP robustness improvements the second this is released without modification.

[mundya]

I'm leaving them since a good number of rig scripts are floating around which I would wish to remain working. Plus it means that doing pip upgrade will allow nengo_spinnaker/Pinus-Rigida to benefit from hardware black-listing, faster booting, and general SC&MP robustness improvements the second this is released without modification.

Fair enough, thanks.

[mossblaser]

NB: this fixes #131. I suggest de-milestoning the other 1.0 milestones since they are not blocking and all have potential implementations with no breaking changes.

[mundya]

I'm very pleased at how much this change simplifies things! This pretty much LGTM!

[mundya]

I propose that once merged this marks v1.0.0 of Rig which we really should have reached ages ago...

and

I suggest de-milestoning the other 1.0 milestones since they are not blocking and all have potential implementations with no breaking changes.

Agreed to both.

[mundya]

2f0c20f39561dd7c795d02c8b206a66318653167 looks fine to me.