# Introduction

In order to organize and create good documentation about the devices supported by HRIM we have created a electronic datasheet for each robot component. We have two differents steps:

• Create the XML file that contains all the information about the device.
• Generate the datasheet in PDF format based on the XML of a specific component.

## Generating the XML

### ID

The first thing that we need to define is the ID which is the identification of each module. It is designed to inform the user and also the system about the component itself.

### Characteristics

Then we need to define the specific characteristics of the component. Here we show two different examples.

This example is related to a camera:

This other example is related to a rotaryservo:

As you can see each one of the components have different characteristics that we need to fill in other to generate a XML file.

## Generating the PDF

We have created a Python tool to generate the datasheets based on the XML description that we have created in the step before.

### command structure

usage: datasheet_generator.py [-h] [--filename FILENAME] [--logo LOGO]
[--component_type {arm,battery,camera,conveyor,depthsensor,encoder,force,forcetoque,gasdetector,gps,gripper,hygrometer,lidar,microphone,mobile,motor,rangefinder,rotaryservo,thermometer,torque}]

Where:

-h/--help shows script's help. --filename selects which XML file you want to convert to pdf --logo selects the logo that the document will show --component_type select the component type. Possible options are : arm, battery, camera, converyor, depthsensor, encoder, force, forcetoque, gasdetector, gps, gripper, hygrometer, lidar, microphone, mobile , motor, rangefinder, rotaryservo, thermometer, torque

### Examples

python3 datasheet_generator.py --filename specific_components_datasheet/actuator/robotiq_gripper_finger_datasheet.xml --logo robotiq --component_type gripper
python3 datasheet_generator.py --filename specific_components_datasheet/actuator/hans_rotaryservo_datasheet.xml --logo hans --component_type rotaryservo