| /* |
| * (C) Copyright 2003 |
| * Stefan Roese, esd gmbh germany, stefan.roese@esd-electronics.com |
| * |
| * SPDX-License-Identifier: GPL-2.0+ |
| */ |
| |
| /*******************************************************/ |
| /* file: lenval.h */ |
| /* abstract: This file contains a description of the */ |
| /* data structure "lenval". */ |
| /*******************************************************/ |
| |
| #ifndef lenval_dot_h |
| #define lenval_dot_h |
| |
| /* the lenVal structure is a byte oriented type used to store an */ |
| /* arbitrary length binary value. As an example, the hex value */ |
| /* 0x0e3d is represented as a lenVal with len=2 (since 2 bytes */ |
| /* and val[0]=0e and val[1]=3d. val[2-MAX_LEN] are undefined */ |
| |
| /* maximum length (in bytes) of value to read in */ |
| /* this needs to be at least 4, and longer than the */ |
| /* length of the longest SDR instruction. If there is, */ |
| /* only 1 device in the chain, MAX_LEN must be at least */ |
| /* ceil(27/8) == 4. For 6 devices in a chain, MAX_LEN */ |
| /* must be 5, for 14 devices MAX_LEN must be 6, for 20 */ |
| /* devices MAX_LEN must be 7, etc.. */ |
| /* You can safely set MAX_LEN to a smaller number if you*/ |
| /* know how many devices will be in your chain. */ |
| #define MAX_LEN 7000 |
| |
| |
| typedef struct var_len_byte |
| { |
| short len; /* number of chars in this value */ |
| unsigned char val[MAX_LEN+1]; /* bytes of data */ |
| } lenVal; |
| |
| |
| /* return the long representation of a lenVal */ |
| extern long value(lenVal *x); |
| |
| /* set lenVal equal to value */ |
| extern void initLenVal(lenVal *x, long value); |
| |
| /* check if expected equals actual (taking the mask into account) */ |
| extern short EqualLenVal(lenVal *expected, lenVal *actual, lenVal *mask); |
| |
| /* add val1+val2 and put the result in resVal */ |
| extern void addVal(lenVal *resVal, lenVal *val1, lenVal *val2); |
| |
| /* return the (byte, bit) of lv (reading from left to right) */ |
| extern short RetBit(lenVal *lv, int byte, int bit); |
| |
| /* set the (byte, bit) of lv equal to val (e.g. SetBit("00000000",byte, 1) |
| equals "01000000" */ |
| extern void SetBit(lenVal *lv, int byte, int bit, short val); |
| |
| /* read from XSVF numBytes bytes of data into x */ |
| extern void readVal(lenVal *x, short numBytes); |
| |
| #endif |