/**
* dfu_element_set_target_size:
* @element: a #DfuElement
* @target_size: size in bytes
*
* Sets a target size for the element. If the prepared element is smaller
* than this then it will be padded with NUL bytes up to the required size.
*
* Since: 0.5.4
**/
void
dfu_element_set_target_size (DfuElement *element, guint32 target_size)
{
DfuElementPrivate *priv = GET_PRIVATE (element);
const guint8 *data;
gsize length;
guint8 *buf;
g_autoptr(GBytes) contents_padded = NULL;
g_return_if_fail (DFU_IS_ELEMENT (element));
/* save for dump */
priv->target_size = target_size;
/* no need to pad */
if (priv->contents == NULL)
return;
if (g_bytes_get_size (priv->contents) >= target_size)
return;
/* reallocate and pad */
data = g_bytes_get_data (priv->contents, &length);
buf = g_malloc0 (target_size);
g_assert (buf != NULL);
memcpy (buf, data, length);
/* replace */
g_bytes_unref (priv->contents);
priv->contents = g_bytes_new_take (buf, target_size);
}
/**
* dfu_element_set_address:
* @element: a #DfuElement
* @address: vendor ID, or 0xffff for unset
*
* Sets the vendor ID.
*
* Since: 0.5.4
**/
void
dfu_element_set_address (DfuElement *element, guint32 address)
{
DfuElementPrivate *priv = GET_PRIVATE (element);
g_return_if_fail (DFU_IS_ELEMENT (element));
priv->address = address;
}
/**
* dfu_element_get_address:
* @element: a #DfuElement
*
* Gets the alternate setting.
*
* Return value: integer, or 0x00 for unset
*
* Since: 0.5.4
**/
guint32
dfu_element_get_address (DfuElement *element)
{
DfuElementPrivate *priv = GET_PRIVATE (element);
g_return_val_if_fail (DFU_IS_ELEMENT (element), 0x00);
return priv->address;
}
/**
* dfu_element_get_contents:
* @element: a #DfuElement
*
* Gets the element data.
*
* Return value: (transfer none): element data
*
* Since: 0.5.4
**/
GBytes *
dfu_element_get_contents (DfuElement *element)
{
DfuElementPrivate *priv = GET_PRIVATE (element);
g_return_val_if_fail (DFU_IS_ELEMENT (element), NULL);
return priv->contents;
}
/**
* dfu_image_add_element:
* @image: a #DfuImage
* @element: a #DfuElement
*
* Adds an element to the image.
**/
void
dfu_image_add_element (DfuImage *image, DfuElement *element)
{
DfuImagePrivate *priv = GET_PRIVATE (image);
g_return_if_fail (DFU_IS_IMAGE (image));
g_return_if_fail (DFU_IS_ELEMENT (element));
g_ptr_array_add (priv->elements, g_object_ref (element));
}
/**
* dfu_element_set_contents:
* @element: a #DfuElement
* @contents: element data
*
* Sets the element data.
*
* Since: 0.5.4
**/
void
dfu_element_set_contents (DfuElement *element, GBytes *contents)
{
DfuElementPrivate *priv = GET_PRIVATE (element);
g_return_if_fail (DFU_IS_ELEMENT (element));
g_return_if_fail (contents != NULL);
if (priv->contents == contents)
return;
if (priv->contents != NULL)
g_bytes_unref (priv->contents);
priv->contents = g_bytes_ref (contents);
}
/**
* dfu_element_to_string:
* @element: a #DfuElement
*
* Returns a string representaiton of the object.
*
* Return value: NULL terminated string, or %NULL for invalid
*
* Since: 0.5.4
**/
gchar *
dfu_element_to_string (DfuElement *element)
{
DfuElementPrivate *priv = GET_PRIVATE (element);
GString *str;
g_return_val_if_fail (DFU_IS_ELEMENT (element), NULL);
str = g_string_new ("");
g_string_append_printf (str, "address: 0x%02x\n", priv->address);
if (priv->target_size > 0) {
g_string_append_printf (str, "target: 0x%04x\n",
priv->target_size);
}
if (priv->contents != NULL) {
g_string_append_printf (str, "contents: 0x%04x\n",
(guint32) g_bytes_get_size (priv->contents));
}
g_string_truncate (str, str->len - 1);
return g_string_free (str, FALSE);
}
