README.md

DeviceManager ADS

This repository shows how to get and set system information made available by the Beckhoff Device Manager using ADS. While this repository uses C++, the general procedure can be adapted to any ADS implementation.

The examples in this repository are continuously developed. If the functionality you want is not already included, feel free to create an Issue describing your use case.

Notes on TwinCAT/BSD

The following packages are required to build and run this example:

• os-generic-userland-devtools
• cmake
• git

Examples

The following examples are currently available in the Examples folder:

• General Area
  • GetDeviceName
• Device Area
  • GetSerialNumber
• Configuration Area
  • NIC
    • ChangeIP
  • TwinCAT
    • ChangeAmsNetId
    • DeleteAdsRoute
    • GetTcVersion
  • CPU
    • GetCpuInfo
  • File System Object
    • DeleteFile
    • Dir
    • Mkdir
    • ReadFile
    • ReadFileWithProgressBar
    • WriteFile
    • WriteFileWithProgressBar
    • CopyFile
  • Mainboard
    • GetMainboardInfo
  • Disk Management
    • DiskInfo
  • Mass Storage Monitoring
    • GetMassStorageInfo
  • Miscellaneous
    • Reboot

Follow these instructions in order to build and run examples:

1. Clone the repository and open a command line in root of the repository
2. Run cmake -B build
3. Adapt the AmsNetId of the target device the examples code
4. Build a specicifc example, e.g.:
   • cmake –-build build –-target GetDeviceName
   • cmake –-build build –-target GetCpuInfo
5. Run the example
   • ./build/Examples/GetDeviceName
   • ./build/Examples/GetCpuInfo