REVIEW REQUEST: sidsc-component specializations

["Beims Bob-RWBC70" <bob.beims@freescale.com>]

Eliot;

We're a little bit ahead of the schedule I'd asked you about below, but
I wanted to go ahead and let you know that the sidsc-component
specializations are ready for your review:

http://www.oasis-open.org/apps/org/workgroup/dita-sidsc/document.php?doc
ument_id=29192

(also see the attached email message for additional comments from Seth
Park)

If it would fit your schedule better to give the SIDSC team your review
during our 10-Sep teleconference, let me know. Otherwise we've given you
an extra week to be able to review the work before providing the review
during the 24-Sep telecon.

Thanks,
Bob

-----Original Message-----
From: Beims Bob-RWBC70 
Sent: Wednesday, August 27, 2008 3:11 PM
To: Eliot Kimber (Really)
Cc: Semiconductor Information Design Subcommittee
Subject: Soliciting your expert opinion

Eliot;

Just a quick heads-up. A couple of the SIDSC folks are putting finishing
touches on our first "official" specialization, and we'd like you to
review it for us and give your candid feedback. The schedule is:

-- complete the specialization package by 10-Sep, and submit it for your
review

-- on our 24-Sep teleconference, have you join the call and give us your
feedback

Does that schedule work for you?

Regards,
Bob

-----Original Message-----
From: Beims Bob-RWBC70
Sent: Wednesday, August 27, 2008 1:57 PM
Subject: Groups - Action Item Modified: #0065 Submit the next version of
the r...


DITA Semiconductor Information Design SC member,

Bob Beims has modified this action item.

Number: #0065
Description: Submit the next version of the r...
Owner: Bob Beims
Status: Open
Due: 10 Sep 2008

Comments:
Bob Beims  2008-08-27 18:56 GMT
Per the 27-Aug-08 telecon, we'll submit the next-pass specialization
(v2.3?) to Eliot Kimber for his review following the 10-Sept-08 call,
and ask him to report to us during the 24-Sept-08 session.

View Details:
http://www.oasis-open.org/apps/org/workgroup/dita-sidsc/members/action_i
tem.php?action_item_id=2231



PLEASE NOTE:  If the above links do not work for you, your email
application may be breaking the link into two pieces.  You may be able
to copy and paste the entire link address into the address field of your
web browser.

- OASIS Open Administration

--- Begin Message ---

• From: "Park Seth-R01164" <seth.park@freescale.com>
• To: <dita-sidsc@lists.oasis-open.org>
• Date: Wed, 3 Sep 2008 14:21:38 -0700

I've thoroughly scrubbed the sidsc-component specialization. The changes
that Tom Cihak made were done properly. In the process of creating a
basic XSLT override for the DITA-OT plugin, I discovered many small
issues (and a few major ones).
 
Now everything seems to be working as expected. I get good XHTML output,
leveraging a healthy mix of fall-back and custom stylesheet processing.
Of course, that's what DITA is all about!
 
The attached file is in the plugin (which you can download from the
OASIS site). It is the result of running the sample (which is described
in the README.html).
 
I am satisfied that the specialization is ready for an Eliot review.
 
Regards,
Seth
 
--------------------------------------------
seth park
information architect
Freescale Semiconductor, Inc.
seth.park@freescale.com
512.895.2463
 

DITA IP-Component Preview

---

General Component Information for imask

Brief Description

interrupt mask block

Full Description

The imask block is used to enable IC's to

• mask interrupts
• unmask interrupts

Unit Address: 0x0000

Component Data Key: Address1

Component Data Value:0x5000

Parent topic: Register Definition

---

Memory Maps Information

Primary Memory Map

Bits in Lau: 8

Memory Map Class: Data

---

Address Blocks Information

Primary Address Block

Brief Description

This address block is where most of the registers are found.

Full Description

When writing to this address block, it is important to understand that doing so may over-write any work previously done to other address blocks. The following table may not be helpful.

Table 1. Lesser Blocks

Name	Over-write?
A	Yes
B	Yes
C	Yes

Address Block Properties

Base Address: 0x0000

Range: 31:0

Width: 32

Byte Order: H2L

---

Registers Information

---

TMI

Too Much Information

Brief Description

The TMI registers indicate a TMI condition

Full Description

Then the TMI registers indicate a TMI condition, plug the information leak. If the TMI registers are a negative value, you may need to increase the data rate

Register Properties

Bits in Lau: 8

Offset: 0x0C

Size: 4

Access: R/W

Rest Value: 0xFFFF

Bit Order: bitOrder

Reset Trigger: HRESET_B

Dimension Information
Dimension Value: dimVal
Dimension Increment: dimInc

---

Bit Fields Information

VALVE

Brief Description

Information Control Valve

Full Description

This bit determines whether information is allowed to pass through the bus. Use this bit to control TMI conditions

Register Properties

Bit Numbers: 1

Bit Width: 1

Bit Offset: 0

Access: RW

Radix: bfRad

Reset: 0
Trigger: TMICB set
Source: System
Trigger: power-on-reset

0	clear	information valve is open; TMI conditions may ensue
1	set	information valve is closed; TMI conditions can not occur

---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php 

--- End Message ---