bluetooth: Document periodic advertising interval unit

It was not possible to see what unit was used for periodic
advertising interval in the scan recv callback without digging
deep into the code.

Signed-off-by: Rubin Gerritsen <rubin.gerritsen@nordicsemi.no>