Add a NodeId header and some NodeId utilities

[bzbarsky-apple]

Fixes #8461

The encoder.cpp changes are needed because it used to bootleg the
PacketBuffer header via basic-types.h including MessageHeader.h,
instead of doing include-what-you-use correctly.

Problem

Could use a utility to generate spec-valid random operational node ids.

Change overview

Add such a utility.

Testing

Made sure that chip-tool is still generating random node ids when it should.

[todo]

Consider making this a class and the various utility methods static

connectedhomeip/src/lib/core/NodeId.h

Lines 24 to 34 in 2de562c

	// TODO: Consider making this a class and the various utility methods static
	// methods.
	using NodeId = uint64_t;
	constexpr NodeId kUndefinedNodeId = 0ULL;
	constexpr NodeId kAnyNodeId = 0xFFFF'FFFF'FFFF'FFFFULL;
	constexpr bool IsOperationalNodeId(NodeId aNodeId)
	{
	return (aNodeId != kUndefinedNodeId) && (aNodeId <= 0xFFFF'FFEF'FFFF'FFFFUL);
	}

---

This comment was generated by todo based on a TODO comment in 2de562c in #8465. cc @bzbarsky-apple.

[bzbarsky-apple]

@msandstedt @tcarmelveilleux Please take a look?

[github-actions]

Size increase report for "esp32-example-build" from d24b3c0

File	Section	File	VM
chip-lock-app.elf	.flash.text	-64	-64

Full report output

BLOAT REPORT

Files found only in the build output:
    report.csv

Comparing ./master_artifact/chip-temperature-measurement-app.elf and ./pull_artifact/chip-temperature-measurement-app.elf:

sections,vmsize,filesize
.debug_info,0,8552
.debug_str,0,177
.debug_loc,0,-4
.debug_abbrev,0,-2884
.debug_line,0,-3841

Comparing ./master_artifact/chip-all-clusters-app.elf and ./pull_artifact/chip-all-clusters-app.elf:

sections,vmsize,filesize
.debug_info,0,15107
.debug_str,0,176
.debug_loc,0,16
.riscv.attributes,0,1
.debug_abbrev,0,-2883
.debug_line,0,-3573

Comparing ./master_artifact/chip-persistent-storage.elf and ./pull_artifact/chip-persistent-storage.elf:

sections,vmsize,filesize

Comparing ./master_artifact/chip-pigweed-app.elf and ./pull_artifact/chip-pigweed-app.elf:

sections,vmsize,filesize

Comparing ./master_artifact/chip-shell.elf and ./pull_artifact/chip-shell.elf:

sections,vmsize,filesize
.debug_info,0,5551
.debug_line,0,264
.debug_str,0,176
.debug_loc,0,17

Comparing ./master_artifact/chip-ipv6only-app.elf and ./pull_artifact/chip-ipv6only-app.elf:

sections,vmsize,filesize

Comparing ./master_artifact/chip-lock-app.elf and ./pull_artifact/chip-lock-app.elf:

sections,vmsize,filesize
.debug_str,0,174
[Unmapped],0,64
.debug_loc,0,3
.flash.text,-64,-64
.debug_line,0,-4714
.debug_abbrev,0,-6038
.debug_info,0,-48453

[todo]

Ideally we'd just ask for an operational cert for the commissionnee

connectedhomeip/examples/chip-tool/commands/pairing/PairingCommand.cpp

Lines 45 to 55 in ada92cf

	// TODO: Ideally we'd just ask for an operational cert for the commissionnee
	// and get the node from that, but the APIs are not set up that way yet.
	NodeId randomId;
	if (Controller::ExampleOperationalCredentialsIssuer::GetRandomOperationalNodeId(&randomId) == CHIP_NO_ERROR)
	{
	ChipLogProgress(Controller, "Generated random node id: 0x" ChipLogFormatX64, ChipLogValueX64(randomId));
	if (GetExecContext()->storage->SetRemoteNodeId(randomId) == CHIP_NO_ERROR)
	{
	GetExecContext()->remoteId = randomId;
	}
	}

---

This comment was generated by todo based on a TODO comment in ada92cf in #8465. cc @bzbarsky-apple.

[todo]

Ideally we'd just ask for an operational cert for the commissionnee

connectedhomeip/examples/chip-tool/commands/pairing/PairingCommand.cpp

Lines 45 to 55 in af22b22

	// TODO: Ideally we'd just ask for an operational cert for the commissionnee
	// and get the node from that, but the APIs are not set up that way yet.
	NodeId randomId;
	if (Controller::ExampleOperationalCredentialsIssuer::GetRandomOperationalNodeId(&randomId) == CHIP_NO_ERROR)
	{
	ChipLogProgress(Controller, "Generated random node id: 0x" ChipLogFormatX64, ChipLogValueX64(randomId));
	if (GetExecContext()->storage->SetRemoteNodeId(randomId) == CHIP_NO_ERROR)
	{
	GetExecContext()->remoteId = randomId;
	}
	}

---

This comment was generated by todo based on a TODO comment in af22b22 in #8465. cc @bzbarsky-apple.

[bzbarsky-apple]

@woody-apple @mspang @jepenven-silabs @jmartinez-silabs @Damian-Nordic Please take a look?