RISC OS Open
A fast and easily customised operating system for ARM devices
ROOL
Home | News | Software | Bugs | Bounties | Forum | Documents | Photos | Contact us
Account

HAL_MachineID

Hardware Abstraction Layer
HAL entry points from RISC OS
» HAL_MachineID

HAL_MachineID

(HAL entry #59)
unsigned int64 HAL_MachineID(void)
Entry
Exit
- Returns machine ID

Use

This is an internal call for OS use only, and its specifications are subject to change without warning. User software should use OS_ReadSysInfo 12 (and friends) instead of calling this function directly.

Returns a 64-bit unique machine identifier,this may later be used to form the ethernet MAC address but otherwise has no great significance on non networked machines.

The top 8 bits are a CRC,based on the same algorithm the original DS2401 used – if the CRC fails zero will be substituted.

If this machine ID format is unsuitable for your hardware, it is recommended that you implement HAL_ExtMachineID instead.

See also

  • HAL_ExtMachineID
  • OS_ReadSysInfo 2
  • OS_ReadSysInfo 5
Information source: Kernel.Docs.HAL.MoreEnts in CVS
Revised on February 8, 2012 13:55:11 by Jeffrey Lee (213) (195.72.173.130)
Edit | Back in time (2 revisions) | See changes | History | Views: Print | Source | Linked from: HAL entry points from RISC OS, HAL entry points by number, HAL_ExtMachineID

Search the Wiki

Commercial use

For commercial enquiries, please contact the owners of RISC OS, Castle Technology Ltd.

ROOL Store

The official C/C++ Development kit and more here.

Donate! Why?

Help ROOL make things happen – please consider donating!

Navigation

  • Home Page
  • All Pages
  • Recently Revised
  • Authors
  • Feeds
  • Export
Site design © RISC OS Open Limited 2011 except where indicated
The RISC OS Open Instiki theme is based on Insitki's default layout

Valid XHTML 1.0  |  Valid CSS

Instiki 0.19.1(MML+)
This site runs on Rails

Hosted by Arachsys